2.13 AUDSERVPARAM

Valid for

Extract

Description

Use AUDSERVPARAM to pass parameters that are specific to the Audserv process.

Note:

AUDSERVPARAM GETPURGEDATAS and IGNOREPURGEDATAS options are deprecated. Extract will instruct Audserv to return purge data operations if any file or wildcard in its parameter file has GETFILEOPS or GETPURGEDATAS.

Default

ABENDONSECURITYCHECK, IGNORENONDATACHANGES, IGNOREALTFILES, SQLCATCLOSEDELAY 60

Syntax

AUDSERVPARAM 
[ABENDONSECURITYCHECK | NOABENDONSECURITYCHECK]
[ARLIBERROR error_number, response]
[ARERRORREPORTINTERVAL seconds]
[GETNONDATACHANGES | IGNORENONDATACHANGES]
[GETALTFILES | IGNOREALTFILES]
[EXCLUDEFILECODES (file_code [, ...])
[SQLCATCLOSEDELAY seconds]

ABENDONSECURITYCHECK | NOABENDONSECURITYCHECK

With ABENDONSECURITYCHECK Audserv will log a message and then abend when the security check omits a file. NOABENDONSECURITYCHECK triggers Audserv to log a message, but not abend. The default is ABENDONSECURITYCHECK.

ARLIBERROR error_number, response

Specifies the action to take when the error number is triggered. Valid response are:

IGNORE: Continue processing and do not issue a message.
WARN: Issue a warning message and continue processing.
ABEND: Issue an error message and end processing.

ARERRORREPORTINTERVAL

Specifies the number of seconds to wait before the reissue of a warning message.

GETNONDATACHANGES | IGNORENONDATACHANGES

Filters records for SQL partition moves and splits. The default is IGNORENONDATACHANGES. NOGETNONDATACHANGES is a synonym for IGNORENONDATACHANGES.

When using NOGETNONDATACHANGES, you cannot extract any data changes produced by the RDF subsystem.

GETALTFILES | IGNOREALTFILES

By default Audserv excludes Enscribe alternate keys. This means, when a file is added to Audserv's "include" list, it will search for any alternate keys and automatically exclude them.

If you are using wildcards in your files to denote alternate keys, you may wish to override this feature. There are two ways to override the default programming. If you wish to include alternate keys for specific files, you may specify the following syntax in your parameter file:

FILE $VOL.SUBVOL.PRIMARY;
FILE $VOL.SUBVOL.ALTFILE0;
FILE $VOL.SUBVOL.ALTFILE1;

where ALTFILE0 and ALTFILE1 represent alternate keys in the PRIMARY file.

If you wish to replicate all alternate keys, you can use the GETALTFILES option in your Extract parameter file as follows:

AUDSERVPARAM GETALTFILES

The default setting for this option is IGNOREGETALTFILES.

EXCLUDEFILECODES (file_code)

The numeric file code of a type of file whose audit is to be excluded.

SQL/MX and SQL/MP catalog files (file codes 563, 564, 565, 572, and 585) are automatically excluded and do not need to be listed.

SQLCATCLOSEDELAY seconds

Sets the time delay after which the SQL/MP catalog tables that have not been accessed are closed. The value must be between 10 and 3600 seconds.

The default is to close the catalog tables when they have not been accessed for 60 seconds.