Change an object's authority collection value

When authority collection for objects is active, an object’s authority collection value determines whether authority information is collected for the object.

The Change Authority Collection (CHGAUTCOL) command is used to change an object's authority collection value.

The authority collection value (AUTCOLVAL) parameter on the CHGAUTCOL command specifies whether to collect authority information for the object. A value of *NONE indicates that authority information is not collected for the object. A value of *OBJINF indicates that the authority checking information is collected for each unique instance of the object level information that is associated with the authority check. Specifying this value results in the collection of object level unique authority checks regardless of the job that accesses the object and regardless of the unique code paths within the job. For examples, see the Change Authority Collection (CHGAUTCOL) command.

If you are changing the authority collection value for a directory or a library, the CHGAUTCOL command provides a subtree (SUBTREE) parameter to indicate whether to also change the authority collection value for the objects in the directory or library.

If you are changing the authority collection value for a physical file, the CHGAUTCOL command provides a parameter to include dependent objects (INCDEPOBJ). This parameter indicates whether to also change the authority collection value for the logical files dependent on the data in the physical file.

If you are changing the authority collection value for a symbolic link, the CHGAUTCOL command provides a symbolic link (SYMLNK) parameter to indicate whether to change the symbolic link or the object pointed to by the symbolic link. If a symbolic link object is encountered, either specified in the Object (OBJ) parameter or encountered in the processing of a subtree, the value that is specified for the SYMLNK parameter is applied to that symbolic link object. If processing a subtree, the processing of that branch of the subtree then stops because a symbolic link object itself cannot have subtrees.