Print Queue Authority (PRTQAUT)

The Print Queue Authority (PRTQAUT) command allows you to print a report of the output queue and job queue authority information for the objects in the specified library. This command provides a way to check the authority attributes of the output queue and job queue objects on the system.

This command will print two reports for a library. The first report (Full Report) will contain all of the output queues and job queues in the specified library. The second report (Changed Report) will contain the output queues and job queues that have been created or had the authority attributes changed since the PRTQAUT command was last run for the library. If the PRTQAUT command was not previously run for the library, there will be no 'Changed Report'. If the command has been previously run for the library but no additional queue information is available then the 'Changed Report' will be printed but there will be no queues listed.

The reports will contain the following information:

• The name of the library that was specified on the command.
• The date and time the report was last run (only shown on the Changed Report).
• An entry for each output queue and job queue that exists on the system. Each entry contains the following information:
  • The name of the library the queue is in.
  • The name of the queue.
  • The object type of the queue.
  • The owner of the queue.
  • The public authority of the queue.
  • The display data value of the output queue. For job queue objects this field will be set to *NONE.
  • The operator control value of the queue.
  • The authority to check value of the queue.

The file QSECQOLD in library QUSRSYS contains information from the last time the PRTQAUT command was run for a library. There is a member within the file, with the same name as the library, for each library that has been previously specified on the command. If a special value is specified for the library name (for example, *USRLIBL), then the '*' will be replaced with a 'Q' in the member name. System file QASECQF in library QSYS with format name of QSECQF is the model file for the QSECQOLD file.

Restriction: You must have all object (*ALLOBJ) or audit (*AUDIT) special authority to run this command.

Parameters

Library (LIB)

This is a required parameter.

The name of the library to search for output queue and job queue objects to report.

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched. If the ASP device (ASPDEV) parameter is specified when this value is used, ASPDEV(*) is the only valid value.

*USRLIBL

If a current library entry exists in the library list for the current thread, the current library and the libraries in the user portion of the library list are searched. If there is no current library entry, only the libraries in the user portion of the library list are searched. If the ASP device (ASPDEV) parameter is specified when this value is used, ASPDEV(*) is the only valid value.

*ALL

All the libraries in the auxiliary storage pools (ASPs) specified for the ASP device (ASPDEV) parameter are searched.

*ALLUSR

All user libraries in the auxiliary storage pools (ASPs) defined by the ASP device (ASPDEV) parameter are searched.

User libraries are all libraries with names that do not begin with the letter Q except for the following:

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Although the following libraries with names that begin with the letter Q are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are also considered user libraries:

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR
QMGTC       QSYS2xxxxx  QUSRNOTES
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' is the number of a primary auxiliary storage pool (ASP).
2. A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.

name

Specify the name of the library to be searched.

Changed report only (CHGRPTONLY)

Specifies whether just the changed report should be printed.

*NO

The full and changed reports will be printed.

*YES

Only the changed report will be printed.

Examples

PRTQAUT   LIB(QUSRSYS)

This command prints both full and changed reports for the output queues and job queues in the library QUSRSYS.

Error messages

*ESCAPE Messages

CPFB307

Command &1 in use in another job.