$BCERR X'4F' MLMP encountered a permanent error condition. Some permanent errors are:
. EOT received in response to data transmitted.
o EOT received in response to an addressing attempt.
a Forward abort received. That is:
Received fiDr IEOT or DISC
\ / Transmitted NAK
r EOT or DISC is transmitted after an error recovery retry count has been exceeded.
Label Valuo Description
$BcTlM X'50' The remote station does not respond to attempted data transfer. lssue a request for this or another file, or close the MLMp files ($CLOS).
Note: X'50'posted in a console DTF indicates that the operator pressed the REO k.ey (Model 10 and Model l2). X'50'posted in a dummy DTF indicates that the operator pressed r:he PF9 key ( M o d e l 1 5 ) .
$BCDAT X'51' Data was received incorrectly (data check). lssue your last request again, or issue a request for another file. Otherwise, close the MLMp files ($CLOS).
SBCLOS X'52' Data received was lost because it exceeded the size of the input buffer, had no endirg control character, or because no record separator was found within two contiguous blocks of-spanned records. lssue your last request again, or issue a request to another station. Otherwise, close t h e M L M P fi t e s ($ c L o s ) .
$BCCON X'53' The switched line connection with the remote station has been lost, or DISC was rec:eived in response to text. lssue your last request again, or issue a request for another file or r;tation. Other-w i s e , c l o s e t h e M L M P fi l e s ($ C L O S ) .
$BCRSP X'54' An invalid response was received f rom the remote station. lssue your last request agarin, or issue a request to another station. Otherwise, close the MLMp files ($CLOS).
$BCADP X'55' The BSCA is not working correctly (adapter check). lssue your last request again, or issue a request for another f ile. Otherwise, close the MLMP f iles ($CLOS).
flote.' The BSC line is disabled if :
o The connection was lost ($BCCON completion code condition), o DISC was received ($BCCON completion code condition), or
o Normal end of file was received ($BCEOT completion code condition).
$BCCMP X'56' None of the DTFs in the checklist indicates completion, but you have regained control as you requested in the first $CKL macro instruction (RTN-y). See index entrv $CKL macro instruc-tion.
$BCCMP is posted in the last DTF in the checklist.
$BCACD X'57' All the DTFs in the checklist are inactive or have been exempted f rom the test for completion.
$BCACD is posted in the last DTF in the checklist.
$BCRLE X'58' The record received was larger than the specified maximum record length {RECL in $DTFB).
flote.' This completion code applies only if you are receiving spanned records separatrrd by record separators.
N o t e : A l l d a t a i n t h e M L M P l / O b u f f e r s a t t h e t i m e o n e o f t h e f o l l o w i n g c o m p l e t i o n c o d e s i s p o s t e d m a y b e l o s t :
$ B C A S C $ B C T I M $ B C C O N $ B C R L E
$BCLST $BCDAT $BCRSP
$ B C E R R $ B c L o s $ B c A D p
The amount of data in the MLMP l/O buffers at any given time depends on record length, block size, buffer size, and the numb€r of buffers you are using, as well as the number of l/O requests you have issued. See index entry move mode,
Diagnostics and Diagnostic Aids /t9
B$C Counters
M[-lvlP cornpiles the following statistics as it monitors re-ceive and transmit operations:
'l . Numhrer of text blocks sent successfully.
2" lnlumtrer of text blocks received succesfully.
3. lrlumber of negative acknowledgements (NAKI re-ceivecl in response to text sent.
4. lrlumber of data checks that occurred on text received.
5. l\,|umber of forward aborts received. A forward abort received is:
Received Transmitted
ffDt ,EOT or D|SC
! ,
t ,
N A K
6. Nlumber of EOTs {$BCERR completion code} re-ceived in response to data transmitted.
V " F,lurnber of adapter checks that occurred while t!-ansmitting.
8. lrJurnber of adapter checks that occurred while receiving.
S" Numhrer of invalid responses received to text transmitted.
10. lrlumber of inquiries (ENO) sent in response to posa_
tive acknowledgements (ACK).
1'l " Number of blocks received f rom which data was lost.
'12.
filumber of disconnect timeouts and abortive (cancell disconnects.
13. Nurnber of timeouts that occurred while receiving text.
For multipoint control stations the following statistics are also recorded (see the ERRLOG operand of the $DTFB nracro instruction):
1. Number of unsuccessful transmissions for each ter-minal address.
Number of successful transmissions for each ter-minal address.
BSC counters and statistics are recorded in main r;torage whenever a BSC file is closed or before an online test. All BSC counters and statistics are logged to disk at end-of-job.
After the BSC program is terminated, BSC counters and statistics can be displayed by the Device Counter Logout program ($$BSDL). For operating procedures required to display the statistics, see the appropriate system operators guide f isted in the Preface.
BSCA Terminal Log Area
You must provide a permanent file on Fl for logging con-trol station terminal statistics (see index entry Terminal Sfatstbs Logging Areal. The permanent file, named M L T E R F I L , re q u i r e s o n e tr a c k . P a r t o f M L T E R F I L com-prises the BSCA Terminal Log Area and is used for logging the control station terminal statistics. Another patt of MLTERFIL is used for logqing MLTA statistics if lylLTA is present lsee IBM System/3 Multiple Line Terminal Adapt-er RPO RefAdapt-ermce and Component Description Ma,nual, G C 2 1 - 7 5 6 0 ) .
I n i t i a l i z i n g M L T E R F T L
To initialize MLTERFIL, MLMp provides, in the rrbject library, module $$ASf t. The OCL required to initiatize M L T E R F I L i s :
/ / L O A D $ $ B S F l , u n i t
/ / F IL E N A M E - M L T E R F t L,UN tT-F 1,pACK-pack, T RACKS- 1, LOCATI ON-track number (optiorral ), R E T A I N _ P
/ / R U N
MLTERFIL must be initialized after BSCA system genera-tion, and before using MLMP or MLTA. lf MLMP cannot f i n d M L T E R F I L o n F l while transmitting o r r e c e i v i n g data for a control station, MLMP issues the y6 halt. For a complete description of the Y6 halt, see the appropriate haft/messages manual tisted in the Preface"
Note: MLTERFIL need be initialized only once to, accomodate both MLMP and MLTA statistics. Don,t initialize the f ile twice if you use both MLMp and lvlLTA.
.}
t .
2 .
3.
4 "
Online Tert
The online t(lst enables you, or an IBM customer engineer, to test a line connection without interrupting data transfer on the other line. The test consists of sending a known mes-Eage over a line, then determining whethrgr the message was received accurately. When the test is cornpleted, results are fogged as follows: (see index entry online fesf resulfs).
o Model 10 and Model l2 - Halt/SyslolE is called to log the onliner test results on the system log device.
. Model 15 - Online test results are logged to the System History Area (SHAI and will be printed only if the print-er is logged.
Reguesting 0nline Test To request an online test:
Buifd a test parameter list (see index entries $RFTL macro instruction and online test ,oarameter listl.
Provide a test message if one is recluired (see index enlry anline test requestsl.
lssue the $RFT macro instruction
Check the l/O request completion code to deter-mine whether the request was accepted (see index entry completion codel.
Check for completion of the test ($CHK).
/Vote.' The $BCDNE completion code, after an on-line test request, indicates completion of the test;
$BCDI\E does not indicate that thre line is okay. To determine what happened on the line during the test, the operator must examine ttre logged results ol the test (see index entry online fe$t re.c//fs).
$RFT Mrcra, lnstruction: The format of the $RFT macro instruction ir;:
l n a m e ] l $ n r r PARM-address [.FROM-address]
[ , L E N - d e c d i g ] [ , D T F - a d d r e s s ] [,R EJECT-address]
PARM-address
Specifies the symbolic address of the first byte of the on-line test par€tmeter list. See index entry online test
param-eter list for trhe format.
FROM-address
Specifies the symbolic address of the first byte of the test message, including control characters. Use this operand r:nly for test types 00 and 0t (see index entry online test paraffi, eter list for test type descriptions).
LEN-decdig
Specifies in decimal the length of the test rnrlssage, includ"
ing controf characters. See index entry online tellr pararn-eter list for restrictions on the length of a terit rnessaqe.
Use this opeiand only for test types (X) and lJl (see index enlry online test parameter /rbf for test type descriptionsl.
DTF-address
Specifies the symbolic address of the pUT DTF iFTyp--TSMI for which the online test request is issued. lf not given, the addres of the DTF is assumed to be in register 2.
After $RFT is executed, register 2 contains the address of the DTF for which the online test request was issuecl.
REJECT-address
Specifies the symbolic address of a user routine to receive control if the online test request cannot be accepted by MLMP. You must provide the routine.
lf the REJECT operand is not specif ied. cher:k for the
$BCREO DTF completion code after each orrline rest re-quest to determine whether or not the requer;t was accept-ed. See index entry completion code.
Accepting an Online Test Request
Valid online test requests transmitted from a remote ter-minal are accepted when you issue an initial 13ET recluest, MLMP then performs the test automatically, logs the re-sults to your system logging device (see index. entry online test rewltsl, and reissues the GET request to receive data.
5.
Diagnostics and Diagnostic Aids bl
lf System/3 does not recognize an online test requesr you receive, the request is passed to you as data. The online test types recognized by System/3 are:
Description
3270 Model 1 align EBCDIC test pattern:
This test checks position alignment for the 480-character display station. lt also checks t h e W C C t o s o u n d t h e a u d i b l e a l a r m . lt starts a printer, printing 40 characters to a l i n e .
3270 Model 2 align EBCDIC test pattern:
This test checks position alignment for the 1920-character display station. lt also checks t h e W C C to s o u n d t h e a u d i b l e a l a r m . lt w i l l start a printer, printing 80 characters to a l i n e .
3270 orders EBCDIC test message:
This tests 3270 orders (SF, SBA, etc.), checks the WCC to sound the audible alarm, and uses display and intensified brightness.
It starts the printer, printing 64 characters t o a l i n e .
3270 EBCDIC Universal Character Set test patte rn :
This test uses the EraseAVrite command, dis-playing the Universal Character Set in EBCDIC. lt checks the WCC to start the printer, sound the audible alarm (on a dis-p l a y ) , a n d p r i n t 1 3 2 c h a r a c t e r s p e r li n e o n the printer. NL and EM are also tested on a printer. Display intensity is used. The SF, N L , E M , a n d lC o r d e r s a r e u s e d .
3270 NL/EM EBCDIC test Pattern:
This test is mainly intended to test the end of message (EM) order and multiple new line (NL) orders on the printer. The WCC is checked to start the printer, sound the alarm
(on a display). and print 132 characters to a l i n e o n t h e p r i n t e r .
3270 ASCII test patterns:
These tests correspond to tests 23-28 except that transmission is in ASC|l.
Receive and acknov'rledge the test message the number of times specif ied in bytes YY o f t h e o n l i n e t e s t p a r a m e t e r l i s t ( s e e in d e x entry online test parameterlrst). The for-matteci test request must not be more than 300 characters long. See index entry onlrne test requests.
Transmit the test message the number of t i m e s s p e c i f i e d i n b y t e s Y Y o f t h e o n l i n e test parameter list (see index entry onlrne test parameter /rst). The f ormatted test re-quest must not be more than 300 characters long. See index entry online test requestsl.
T r a n s m i t 3 6 a l p h a m e r i c c h a r a c t e r s , A - Z a n d 0-9, the number of times specified in bytes YY of the online test parameter list (see in-dex entry online test parameter lrst). Trans-m i t t h e c h a r a c t e r s i n A S C I I ( A S C l l a d a p t e r
14 Transmit 36 alphameric characters, A-Z and G9, the number of times specif ied in bytes YY of the online test parameter list (see in-dex entry online test parameter /rbt). Transmit t h e c h a r a c t e r s i n E B C D I C { E B C D I C a d a p t e r o n l Y ) .
2 3 3 2 7 0 b a s i c E B C D I C t e s t m e s s a g e : This test checks all alphameric characters at a display station or printer. lt checks the use of the WCC to sound the audible alarm and allows attribute field specif ications to
be checked at a display station. lt starts a p r i n t e r . p r i n t i n g o n l y 4 0 c h a r a c t e r s t o a l i n e .
28
29-34
Online Test Results
R e s u l t s a r e l o g g e d in o n e o f t w o f o r m a t s , d e p e n d i n g o n w h e t h e r t h e t e s t m e s s a g e ( n o t t h e t e s t r e q u e s t ) w a s t r a n s -m i t t e d o r r e c e i v e d .
Test Message Transmitteo :
' B S c oN L r \ E r E S r , L r N E
l r , , , t l r E R r v r N A L A D D R H E X h e x l M E S S A G E T Y P E t t , M E S S A G E C o U N T c c
A C K R C V I ) N A K R C V D T I M E O U T IN V L D M S G
X X X X
E N D O N L I N E T E S T
T E R M I N A L A D D R H E X h e x i c l e n t i f i e s th e t e r m r n a t t o w h i c h t h e t e s t m e s s a g e w a s s e n t if t h e l o g g i n g s t a t i o n is a c o n t r o l s t a l i o n ( T Y P E - C S i n $ D T F B ) .
tt identif ies the test message type. See index entry online test parameter list Ior a description of the test tylres.
c c i s t h e n u m b e r o f t i m e s t h e t e s t m e s s a g e w a s t o b e t r a n s -r n i t t e d . T h e m e s s a g e c o u n t i s s p e c i f i e d i n t h e o n t t n e te s t p a r a m e t e r l i s t .
A C K R C V D x x i s t h e n u m b e r o f t i m e s A C K w a s r e c e r v e d a s a r e p l y t o t h e t e s t m e s s a g e .
N A K R C V D x x i s t h e n u m b e r o f t i m e s N A K w a s r e c e r v e o a s a r e p l y t o t h e t e s t m e s s a g e .
T I M E O U T x x i s t h e n u m b e r o f 3 - s e c o n d t i m e o u t s r e c o r d e d d u r i n g t h e o n l i n e t e s t b y t h e B S C A .
I N V L D M S G x x i s t h e n u m b e r o f i n v a l i c l r e p l i e s r e c e i v e d I n r e s p o n s e t o t e s t m e s s a g e s s e n t .
T e s t M e s s a g e R e c e i v e d :
' B S C o N L r r \ r E T E S T , L t N E f r o , z
f t r e n r N A L A D D R H E X h e x l M E S S A G E T Y P E 1 t . M E S S A G E C O U N T c c
T X T R C V I ) D A T A C H K T I M E o U T II l V L D M S G
X X
- E N O O N L I N E T E S T
X X X X
T E R M I N A L A D D R H E X h e x i d e n t i f i e s r h e r e r m i n a l t h a t t r a n s m i t t e d t h e t e s t m e s s a g e i f t h e l o g g i n g s t a t i o n is a c o n -t r o l s -t a -t i o n (T Y P E - C S i n $ D T F B ) .
tt identif ies the test message type. See index entry online test paraneter list lor a description of the test types.
c c i s t h e n u m b e r o f t i m e s t h e t e s t m e s s a g e w a s t o b e t r a n s -m i t t e d . T h e -m e s s a g e c o u n t i s s p e c i f i e d i n t h e o n l i n e t e s t P a r a m e t e r l i s t .
T X T R C V D x x i s t h e n u m b e r o f t i m e s th e t e s t m e s s a g e w a s r e c e i v e d c o r r e c t l y .
D A T A C H K x x i s t h e n u m b e r o f d a t a c h e c k s re c o r d e d dur-i n g t h e o n l dur-i n e t e s t b y t h e B S C A .
T I M E O U T x x i s t h e n u m b e r o f 3 - s e c o n d t i m e o u t s r e c o r d e d d u r i n g t h e o n l i n e t e s t b y t h e B S C A .
I N V L D M S G x x i s t h e n u m b e r o f t e s t m e s s a g e s r e c e i v e d i n c o r r e c t l y fo r w h i c h a d a t a c h e c k o r t i m e o u t w a s n o r r e -cordeci.
A n o n l i n e te s t o n l y i n d i c a t e s l i n e c o n d i t i o r - r s e x i s t r n g a t t h e t i m e o f t h e t e s t . l f t h e t e s t r e v e a l s t h e p r e r ; e n c e o f l i n e p r o -b l e m s , y o r - r m u s t d e c i d e w h e t h e r t h e p r o b a b i l i t y o f s u c c e s s -f u l t r a n s m i s s i o n i s g r e a t e n o u g h t o j u s t i f y o o n t i n u e d t r a n s -m i s s i o n o v e r th e l i n e .
T o d i s c o v e r s i g n i f i c a n t t r e n d s in t h e a p p e a r a n c e o f l i n e p r o b l e m s , c o n s i d e r o n l i n e te s t r e s u l t s i n c o n j u n c t i o n w i t h t h e B S C c o u n t e r s a n d c o n t r o l s t a t i o n te r m i n a l s t a t i s t i c s ( s e e i n d e x e n t r y 8 S C c o u n t e r s \ .
On I i ne Test C onsi derati on s
l f y o u w a n t t o r e q u e s t a n o n l i n e t e s t o r e x i t e c t to r e c e i v e a r e q u e s t f o r a n o n l i n e te s t , c o n s i d e r t h a t :
o T h e M L M P l / O b u f f e r s m u s t b e l a r g e e n o u g h to a c c o m o -d a t e a n o n l i n e te s t r e q u e s t . S e e t h e R E r I L a n d B L K L o p e r a n d s i n t h e $ D T F B m a c r o in s t r u c t i o n , a n d i n d e x entries online test requests and MLMP l/O area.
. N o d a t a e x c e p t t h e o n l i n e t e s t m e s s a g e c a n b e s e n t o r r e c e i v e d o v e r a l i n e t h a t i s b e i n g te s t e d u n t i l t h e o n l i n e t e s t i s c o m p l e t e .
o A n o n l i n e t e s t r e q u e s t th a t i s n o t r e c o g r r i z e d b y M L M P i s a c c e p t e d a s d a t a a n d m o v e d t o y o u r l o g i c a l b u f f e r .
X X X X
D i a g n o s t i c s a n d D i a g n o s t i c A i d s 5 3
P a s e o f G C 2 1 . 7 5 7 3 4 lssued 25 November 1977 B y T N L : G N 2 1 - 5 5 8 7
C o n s i d e r a t i o r r s u t r i c l u e t o r e q u e s t i n g a n o n l i n e t e s t a r e : l n c l u c l e T r a c e , A s s e m b l e r
o A n o n l i r t e te s t r e q u e s t fo r S y s t e m / 3 must be the first I n c l u d e th e t r a c e m o d u l e i n y o u r p r o g r a m b y s p e c i f y i n g a n c i o n l ! ' t e x t m e s s a g e t r a n s m i t t e d o v e r a l i n e . A n o r r _ E X T R N $ $ g S f f i n y o u r p r o g r a m , o r b y p l a c i n g a n l N -l -l n e te s t r e q L r e s t t r a n s m i t t e d t o S y s t e r n / 3 a f t e r t e x t h a s C L U D E c a r d in t h e l i n k a g e e d i t o r in p u t d e c k :
b e e n s e r r t w i l l b e r e c e i v e d b y S y s t e m / 3 a n d p a s s e d t o
y o u a s d a t a . / / I N C L U D E N A M E $ $ B S T T , U N | T _ x x
. Y o u m u s t t r a n s m i t E O T a f te r t r a n s m i t t i n g a n o n l i n e ( x x i s t h e u n i t n a m e R 1 , F 1 , R 2 , o r F 2 l t e s t r e c l u e s t t o S y s t e m / 3 if t h e m e s s a g e t y p e i s n o t 0 0 .
l f y o u t r a n s m i t c l a t a o t l r e r th a r - r t h e t e s t m e s s a g e b e f o r e N o t e : l t y o u u s e a n I N C L U D E s t a t e m e n t t o c a l l t h e t r a c e y o u s e n t i E O T , S y s t e m / 3 a b o r t s tr a n s m i s s i o n a n c l p o s t s m o d u l e , th e o v e r l a y li n k a g e e d i t o r g e n e r a t e s a n a m e n o t t h e S y s t e r r / 3 u s e r w i t h t h e $ B C O L T c o m p l e t i o n c o d e r e f e r e n c e d e r r o r m e s s a g e ( 0 L 0 3 1 ) . T h i s e r r o r d o e s n o t ( s e e i n d e x e n l r y c o n t p l e t i o n c o d e l . T l r e d a t a t r a l s m i t t e d a f f e c t t h e o u t p u t o f t h e l i n k a g e e d i t o r , h o w e v e r , a n d s h o u l d
b e f o r e E O T i s l o s t . b e i q n o r e o .
a $ R F T s h o u l d n o t b e u s e d u n l e s s t h e r e m o t e o e v r c e c a n
I a c c e p t re m o t e l y in i t i a t e d o n l i n e t e s t r e q u e s t s . l n c l u 4 e T r a c e . R p G l l
. $ R F T m u s t b e i s s u e d o n l y f o r a P U T D T F ( F T Y P T S M l f y o u a r e r u n n i n g u n d e r R P G l l a s a s u b r o u t i n e , $ $ B S M T i n $ D T F B ) t h a t i s o p e n e d b u t n o t b e i n g u s e d f o r d a t a i s a u t o m a t i c a l l y l i n k - e d i t e d a s a d u m m y t r a c e m o d u l e . l f t r a n s f e r ' v o u w a n t t o i n c l u d e th e a c t u a l tr a c e m o d u l e i n y o u r p r o
-g r a m y o u m u s t r e n a m e th e d u m m y a n d a c t u a l tr a c e m o d u l e s . ' A m u l t i p o i n t c o n t r o l s t a t i o n (T Y P E - C S in $ D T F B ) A f t e r r e n a m i n g t h e m o d u l e s , r e c o m p i l e y o u r p r o g r a m t o I c a n o n l y r e q u e s t t e s t t y p e 0 0 f o r a t r i b u t a r y s t a t i o n . g e t t h e a c t u a l m o d u l e l i n k - e d i t e d . T h e f o l l o w i n g s t a t e m e n t s
See index enlry online test parameter list Ior d vre used to rename the trace modules:
d e s c r i p t i o n o f t h e t e s t t V p e s .
L O A D $ M A l N T , x x o A S y s t e r r / 3 m u l t i p o i n t tr i b u t a r y (T Y P E - M P i n $ D T F B )
c a n n o t r e q u e s t t h a t a n o n l i n e t e s t b e s e n t to a n o t h e r / / R U N S y s t e m / 3 tr i b u t a r y i n t h e n e t w o r k .
/ / R E N A M E F R O M - x x , L l B R A R Y - R , N A M E - $ $ B S M T ,
See also index entry how to request an online test from a NEWNAME_$$BSAV
3270.
/ / R E N A M E F R O M - x x , L l B R A R Y - R , N A M E - $ $ B S T T ,
T r a c e N E W N A M E - $ $ B S M T
l f y o u a r e fa m i l i a r w i t h S y s t e m / 3 B S C A h a r d w a r e a n d B S C / / E N D l i n e c o n t r o l p r o c e d u r e s , y o u m a y f i n d a r e c o r d o f t h e B S C A
l / O s e q u e n c e h e l p f u l in i s o l a t i n g a n M L M P p r o g r a m m i n g ( x x i s t h e u n i t n a m e R 1 , F 1 , R 2 , o r F 2 l p r o b l e m . M L M P p r o v i d e s a t r a c e m o d u l e ( $ $ B S T T ) t o
r e c o r d l/ O i n f o r m a t i o n a f t e r e a c h B S C A i n t e r r u p t . T h i s T o r e p l a c e t h e a c t u a l tr a c e m o d u l e w i t h d u m m y t r a c e i n f o r m a t i o n c a n b e e x a m i n e d b y V o u o r a n I B M c u s t o m e r m o d u l e :
e n g i n e e r t o d i a g n o s e a p r o b l e m .
1 . R e n a m e t h e m o d u l e s : O n c e th e t r a c e m o d u l e i s i n c l u d e d in y o u r p r o g r a m , e a c h
M L M P l / O o p e r a t i o n c a l l s T r a c e t o r e c o r d t h e e v e n t r n a / l L O A D $ M A l N T , x x t r a c e ta b l e ' T h e f o r m a t o f t h e t a b l e i s s h o w n i n A p p e n t l i x / / R U N
C . D u m p t h e t r a c e t a b l e w h e n y o u a r e r e a d v to e x a m i n e t h e / / R E N A M E F R O M - x x , L l B R A R Y - R , N A M E - $ $ B S M T , i n f o r m a t i o r r r e c o r d e d i n i t . Y o u c a n u s e th e $ S N A P m a c r o N E W N A M E - $ $ B S T T
i n s t r u c t i o n t o d u m p t h e t a b l e ( s e e i n d e x e n t r v .g S t V A P / / R E N A M E F R O M - x x , L l B R A R Y - R , N A M E - $ $ B S A V , m a c r o i n s t r u c t i o n ) . D u m p m a i n s t o r a g e f r o m s y m b o l i c N E W N A M E - $ $ B S M T
a d d r e s s M T B S M L t o s y m b o l i c a d d r e s s M T B S M M , th e / / E N D b e g i n n i n g a n d e n d i n g a d d r e s s e s o f t h e t r a c e t a b l e .
( M T B S M L a n d M T B S M M e a c h re q u i r e t h a t a n E X T R N ( x x i s t h e u n i t n a m e R 1 , F l , R 2 , o r F 2 l b e d e f i n e d in t h e p r o g r a m re q u e s t i n g t h e d u m p . )
Tr*e Considerations Since a printer is much faster than the console, it is re-commended that the system logging device be a printer o ITB interrupts, BSCA enabling operations, and BSCA when you intend to use $SNAP.
disabling operations are not recorded by Trace.
o Trace entries are recorded independently of your pro- .SS/VAP Macro lnstruction Format gramming operations. That is, entries are recorded when
an interrupt occurs regardless of current operations occurring in your program, and can |)e recorded at any time, even during a snap dump (see {ollowing discussionl.
Consequently, be aware that entries may have been made to the trace table after a request to clump the table.
o Trace requires 512 bytes of main storage.
Specif ies a 2-byte parameter to identify the' dump. The o For program efficiency, include Trae in your program parameter is printed at the beginning of the, dump output.
only when you are trying to diagnose a problem.
START-address Snrp Dump Main Storage ($SNAP)
Specifies the symbolic address of where the duinp should The $SNAP macro instruction generater; linkage to a system begin.
storage dump routine. You must provirle dump identifica-tion and durnp limits. The output frorrr the dump routine
is printed on the system logging device. Output consists END-address of:
Specifies the symbolic address of where the dump should
1. The dump identification. end.
2. The contents of registers 1 and 2.
3. The address of the next sequential instruction after the $SNAP macro instruction.
4. The contents of main storage identified by the dump limits,.
lnamel | $SNAP I lD-hex,sTART-address, EN D-address
l D - h e x
Diagnostics and Diagnostic Aidr 55
C h a p t e r 5 . R e q u i r e m e n t s a n d C o n s i d e r a t i o n s
S Y S T E M C O N F I G U R A T I O N M o d e l 1 0
T h e m i n i m u m s y s t e m c o n f i g u r a t i o n a n c l o p t i o n a l d e v i c e T h e m i n i m u m M o c l e l 1 0 c o n f rg u r a l i o n i s : s u p p o r t f o r M L M P i s :
o 5 4 1 0 P r o c e s s i n g U n i t M o d e l A l 3 ( 1 2 K b v t e s ) (i f n o t a c o n t r o l s t a t i o n , a M o d e l A l 4 ( 1 6 K ) i s r e q u i r e r j f o r a
M o d e l 8 c o n t r o l s t a t i o n )
T h e n r i n i m u m M o d e l 8 c o n f i g u r a t i o n is : . 5 4 4 4 D i s k S t o r a g e D r i v e M o d e l 1 . 5 4 0 8 P r o c e s s i n g U n i t M o d e l A 1 4 ( 1 6 , K b y t e s ) . 5 4 2 4 M F C U M o d e t A 1
. 5 4 4 4 D i s k S t o r a g e D r i v e M o d e l 4 1 o 5 2 0 3 P r i n t e r M o d e l 1
. 5 2 0 3 P r i n t e r M o d e l 1 o B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s l \ d a p t e r ( B S C A ) , o r L o c a l C o m m u n i c a t i o n s A d a p t e r ( L C , A )
. 5 4 7 l P r i n t e r - K e y b o a r d M o d e l 1 o r D i r e c t l v a t t a c n e d
3 7 4 1 D a t a S t a t i o n M o d e l 1 A d d i t i o n a l d e v i c e s s u p p o r t e d f o r t h e M o d e | 1 0 a r e : . B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s A d a p t e r ( B S C A ) , o b 4 l 0 P r o c e s s i n g U n i t M o c l e l A l 4 ( 1 6 K ) , A 1 5 e 4 K ) ,
L o c a l D i s p l a y / \ d a p t e r , o r I n t e g r a t e d C o m m u n i c a t i o n s A 1 6 ( 3 2 K ) , o r A 1 7 ( 4 B K ) A d a p t e r t , I C A )
. 5 4 4 4 D i s k S t o r a g e D r i v e M o d e l 2 , 3 , A 1 . A 2 , o r A 3 A d d i t i o n a l d e v i c e s s u p p o r t e d f o r t h e M o d e l 8 a r e :
. 5 4 4 5 D i s k S t o r a g e M o d e l 1 ,2 , o r 3 o 5 4 0 8 P r o c e s s i n g U n i t M o d e l A 1 6 ( 3 2 K ) , A j 7 ( 4 8 K ) ,
o r A 1 8 ( 6 4 K ) . 3 4 1 0 / 3 4 1 1 M a g n e t i c T a p e S u b s y s t e m l l l o d e l s 1 . 2 . a n d 3
. 5 4 4 4 D i s k S t o r a g e D r i v e M o d e l A 2 or 43
. 1 4 4 2 C a r d R e a d P u n c h M o d e l 6 o r 7 . 5 2 0 3 P r i n t e r M o d e l 2 o r 3
. 5 4 7 1 P r i n t e r - K e v b o a r d . B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s A d a p t e r (B S C A ) ,
L o c a l D i s p l a y A d a p t e r , o r l n t e g r a t e d C o m m u n i c a t i o n s . 5 2 0 3 P r i n t e r M o d e l 2 o r 3 A d a p t e r ( l C A )
. 1 4 0 3 P r i n t e r M o d e l 2 o r N 1 l V o t e . ' T w o a d a p t e r s c a n b e p r e s e n t . T h e l o c a l d i s p l a y
a d a p t e r , l C A , a n d B S C A - 2 a r e m u t u a l l y e x c l u s i v e . . 5 4 2 4 M F C U M o d e l A 2
o D i r e c t l y a t t a c h e d 3 7 4 1 D a t a S t a t i o n M o d e l 2 or o B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s p , d a p t e r ( B S C A ) , P r o g r a m n r a b l e W o r k S t a t i o n M o d e l 3 o r 4 o r L o c a l C o m m u n i c a t i o n s A d a p t e r ( L C r \ ) ( b o t h c a n b e
p r e s e n t )
o D i r e c t l y a t t a c h e d 3 7 4 ' l D a t a S t a t i o n M c , d e l 1 o r 2 . o r P r o g r a m m a b l e W o r k S t a t i o n M o d e l 3 o r 4
R e q u i r e m e n t s a n d C o n s i d e r a t i o n s 5 7
P a g e o f G C 2 1 - 7 5 7 3 4 l s s u e d 2 5 N o v e m b e r 1 9 7 7 B y T N L : G N 2 1 - 5 5 8 7
M o d e l 1 2 . 5 4 2 4 M F C U M o d e l A 1 o r A 2 . 2 5 6 0 M F C M M o d e l
A'l or 42 T h e m i n i m u m M o d e l ' l
2 c o n f i q u r a t i o n i s : o r
1 4 4 2 C a r d R e a d P u n c h M o d e l 6 o r 7 . 5 4 1 2 P r o c e s s i n g U n i t M o d e l 8 1 6 ( 3 2 K b y t e s )
o 1 4 0 3 P r i n t e r M o d e l 5 o 3 3 4 0 D i r e c t A c c e s s S t o r a g e F a c i l i t y M o d e l C 2
. B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s A d a p t e r ( B S C A ) , . 5 4 2 4 M F C U M o d e l A 1 D i s p l a y A d a p t e r , o r L o c a l C o m m u n i c a t i o n s A d a p t e r
( L C A ) . 5 2 0 3 P r i n t e r M o d e l 1
A d d i t o n i a l d e v i c e s s u p p o r t e d fo r t h e M o d e l 1 5 a r e : o I n t e g r a t e d C o m m u n i c a t i o n s A d a p t e r ( l C A ) , L o c a r
D i s p l a y A d a p t e r , o r B i n a r y S y n c h r o n o u s C o m m u n i c a - . 5 4 1 5 P r o c e s s i n g U n i t M o d e l A 1 8 ( 6 4 K ) , A 1 9 ( 9 6 K ) , o r t i o n s A d a p t e r ( B S C A ) A 2 0 ( ' l 2 B K ) ( w i t h 5 4 4 4 1 5 4 4 5 d i s k u n i t s )
A d d i t i o n a l c l e v i c e s s u p p o r t e d f o r t h e M o d e l 1 2 a r e ; . 5 4 1 5 P r o c e s s i n g U n i t M o d e l 8 1 8 ( 6 4 K ) , 8 1 9 ( 9 6 K ) , o r 8 2 0 ( 1 2 8 K ) ( w i t h 3 3 4 0 d i s k u n i t s )
. 5 4 1 2 P r o c e s s i n g U n i t M o d e l 8 1 7 ( 4 8 K ) o r B l 8 ( 6 4 K )
t 5 4 t 5 P r o c e s s i n g U n i t M o d e l C 2 1 ( 1 6 0 K ) , C 2 2 ( 1 9 2 K 1 , . 3 4 1 0 1 3 4 1 1 M a g n e t i c T a p e S u b s y s t e m M o d e l s 1 , 2 , a n d 3 C 2 3 ( 2 2 4 K 1 , o r C 2 4 ( 2 5 6 K ) ( w i t h 3 3 4 0 d i s k u n i t s )
. 5 4 1 5 P r o c e s s i n g U n i t M o d e l D 1 9 ( 9 6 K ) , D 2 0 ( 1 2 8 K ) , D 2 l ( 1 6 0 K ) , D 2 2 ( 1 9 2 K ) , D 2 3 l 2 2 4 K l , D 2 4 ( 2 5 6 K 1
| ( * i t n 3 3 4 0 1 3 3 4 4 d i s k u n i t s ) , D 2 5 ( 3 8 4 K ) , o r I D 2 6 ( 5 i 2 K )
. 3 3 4 0 D i r e c t A c c e s s S t o r a g e F a c i l i t y M o d e l B ' l o r 8 2 ( a v a i l a b l e w i t h 5 4 1 5 - 8 , -C . a n d - D m o d e l s )
. 5 4 4 4 D i s k S t o r a g e D r i v e M o d e l A 3 ( a v a i l a b l e w i t h 5 4 1 5 A m o d e l s )
o B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s A d a p t e r ( B S C A ) ,
L o c a l D i s p l a y A d a p t e r , o r I n t e g r a t e d C o m m u n i c a t i o n s . S 4 4 S D i s k S t o r a g e M o d e l 1 ,2 , o r 3 ( a v a i l a b l e w i t h . 1 4 4 2 C a r c l R e a d P u n c h M o d e l s 6 o r 7
. 5 4 7 1 P r i n t e r - K e y b o a r d . 5 2 0 3 P r i n t e r M o d e l 2 o r 3 . 1 4 0 3 P r i n t e r M o d e l 2 , 5 , o r N 1 . 5 4 2 4 M F C U M o d e l 4 2
A d a p t e r ( l C A )
N o r c : f w o a d a p t e r s c a n b e p r e s e n t . T h e l o c a l d i s p l a y a d a p t e r , l C A , a n d B S C A 2 a r e m u t u a l l y e x c l u s i v e .
5 4 1 5 A m o d e l s )
. 3 4 1 0 / 3 4 1 1 M a g n e t i c T a p e S u b s y s t e m M o d e l s 1 , 2 , a n d 3
o D i r e c t l y a t t a c h e d 3 7 4 1 D a t a S t a t i o n M o d e l 1 o r 2 o r P r o g r a m m a b l e W o r k S t a t i o n M o d e l 3 o r 4
o D i r e c t l y a t t a c h e d 3 7 4 1 D a t a S t a t i o n M o d e l 1 o r 2 o r . 1 4 0 3 p r i n t e r M o d e l 2 o r N 1 P r o g r a m m a b l e W o r k S t a t i o n M o d e l 3 o r 4
. 3284 Printer
Modef 'l 5 . 2501 Card Reader
T h e m i n i m u m M o d e l 1 5 c o n f ig u r a t i o n i s : ' l n t e r v a l T i m e r o 5 4 1 5 P r o c e s s i n g U n i t M o d e l A 1 7 ( 4 8 K b y t e s ) a n d a
5 4 4 4 D i s k S t o a r g e D r i v e M o d e l 4 2 o r
5 4 1 5 P r o c e s s i n g U n i t M o d e l B 1 7 ( 4 8 K b y t e s ) a n d a o B i n a r y S y n c h r o n o u s C o m m u n i c a t i o n s A d a p t e r ( B S C A ) , 3 3 4 0 D i r e c t A c c e s s S t o r a g e F a c i l i t y M o d e l A 2 D i s p l a y A d a p t e r , o r L o c a l C o m m u n i c a t i o n s
A d a p t e r ( L C A ) . 3 2 7 7 D i s p l a y S t a t i o n ( C R T / K e y b o a r d )
Storage Requirements
MLMP resides in the Model 10 Disk System, Model 12, or M o d e l 1 5 l i b r a r i e s a n d r e q u i r e s :
. 0.25K in the system nucleus. (The module $$gStt! is required in main storage at execution time _ Model 1 0 o n l y . )
. 5.25K of main storage to include:
$$BMS-M LMP Data Management
$$BMCH-Check Routine
$$BSLG-Terminal Statistics Loggirrg Routine
$$BSAT-Line 2 Work Area
Additional main storage requirements for MLMp are:
0.25K for $$BSMD if AUTORS-y is specified in
$ D T F B
2.00K for $$BSMA, $$BSMB, $$BSMC. and ggBSur if POLRES-Y is specified in $DTFB
0.50K for $$eStO if the display adapter is supported 0.75K for Trace (ggBSTT) if Trace is used
. Main storage for user's code, including lllO buffers, DTFs, polling lists. $GETBs, gpUTBs, etc.
o T'wo cylinders of disk storage space for object code.
o Five tracks of disk storage space in the source library for MLMP macro instructions.
a One track of disk storage space for error. logging. See index entry BSCA Terminat Log Area.
Programming Requirements A . M o d e l 1 0
. IBM System/3 Model 10 Disk System lVlanagement ( 5 7 0 2 - S C 1 ) .
. IBM System/3 Assembler (S702-ASl ) or its equivalent.
. IBM System/3 Model l0 Disk System Mlacros Feature (Feature Number 6020 or 6021).
o IBM System/3 Model l0 Disk System Overlay Linkage Editor (Feature Number 6026 or 60271 , unless MLMp programs are written as subroutine to an RpG ll program.
B . M o d e l 1 2
o I B M S y s t e m / 3 M o d e l 1 2 D i s k S y s t e m M i r n a g e m e n t (5705-SC1). This includes the System Macros and Over-l a y L i n k a g e E d i t o r .
o I B M System/3 A s s e m b l e r ( S 7 O 5 - A S 1 ) o r i t s e q u i v a l e n t . C . M o d e l '1 5
I B M S y s t e m / 3 M o d e l l5 D i s k S y s t e m M a n a g e m e n t (5704-SC1 or 5705-SC2). This includes the System Macros and Overlay Linkage Editor.
IBM System/3 Assembler (b704-AS1 or 5,704-AS2) or its equivalent.
MLMP Programming Considerations
o T h e u s e r m u s t d e f i n e o n e E X T R N in e v e r y M L M p p r o -gram: $$BSMS. Other required EXTRNT; are generated by the MLMP macro instructions when MLMp programs are assembled.
o M L M P Data Managerrrent { $ S B S M S ) , B S C D T F s , M L M p l/O areas, and user logical ltrffers must be in the root seg-ment. They must nor be overlaid. The Allocate, Rollout, and Tape End of Volume functions cannot be performad while BSCA files are open See IBM System/3 Overlay Linkage Editor Reference Manual. GC21-7561.
l f A U T O R S - Y i s s p e c i l i e d i n a $ D T F B m a c r o i n s t r u c t i o n ,
$$BSMD must be in the roor segmenf . lf pOLRES-y is s p e c i f i e d i n a $ D T F B m a c r o i n s t r u c r r o n , g g B S M A . $ $ B S M B , a n d $ $ B S M F m u s t b e in t h e r o o t ie g m e n t .
o Binary and packed decimal data rnust be transmitted in t r a n s p a r e n t m o d e {EBCDIC o n l y ) .
o A System/3 RPG ll program using the RpG ll Telecom-munications Feature nlust not call an assernbler subrou-tine to use a BSCA. (For information on rrvriting an assem-bf er subroutine for an RPG ll program, seet IBM System/3 Basic Assembler Reference Manual, SC2 7lt0g.)
T h e M L M P u s e r s h o u l d a l s o b e fa m i l i a r w i t h t h e u n i q u e B S C characteristics of the terminals to be used. Some BSC char.
acteristics are listed by machine in Appendix A. For more information regarding the terminals that can lr used with MLMP, see the publicaitons listed in the front of this manual.
R e q u i r e m e n t s a n d C o n s i d e r a t i o n s 59
I B M 2 9 7 2 B A N K T N G T E R M I N A L S Y S T E M
t flata received f r o m t h e 2 9 7 2 in c l u d e s t h e t e r m i n a l l D a n d k e y b o a r d s h i f t c h a r a c t e r s .
. D a t a trarrsmitted t o t h e 2 g 7 2 m u s t jn c l u d e k e y b o a r d slrift characters for upper case and lower case as well a : ; N L , H T , a n d o t h e r appropriate c o m m a n d s . o More than tlne record can be transrritted to the 2972
b e f o r e y o u h a v e t o t r a n s m i t a n e w li n e c o m m a n d , o lf you've been transmittirrg to one 2gg0, you must
trans-mit EOT before transtrans-mitting data to another 2gg0 (see index entry terminating transmlt filesl .
lFor more information regarcling the 2972, see Component De*ription: l8M 2g7Z lWodels g and itl General Banking lfe rrn i n a I S y ste m s, GL27 -3A2O "
I B M 3 2 7 0 IN F O R M A T I o N DISPLAY ISYSTEM lSefrcre writing an application program using a 3270, you rnust understand the 3270,s physical characteristics and capabilities as they are described in lBful 3270 lnformation Display System Component Dexription, GA27 _2749.
l \ f t e r r e a d i n g t h e 3 2 7 0 c o m p o n e n t d e s c r i p t i o n , u s e t h i s s e c t i o n a s a g u i d e t o c o d i n g M L M p m a c r o i n s t r u c t i o n s t o control and clefine l/O for a3270. Use the 3270
compo-|lent description to corrstruct data areas (called data stream) t ' . , s e n d t o a 3 2 7 O to d i s p l a y a n i m a g e o r p r i n t a l i n e . a n d t,o interpret data streams received from a 3270. Data strearn formats are shown in this sectiorr, but you must have rriad Lhe component description to understand the terms rn/ithin the formats.
Y o u m u s t a l s o u n d e r s t a n d b i n a r y s y n c h r o n o u s t e l e c o m m u n i -c,ations procedures as described in General lnformation:
Binary Synchronous Cornmunications, GA27_3004.
A, sarnple M LMP program that communicates with a 327O a i r p l i c a t i o n i s s h o w n i n A p p e n d i x B .