TESTCB—Test a field of a request parameter list

The format of the TESTCB macro to test fields in a request parameter list is:

[label]

TESTCB

RPL=address
[,ERET=address]
,{AIXFLAG=AIXPKP|
AIXPC=abs expression|
FTNCD=abs expression|
IO=COMPLETE|
OPTCD=([ADR][,ARD][,ASY][,BWD]
[,CNV] [,DIR][,FKS][,FWD]
[,GEN][,KEQ][,KEY][,KGE][,LOC]
[,LRD][,MVE][,NSP][,NUP][,SEQ]
[,SKP][,SYN][,UPD])|
ACB=address|
AREA=address|
AREALEN=abs expression|
ARG=address|
ECB=address|
FDBK=abs expression|
KEYLEN=abs expression|
MSGAREA=address|
MSGLEN=abs expression|
NXTRPL=address|
RBA=abs expression|
RECLEN=abs expression|
RPLLEN=abs expression|
TRANSID=abs expression}

The subparameters of the TESTCB macro can be expressed as absolute numeric expressions, as character strings, as codes, as expressions that generate valid relocatable A-type address constants, in register notation, as S-type address constants, and as indirect S-type address constants. Subparameters with GENCB, MODCB, SHOWCB, and TESTCB, further defines these operand expressions.

label: specifies 1 to 8 characters that provide a symbolic address for the TESTCB macro.
RPL=address: specifies the address of the request parameter list whose information you want to test. You may omit it only if you are testing the length of a request parameter list (RPLLEN=number). (All request parameter lists have the same length.)
ERET=address: specifies the address of a routine to which VSAM gives control if an error occurs and VSAM is unable to test for the specified condition. For example, testing AVSPAC in an access method control block for an unopened data set would fail. VSAM indicates in register 15 whether it could do the test and, if not, indicates in register 0 the reason it could not. (The reasons are discussed under Control block manipulation macro return and reason codes.) A failure trying to execute TESTCB indicates a basic logical problem in the processing program, so the error routine would probably issue an abend. If it lets the program continue, it must branch to the continuation point itself, and not return to VSAM.
AIXFLAG=AIXPKP: specifies that prime-key pointers are used rather than RBAs.
AIXPC=abs expression: specifies the pointer count.
FTNCD=abs expression: specifies whether the upgrade set is correct or may have been modified by a request. These codes are described under Component codes (RPLCMPON).
IO=COMPLETE: specifies that a test is made to determine whether an asynchronous request has been completed. (When you issue a CHECK macro, you suspend processing until a request has been completed.)
OPTCD=([,ADR][,ARD][,ASY][,BWD] [,CNV]
[,DIR][,FKS][,FWD][,GEN][,KEQ]
[,KEY][,KGE][,LOC][,LRD][,MVE]
[,NSP][,NUP][,SEQ]
[,SKP][,SYN][,UPD]: specifies that a test is to be made to determine what subparameter or combination of subparameters is being used for the request. See Table 1 for a description of these subparameters.