GDSX Management Programming Manual

SPI Programming Considerations

GDSX Management Programming Manual—529930-001

3-2

Discontinuing a Command in Progress

When the GDS subsystem discontinues a command because of an error or warning, it

immediately sends a reply message to the application.

The GDS subsystem supports the use of the token ZSPI-TKN-ALLOW-TYPE, which

allows an application to specify, in a command operating on multiple objects, whether

or not GDSX should continue with the next object if it failed on the previous one. If no

value is specified for this token, GDSX will continue with the next object only if no

errors or warnings occurred with the previous one.

Receiving and Decoding the Response Buffer

The following programming considerations apply when an application receives and

decodes the response buffer for a GDSX response.

In responses to GDSX commands that operate on objects, a response record always

contains response information for the operation of the command on a single object.

The GDS subsystem supports multiple response records in a single reply message.

If multiple response records are to be returned in one reply message, the

recommended buffer size in bytes for the response is a predefined value with the

symbolic name ZGDS-VAL-MAXBUFLEN. If a single response record is to be returned

in each reply message, the recommended buffer size in bytes for the response is the

predefined value ZGDS-VAL-BUFLEN.

The GDS subsystem also supports the use of the token ZSPI-TKN-RESPONSE-TYPE,

which allows an application to specify, in a command operating on multiple objects,

which kinds of response records should be returned—one for every object, or only

those for objects on which errors or warnings occurred. If no value is specified for this

token, the GDS subsystem returns a response record for every object.

Note that for commands such as the INFO command, whose purpose is to return

information, using ZSPI-TKN-RESPONSE-TYPE to request the return of only those

response records for objects on which errors or warnings occurred can result in no

information being returned.

Handling Errors

The GDS subsystem passes through errors from other subsystems or interfaces.

Error-handling considerations for specific commands are described in Section 5,

Commands and Responses. The error numbers returned by the GDS subsystem are

described in Section 7, Error Numbers and Error Lists