|
The first figure in this appendix (Table 1) describes all of the operands of the manipulative
macroinstructions (GENCB, MODCB, SHOWCB, and TESTCB) that do not involve
a particular control block field. The remaining figures deal exclusively
with the operands you use to select the control block field or fields
to be set, moved, or tested. These figures indicate which manipulative
macroinstructions apply for each operand and the types of values that
can be coded with each operand.
For example, suppose you are interested in
examining an ACB's OFLAGS field. Refer to Table 2 and
locate the OFLAGS entry. TESTCB (but not SHOWCB) can be used to examine
this field. The OFLAGS operand is coded in a fixed form, in this case,
OFLAGS=OPEN.
The “Notation Category” and “Example” columns
in Table 2 through Table 5 do
not apply to the SHOWCB macroinstruction whose control block field
name is always coded after the FIELDS keyword (for example, FIELDS=PASSWD).
In the following table an X in the macroinstruction's
column means that the operand applies to that macroinstruction.
Table 1. Manipulative macroinstruction
operands exclusive of control block operandsOperand keyword |
GENCB |
MODCB |
SHOWCB |
TESTCB |
Notation category |
Example |
---|
ACB |
|
X |
X |
X |
Address |
ACB=ACB1 |
AM |
X |
X |
X |
X |
Fixed value |
AM=VTAM |
AREA |
|
|
X |
|
Address |
AREA=WORKAREA |
BLK |
X |
|
|
|
Fixed value |
BLK=RPL |
COPIES |
X |
|
|
|
Quantity |
COPIES=7 |
ERET |
|
|
|
X |
Address |
ERET=ERRPGM |
EXLST |
|
X |
X |
X |
Address |
EXLST=EXLST1 |
FIELDS |
|
|
X |
|
Fixed value |
FIELDS=(ARG, ECB) |
LENGTH |
X |
|
X |
|
Quantity |
LENGTH=132 |
MF |
X |
X |
X |
X |
See Forms of the manipulative macroinstruction |
MF=(E,PARMLIST) |
NIB |
|
X |
X |
X |
Address |
NIB=NIB1 |
RPL |
|
X |
X |
X |
Address |
RPL=RPL1 |
WAREA |
X |
|
|
|
Address |
WAREA=WORKAREA |
Table 2. Manipulative macroinstruction
operands for ACB fieldsOperand keyword |
GENCB |
MODCB |
SHOWCB |
TESTCB |
Notation category |
Example |
---|
ACBLEN |
|
|
X |
X |
Quantity |
ACBLEN=(7) |
AM |
X |
X |
X |
X |
Fixed value |
AM=VTAM |
APPLID |
X |
X |
X |
X |
Address |
APPLID=AREA |
ERROR |
|
|
X |
X |
Quantity |
ERROR=13 |
EXLST |
X |
X |
X |
X |
Address |
EXLST=EXLST2 |
MACRF |
X |
X |
|
|
Fixed value |
MACRF=EXLST2 |
OFLAGS |
|
|
|
X |
Fixed value |
OFLAGS=OPEN |
PASSWD |
X |
X |
X |
X |
Address |
PASSWD=PASSWD1 |
Note: - An X in the macroinstruction's column means that the operand applies
to that macroinstruction.
- The ACB PARMS keyword is not supported by the manipulative macroinstructions.
However, a map can be generated using the DSECT-creating macroinstructions,
as described in Using DSECT-creating assembler instructions and macroinstructions.
|
In the following table an X in the macroinstruction's
column means that the operand applies to that macroinstruction.
Table 3. Manipulative macroinstruction
operands for EXLST fieldsOperand keyword |
GENCB |
MODCB |
SHOWCB |
TESTCB |
Notation category |
Example |
---|
DFASY |
X |
X |
X |
X |
Address |
DFASY=(3) |
EXLLEN |
|
|
X |
X |
Quantity |
EXLLEN=(3) |
LERAD |
X |
X |
X |
X |
Address |
LERAD=LERTN |
LOGON |
X |
X |
X |
X |
Address |
LOGON=LGNRTN |
LOSTERM |
X |
X |
X |
X |
Address |
LOSTERM=(6) |
NSEXIT |
X |
X |
X |
X |
Address |
NSEXIT=ERRORTN |
RELREQ |
X |
X |
X |
X |
Address |
RELREQ=(S,AREA1) |
RESP |
X |
X |
X |
X |
Address |
RESP=RESPEXIT |
SCIP |
X |
X |
X |
X |
Address |
SCIP=(*,SCIPADR) |
SYNAD |
X |
X |
X |
X |
Address |
SYNAD=(*,AREA2) |
TPEND |
X |
X |
X |
X |
Address |
TPEND=(S,4(7)) |
In the following table an X in the macroinstruction's
column means that the operand applies to that macroinstruction.
Table 4. Manipulative macroinstruction
operands for RPL fieldsOperand keyword |
GENCB |
MODCB |
SHOWCB |
TESTCB |
Notation category |
Example |
---|
AAREA |
X |
X |
X |
X |
Address |
AAREA=INAREA |
AAREALN |
X |
X |
X |
X |
Quantity |
AAREALN=100 |
ACB |
X |
X |
X |
X |
Address |
ACB=ACB1 |
AREA |
X |
X |
X |
X |
Address |
AREA=(*,FLWORD) |
AREALEN |
X |
X |
X |
X |
Quantity |
AREALEN=132 |
ARECLEN |
X |
X |
X |
X |
Quantity |
ARECLEN=(S,QUANT1) |
ARG |
X |
X |
X |
X |
Register- indirect value |
ARG=(7) |
BRACKET1 |
X |
X |
|
X |
Fixed value |
BRACKET=(BB,NEB) |
BRANCH |
X |
X |
|
X |
Fixed value |
BRANCH=YES |
CHAIN |
X |
X |
|
X |
Fixed value |
CHAIN=LAST |
CHNGDIR |
X |
X |
|
X |
Fixed value |
CHNGDIR=(CMD,NREQ) |
CODESEL |
X |
X |
|
X |
Fixed value |
CODESEL=STANDARD |
CONTROL |
X |
X |
|
X |
Fixed value |
CONTROL=QEC |
CRYPT |
X |
X |
|
X |
Fixed value |
CRYPT=YES |
ECB |
X |
X |
X |
X |
Address |
ECB=FULLWORD |
EXIT |
X |
X |
X |
X |
Address |
EXIT=EXITRTN |
FDBK |
|
|
X |
X |
Quantity |
FDBK=(4) |
FDBK2 |
|
|
X |
X |
Quantity |
FDBK2=128 |
IBSQAC |
X |
X |
|
X |
Fixed value |
IBSQAC=TESTPOS |
IBSQVAL |
X |
X |
X |
X |
Quantity |
IBSQVAL=0 |
IO |
|
|
|
X |
Fixed value |
IO=COMPLETE |
NIB |
X |
X |
X |
X |
Address |
NIB=NIB6 |
OBSQAC |
X |
X |
|
X |
Fixed value |
OBSQAC=INVALID |
OBSQVAL |
X |
X |
X |
X |
Quantity |
OBSQVAL=(4) |
OPTCD2 |
X |
X |
|
X |
Fixed value |
OPTCD=(SYN,SPEC) |
POST |
X |
X |
|
X |
Fixed value |
POST=SCHED |
RECLEN |
X |
X |
X |
X |
Quantity |
RECLEN=32 |
RESPOND |
X |
X |
|
X |
Fixed value |
RESPOND=(NEX,FME) |
REQ |
|
|
X |
X |
Quantity |
REQ=VAL23 |
RPLLEN |
|
|
X |
X |
Quantity |
RPLLEN=(7) |
RTNCD |
|
|
X |
X |
Quantity |
RTNCD=(*,X'00',X'03') |
RTYPE |
X |
X |
|
X |
Fixed value |
RTYPE=(NDFSYN, DFASY) |
SEQNO |
X |
X |
X |
X |
Quantity |
SEQNO=(10) |
SIGDATA |
X |
X |
X |
X |
Quantity |
SIGDATA=32767 |
SSENSEI |
|
|
|
X |
Fixed value |
SSENSEI=CPM |
SSENSEO |
X |
X |
|
X |
Fixed value |
SSENSEO=STATE |
SSENSMI |
|
|
X |
X |
Quantity |
SSENSMI=255 |
SSENSMO |
X |
X |
X |
X |
Quantity |
SSENSMO=(*,0(12)) |
STYPE |
X |
X |
|
|
Fixed value |
STYPE=REQ |
USENSEI |
|
|
X |
X |
Quantity |
USENSEI=4095 |
USENSEO |
X |
X |
X |
X |
Quantity |
USENSEO=(4) |
USER |
|
|
X |
X |
Quantity |
USER=1024 |
The RPL PARMS keyword is not supported by the
manipulative macroinstructions. However, a map can be generated for
all operands by using DSECT-creating macroinstructions, as described
in Using DSECT-creating assembler instructions and macroinstructions. Note: - CEB/NCEB are not valid BRACKET operands when using the manipulative
macroinstructions.
- The following OPTCD operands are not applicable when using manipulative
macroinstructions:
LMPEO or NLMPEO, SENSE or NSENSE, HOLD, BUFFLST or NBUFFLST,
SONCODE or NSONCODE, USERRH or NUSERRH, RSPQUED or
NRSPQUED, CONTCHN or NCONTCHN, UNBIND, QALL or QSESSLIM
or QNOTENAB, RESTORE, PERSIST or NPERSIST, PERSESS,
BACKUP or NBACKUP, NQN, GNAMEADD or GNAMEDEL,
SESSNAME, ENDAFFIN, KEEPSRB, NKEEPSRB
These notes refer to the following table. Notes: - PROC=NEGBIND|NNEGBIND is not valid when using the manipulative
macroinstructions. Use the DSECT-creating macroinstructions as an
alternative as described in Using DSECT-creating assembler instructions and macroinstructions.
- An X in the macroinstruction's column means that the operand applies
to that macroinstruction.
Table 5. Manipulative macroinstruction
operands for NIB fieldsOperand keyword |
GENCB |
MODCB |
SHOWCB |
TESTCB |
Notation category |
Example |
---|
BNDAREA |
X |
X |
X |
X |
Address |
BNDAREA=BNDADDR |
CID |
|
|
X |
X |
Register- indirect value |
CID=(7) |
CON |
|
|
|
X |
Fixed value |
CON=YES |
DEVCHAR |
|
|
X |
X |
Indirect value |
DEVCHAR=(*,0(5)) |
ENCR |
X |
X |
|
X |
Fixed value |
ENCR=SEL |
EXLST |
X |
X |
X |
X |
Address |
EXLST=(*,EXLSTADR) |
LISTEND |
X |
X |
|
X |
Fixed value |
LISTEND=NO |
LOGMODE |
X |
X |
X |
X |
Name |
LOGMODE=S3270 |
MODE |
X |
X |
X |
X |
Fixed value |
MODE=RECORD |
NAME |
X |
X |
X |
X |
Name |
NAME=NYCTERM |
NIBLEN |
|
|
X |
X |
Quantity |
NIBLEN=(8) |
PROC |
X |
X |
|
X |
Fixed value |
PROC=(RESPX,CS) |
RESPLIM |
X |
X |
X |
X |
Quantity |
RESPLIM=10 |
SDT |
X |
X |
|
X |
Fixed value |
SDT=SYSTEM |
USERFLD |
X |
X |
X |
X |
Quantity |
USERFLD=(9) |
A given operand can be coded in different ways,
but the number of valid combinations is small. The valid coding combinations
for each operand have been grouped under the heading “Notation Category”
in Table 1 through Table 5.
The rest of this appendix contains coding instructions for these notation
categories. Three of these categories, described in Address, Quantity,
and Fixed value encompass almost all of the
operands. A few operands fall into categories described in Name, Register-indirect value,
and Indirect value.
|