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

415 lines
16 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>Display Distribution List (DSPDSTL)</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="DSPDSTL.Top_Of_Page"></a>
<h2>Display Distribution List (DSPDSTL)</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="#DSPDSTL.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDSTL.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDSTL.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDSTL"></a>
<p>The Display Distribution List (DSPDSTL) command is used to display, print, or create a database output file for distribution lists contained in the distribution directory. No distribution lists can be created or deleted, nor can updates be made to existing lists from this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDSTL.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="#DSPDSTL.LSTID"><b>LSTID</b></a></td>
<td valign="top">List identifier</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: List ID</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: List ID qualifier</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTL.OWNER"><b>OWNER</b></a></td>
<td valign="top">Owner</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *CURRENT</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTL.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPDSTL.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File to receive output</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" rowspan="3"><a href="#DSPDSTL.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Output member options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Member to receive output</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTL.DETAIL"><b>DETAIL</b></a></td>
<td valign="top">Detail</td>
<td valign="top"><b><u>*BASIC</u></b>, *FULL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPDSTL.CMDCHRID"><b>CMDCHRID</b></a></td>
<td valign="top">Command character identifier</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDSTL.LSTID"></a>
<h3>List identifier (LSTID)</h3>
<p>Specifies which distribution lists to display, print, or direct to a database file.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All distribution lists in the system distribution directory are included in the output. The entries are provided in alphabetical order by list ID. If the output is a printed list or output file, the DETAIL parameter determines whether a list of distribution lists of a list of the entries in each list is the output.
</dd>
</dl>
<p>The possible list identifier value is:
</p>
<dl>
<dt><b><i>list-ID</i></b></dt>
<dd>Specify the list identifier (ID) of the distribution list.
</dd>
</dl>
<p>The possible list qualifier value is:
</p>
<dl>
<dt><b><i>list-ID-qualifier</i></b></dt>
<dd>Specify the list ID qualifier of the distribution list.
<p>
<b>Note: </b>The distribution list identifier has two parts, the ID and the qualifier, separated by at least one space. If lowercase characters are specified, the system changes them to uppercase.
</p>
<p>The naming rules for the two-part list ID are identical to the rules for the user ID and address. A complete description of these rules is in the SNA Distribution Services book, SC41-5410.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.OWNER"></a>
<h3>Owner (OWNER)</h3>
<p>Specifies the owner of the distribution lists to display, print, or write to a database file.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The distribution lists owned by all user profiles are directed for output.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The distribution lists owned by the current user are directed for output.
</dd>
<dt><b><i>user-profile-name</i></b></dt>
<dd>Specify the user profile of the owner whose distribution lists are to be directed for output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is shown at the requesting work station, printed with the job's spooled output, or written to a database file.
</p>
<dl>
<dt><b><u>*:</u></b></dt>
<dd>Output requested by an interactive job is shown on the display. If the command is run as part of a batch job, the output is printed with the job's spooled output.
</dd>
<dt><b>*PRINT:</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
<dt><b>*OUTFILE:</b></dt>
<dd>The output is directed to the database file specified on the OUTFILE parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the name of the database file to which the output of the display is directed. If the output file does not exist, this command creates a database file in the specified library. If no library is specified, the database file is created in QGPL.
</p>
<p>If the file is created, the text is 'OUTFILE created by DSPDSTL' and the public authority to the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
</p>
<p>The possible library values are:
</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 job is used to locate the database file. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the database file is located.
</dd>
<dt><b><i>data-base-file-name</i></b></dt>
<dd>Specify the name of the database file that receives the output of the display. If the database file is qualified with *LIBL but the system cannot find the file, one is created in the user's default library, if specified. If the default library was not specified, the file is created in QGPL.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, system file QAOSDSTO in system library QSYS with a format name of OSDSTL is used as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the name of the database file member to which the output of the display is directed. If a member already exists, the system uses the second part of this parameter to determine whether the member is cleared before the new records are added. If the member does not exist and a member name is not specified, the system creates a member with the name of the file specified on the <b>File to receive output (OUTFILE)</b> parameter. If an output file member name is specified, but the member does not exist, the system creates it.
</p>
<p>The possible <b>member to receive output</b> values are:
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the output file receives the output.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the output file member that receives the output.
</dd>
</dl>
<p>The possible <b>replace or add records</b> values are:
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The new data replaces the data currently contained in the output file member. The member is cleared when the file is opened.
</dd>
<dt><b>*ADD</b></dt>
<dd>The member is not cleared. The new data is added to the database file member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.DETAIL"></a>
<h3>Detail (DETAIL)</h3>
<p>Specifies how much detail should be printed or directed to the database file. This parameter is not used when * is specified on the <b>Output (OUTPUT)</b> parameter or when a specific list ID was specified on the <b>List identifier (LSTID)</b> parameter. When *ALL is specified on the LSTID parameter, this parameter is used to determine whether a list of all distribution lists or a list of all entries in every distribution list is used as the output.
</p>
<dl>
<dt><b><u>*BASIC</u></b></dt>
<dd>The list or output in the database file contains only a list of all distribution lists contained in the directory.
</dd>
<dt><b>*FULL</b></dt>
<dd>The list or output in the database file contains all of the entries in every distribution list contained in the directory.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTL.CMDCHRID"></a>
<h3>Command character identifier (CMDCHRID)</h3>
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values.
</p>
<p><b>Note:</b>
</p>
<ul>
<li>Only the user ID and address, system name and group, department, and the X.400 O/R parameters are translated to the graphic character set identifier (GCID) specified on this parameter. All other parameter values that you specify are stored exactly as they are entered; the GCID value is stored with them.
</li>
<li>If this command is run interactively, the default GCID value is taken from the display device description. If it is run in batch, the default GCID value is taken from the QCHRID system value. You can override these values by specifying a specific character set and code page on this parameter.
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
</dd>
</dl>
<dl>
<dt><b>*DEVD</b></dt>
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
</dd>
</dl>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the graphic character set to use.
</dd>
</dl>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the code page to use.
</dd>
</dl>
<p><b>Note:</b>
</p>
<ul>
<li>Only the user ID and address, system name and group, department, and the X.400 O/R parameters are translated to the graphic character set identifier (GCID) specified on this parameter. All other parameter values that you specify are stored exactly as they are entered; the GCID value is stored with them.
</li>
<li>If this command is run interactively, the default GCID value is taken from the display device description. If it is run in batch, the default GCID value is taken from the QCHRID system value. You can override these values by specifying a specific character set and code page on this parameter.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTL.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Displaying a List</b>
</p>
<p>
<pre>
DSPDSTL LSTID(*ALL) OUTPUT(*)
</pre>
</p>
<p>This command displays a list of all distribution lists in the directory. Specifying DSPDSTL without parameters would result in the same action.
</p>
<p><b>Example 2: Printing a List</b>
</p>
<p>
<pre>
DSPDSTL LSTID(DEPT48K DISTLIST) OUTPUT(*PRINT)
</pre>
</p>
<p>This command prints a list of all entries in the distribution list DEPT48K DISTLIST. The detail parameter is not used when printing for a specific list.
</p>
<p><b>Example 3: Directing Output to a Database File</b>
</p>
<p>
<pre>
DSPDSTL OUTPUT(*OUTFILE)
OUTFILE(ALLLISTS) OUTMBR(*FIRST *REPLACE)
DETAIL(*BASIC)
</pre>
</p>
<p>This command writes one record for each distribution list contained in the directory to the database file ALLLISTS. If this file is not found in the library list, it is created in the QGPL library, since no library is specified.
</p>
<p><b>Example 4: Directing Output for a Distribution List Owner to a Database File</b>
</p>
<p>
<pre>
DSPDSTL OWNER(ABSMITH) OUTFILE(DISTLIST/ABSMITH)
OUTMBR(*FIRST *REPLACE) DETAIL(*BASIC)
</pre>
</p>
<p>This command writes one record for each distribution list owned by user profile ABSMITH to the database file ABSMITH in the library DISTLIST. If this file is not found in the library DISTLIST, it is created.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTL.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF905C</b></dt>
<dd>Error occurred trying to find a translation table.
</dd>
<dt><b>CPF9052</b></dt>
<dd>List ID, &amp;1 &amp;2, cannot be found.
</dd>
<dt><b>CPF9096</b></dt>
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
</dd>
<dt><b>CPF9820</b></dt>
<dd>Not authorized to use library &amp;1.
</dd>
<dt><b>CPF9822</b></dt>
<dd>Not authorized to file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9838</b></dt>
<dd>User profile storage limit exceeded.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9847</b></dt>
<dd>Error occurred while closing file &amp;1 in library &amp;2.
</dd>
<dt><b>CPF9850</b></dt>
<dd>Override of printer file &amp;1 not allowed.
</dd>
<dt><b>CPF9851</b></dt>
<dd>Overflow value for file &amp;1 in &amp;2 too small.
</dd>
<dt><b>CPF9860</b></dt>
<dd>Error occurred during output file processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTL.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>