File Utility Program (FUP) Management Programming Manual

FUP Commands and Responses
File Utility Program (FUP) Management Programming Manual—523322-001
3-35
LOADALTFILE Command
ZSPI-TKN-COMMENT
is the standard SPI token that allows you to include an 80-byte arbitrary comment
in the command buffer. Although FUP 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. The data list ends with
ZSPI-TKN-ENDLIST.
ZFUP-TKN-FILE
is the name of the primary file from which the LOADALTFILE command reads
records. The file name is in the Guardian internal file-name format. This token is
returned with every response.
ZFUP-MAP-LOADALT-XFER-CNTS
is a structured token that specifies the transfer counts for the LOADALTFILE
command. The fields are:
ZNAME
specifies the name of the file or partition loaded.
ZCOUNT
specifies the number of records loaded into the file or partition identified by
ZNAME.
ZFUP-TKN-READ-COUNT
specifies the number of primary records read.
ZSPI-TKN-RETCODE
is the standard SPI return token returned in the response buffer by all Compaq
subsystems. ZSPI-TKN-RETCODE contains zero if the command was successful,
or an error number if an error occurred.
Table 3-5, Errors Returned by RESTART, on page 3-40 shows the ZSPI-TKN-
RETCODE values specific to the LOADALTFILE command.
Note. Table 2-7, Errors Returned by All FUP Commands, on page 2-28 shows the ZSPI-TKN-
RETCODE values common to all FUP commands.