PRTPVTAUT (Print Private Authorities)

PRTPVTAUT Command syntax diagram

 

Purpose

The Print Private Authorities (PRTPVTAUT) command allows you to print a report of all the private authorities for objects of a specified type in a specified library, folder, or directory. The report lists all objects of the specified type and the users that are authorized to the object. This is a way to check for different sources of authority to objects.

This command prints three reports for the selected objects. The first report (Full Report) contains all of the private authorities for each of the selected objects.

The second report (Changed Report) contains additions and changes to the private authorities to the selected objects if the PRTPVTAUT command was previously run for the specified objects in the specified library, folder, or directory. Any new objects of the selected type, new authorities to existing objects, or changes to existing authorities to the existing objects are listed in the 'Changed Report'. If the PRTPVTAUT command was not previously run for the specified objects in the specified library, folder, or directory, there will be no 'Changed Report'. If the command has been previously run but no changes have been made to the authorities on the objects, then the 'Changed Report' is printed but there are no objects listed.

The third report (Deleted Report) contains any deletions of privately authorized users from the specified objects since the PRTPVTAUT command was previously run. Any objects that were deleted or any users that were removed as privately authorized users are listed in the 'Deleted Report'. If the PRTPVTAUT command was not previously run, there will be no 'Deleted Report'. If the command has been previously run but no delete operations have been done to the objects, then the 'Deleted Report' is printed but there are no objects listed.

Restriction: You must have *ALLOBJ special authority to use this command.

 

Required Parameters

OBJTYPE

Specifies the type of object to search for. For a complete list of object types, position the cursor on the field for the Object type prompt (OBJTYPE parameter), and press F4.

object-type: Specify the object type to be processed.

 

Optional Parameters

CHGRPTONLY

Specifies whether just the changed reports should be printed.

*NO: The full and changed reports are printed.

*YES: Only the changed report and deleted report are printed.

LIB

Specifies the name of the library to search for objects to be included in the private authority report.

library-name: Specify the name of the library to be searched.

This is a required parameter for all object types except *AUTL, *BLKSF, *CFGL, *CNNL, *COSD, *CTLD, *DEVD, *DIR, *DOC, *FLR, *LIB, *LIND, *MODD, *NWID, *NWSD, *OOPOOL, *SOCKET, *STMF, *SYMLNK, and *USRPRF.

AUTTYPE

Specifies whether object level authority, field level authority, or both object level and field level authority reports are generated. Field level authority information only applies to *FILE objects.

*OBJECT: Object level authority reports are generated for the specified objects.

*FIELD: For each data base file that has field level authorities, a field level authority report is generated.

This value is only valid if *FILE is specified for the Object type prompt (OBJTYPE parameter).

*ALL: For each data base file that has field level authorities, a field level authority report is generated. Also, the object level authority reports for all the files in the specified library are generated.

This value is only valid if *FILE is specified for the Object type prompt (OBJTYPE parameter).

FLR

Specifies the name of the folder to search for documents to be included in the private authority report.

This is a required parameter if *DOC is specified for the Object type prompt (OBJTYPE parameter).

folder-name: Specify the name of the folder to be searched.

AUTLOBJ

Specifies whether the Display Authorization List Objects (DSPAUTLOBJ) command will be run for each of the authorization lists on the system. DSPAUTLOBJ provides a list of all the objects that are secured by a specific authorization list. This parameter is only used if the object type is *AUTL. It is ignored for all other object types.

*NO: The DSPAUTLOBJ command will not be run for each of the authorization lists on the system.

*YES: The DSPAUTLOBJ command will be run for each of the authorization lists on the system. The output for the command will be sent to the same output queue as the authorization list report.

DIR

Specifies the name of the directory to search for objects to be included in the private authority report. Only local objects in the Root, QOpenSys, and User-Defined file systems are supported.

This is a required parameter if *BLKSF, *DIR, *OOPOOL, *SOCKET, *STMF, or *SYMLNK is specified for the OBJTYPE parameter.

'directory-name': Specify the name of the directory to be searched.

SCHSUBDIR

Specifies whether to search the subdirectories for objects to be included in the private authority report. This parameter is used only when the OBJTYPE parameter is *BLKSF, *OOPOOL, *SOCKET, *STMF, or *SYMLNK.

*NO: The subdirectories are not searched.

*YES: The subdirectories are searched.

Example for PRTPVTAUT

PRTPVTAUT   OBJTYPE(*FILE)  LIB(PAYROLLLIB)

This command creates the full, changed, and deleted reports for all file objects in the library PAYROLLLIB.

Error messages for PRTPVTAUT

*ESCAPE Messages

CPFB304

User does not have required special authorities.

CPFB307

Command &1 in use in another job.