Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Commands
Safeguard Management Programming Manual—422086-028
7-202
NEXTFILE (SWITCH) Command
Operational Notes
ZCOM-TKN-OBJNAME
is optional for the NEXTFILE command. If present, this token must have the value
of the current audit pool.
Error-Handling Notes
ZSPI-TKN-RETCODE
is the standard SPI return code token, whose value is a number identifying
successful completion (ZCOM-ERR-OK), an informational warning, or an error.
These errors or warnings can occur in response to the NEXTFILE command:
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to
perform the NEXTFILE command. For the rules for who can manage the audit
service, see the Safeguard Reference Manual.
ZCOM-ERR-VSN-INCOMP
is returned when the version of the command is greater than the subsystem
version and the command contains unknown tokens. Or a field in a structured
token is greater than the subsystem version. The error list contains the
subsystem version.
ZCOM-ERR-FS-ERR
is returned when a file-system error occurs. The file-system error list describes
the file-system error, the file-system procedure, and the file in question.
ZSFG-ERR-AUDITPOOL-FULL
is returned when there are no available files in the audit pool. To make files
available, use the RELEASE command or increase MAXFILES.
ZSFG-ERR-AUDITPOOL-NOTCURRENT
is returned when the ZCOM-TKN-OBJNAME refers to an audit pool that is not
the current audit pool.
ZSFG-ERR-INTERNAL
is returned when an internal error occurs within the Safeguard software. This
error should never occur and is included here only for completeness.