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

547 lines
20 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 Distribution Log (DSPDSTLOG)</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="DSPDSTLOG.Top_Of_Page"></a>
<h2>Display Distribution Log (DSPDSTLOG)</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="#DSPDSTLOG.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPDSTLOG.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPDSTLOG.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPDSTLOG"></a>
<p>The Display Distribution Log (DSPDSTLOG) command provides a convenient interface to the Systems Network Architecture distribution services (SNADS) log. The SNADS log (the QSNADS journal) contains entries that track SNADS operations that have been performed on the system. These operations include sending, receiving, and routing distributions and configuration changes.
</p>
<p>This command provides a wide range of selection criteria which allows easy access to the desired information. The selection criteria includes time period, function type (such as router and sender/receiver), entry type (such as normal, error, and configuration), and job name. Any number of selection parameters can be entered, and the resulting output is cumulative, based on all parameters entered.
</p>
<p>Both displayed and printed output can be produced in conjunction with the input parameter specified. If the user requests output that can be shown, a summary of all entries matching the selection criteria are shown. The summary display includes basic information, such as function type, entry type, date-time of logging, job name, and originating user ID. From the summary display, any of the entries can be chosen to view the details of that log entry. The detail display gives more specific information on that particular log entry. If the user requests printed output, a detail printout for each log entry in the selection is produced.
</p>
<p>By specifying the appropriate selection criteria, the user can determine the following types of information:
</p>
<ul>
<li>Configuration changes that were made, when and by whom they were made for all tables or for specific tables
</li>
<li>Configuration changes correlated with error entries or distributions routed and/or sent
</li>
<li>List error entries for all functions or for specific functions (such as routing errors)
</li>
<li>All distributions received, routed, or sent during a selected time interval
</li>
<li>Activity for a specific sender or receiver job
</li>
</ul>
<p><b>Restrictions:</b>
</p>
<ol>
<li>This command is shipped with public *EXCLUDE authority.
</li>
<li>This command cannot be used to show information on the 12 by 80 size work station (*DS2) or on the console (*DS1).
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPDSTLOG.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="7"><a href="#DSPDSTLOG.PERIOD"><b>PERIOD</b></a></td>
<td valign="top">Time period for log output</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: </td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
<td valign="top">
<i>Time</i>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
<td valign="top">
<i>Date</i>, <b><u>*CURRENT</u></b>, *BEGIN</td>
</tr>
<tr>
<td valign="top">Element 2: </td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
<td valign="top">
<i>Time</i>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
<td valign="top">
<i>Date</i>, <b><u>*CURRENT</u></b>, *END</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTLOG.FNCTYP"><b>FNCTYP</b></a></td>
<td valign="top">Function type</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 8 repetitions): *RCV, *RTR, *SND, *CFG, *OPR, *ORG, *ARV, *SYS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPDSTLOG.ENTTYP"><b>ENTTYP</b></a></td>
<td valign="top">Entry type</td>
<td valign="top">Single values: <b><u>*ALLDST</u></b>, *ALL<br>Other values (up to 5 repetitions): *NRM, *ERR, *RTG, *DSQ, *SYS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPDSTLOG.ORGUSRID"><b>ORGUSRID</b></a></td>
<td valign="top">Origin user identifier</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: User ID</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b>, *BLANK</td>
</tr>
<tr>
<td valign="top">Element 2: Address</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b>, *BLANK</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#DSPDSTLOG.ORGSYSNAME"><b>ORGSYSNAME</b></a></td>
<td valign="top">Origin system name</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: System name</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: System group</td>
<td valign="top">
<i>Character value</i>, <b><u>*ALL</u></b>, *BLANK</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#DSPDSTLOG.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values: <i>Qualified job name</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job name</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: User</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 3: Number</td>
<td valign="top">000000-999999</td>
</tr><tr>
<td valign="top" rowspan="7"><a href="#DSPDSTLOG.RCVRNG"><b>RCVRNG</b></a></td>
<td valign="top">Range of journal receivers</td>
<td valign="top">Single values: <b><u>*CURRENT</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Starting journal receiver</td>
<td valign="top">
<i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Starting journal receiver</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top">Element 2: Ending journal receiver</td>
<td valign="top">
Single values: <b><u>*CURRENT</u></b><br>Other values: <i>Qualified object name</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Qualifier 1: Ending journal receiver</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#DSPDSTLOG.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPDSTLOG.PERIOD"></a>
<h3>Time period for log output (PERIOD)</h3>
<p>Specifies the time period for which log entries are shown. The following values can be coded in this parameter, which contains two lists of two values each.
</p>
<p><b>Beginning Time: </b>One of the following is used to specify the beginning time.
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>The log entries from the starting date to the ending date are shown.
</dd>
<dt><b><i>start-time</i></b></dt>
<dd>Specify the starting time for the specified starting date for which you want the log entries shown. The time can be specified with or without a time separator:
<ul>
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
</li>
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
</li>
</ul>
</dd>
</dl>
<p><b>Beginning Date: </b>One of the following is used to specify the beginning date.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The log entries that are available for the current day and between the specified starting and ending times (if specified) are shown.
</dd>
<dt><b>*BEGIN</b></dt>
<dd>The entries from the beginning of the log are shown. If *BEGIN is specified then beginning-time is ignored.
</dd>
<dt><b><i>beginning-date</i></b></dt>
<dd>Specify the start date for which the log entries are shown. (The system date format must be used.)
</dd>
</dl>
<p><b>Ending Time: </b>One of the following is used to specify the ending time.
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>The log entries from the beginning date to the ending date are shown.
</dd>
<dt><b><i>ending-time</i></b></dt>
<dd>Specify the ending time for the specified ending date to which you want the log entries shown. See the start-time description in this parameter description for details on how the time must be specified.
</dd>
</dl>
<p><b>Ending Date: </b>One of the following is used to specify the ending date.
</p>
<dl>
<dt><b><u>*CURRENT</u></b></dt>
<dd>The log entries that are available for the current day and between the specified starting and ending times (if specified) are shown.
</dd>
<dt><b><u>*END</u></b></dt>
<dd>The entries to the end of the log are shown. If *END is specified then ending-time is ignored.
</dd>
<dt><b><i>ending-date</i></b></dt>
<dd>Specify the ending date to which you want the log entries shown. (The system date format must be used.)
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.FNCTYP"></a>
<h3>Function type (FNCTYP)</h3>
<p>Specifies the SNADS function that was being performed when entries were made to the QSNADS journal. If the default value *ALL is not specified, a maximum of eight functions can be specified.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All SNADS functions that made log entries are specified.
</dd>
<dt><b>*RCV</b></dt>
<dd>The SNADS receiver function is specified.
</dd>
<dt><b>*RTR</b></dt>
<dd>The SNADS router function is specified.
</dd>
<dt><b>*SND</b></dt>
<dd>The SNADS sender function is specified.
</dd>
<dt><b>*ORG</b></dt>
<dd>The SNADS originator function is specified.
</dd>
<dt><b>*ARV</b></dt>
<dd>The SNADS arrival function is specified.
</dd>
<dt><b>*CFG</b></dt>
<dd>The SNADS configuration function is specified. If *CFG is specified on this parameter, the <b>User ID</b> prompt (ORGUSRID parameter), and the <b>System group</b> prompt (ORGSYSNAME parameter) cannot be specified.
</dd>
<dt><b>*OPR</b></dt>
<dd>The SNADS operation function is specified.
</dd>
<dt><b>*SYS</b></dt>
<dd>The SNADS system function is specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.ENTTYP"></a>
<h3>Entry type (ENTTYP)</h3>
<p>Specifies the type of log entries that are shown. If the values *ALL or *ALLDST are not specified, a maximum of five entry types may be specified.
</p>
<p>You can enter multiple values for this parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALLDST</u></b></dt>
<dd>All log entry types are shown except *SYS.
</dd>
<dt><b><u>*ALL</u></b></dt>
<dd>All log entry types are shown.
</dd>
<dt><b>*NRM</b></dt>
<dd>Normal (or non-error) log entries are shown.
</dd>
<dt><b>*ERR</b></dt>
<dd>Error log entries are shown.
</dd>
<dt><b>*RTG</b></dt>
<dd>Routing table log entries or secondary system name log entries are shown.
</dd>
<dt><b>*DSQ</b></dt>
<dd>Distribution queue log entries are shown.
</dd>
<dt><b>*SYS</b></dt>
<dd>The QSNADS journal entries are shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.ORGUSRID"></a>
<h3>Origin user identifier (ORGUSRID)</h3>
<p>Specifies the originating user ID and address of logged distributions. This parameter allows you to display or print only those entries logged because of distributions originated by a user with the specified ID or address. The user ID and address are translated to the character set and code page '697 500' using the job's coded character set identifier (CCSID).
</p>
<p>The possible <b>user ID</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All log entries are shown regardless of the originating user ID.
</dd>
<dt><b>*BLANK</b></dt>
<dd>Only log entries with an originating user ID of all blanks (as in the case of SNADS status distributions) are shown.
</dd>
<dt><b><i>user-ID</i></b></dt>
<dd>Specify the originating user ID for which log entries are to be shown.
</dd>
</dl>
<p>The possible <b>address</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All log entries are shown regardless of the originating address.
</dd>
<dt><b>*BLANK</b></dt>
<dd>Only log entries with an originating address of all blanks (as in the case of SNADS status distributions) are shown.
</dd>
<dt><b><i>address</i></b></dt>
<dd>Specify the originating address for which log entries are to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.ORGSYSNAME"></a>
<h3>Origin system name (ORGSYSNAME)</h3>
<p>Specifies the name and group name of the originating system of logged distributions. This parameter allows you to display or print only those entries logged because of distributions that originated from the specified system or group.
</p>
<p>AS/400, System/38, and System/36 systems do not specify a system group. The originating system group name of distributions from these systems will always be blanks.
</p>
<p>The name and group are translated to the character set and code page '697 500' using the job's coded character set identifier (CCSID).
</p>
<p>The possible <b>system name</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All log entries are shown regardless of the originating system.
</dd>
<dt><b><i>system-name</i></b></dt>
<dd>Specify the name of the originating system for which log entries are to be shown.
</dd>
</dl>
<p>The possible <b>group name</b> values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All log entries are shown regardless of the originating system group name.
</dd>
<dt><b>*BLANK</b></dt>
<dd>Only log entries with an originating address of all blanks are shown.
</dd>
<dt><b><i>system-group-name</i></b></dt>
<dd>Specify the originating system group name for which log entries are to be shown.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the name of the SNADS job that made the log entry. This parameter allows you to display or print only those entries logged by the specified job.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Entries are shown regardless of the job that logged them.
</dd>
<dt><b><i>job name (user name (job number))</i></b></dt>
<dd>Specifies the particular SNADS job name that made the entries.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.RCVRNG"></a>
<h3>Range of journal receivers (RCVRNG)</h3>
<p>Specifies the journal receivers that contain the SNADS logs. This allows you to display entries from SNADS logs that are kept in journal receivers which are no longer active.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*CURRENT</b></dt>
<dd>The current SNADS log is shown.
</dd>
<dt><b><i>starting-receiver-name</i></b></dt>
<dd>Specify a starting receiver name (library name/starting receiver name). The SNADS logs that are kept in the journal receivers from the starting receiver name through the ending receiver name are shown.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the journal receiver.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the journal receiver. If no library is specified as the current library, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the journal receiver is located.
</dd>
</dl>
</dd>
<dt><b><i>ending-receiver-name</i></b></dt>
<dd>Specify a ending receiver name (library name/ending receiver name). The SNADS logs that are kept in the journal receivers from the starting receiver name through the ending receiver name are shown.
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the journal receiver.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the journal receiver. If no library is specified as the current library, QGPL is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library where the journal receiver is located.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPDSTLOG.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>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (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>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTLOG.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Printing a Distribution Log</b>
</p>
<p>
<pre>
DSPDSTLOG OUTPUT(*PRINT)
</pre>
</p>
<p>This command directs the distribution log information to the job's output spooling queue to be printed. If OUTPUT(*) is specified, and the command was entered from a work station, the information about the distribution log is shown at the work station.
</p>
<p><b>Example 2: Getting a SNADS Distribution Log</b>
</p>
<p>
<pre>
DSPDSTLOG ENTTYPE(*SYS)
</pre>
</p>
<p>This command directs the SNADS distribution log entries to be shown on the work station display for an interactive job, or printed with the job's spooled output for a batch job.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPDSTLOG.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPDSTLOG.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>