Summary of operand specifications

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 operands
Operand 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 fields
Operand 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:
  1. An X in the macroinstruction's column means that the operand applies to that macroinstruction.
  2. 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 fields
Operand 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 fields
Operand 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:
  1. CEB/NCEB are not valid BRACKET operands when using the manipulative macroinstructions.
  2. 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:
  1. 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.
  2. An X in the macroinstruction's column means that the operand applies to that macroinstruction.
Table 5. Manipulative macroinstruction operands for NIB fields
Operand 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.