Safeguard Management Programming Manual (G06.24+, H06.03+)

Commands

Safeguard Management Programming Manual—422086-012

7-26

ADD AUDIT POOL (FILESET) Command

ZSFG-TKN-SECONDARYEXTENT

is an optional token that specifies the secondary extent size, in 2048-byte pages,

of the audit files that will be created in this audit pool.

ZSFG-TKN-MAXEXTENTS

is an optional token that specifies the maximum number of file extents that each

audit file in this audit pool is to contain.

ZSFG-TKN-MAXFILES

is an optional token that specifies the maximum number of audit files that can

reside in the audit pool being added.

ZSFG-TKN-LIKE-OBJNAME

is a optional token that names an existing audit pool from which the attribute

values of the added audit pool are to be copied. If this token is present in the

command buffer, any explicit specification of these attributes by other tokens in the

buffer is applied after the LIKE attribute values.

Tokens in Response Buffer

For a description of the tokens present in the response buffer for the ADD AUDIT

POOL command, see Section 6, Common Definitions.

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 ADD AUDIT POOL

command:

ZCOM-ERR-SECUR-VIOL

is returned if the requestor's process access ID does not have authority to

perform the ADD AUDIT POOL command. For the rules for who can manage

audit pool security, 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.