SPI Common Extensions Manual

ZCMK Definitions
SPI Common Extensions Manual—427508-001
B-38
Special Tests
Special Tests
ZCMK-based subsystems perform three additional specialized tests on every request:
1. If the command is ZCOM-CMD-LISTOBJECTS, the object type is ZCOM-OBJ-
NULL, and ZCOM-TKN-SUB is in the request, the value of ZCOM-TKN-SUB must
be ZCOM-VAL-SUB-NONE. If this test fails, ZCOM-ERR-TKN-VAL-INV is issued.
2. The second test is expressed in the algorithm:
IF the opener is the super ID
and ZCOM-MAP-REQID is present in the buffer
THEN allow for the presence of ZCOM-MAP-REQID.
ELSE IF the opener is the super ID
and ZCOM-TKN-REQID-PAID is present
THEN allow for the presence of ZCOM-TKN-REQID-PAID
and require the presence of
ZCOM-TKN-REQID-PHANDLE
ZCOM-TKN-REQID-PPROGXFILE
ZCOM-TKN-REQID-PSTRING
generating ZCOM-ERR-TKN-REQ if any is missing
Any REQID token appearing in a request from other than the super ID is marked
as extraneous, resulting in ZCOM-ERR-TKN-CODE-INV.
3. Verify that no extraneous tokens are in the request, after allowing for the presence
of these additional tokens:
ZSPI-TKN-MANAGER
ZSPI-TKN-COMMENT
ZSPI-TKN-ALLOW-TYPE
ZSPI-TKN-RESPONSE-TYPE
ZCOM-TKN-XMGR
ZCOM-TKN-OBJNAME
ZCOM-TKN-CMD-TIMEOUT
ZCOM-TKN-SUB
The presence of an extraneous token results in ZCOM-ERR-TKN-CODE-INV.
ZCOM-TKN-XMGR None.
ZSPI-TKN-ALLOW-SEGMENTS Value is 1, 0, or blanks.
ZSPI-TKN-ALLOW-TYPE Value is 1, 3, or 7.
ZSPI-TKN-COMMENT None.
ZSPI-TKN-CONTEXT None.
ZSPI-TKN-MANAGER None.
ZSPI-TKN-RESPONSE-TYPE Value is 6 or 7.
Token Test