File Utility Program (FUP) Management Programming Manual

ORSERV Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
5-13
Tokens in the Command Buffer
Tokens in the Command Buffer
ZORS-TKN-FILE
is a required token that specifies the target file or SQL object for the STATUS
command. Only one of these tokens is allowed per command.
The target file must be a single file or SQL object in the Guardian internal file-name
format. A file set or file-set list is not allowed.
ZSPI-TKN-MAXRESP
is the standard SPI token that specifies the number of responses that a subsystem
returns in the response buffer. Because ORSERV returns only one response per
buffer, ZSPI-TKN-MAXRESP can have these values:
ZSPI-TKN-RESPONSE-TYPE and ZSPI-TKN-ALLOW-TYP
are standard SPI response-control tokens. Although you can set these tokens, they
have no effect on the execution of the command.
ZSPI-TKN-COMMENT
is the standard SPI token that allows you to include an 80-byte arbitrary comment
in the command buffer. Although ORSERV ignores ZSPI-TKN-COMMENT in the
command buffer, the token can be useful when you are debugging an application.
Tokens in the Response Buffer
ZSPI-TKN-DATALIST
is the standard SPI token that begins a data list. Because ORSERV returns only
one response record per buffer, this response is enclosed in a data list if
ZSPI-TKN-MAXRESP has a value other than zero. The data list ends with
ZSPI-TKN-ENDLIST.
ZORS-TKN-FILE
specifies the target file that is the object of the STATUS command. This token is in
the NonStop Kernel internal file-name format and is returned with every response.
Zero ORSERV does not enclose the response in a data list.
Nonzero ORSERV encloses the response in a data list.