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

Commands
Safeguard Management Programming Manual—422086-028
7-160
INFO AUDIT POOL Command
ZCOM-TKN-OBJNAME
is a string that designates an existing audit pool or set of audit pools as the subject
of this inquiry. For INFO AUDIT POOL, a missing or null string designates the
currently active audit pool.
Tokens in Response Buffer
See the token descriptions under the ADD AUDIT POOL (FILESET) Command on
page 7-25.
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 INFO AUDIT POOL
command:
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to
perform the INFO AUDIT POOL 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.
ZCOM-ERR-OBJ-NOT-FOUND
is returned if the specified audit pool ZCOM-TKN-OBJNAME does not exist.
ZSFG-ERR-INTERNAL
is returned when internal an error occurs within the Safeguard software. This
error should never occur and is included here only for completeness.