File Utility Program (FUP) Management Programming Manual

ORSERV Commands and Responses

File Utility Program (FUP) Management Programming Manual—523322-001

5-18

SUSPEND Command

ORSERV reads the ZZRELOAD file to determine the process ID of the ORSERV

process performing the reload operation, then stops it. ORSERV records the

timestamp when the process is stopped in the ZZRELOAD file.

An ORSERV process accepts only one SUSPEND command. After stopping the

process performing the reload operation (and returning the response buffer), ORSERV

stops itself.

Tokens in the Command Buffer

ZORS-TKN-FILE

is a required token that specifies the target file or SQL object for the SUSPEND

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:

Command

ZORS-CMD-SUSPEND

Object Type

ZORS-OBJ-FILE

Tokens in the Command Buffer

ZORS-TKN-FILE token-type ZSPI-TYP-FNAME

ZSPI-TKN-MAXRESP token-type ZSPI-TYP-INT.

ZSPI-TKN-RESPONSE-TYPE token-type ZSPI-TYP-ENUM.

ZSPI-TKN-ALLOW-TYPE token-type ZSPI-TYP-ENUM.

ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING.

Tokens in the Response Buffer

ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST.

ZORS-TKN-FILE token-type ZSPI-TYP-FNAME.

ZSPI-TKN-RETCODE token-type ZSPI-TYP-RETCODE.

ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.

...

ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.