252 lines
8.9 KiB
HTML
252 lines
8.9 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>Display Program (DSPPGM)</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="DSPPGM.Top_Of_Page"></a>
|
|
<h2>Display Program (DSPPGM)</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="#DSPPGM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPPGM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPPGM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPPGM"></a>
|
|
<p>The Display Program (DSPPGM) command displays information about a program. The display includes information about the compiler, the source from which the program was created, certain processing attributes of the program, the size of the program, and the number of parameters that must be passed to the program when it is called.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have read (*READ) authority to the program and execute (*EXECUTE) authority to the library to use this command.
|
|
</li>
|
|
<li>You must have use (*USE) authority to the program when DETAIL(*MODULE) is specified.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPPGM.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" rowspan="3"><a href="#DSPPGM.PGM"><b>PGM</b></a></td>
|
|
<td valign="top">Program</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Program</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DSPPGM.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPPGM.DETAIL"><b>DETAIL</b></a></td>
|
|
<td valign="top">Detail</td>
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 7 repetitions): *BASIC, *SIZE, *MODULE, *ACTGRPEXP, *ACTGRPIMP, *SRVPGM, *COPYRIGHT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPPGM.PGM"></a>
|
|
<h3>Program (PGM)</h3>
|
|
<p>Specifies the program for which information is displayed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Program</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the program.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</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 used to locate the program. If no library is specified as the current library for the thread, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the program is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPGM.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The output is shown (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPPGM.DETAIL"></a>
|
|
<h3>Detail (DETAIL)</h3>
|
|
<p>Specifies the type of information displayed for the service program. More than one value can be specified, but a list of values must not include *ALL. *ALL must be specified as a single value.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>DETAIL(*ALL) or DETAIL(*BASIC) are the only values valid for original program model (OPM) programs. All values other than *ALL or *BASIC are ignored for an OPM program.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All of the DETAIL information types (*BASIC, *SIZE, *MODULE, *SRVPGM, *ACTGRPEXP, *ACTGRPIMP, and *COPYRIGHT) are shown on the display. If the user has chosen the information to be displayed on the screen, the user can scroll through the information for each DETAIL, but will have to press Enter (or PF12) to go from DETAIL to DETAIL.
|
|
</dd>
|
|
<dt><b>*BASIC</b></dt>
|
|
<dd>General program information is shown.
|
|
</dd>
|
|
<dt><b>*SIZE</b></dt>
|
|
<dd>The size and size limits for this program are shown.
|
|
</dd>
|
|
<dt><b>*MODULE</b></dt>
|
|
<dd>A list is shown of the module objects bound by this program. The library shown for each module is the library that the module was in when the program was first created. If the module has been replaced by a module from a different library, this library name remains the name of the library that the module was in when the program was created. To determine the source that the module was created from, use option 5=Display description to see the source file, library, and member names.
|
|
</dd>
|
|
<dt><b>*SRVPGM</b></dt>
|
|
<dd>A list is shown of the service programs bound by this program.
|
|
</dd>
|
|
<dt><b>*ACTGRPEXP</b></dt>
|
|
<dd>A list is shown of the data items exported to the activation group specified in the data export entry in the binding specifications.
|
|
</dd>
|
|
<dt><b>*ACTGRPIMP</b></dt>
|
|
<dd>A list is shown of the imports that are resolved by weak exports that had been exported to the activation group directory.
|
|
</dd>
|
|
<dt><b>*COPYRIGHT</b></dt>
|
|
<dd>A list is shown of the copyrights for this service program.
|
|
<p>
|
|
<b>Note: </b>The DETAIL values *SIZE, *MODULE, *SRVPGM, and *COPYRIGHT are valid only for integrated language environment (ILE) programs. Specifying one of these values for an original program model (OPM) program results in the *BASIC information being shown.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPGM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying Program Information</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPGM PGM(LIB01/PAYROLL)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays information about the program named PAYROLL in library LIB01. The display is shown at the display station if requested by an interactive job, or printed if requested by a batch job.
|
|
</p>
|
|
<p><b>Example 2: Printing Program Information</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPPGM PGM(CUSINQ) OUTPUT(*PRINT)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays information about a program named CUSINQ. The library list is used to find the program, and the information is printed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPPGM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2150</b></dt>
|
|
<dd>Object information function failed.
|
|
</dd>
|
|
<dt><b>CPF2151</b></dt>
|
|
<dd>Operation failed for &2 in &1 type *&3.
|
|
</dd>
|
|
<dt><b>CPF8122</b></dt>
|
|
<dd>&8 damage on library &4.
|
|
</dd>
|
|
<dt><b>CPF8123</b></dt>
|
|
<dd>Damage on object information for library &4.
|
|
</dd>
|
|
<dt><b>CPF8129</b></dt>
|
|
<dd>Program &4 in &9 damaged.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9806</b></dt>
|
|
<dd>Cannot perform function for object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9807</b></dt>
|
|
<dd>One or more libraries in library list deleted.
|
|
</dd>
|
|
<dt><b>CPF9808</b></dt>
|
|
<dd>Cannot allocate one or more libraries on library list.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9811</b></dt>
|
|
<dd>Program &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9821</b></dt>
|
|
<dd>Not authorized to program &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9871</b></dt>
|
|
<dd>Error occurred while processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|