Change DLO Auditing Level (CHGDLOAUD)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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.
| Top |
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.
| Top |
System object name (SYSOBJNAM)
Specifies the system object name. This parameter is valid only when DLO(*SYSOBJNAM) is specified. Ten characters must be specified.
| Top |
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.
| Top |
Level of list (LEVEL)
Specifies whether documents and folders at nested levels in the specified folder are changed.
- *CURRENT
- Only the documents and folders at the current level are included in the change.
- *ALL
- The documents and folders at all levels are included in the change.
| Top |
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.
| Top |
Error messages
*ESCAPE Messages
- CPF22B0
- Not authorized to change the auditing value.
- CPF89AF
- Auditing level not changed for some document library objects.
- CPI905C
- &1 document library objects changed.
| Top |