182 lines
7.3 KiB
HTML
182 lines
7.3 KiB
HTML
|
|
<!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 Trigger Programs (PRTTRGPGM)</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="PRTTRGPGM.Top_Of_Page"></a>
|
|
<h2>Print Trigger Programs (PRTTRGPGM)</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="#PRTTRGPGM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#PRTTRGPGM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#PRTTRGPGM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="PRTTRGPGM"></a>
|
|
<p>The Print Trigger Program (PRTTRGPGM) command lists the programs which have been defined as a trigger program for the files in the specified library.
|
|
</p>
|
|
<p>This command will print two reports for a library. The first report (Full Report) will contain all of the trigger programs associated with files in the specified library. The second report (Changed Report) will contain the trigger programs that <b>now</b> appear in the specified library and were not in the library when the PRTTRGPGM command was previously run for the library. If the PRTTRGPGM 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 trigger programs are in the specified library, the 'Changed Report' will be printed but there will be no objects listed. Changing the trigger time, trigger event or trigger update condition for a trigger program will not cause a 'Changed Report' to be generated.
|
|
</p>
|
|
<p>The file QSECTRGOLD in library QUSRSYS contains information from the last time the PRTTRGPGM command was run for a library. There is a member within the file, with the same name as the library specified, for each library previously specified on the command. System file QAFDTRG in library QSYS with format name of QWHFDTRG is the model file for the QSECTRGOLD 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="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="PRTTRGPGM.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="#PRTTRGPGM.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">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#PRTTRGPGM.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="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="PRTTRGPGM.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The name of the library to search for files that have trigger programs.
|
|
</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="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="PRTTRGPGM.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="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTTRGPGM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
PRTTRGPGM LIB(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command searches all files in all libraries and prints both full and changed trigger program reports.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="PRTTRGPGM.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>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#PRTTRGPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|