1123 lines
44 KiB
HTML
1123 lines
44 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>Trace Connection (TRCCNN)</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="TRCCNN.Top_Of_Page"></a>
|
||
|
|
<h2>Trace Connection (TRCCNN)</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="#TRCCNN.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#TRCCNN.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#TRCCNN.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="TRCCNN"></a>
|
||
|
|
<p>The Trace Connection (TRCCNN) command allows the tracing of encrypted data flowing over internet protocol (IP) and Secure Sockets Layer (SSL) connections. Specific types of traces are started and stopped by using this command.
|
||
|
|
</p>
|
||
|
|
<p>TRCCNN uses the Trace Internal (TRCINT) command to collect the trace records and generate an intermediate spooled file named QPCSMPRT. The QPCSMPRT spooled file data is used to generate a spooled file named QSYSPRT. The user data for the QSYSPRT file is 'TRCCNN'.
|
||
|
|
</p>
|
||
|
|
<p>You can use also use TRCCNN with a QPCSMPRT spooled file generated by using TRCINT directly. TRCCNN can extract and format the IP and SSL connection-related trace records. This allows you to use TRCINT to collect many types of trace records and then use TRCCNN to format the subset of trace records related to IP or SSL connections.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service Trace function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
|
||
|
|
</li>
|
||
|
|
<li>The following user profiles have private authorities to use the command:
|
||
|
|
<ul>
|
||
|
|
<li>QSRV
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>When the <b>Watched job (WCHJOB)</b> parameter is specified, the issuer of the command must be running under a user profile which is the same as the job user identity of the job being watched, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. Job control (*JOBCTL) special authority is also required if a generic user name is specified for the WCHJOB parameter.
|
||
|
|
</li>
|
||
|
|
<li>If you specify a generic user name in the WCHJOB parameter, you must have all object (*ALLOBJ) special authority, or be authorized to the Watch Any Job function of Operating System through iSeries Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_WATCH_ANY_JOB, can also be used to change the list of users that are allowed to start and end watch operations.
|
||
|
|
</li>
|
||
|
|
<li>You must have operational (*OBJOPR) and execute (*EXECUTE) authorities to the user exit program if specified in <b>Trace program (TRCPGM)</b> parameter, and execute (*EXECUTE) authority to the library where the program is located.
|
||
|
|
</li>
|
||
|
|
<li>You must have use (*USE) authority to the message queues specified in <b>Watched message queue (WCHMSGQ)</b> parameter, and use (*USE) authority to the library where the message queue is located.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="TRCCNN.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="#TRCCNN.SET"><b>SET</b></a></td>
|
||
|
|
<td valign="top">Trace option setting</td>
|
||
|
|
<td valign="top">*ON, *OFF, *END, *FORMAT</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.TRCTYPE"><b>TRCTYPE</b></a></td>
|
||
|
|
<td valign="top">Trace type</td>
|
||
|
|
<td valign="top">Values (up to 2 repetitions): *IP, *SSL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.TRCFULL"><b>TRCFULL</b></a></td>
|
||
|
|
<td valign="top">Trace full</td>
|
||
|
|
<td valign="top"><b><u>*WRAP</u></b>, *STOPTRC</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.TRCTBL"><b>TRCTBL</b></a></td>
|
||
|
|
<td valign="top">Trace table name</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*GEN</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#TRCCNN.SIZE"><b>SIZE</b></a></td>
|
||
|
|
<td valign="top">Size</td>
|
||
|
|
<td valign="top">Single values: *MAX, *MIN<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Number of units</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-998000, <b><u>16000</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Unit of measure</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*KB</u></b>, *MB</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.FMTDTA"><b>FMTDTA</b></a></td>
|
||
|
|
<td valign="top">Trace data to be formatted</td>
|
||
|
|
<td valign="top">72-99999, <b><u>*CALC</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.CCSID"><b>CCSID</b></a></td>
|
||
|
|
<td valign="top">Coded character set identifier</td>
|
||
|
|
<td valign="top">1-65533, <b><u>*EBCDIC</u></b>, *ASCII</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#TRCCNN.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Job name</td>
|
||
|
|
<td valign="top">Single values: <b><u>*</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"><a href="#TRCCNN.SPLNBR"><b>SPLNBR</b></a></td>
|
||
|
|
<td valign="top">Spooled file number</td>
|
||
|
|
<td valign="top">1-999999, *ONLY, <b><u>*LAST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
|
||
|
|
<td valign="top">Job system name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#TRCCNN.CRTDATE"><b>CRTDATE</b></a></td>
|
||
|
|
<td valign="top">Spooled file created</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Creation date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Creation time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#TRCCNN.TCPDTA"><b>TCPDTA</b></a></td>
|
||
|
|
<td valign="top">TCP/IP data</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Protocol</td>
|
||
|
|
<td valign="top">
|
||
|
|
*TCP, *UDP, *ICMP, *IGMP, *ARP, *ICMP6</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Local port</td>
|
||
|
|
<td valign="top">
|
||
|
|
Values (up to 2 repetitions): 1-65535</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Remote port</td>
|
||
|
|
<td valign="top">
|
||
|
|
Values (up to 2 repetitions): 1-65535</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Local IP address</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 5: Remote IP address</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 6: Line description</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#TRCCNN.WCHMSG"><b>WCHMSG</b></a></td>
|
||
|
|
<td valign="top">Watch for message</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Message identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Comparison data</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Compare against</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*MSGDTA</u></b>, *FROMPGM, *TOPGM</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#TRCCNN.WCHMSGQ"><b>WCHMSGQ</b></a></td>
|
||
|
|
<td valign="top">Watched message queue</td>
|
||
|
|
<td valign="top">Values (up to 3 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Message queue</td>
|
||
|
|
<td valign="top">
|
||
|
|
Single values: <b><u>*SYSOPR</u></b>, *JOBLOG, *HSTLOG<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Message queue</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></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#TRCCNN.WCHJOB"><b>WCHJOB</b></a></td>
|
||
|
|
<td valign="top">Watched job</td>
|
||
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Job name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified job name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Job name</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: User</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 3: Number</td>
|
||
|
|
<td valign="top">000001-999999, <b><u>*ALL</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#TRCCNN.WCHLICLOG"><b>WCHLICLOG</b></a></td>
|
||
|
|
<td valign="top">Watch for LIC log entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Major code</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ALL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Minor code</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ALL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Comparison data</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.WCHTIMO"><b>WCHTIMO</b></a></td>
|
||
|
|
<td valign="top">Length of time to watch</td>
|
||
|
|
<td valign="top">1-43200, <b><u>*NOMAX</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#TRCCNN.TRCPGM"><b>TRCPGM</b></a></td>
|
||
|
|
<td valign="top">Trace program</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Trace 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></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#TRCCNN.TRCPGMITV"><b>TRCPGMITV</b></a></td>
|
||
|
|
<td valign="top">Time interval</td>
|
||
|
|
<td valign="top">1-9999, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="TRCCNN.SET"></a>
|
||
|
|
<h3>Trace option setting (SET)</h3>
|
||
|
|
<p>Specifies whether tracing is started, stopped or ended. Also, you can select to format trace record data collected previously using the TRCCNN or TRCINT (Trace Internal) command.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ON</b></dt>
|
||
|
|
<dd>The collection of internal trace records is started for the trace types specified in the TRCTYPE parameter. If *GEN is specified in the TRCTBL parameter then the trace table name will be QTRCCNNxxxxxx where xxxxxx is the job number of the current job. Otherwise the trace table name will be the name specified on the TRCTBL parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OFF</b></dt>
|
||
|
|
<dd>Collection of trace records stops. A spooled file named QPCSMPRT is generated by the TRCINT command and contains the collected trace record data. TRCCNN formats this data in a second spooled file named QSYSPRT. The user data for the QSYSPRT spooled file is 'TRCCNN'. The trace table is deleted after the spooled files are generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*END</b></dt>
|
||
|
|
<dd>Collection of trace records stops and the trace table is deleted. No spooled output is generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FORMAT</b></dt>
|
||
|
|
<dd>Formats trace data in a QPCSMPRT spooled file created by a previous invocation of TRCCNN or TRCINT. The formatted data is written to a spooled file named QSYSPRT. The user data for the QSYSPRT spooled file is 'TRCCNN'. Use the TRCTYPE parameter to specify which connection-related trace records to format. Use the JOB, SPLNBR, JOBSYSNAME and CRTDATE parameters to identify which QPCSMPRT file to use.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TRCTYPE"></a>
|
||
|
|
<h3>Trace type (TRCTYPE)</h3>
|
||
|
|
<p>If SET(*ON) is specified, identifies the types of trace records to start collecting. If SET(*FORMAT) is specified, identifies the types of collected trace records to format. Multiple trace types may be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*IP</b></dt>
|
||
|
|
<dd>Trace IP (internet protocol) data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SSL</b></dt>
|
||
|
|
<dd>Trace SSL (Secure Sockets Layer) connection data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TRCFULL"></a>
|
||
|
|
<h3>Trace full (TRCFULL)</h3>
|
||
|
|
<p>Specifies whether the trace records wrap (replace the oldest records with new records) or stop tracing when the trace table is full.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*WRAP</u></b></dt>
|
||
|
|
<dd>When the trace table is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STOPTRC</b></dt>
|
||
|
|
<dd>Tracing is stopped when the trace table is full of trace records.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TRCTBL"></a>
|
||
|
|
<h3>Trace table name (TRCTBL)</h3>
|
||
|
|
<p>Specifies the trace table to hold the collected trace data.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*GEN</u></b></dt>
|
||
|
|
<dd>The trace table name will be QTRCCNNxxxxxx where xxxxxx is the job number of the current job.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the trace table to be used. If SET(*ON) is specified and the name specified does not match an existing trace table, a new trace table by the specified name will be created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.SIZE"></a>
|
||
|
|
<h3>Size (SIZE)</h3>
|
||
|
|
<p>Specifies the size of the trace table. The amount of storage to be allocated can be specified in units of kilobytes (*KB) or megabytes (*MB). If the size is specified in kilobytes, the amount of storage allocated for the table will be rounded up to the nearest megabyte. Valid table size values range from one megabyte to 258048 megabytes.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The amount of storage specified by this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). This storage space is not dynamically allocated as it is needed. This storage space will not be available for use by the system except to record trace-related information. Before specifying a large value on this parameter, the amount of free space in the system ASP should be checked. Use the Work with System Status (WRKSYSSTS) command to determine the amount of available free space in the system ASP. System performance degradation may result if the size of the free space in the system ASP is significantly reduced as a result of the value specified.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If tracing data over a gigabit Ethernet line the trace table size should be greater than 128000 kilobytes or 128 megabytes.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MAX</b></dt>
|
||
|
|
<dd>The trace table is set to the maximum size of 258048 megabytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MIN</b></dt>
|
||
|
|
<dd>The trace table is set to the minimum size of one megabyte.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Number of units</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>16000</u></b></dt>
|
||
|
|
<dd>The trace table size is either 16000 kilobytes or 16000 megabytes, depending on the value specified for the second element of this parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-998000</i></b></dt>
|
||
|
|
<dd>Specify the size of the trace table in kilobytes or megabytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Unit of measure</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies whether the value specified for the first element should be treated as number of kilobytes or number of megabytes.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*KB</u></b></dt>
|
||
|
|
<dd>The trace table size is specified in kilobytes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MB</b></dt>
|
||
|
|
<dd>The trace table size is specified in megabytes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.FMTDTA"></a>
|
||
|
|
<h3>Trace data to be formatted (FMTDTA)</h3>
|
||
|
|
<p>Specifies the number of bytes of traced data to be formatted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CALC</u></b></dt>
|
||
|
|
<dd>The system determines the number of bytes of data to be formatted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>72-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of bytes of data to be formatted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.CCSID"></a>
|
||
|
|
<h3>Coded character set identifier (CCSID)</h3>
|
||
|
|
<p>Specifies whether the extended binary-coded decimal interchange code (*EBCDIC- 37) or the American National Standard Code for Information Interchange (*ASCII- 819) character code or any other is used for the formated output.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*EBCDIC</u></b></dt>
|
||
|
|
<dd>The EBCDIC (37) character code is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASCII</b></dt>
|
||
|
|
<dd>The ASCII (819) character code is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-65533</i></b></dt>
|
||
|
|
<dd>Specify the coded character set identifier (CCSID) value to be used when formatting the trace data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.JOB"></a>
|
||
|
|
<h3>Job name (JOB)</h3>
|
||
|
|
<p>Specifies the name or qualified name of the job that created the input QPCSMPRT spooled file (SPLNBR parameter). This parameter is valid only if SET(*FORMAT) is specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The job that issued this command is the job that created the input QPCSMPRT spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the job that created the input QPCSMPRT spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: User</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user name that identifies the user profile under which the job was run that created the input QPCSMPRT spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 3: Number</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>000000-999999</i></b></dt>
|
||
|
|
<dd>Specify the system-assigned job number of the job that created the input QPCSMPRT spooled file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.SPLNBR"></a>
|
||
|
|
<h3>Spooled file number (SPLNBR)</h3>
|
||
|
|
<p>Specifies the file number of the QPCSMPRT spooled file from the job (JOB parameter) that created the spooled file. This parameter is valid only if SET(*FORMAT) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LAST</u></b></dt>
|
||
|
|
<dd>The highest-numbered spooled file named QPCSMPR created by the specified job is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ONLY</b></dt>
|
||
|
|
<dd>Only one spooled file named QPCSMPRT was created by the specified job; therefore, the number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file for the specified job is named QPCSMPRT, an error message is issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-999999</i></b></dt>
|
||
|
|
<dd>Specify the number of the QPCSMPRT spooled file created by the specified job.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.JOBSYSNAME"></a>
|
||
|
|
<h3>Job system name (JOBSYSNAME)</h3>
|
||
|
|
<p>Specifies the name of the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name and spooled file number parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number and spooled file creation date and time.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number and creation date and time is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The job system name is not used to determine which spooled file is used. Use this value when the spooled file creation date and time parameter is to take precedence over the job system name when selecting a spooled file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the system where the job that created the spooled file ran.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.CRTDATE"></a>
|
||
|
|
<h3>Spooled file created (CRTDATE)</h3>
|
||
|
|
<p>Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number and job system name parameter requirements have been met.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number and job system name.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest creation date and time of the specified job name, user name, job number, spooled file name, spooled file number and job system name is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Creation date</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Creation time</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>There is only one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The spooled file with the latest creation time of the specified job name, user name, job number, spooled file name, spooled file number,job system name, and spooled file creation date is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>time</i></b></dt>
|
||
|
|
<dd>Specify the time the spooled file was created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TCPDTA"></a>
|
||
|
|
<h3>TCP/IP data (TCPDTA)</h3>
|
||
|
|
<p>Specifies whether a subset of TCP/IP and/or SSL trace data should be collected. Each parameter element is optional; if no element value is specified, no filtering of trace data is done for that element. For example, if *TCP is specified for element 1, only trace records where the TCP protocol is used are collected. If no value is specified for element 1, trace records using all TCP/IP protocols are collected.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Protocol</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify a TCP/IP protocol to be traced.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*TCP</b></dt>
|
||
|
|
<dd>Enable trace for transmission control protocol.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UDP</b></dt>
|
||
|
|
<dd>Enable trace for user datagram protocol.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ICMP</b></dt>
|
||
|
|
<dd>Enable trace for internet control message protocol.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IGMP</b></dt>
|
||
|
|
<dd>Enable trace for internet group management protocol
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ARP</b></dt>
|
||
|
|
<dd>Enable trace for address resolution protocol. This will only apply for TCP/IP.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ICMP6</b></dt>
|
||
|
|
<dd>Enable trace for internet control message protocol version 6.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Local port</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-65535</i></b></dt>
|
||
|
|
<dd>Specify one or two local port numbers for which trace data is collected.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Remote port</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-65535</i></b></dt>
|
||
|
|
<dd>Specify one or two remote port numbers for which trace data is collected
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 4: Local IP address</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify a local internet protocol address.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 5: Remote IP address</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify a remote internet protocol address.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 6: Line description</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of a line description for which TCP/IP trace data is to be collected.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.WCHMSG"></a>
|
||
|
|
<h3>Watch for message (WCHMSG)</h3>
|
||
|
|
<p>Specifies up to five message identifiers which are to be watched for. If a value other than *NONE is specified, you must specify where to watch for the message on the WCHMSGQ parameter. When the watched for message is added to the specified message queue or log, the trace exit program is called; if no trace exit program is defined, the trace stops.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No messages will be watched for.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Message identifier</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the 7-character message identifier to be watched for.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Comparison data</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify comparison data to be used if a message matching the specified message ID is added to the specified message queue or log. If the message data, the "From program" or the "To program" includes the specified text, the watched for condition is true. If the message data, the "From program" or the "To program" does not contain the specified text, the trace function continues.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No comparison data is specified. If a message matching the specified message ID is added to the specified message queue or log, the watched for condition is true.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the text string used to compare against the message data, the "From program" or the "To program" of the watched for message. This text is case sensitive and can be quoted in order to specify imbedded or trailing blanks.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Compare against</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify which part of the message the comparison data specified for element 2 is to be compared against.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MSGDATA</u></b></dt>
|
||
|
|
<dd>The comparison data will be compared against the message replacement data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FROMPGM</b></dt>
|
||
|
|
<dd>The comparison data will be compared against the name of the program sending the message, or the name of the ILE program that contains the procedure sending the message.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TOPGM</b></dt>
|
||
|
|
<dd>The comparison data will be compared against the name of the program the message was sent to, or the name of the ILE program that contains the procedure the message was sent to.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.WCHMSGQ"></a>
|
||
|
|
<h3>Watched message queue (WCHMSGQ)</h3>
|
||
|
|
<p>Specifies where to watch for the message identifiers specified on the WCHMSG parameter. You can specify to watch the message being added to the system operator message queue, the history log, other message queues, and job logs. Up to three message queues or special values can be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Message queue</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSOPR</u></b></dt>
|
||
|
|
<dd>Watch messages added to the system operator message queue (QSYSOPR message queue in library QSYS).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOBLOG</b></dt>
|
||
|
|
<dd>Watch messages added to the job logs of the jobs specified for the <b>Watched job (WCHJOB)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HSTLOG</b></dt>
|
||
|
|
<dd>Watch messages added to the history log (QHST message queue in library QSYS).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 1: Message queue</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue to watch.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<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><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.WCHJOB"></a>
|
||
|
|
<h3>Watched job (WCHJOB)</h3>
|
||
|
|
<p>Specifies the job whose job log is watched for the messages specified on the WCHMSG parameter. The specified job will only be watched if *JOBLOG is specified on the WCHMSGQ parameter. Up to five job names may be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>Only the job log of the job that issued this trace command is watched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 1: Job name</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the job to be watched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 2: User</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the user name of the job to be watched. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic user name specifies all jobs with the specified job name and with user names that begin with the generic prefix.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the user name of the job to be watched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 3: Number</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All jobs with the specified job name and user name are watched.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>000001-999999</i></b></dt>
|
||
|
|
<dd>Specify the job number to further qualify the job name and user name. You cannot specify a job number if a generic job name or a generic user name qualifier is specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.WCHLICLOG"></a>
|
||
|
|
<h3>Watch for LIC log entry (WCHLICLOG)</h3>
|
||
|
|
<p>Specifies up to five licensed internal code (LIC) log entry identifiers which are to be watched for. Each LIC log entry contains a major and a minor code. The watched for condition will be met if a LIC log entry is added that matches the specified major and minor codes and any comparison data specified. When the watched for log entry is added to the LIC log, the trace exit program is called, even when the comparison data specified does not match; if no trace exit program is defined, the trace stops.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No LIC log entries will be watched for.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Major code</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Any LIC log entry major code will be considered to be a match. If *ALL is specified for the major code, you cannot specify *ALL for the LIC log entry minor code.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the LIC log major code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Minor code</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Any LIC log entry minor code will be considered to be a match. If *ALL is specified for the minor code, you cannot specify *ALL for the LIC log entry major code.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the LIC log minor code to be watched for. You can specify either a hexadecimal digit or a question mark for each character in the four-digit code. A question mark is a wildcard character that will match any digit in that position. Up to three wildcard characters can be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Comparison data</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify comparison data to be used if a log entry matching the specified major and minor codes is added to the licensed internal code (LIC) log. If this text is found in the LIC log entry data fields of the watched for log entry, the watched for condition is true. If this text is not found in the LIC log entry data fields of the watched for log entry and no exit program is specified on the TRCPGM parameter, the trace function continues. If the log entry matches the specified major and minor codes and an exit program is specified on the TRCPGM parameter, but the entry data does not contain the specified text, the exit program is called to determine if the trace should continue or stop.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No comparison data is specified. If a LIC log entry matching the specified major and minor codes is added to the LIC log, the watched for condition is true.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the text string used to compare against the entry data of the watched for log entry. If this text is found in the LIC log entry data fields compared of a watched for log entry, the watch condition is considered to be true. This text is case sensitive. The LIC log fields which can be compared are TDE number, task name, server type, job name, user ID, job number, thread ID, exception ID, LIC module compile timestamp, LIC module offset, LIC module RU name, LIC module name, LIC module entry point name. The comparison data cannot be used to match across two fields, and can match an entire field or a substring of any field.
|
||
|
|
<p>When watching for an exception ID, all four hexadecimal digits of the exception ID must be specified. Also, the prefix MCH may be specified if you want to compare only against the exception ID field and avoid possible substring matches with the other fields.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.WCHTIMO"></a>
|
||
|
|
<h3>Length of time to watch (WCHTIMO)</h3>
|
||
|
|
<p>Specifies the time limit, in minutes, for watching for a message or a licensed internal code (LIC) log entry. When the specified amount of time has elapsed, the trace exit program is called (if one was specified on the TRCPGM parameter), the trace is ended, and message CPI3999 is sent to the system operator message queue.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOMAX</u></b></dt>
|
||
|
|
<dd>There is no time limit for watching for a particular message or LIC log entry.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-43200</i></b></dt>
|
||
|
|
<dd>Specify the number of minutes that the trace will remain active while none of the watched for conditions have been met.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TRCPGM"></a>
|
||
|
|
<h3>Trace program (TRCPGM)</h3>
|
||
|
|
<p>Specifies the program to be called for user-defined trace commands and procedures.
|
||
|
|
</p>
|
||
|
|
<p>The trace program will be called:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Before the application trace starts.
|
||
|
|
</li>
|
||
|
|
<li>After a match of a message identifier specified for the WCHMSG parameter, or a match of a Licensed Internal Code (LIC) log entry specified for the WCHLICLOG parameter occurs.
|
||
|
|
</li>
|
||
|
|
<li>When the time interval specified on the TRCPGMITV parameter is reached.
|
||
|
|
</li>
|
||
|
|
<li>When the length of time to watch specified on WCHTIMO parameter is reached.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>There are three input parameters and one output parameter associated with the trace program. The four parameters are required:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
1 Trace option setting Input Char(10)
|
||
|
|
2 Reserved Input Char(10)
|
||
|
|
3 Error detected Output Char(10)
|
||
|
|
4 Comparison data Input Char(*)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Allowed values for the "Trace option setting" parameter are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ON</b></dt>
|
||
|
|
<dd>The watch for trace facility is starting when the collection of trace information is started.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MSGID</b></dt>
|
||
|
|
<dd>A match on a message id specified on WCHMSG parameter occurred.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LICLOG</b></dt>
|
||
|
|
<dd>A match on a LIC log specified on the WCHLICLOG parameter occurred.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CMPDATA</b></dt>
|
||
|
|
<dd>The major and minor code of a LIC log matched, but the comparison data did not.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INTVAL</b></dt>
|
||
|
|
<dd>The time interval specified on TRCPGMITV parameter is elapsed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*WCHTIMO</b></dt>
|
||
|
|
<dd>The length of time to watch specified on WCHTIMO parameter is elapsed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The "Reserved" parameter must be set to blanks.
|
||
|
|
</p>
|
||
|
|
<p>Allowed values for the "Error detected" parameter are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CONTINUE</b></dt>
|
||
|
|
<dd>The trace and the watch for trace event facility will continue running.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*STOP</b></dt>
|
||
|
|
<dd>The trace and the watch for trace event facility will be ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ERROR</b></dt>
|
||
|
|
<dd>Error detected by customer trace program.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>Allowed values for the "Comparison data" parameter when *MSGID is specified for the "Trace option setting" parameter will be the following structure:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OFFSET TYPE FIELD
|
||
|
|
Dec Hex
|
||
|
|
0 0 BINARY(4) Length of trace information
|
||
|
|
4 4 CHAR(7) Message ID
|
||
|
|
11 B CHAR(9) Reserved
|
||
|
|
20 14 BINARY(4) Offset to comparison data
|
||
|
|
24 18 BINARY(4) Length of comparison data
|
||
|
|
* * CHAR(*) Message comparison data
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Allowed values for the "Comparison data" parameter when *LICLOG or *CMPDATA is specified for the "Trace option setting" parameter will be the following structure:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OFFSET TYPE FIELD
|
||
|
|
Dec Hex
|
||
|
|
0 0 BINARY(4) Length of trace information
|
||
|
|
4 4 CHAR(4) LIC Log major code
|
||
|
|
8 8 CHAR(4) LIC Log minor code
|
||
|
|
12 C CHAR(8) LIC Log identifier
|
||
|
|
20 14 BINARY(4) Offset to comparison data
|
||
|
|
24 18 BINARY(4) Length of comparison data
|
||
|
|
* * CHAR(*) LIC log comparison data
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Allowed values for the "Comparison data" parameter when *ON, *INTVAL or *WCHTIMO is specified for the "Trace option setting" parameter will be the following structure:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
OFFSET TYPE FIELD
|
||
|
|
Dec Hex
|
||
|
|
0 0 BINARY(4) Length of trace information (always 4).
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>For more information on the trace exit program interface, refer to the System API Reference information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter .
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No trace exit program is defined. If a watched for message or licensed internal code (LIC) log entry is added, or if the specified watch time limit is exceeded, the trace function ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Trace program</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the trace exit program.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the user exit program is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TRCCNN.TRCPGMITV"></a>
|
||
|
|
<h3>Time interval (TRCPGMITV)</h3>
|
||
|
|
<p>Specifies how often the trace exit program will be called.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No time interval is specified. The trace exit program will not be called because a time interval has elapsed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-9999</i></b></dt>
|
||
|
|
<dd>Specify the interval of time, in seconds, of how often the trace exit program will be called. This must be less than the amount of time specified for the <b>Length of time to watch (WCHTIMO)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="TRCCNN.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Starting SSL Traces</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*SSL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for Secure Sockets Layer (SSL) connections.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Starting IP Traces</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*IP)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for connections at the internet protocol (IP) level.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Stopping Traces and Clearing Trace Storage</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*END)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops all traces and deletes the trace table. No spooled output is generated.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Printing Traces</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*OFF)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops all traces and generates a spooled file (QPCSMTRC) that contains the trace records collected by the TRCINT (Trace Internal) command, and a spooled file (QSYSPRT) that contains the formatted trace data.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Formatting Trace Data from TRCINT Command</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCINT SET(*ON) TRCTYPE(*SCK)
|
||
|
|
TRCINT SET(*OFF)
|
||
|
|
TRCCNN SET(*FORMAT) TRCTYPE(*SSL) JOB(*) SPLNBR(*LAST)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The TRCINT (Trace Internal) commands are used to start collecting trace records related to all usage of sockets, and to stop collecting trace records and create a spooled file named QPCSMPRT. The TRCCNN command will use the trace information in the last spooled file named QPCSMPRT for the current job, and format the trace records related to SSL (Secure Sockets Layer) in a spooled file named QSYSPRT.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Specifying a Trace Table</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*IP) TRCTBL(USER)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for connections at the internet protocol (IP) level and stores the trace data in the USER trace table.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Specifying a Trace Table Size in Megabytes</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*IP) SIZE(20000 *MB)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for connections at the internet protocol (IP) level and stores the data in a 20000-megabyte trace table.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 8: Specifying a CCSID for Trace Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*OFF) CCSID(*ASCII)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command stops all traces and generates a spooled file (QSYSPRT). ASCII (819) CCSID will be used when formatting the trace data.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 9: Start a Trace and Watch for a Message to End the Trace</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*IP) WCHMSG((MCH2804))
|
||
|
|
WCHMSGQ((*SYSOPR) (*JOBLOG))
|
||
|
|
WCHJOB((*ALL/MYUSER/MYJOBNAME))
|
||
|
|
TRCPGM(MYLIB/TRCEXTPGM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for connections at the internet protocol (IP) level. The trace will be ended when MCH2804 message is found on the System Operator message queue or within the *ALL/MYUSER/MYJOBNAME job log. Also, MYLIB/TRCEXTPGM is specified as a trace exit program.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 10: Start a Trace and Watch for a LIC Log Entry to End the Trace</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TRCCNN SET(*ON) TRCTYPE(*IP)
|
||
|
|
WCHLICLOG(('99??' 9932 MYJOBNAME))
|
||
|
|
WCHTIMO(*NOMAX)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command starts tracing for connections at the internet protocol (IP) level. The trace will be ended when a Licensed Internal Code (LIC) log entry that has a major code starting with 99 and a minor code of 9932 is generated on the system. Also, the LIC log information should contain the text "MYJOBNAME". *NOMAX on WCHTIMO parameter indicates that the trace will be active until the event occurs or TRCCNN command is issued manually to end the trace.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div>
|
||
|
|
<h3><a name="TRCCNN.ERROR.MESSAGES">Error messages</a></h3>Unknown
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TRCCNN.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|