ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/prtpubaut.htm

416 lines
19 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Print Publicly Auth Objects (PRTPUBAUT)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="PRTPUBAUT.Top_Of_Page"></a>
<h2>Print Publicly Auth Objects (PRTPUBAUT)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#PRTPUBAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTPUBAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTPUBAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTPUBAUT"></a>
<p>The Print Publicly Authorized Objects (PRTPUBAUT) command allows you to print a report of the specified objects that do not have public authority of *EXCLUDE. For *PGM objects, only the programs that do not have public authority of *EXCLUDE that a user can call (the program is either user domain or the system security level (QSECURITY system value) is 30 or below) will be included in the report. This is a way to check for objects that every user on the system is authorized to access.
</p>
<p>This command will print two reports. The first report (Full Report) will contain all of the specified objects that do not have public authority of *EXCLUDE. The second report (Changed Report) will contain the objects that <b>now</b> do not have public authority of *EXCLUDE that did have public authority of *EXCLUDE or did not exist when the PRTPUBAUT command was previously run. If the PRTPUBAUT command was not previously run for the specified objects and library or folder, there will be no 'Changed Report'. If the command has been previously run, but no additional objects do not have public authority of *EXCLUDE, then the 'Changed Report' will be printed but there will be no objects listed.
</p>
<p>The reports will contain the following information:
</p>
<ul>
<li>The object type specified on the command (if object type is not *DOC or *FLR).
</li>
<li>The name of the library specified on the command (if object type is not *BLKSF, *DIR, *DOC, *FLR, *SOCKET, *STMF, or *SYMLNK).
</li>
<li>The name of the folder the documents are in (if object type is *DOC).
</li>
<li>The name of the directory objects are in (if object type is *BLKSF, *DIR, *SOCKET, *STMF, or *SYMLNK).
</li>
<li>The date and time the report was last run (only shown on the Changed Report).
</li>
<li>An entry for each object that does not have *PUBLIC authority of *EXCLUDE. Each entry contains the following information:
<ul>
<li>The name of the library the object is in (if object type is not *BLKSF, *DIR, *DOC, *FLR, *SOCKET, *STMF, or *SYMLNK).
</li>
<li>The name of the folder the folder is in (if object type is *FLR).
</li>
<li>The name of the object.
</li>
<li>The owner of the object.
</li>
<li>The authorization list securing the object.
</li>
<li>The special value for the *PUBLIC authority (e.g. *ALL or *CHANGE).
</li>
<li>The sensitivity level of the document or folder (if object type is *DOC or *FLR).
</li>
<li>An indicator for the individual authorities that *PUBLIC has to the program ('X' or ' ') (if object type is not *DOC or *FLR).
</li>
</ul>
</li>
</ul>
<p>The file QPBXXXXXXX (where 'XXXXXXX' is the object type specified on the command) in library QUSRSYS contains information from the last time the PRTPUBAUT command was run. If object type is not *BLKSF, *DIR, *DOC, *FLR, *SOCKET, *STMF, or *SYMLNK 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. For object types that don't require a library to be specified (e.g. *USRPRF), the library name is QSYS. System file QAOBJAUT in library QSYS with format name of QSYDSAUT is the model file for the file.
</p>
<p>If the object type is *FLR, the first member will contain the information from the previous time *FLR was specified on the command. System file QASECDLO in library QSYS with format name of QSECDLO is the model file for the file.
</p>
<p>If the object type is *DOC, there is a member within the file for each folder that has been previously specified on the command. The member name will be the same as the system name of the folder. System file QASECDLO in library QSYS with format name of QSECDLO is the model file for the file.
</p>
<p>If the object type is *BLKSF, *DIR, *SOCKET, *STMF, or *SYMLNK, there is a member within the file for each directory that has previously been specified in the <b>Directory (DIR)</b> parameter. The member names are based on the order the directories are processed. The member naming convention is x000000001, x000000002, and so on. The first character in the member name will either be N or Y. This character indicates if the subdirectories were searched when the data was gathered. N indicates the subdirectories were not searched, Y indicates they were searched. Once a member name has been assigned to a directory, the numeric portion with the appropriate prefix is used for all of the object types listed above. The system file QASECDIR in library QSYS with format name of QSECDIR is the model file for the file.
</p>
<p>
<b>Note: </b>The file QASECGFIPB in library QUSRSYS contains the file ID values of every directory that has been processed and the Nxxxxxxxxx member name that has been assigned to it. The system file QASECGFI in library QSYS with format name of QSECGFI is the model file for QASECGFIPB.
</p>
<p><b>Restriction:</b> You must have all object (*ALLOBJ) or audit (*AUDIT) special authority to run this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTPUBAUT.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top">*ALRTBL, *AUTL, *BLKSF, *BNDDIR, *CFGL, *CHRSF, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DIR, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FIFO, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *M36, *M36CFG, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SOCKET, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *STMF, *SVRSTG, *SYMLNK, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.CHGRPTONLY"><b>CHGRPTONLY</b></a></td>
<td valign="top">Changed report only</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Name</i>, *LIBL, *USRLIBL, *CURLIB, *ALL, *ALLUSR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.FILAUT"><b>FILAUT</b></a></td>
<td valign="top">Print file authority</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.CMDAUT"><b>CMDAUT</b></a></td>
<td valign="top">Print command authority</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.PGMAUT"><b>PGMAUT</b></a></td>
<td valign="top">Print program authority</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.JOBDAUT"><b>JOBDAUT</b></a></td>
<td valign="top">Print JOBD authority</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.DIR"><b>DIR</b></a></td>
<td valign="top">Directory</td>
<td valign="top"><i>Path name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#PRTPUBAUT.SCHSUBDIR"><b>SCHSUBDIR</b></a></td>
<td valign="top">Search subdirectory</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTPUBAUT.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>This is a required parameter.
</p>
<p>The type of object to search for. For a complete list of object types, press the F4 key when prompting this parameter.
</p>
<dl>
<dt><b><i>object-type</i></b></dt>
<dd>The type of object to be processed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.CHGRPTONLY"></a>
<h3>Changed report only (CHGRPTONLY)</h3>
<p>Specifies whether just the changed report should be printed.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The full and changed reports will be printed.
</dd>
<dt><b>*YES</b></dt>
<dd>Only the changed report will be printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.LIB"></a>
<h3>Library (LIB)</h3>
<p>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, *SOCKET, *STMF, *SYMLNK, and *USRPRF.
</p>
<p>The name of the library to search for objects with public authority that is not *EXCLUDE.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>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 <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
</dd>
</dl>
<dl>
<dt><b>*USRLIBL</b></dt>
<dd>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 <b>ASP device (ASPDEV)</b> parameter is specified when this value is used, ASPDEV(*) is the only valid value.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>All the libraries in the auxiliary storage pools (ASPs) specified for the <b>ASP device (ASPDEV)</b> parameter are searched.
</dd>
</dl>
<dl>
<dt><b>*ALLUSR</b></dt>
<dd>All user libraries in the auxiliary storage pools (ASPs) defined by the <b>ASP device (ASPDEV)</b> parameter are searched.
<p>User libraries are all libraries with names that do not begin with the letter Q except for the following:
</p>
<p>
<pre>
#CGULIB #DSULIB #SEULIB
#COBLIB #RPGLIB
#DFULIB #SDALIB
</pre>
</p>
<p>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:
</p>
<p>
<pre>
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
QGPL QSRVAGT QUSRINFSKR
QGPL38 QSYS2 QUSRNOTES
QMGTC QSYS2xxxxx QUSROND
QMGTC2 QS36F QUSRPOSGS
QMPGDATA QUSER38 QUSRPOSSA
QMQMDATA QUSRADSM QUSRPYMSVR
QMQMPROC QUSRBRM QUSRRDARS
QPFRDATA QUSRDIRCL QUSRSYS
QRCL QUSRDIRDB QUSRVI
</pre>
</p>
<ol>
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
</li>
<li>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.
</li>
</ol>
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.FILAUT"></a>
<h3>Print file authority (FILAUT)</h3>
<p>Specifies whether the Print Publicly Authorized Objects (PRTPUBAUT) command will be run for *FILE objects for each of the libraries that do not have public authority of *EXCLUDE, when *LIB is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is only used when OBJTYPE is *LIB.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The PRTPUBAUT command will not be run for *FILE objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
<dt><b>*YES</b></dt>
<dd>The PRTPUBAUT command will be run for *FILE objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.CMDAUT"></a>
<h3>Print command authority (CMDAUT)</h3>
<p>Specifies whether the Print Publicly Authorized Objects (PRTPUBAUT) command will be run for *CMD objects for each of the libraries that do not have public authority of *EXCLUDE, when *LIB is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is only used when OBJTYPE is *LIB.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The PRTPUBAUT command will not be run for *CMD objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
<dt><b>*YES</b></dt>
<dd>The PRTPUBAUT command will be run for *CMD objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.PGMAUT"></a>
<h3>Print program authority (PGMAUT)</h3>
<p>Specifies whether the Print Publicly Authorized Objects (PRTPUBAUT) command will be run for *PGM objects for each of the libraries that do not have public authority of *EXCLUDE, when *LIB is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
<p>
<b>Note: </b>This parameter is only used when OBJTYPE is *LIB.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The PRTPUBAUT command will not be run for *PGM objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
<dt><b>*YES</b></dt>
<dd>The PRTPUBAUT command will be run for *PGM objects for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.JOBDAUT"></a>
<h3>Print JOBD authority (JOBDAUT)</h3>
<p>Specifies whether the Print Job Description Authority (PRTJOBDAUT) command will be run for each of the libraries that does not have public authority of *EXCLUDE, when *LIB is specified for the <b>Object type (OBJTYPE)</b> parameter. The PRTJOBDAUT command will list all of the job descriptions in the library that do not have public authority of *EXCLUDE and have a user name specified.
</p>
<p>
<b>Note: </b>This parameter is only used when OBJTYPE is *LIB.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The PRTJOBDAUT command will not be run for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
<dt><b>*YES</b></dt>
<dd>The PRTJOBDAUT command will be run for each of the libraries that does not have public authority of *EXCLUDE.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.FLR"></a>
<h3>Folder (FLR)</h3>
<p>This is a required parameter if *DOC is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
<p>The name of the folder to search for documents with *PUBLIC authority that is not *EXCLUDE.
</p>
<dl>
<dt><b><i>folder-name</i></b></dt>
<dd>The name of the folder to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.DIR"></a>
<h3>Directory (DIR)</h3>
<p>This is a required parameter if *BLKSF, *DIR, *SOCKET, *STMF, or *SYMLNK is specified for the <b>Object type (OBJTYPE)</b> parameter.
</p>
<p>The pathname of the directory to search for objects that do not have public authority of *EXCLUDE. Only local objects in the Root, QOpenSys, and User-Defined file systems are supported.
</p>
<dl>
<dt><b><i>directory-name</i></b></dt>
<dd>The name of the directory to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTPUBAUT.SCHSUBDIR"></a>
<h3>Search subdirectory (SCHSUBDIR)</h3>
<p>Specifies whether to search the subdirectories for objects to be included in the public authority report.
</p>
<p>
<b>Note: </b>This parameter is only used when OBJTYPE is *BLKSF, *DIR, *SOCKET, *STMF, or *SYMLNK.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The subdirectories are not searched.
</dd>
<dt><b>*YES</b></dt>
<dd>The subdirectories are searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTPUBAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
PRTPUBAUT OBJTYPE(*FILE) LIB(QSYS)
</pre>
</p>
<p>This command prints both full and changed reports for the file objects in the library QSYS.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTPUBAUT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPFB304</b></dt>
<dd>User does not have required special authorities.
</dd>
<dt><b>CPFB307</b></dt>
<dd>Command &amp;1 in use in another job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTPUBAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>