SPI Programming Manual (G06.24+, H06.03+, J06.03+)

Errors
SPI Programming Manual—427506-006
A-4
–2: ZSPI-ERR-ILLPARM
•
The length of the used portion of the buffer (ZSPI-TKN-USEDLEN) is greater than
the maximum buffer length (Z-BUFLEN). SSPUT might have been called with
ZSPI-TKN-RESET-BUFFER and a
maxlen value that was smaller than ZSPI-
TKN-USEDLEN.
•
The buffer contains ZSPI-TKN-ENDLIST but no corresponding list token.
•
The position descriptor within the buffer (ZSPI-TKN-POSITION) indicates a current
list that does not begin with a list token. Perhaps an incorrect position descriptor—
for instance, one saved from another buffer—was restored to ZSPI-TKN-
POSITION.
Effect. The requested operation is not completed. Because the buffer format is invalid,
the last error is not saved.
Recovery. Check for an incorrect buffer parameter or a corrupted buffer; or if this
error was returned from a call to SSGET with ZSPI-TKN-RESET-BUFFER, check for a
short read and allocate a larger buffer.
–2: ZSPI-ERR-ILLPARM
Cause. An invalid parameter was supplied in the procedure call. Possibilities include:
•
SSINIT was called with an invalid header type.
•
A negative index or count parameter was supplied.
•
An attempt was made to use SSPUT or SSGET on a token using a count of zero.
•
A call was made to one of the special operations that return attributes of a token,
but the operation was applied to the special token itself. The special tokens that
return attributes are ZSPI-TKN-COUNT, ZSPI-TKN-LEN, ZSPI-TKN-OFFSET, and
ZSPI-TKN-ADDR.
•
The program supplied an SPI-defined token code that was invalid for this
procedure call. For example, ZSPI-TKN-DELETE was specified in a call to SSGET,
or ZSPI-TKN-COMMAND was specified in a call to SSPUT.
•
An invalid position descriptor was supplied with ZSPI-TKN-POSITION.
Effect. ZSPI-TKN-LASTERR is set to ZSPI-ERR-ILLPARM and the requested
operation is not completed.
Recovery. Correct the parameter in error.
–3: ZSPI-ERR-MISPARM
Cause. This error number indicates that a required parameter was not supplied.
Certain parameters are required only under certain circumstances:
•
The ssid parameter is required when calling SSGET with ZSPI-TKN-NEXTCODE
or ZSPI-TKN-NEXTTOKEN if the next token code in the buffer is not qualified by
the default subsystem ID. Always supply a variable for
ssid when calling SSGET