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

219 lines
9.2 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 JOBD Authority (PRTJOBDAUT)</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="PRTJOBDAUT.Top_Of_Page"></a>
<h2>Print JOBD Authority (PRTJOBDAUT)</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="#PRTJOBDAUT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#PRTJOBDAUT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#PRTJOBDAUT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="PRTJOBDAUT"></a>
<p>The Print Job Description Authority (PRTJOBDAUT) command allows you to print a report of the job descriptions in a library that do not have public authority of *EXCLUDE, and a user name is specified in the job description. This is a way to check for job descriptions that every user on the system is authorized to use that allow the user to run as another user profile.
</p>
<p>This command will print two reports for a library. The first report (Full Report) will contain all of the job descriptions that do not have public authority of *EXCLUDE and have a user name specified. The second report (Changed Report) will contain the job descriptions that <b>now</b> do not have public authority of *EXCLUDE or have a user name specified that either did have public authority of *EXCLUDE, did not have a user name specified, or did not exist when the PRTJOBDAUT command was previously run for the library. If the PRTJOBDAUT 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 job descriptions do not have public authority of *EXCLUDE and a user name specified, then the 'Changed Report' will be printed but there will be no job descriptions listed. Changes to user profile special authorities will not cause a 'Changed Report' to be generated.
</p>
<p>The reports will contain the following information:
</p>
<ul>
<li>The name of the library that was specified on the command.
</li>
<li>The date and time the report was last run (only shown on the Changed Report).
</li>
<li>An entry for each job description that does not have *PUBLIC authority of *EXCLUDE and has a user name specified. Each entry contains the following information:
<ul>
<li>The name of the library the job description is in.
</li>
<li>The name of the job description.
</li>
<li>The owner of the job description.
</li>
<li>The name of the user profile specified in the job description.
</li>
<li>The special authorities associated with the user profile. The special authorities that are shown are all of the special authorities that would be available when that job description is used. The special authorities shown are the special authorities that the user has, plus the special authorities that the user's group profiles have (if the user has any groups).
</li>
</ul>
</li>
</ul>
<p>The file QSECJBDOLD in library QUSRSYS contains information from the last time the PRTJOBDAUT 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 QAOBJAUT in library QSYS with format name of QSYDSAUT is the model file for the QSECJBDOLD file.
</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="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="PRTJOBDAUT.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="#PRTJOBDAUT.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><i>Name</i>, *LIBL, *USRLIBL, *CURLIB, *ALL, *ALLUSR, *ALLAVL, *ALLUSRAVL</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#PRTJOBDAUT.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="PRTJOBDAUT.LIB"></a>
<h3>Library (LIB)</h3>
<p>This is a required parameter.
</p>
<p>The name of the library to search for job descriptions with public authority that is not *EXCLUDE and a user name is specified.
</p>
<p>.*
</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>*ALLAVL</b></dt>
<dd>All libraries in all available ASPs are searched.
</dd>
</dl>
<dl>
<dt><b>*ALLUSRAVL</b></dt>
<dd>All user libraries in all available ASPs are searched. Refer to *ALLUSR for a definition of user libraries.
</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="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="PRTJOBDAUT.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="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTJOBDAUT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
PRTJOBDAUT LIB(QGPL)
</pre>
</p>
<p>This command prints both full and changed report for the job descriptions in the library QGPL.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="PRTJOBDAUT.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="#PRTJOBDAUT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>