SPI Common Extensions Manual

ZCMK Definitions
SPI Common Extensions Manual—427508-001
B-35
ZCMK Request Validation
ZCMK Request Validation
Subsystems based on the ZCMK definitions perform a common set of tests to validate
a request buffer and its contents. These tests fall into four basic categories:
SPI Buffer Validation
ZCMK-based subsystems perform these buffer tests on every request. If a test fails,
the indicated error and event messages are issued, and the request is rejected.
General Request Validation
After testing for a valid SPI buffer, and before a detailed examination of the request,
ZCMK-based subsystems scan the buffer’s contents, performing a variety of tests that
are independent of the specified command, object, or object type. If a test fails, the
indicated error and event messages are issued, and the request is rejected.
Category Page
SPI Buffer Validation
B-35
General Request Validation B-35
Token Occurrence and Value Tests B-36
Special Tests B-38
Test Result If Test Fails
Request buffer is at least 6 bytes long. Error: file-system error 2
Event: ZCMK-EVT-SPI-SHORT
First word of the request contains -28. Error: file-system error 2
Event: ZCMK-EVT-SPI-NOT-MSGCODE
Z-OCCURS value in buffer is consistent with the
size of the message.
Error: file-system error 2
Event: ZCMK-EVT-SPI-BAD-OCCURS
Sufficient storage is available to decode the
request and generate a response.
Error: file-system error 31
Retrieve ZSPI-TKN-HDRTYPE. Error: file-system error 2
Event: ZCMK-EVT-NO-HDR
Header type is ZSPI-VAL-CMDHDR. Error: file-system error 2
Event: ZCMK-EVT-SPI-NOT-CMD
The value in ZSPI-TKN-MAX-FIELD-VERSION
does not exceed the version of the server.
Error: ZCOM-ERR-VSN-INCOMP
The value in ZSPI-TKN-SSID matches that of the
subsystem, ignoring version.
Error: ZCOM-ERR-TKN-INV
The object type in the request header is either
ZCOM-OBJ-NULL or a subsystem-supported
object type.
Error: ZCOM-ERR-OBJ-NOT-SUPP