Change DLO Auditing Level (CHGDLOAUD)

The Change Document Library Object Audit (CHGDLOAUD) command allows a user with audit (*AUDIT) special authority to change the auditing level of a document library object (DLO) or group of DLOs.

Notes:

Only the document library objects that exist when the command begins processing are changed. Objects created while the command is running might not be included in the change.
When changing objects in a folder (including the *ROOT level folder), the auditing level of the folder is changed first so any subsequent objects created into the folder inherit the containing folder's auditing level.
The *ROOT level folder is changed first when changing all objects on the system.
The default auditing level for newly created documents not contained in any folder is the value found in the QCRTOBJAUD system value. This system value should be changed to the desired auditing level prior to running the CHGDLOAUD command for documents not contained in any folder in order to ensure that all newly created documents not contained in any folder will inherit the proper auditing level.

Parameters

Keyword	Description	Choices	Notes
DLO	Document library object	Character value, SYSOBJNAM, ROOT, *ALL	Required, Positional 1
FLR	Folder	Character value, NONE, ANY, *ROOT	Optional, Positional 2
SYSOBJNAM	System object name	Name	Optional
AUDDLO	DLO auditing level	SAME, NONE, USRPRF, CHANGE, *ALL	Optional
LEVEL	Level of list	CURRENT, ALL	Optional

Top

Document library object (DLO)

Specifies the name of the document or folder whose auditing level is changed. If FLR(*ANY) is specified, then DLO(*ALL) must be specified.

*ALL: The auditing level for all DLOs in the specified folder is changed.
*ROOT: The auditing level for the *ROOT level folder is changed. The value specified on the AUDDLO parameter becomes the default auditing level for all new first-level folders.
If DLO(*ROOT) is specified, then FLR(*NONE) must be specified.
*SYSOBJNAM: The auditing level for the document or folder with the system object name specified on the SYSOBJNAM parameter is changed.
If DLO(*SYSOBJNAM) is specified, then FLR(*NONE) must be specified.
name: Specify the document library object for which the auditing level is changed.

Folder (FLR)

Specifies the folder containing the document library object whose auditing level is changed. If DLO(*ROOT or *SYSOBJNAM) is specified, then FLR(*NONE) must be specified.

*NONE: The documents that are not in a folder are changed.
*ANY: All document library objects are changed.
If FLR(*ANY) is specified, then DLO(*ALL) must be specified.
*ROOT: All first-level folders are changed. The *ROOT level folder is also changed.
name: Specify the name of the folder that contains the document library object whose auditing level is changed. The folder specified on the command is also changed if DLO(*ALL) is specified.

DLO auditing level (AUDDLO)

Specifies the auditing level for the document or folder changed.

*SAME: The level does not change.
*NONE: No read or change auditing occurs for the document or folder.
*USRPRF: The current user profile is used to determine whether an audit record is sent for this session.
*CHANGE: All change access to this DLO is logged.
*ALL: All change and read access to this DLO is logged.

Examples

Example 1: Changing an Auditing Level

CHGDLOAUD   DLO(MYDOC)  FLR(MYFLR)  AUDDLO(*ALL)

This command changes the auditing level of document MYDOC in folder MYFLR so all change or read access to this DLO is logged in the security journal.

Example 2: Changing a System Object Name Auditing Level

CHGDLOAUD   DLO(*SYSOBJNAM)  SYSOBJNAM(FMCM210974)
            AUDDLO(*ALL)

This command changes the auditing level of a document with the system object name FMCM210974 so all change or read access to this DLO is logged in the security journal.

Example 3: Changing the Auditing Level of All DLOs

CHGDLOAUD   DLO(*ALL)  FLR(*ANY)  AUDDLO(*ALL)

This command changes the auditing level of all the DLOs so all change or read access to the DLOs is logged in the security journal.