friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/trcint.htm

2163 lines
89 KiB
HTML
Raw Permalink Blame History

<!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 Internal (TRCINT)</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="TRCINT.Top_Of_Page"></a>
<h2>Trace Internal (TRCINT)</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="#TRCINT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#TRCINT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#TRCINT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="TRCINT"></a>
<p>The Trace Internal (TRCINT) command is the command interface to the Trace Licensed Internal Code service tool and is used for problem analysis. Specific types of traces are started and stopped by using this command. While previously started internal traces are being performed, additional internal traces can be started through this command. The output created by the trace is placed in a trace table. The records from the trace table can be written to a spooled printer file, to a database file, or to tape or optical media.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<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>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="TRCINT.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="#TRCINT.SET"><b>SET</b></a></td>
<td valign="top">Trace option setting</td>
<td valign="top">*ON, *OFF, *END, *HOLD, *SAVE, *SIZE</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.TRCTBL"><b>TRCTBL</b></a></td>
<td valign="top">Trace table name</td>
<td valign="top"><i>Character value</i>, <b><u>*SYSDFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.SIZE"><b>SIZE</b></a></td>
<td valign="top">Trace table size</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b>, *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</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="#TRCINT.TRCFULL"><b>TRCFULL</b></a></td>
<td valign="top">Trace full</td>
<td valign="top"><b><u>*NOCHG</u></b>, *WRAP, *STOPTRC</td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.TRCTYPE"><b>TRCTYPE</b></a></td>
<td valign="top">Trace type</td>
<td valign="top">Values (up to 50 repetitions): 000000-999999, *SVL, *MPL, *TNS, *TTPERF, *ACTCALL, *ALTTCP, *APPCOVRTCP, *APPCPS, *APPNALL, *APPNCPM, *APPNCPPS, *APPNDS, *APPNLM, *APPNMST, *APPNTRS, *AUTMGT, *AUXSTGALL, *AUXSTGMGT, *BSSMGT, *CCIOM, *CLUE, *CMNACCMTH, *CMNTRC, *CMTMGT, *COMMON, *CRPSRV, *CSTALL, *CSTCMN, *CTXMGT, *DBGINT, *DBMGT, *DLUR, *DSPPASTHR, *EREP, *ERRLOG, *EVTMGT, *EXCMGT, *FRCA, *HDWRSC, *HEAPMGT, *IDXMGT, *IFS, *IPCF, *ISCSI, *ISDN, *JRNMGT, *LNKTST, *LODDMP, *MCHOBS, *MITFMALL, *MITFMEVAL, *MITFMHEAP, *MITFMINT, *MITFMMI, *MITFMSTG, *MODMGT, *MOD2, *MSCP, *MSMCALL, *MSMDTL, *M36ALL, *M36ASC, *M36BSC, *M36CSP, *M36DKT, *M36DSK, *M36ILAN, *M36PRT, *M36SDLC, *M36TAP, *M36TRN, *M36WS, *M36X25, *NTBTCP, *OPC, *PASE, *PFRCOLSRV, *PGMBND, *PGMMGT, *PORTUTIL, *PRCMGT, *PRCTBL, *PSEUDOTERM, *PWRMGT, *QMGT, *QSMGT, *RCYMGT, *RMTSPT, *RSCMGT, *SCK, *SCKASCIO, *SCKNET, *SCKOTHER, *SCKOVRMPTN, *SCKOVRPEC, *SCKRSLV, *SCKSEL, *SCKSSL, *SCKSTDIO, *SIG, *SMBSVR, *SPCOBJMGT, *SRCSINK, *STGMGTALL, *STM, *SYNCMGT, *SYSCALL, *SYSJRNMGT, *TCPIP, *TLI, *TRXMGT, *VRTDEVMGT, *VRTIO</td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#TRCINT.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b><br>Other values (up to 10 repetitions): <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>Generic name, name</i>, *ALL</td>
</tr><tr>
<td valign="top">Qualifier 2: User</td>
<td valign="top"><i>Generic name, name</i>, *ALL</td>
</tr><tr>
<td valign="top">Qualifier 3: Number</td>
<td valign="top">000000-999999, *ALL</td>
</tr><tr>
<td valign="top"><a href="#TRCINT.SLTTHD"><b>SLTTHD</b></a></td>
<td valign="top">Thread ID to include</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b>, *ALL, *SELECT<br>Other values (up to 20 repetitions): <i>Hexadecimal value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.SVRTYPE"><b>SVRTYPE</b></a></td>
<td valign="top">Server type</td>
<td valign="top">Single values: *ALL, <b><u>*NOCHG</u></b><br>Other values (up to 5 repetitions): <i>Generic name, name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.TASK"><b>TASK</b></a></td>
<td valign="top">Task name</td>
<td valign="top">Single values: *ALL, <b><u>*NOCHG</u></b><br>Other values (up to 10 repetitions): <i>Generic name, name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.TASKNBR"><b>TASKNBR</b></a></td>
<td valign="top">Task number</td>
<td valign="top">Single values: *ALL, <b><u>*NOCHG</u></b><br>Other values (up to 10 repetitions): <i>Hexadecimal value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.SLTTRCPNT"><b>SLTTRCPNT</b></a></td>
<td valign="top">Select trace points</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Trace point qualifier</td>
<td valign="top">
0-65535</td>
</tr>
<tr>
<td valign="top">Element 2: To trace point qualifier</td>
<td valign="top">
0-65535</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.OMTTRCPNT"><b>OMTTRCPNT</b></a></td>
<td valign="top">Omit trace points</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Trace point qualifier</td>
<td valign="top">
0-65535</td>
</tr>
<tr>
<td valign="top">Element 2: To trace point qualifier</td>
<td valign="top">
0-65535</td>
</tr>
<tr>
<td valign="top" rowspan="6"><a href="#TRCINT.STOPTRCPNT"><b>STOPTRCPNT</b></a></td>
<td valign="top">Stop on trace point</td>
<td valign="top">Single values: <b><u>*NOCHG</u></b><br>Other values (up to 4 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="6">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Trace point type</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Trace point qualifier</td>
<td valign="top">
0-65535</td>
</tr>
<tr>
<td valign="top">Element 3: Trace point entry</td>
<td valign="top">
1-65535</td>
</tr>
<tr>
<td valign="top">Element 4: Trace point entry offset</td>
<td valign="top">
<i>Hexadecimal value</i></td>
</tr>
<tr>
<td valign="top">Element 5: Trace point match value</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.JOBTYPE"><b>JOBTYPE</b></a></td>
<td valign="top">Job types</td>
<td valign="top">Single values: *NONE, *ALL<br>Other values (up to 12 repetitions): <b><u>*DFT</u></b>, *ASJ, *BCH, *EVK, *INT, *MRT, *RDR, *SBS, *SYS, *WTR, *PDJ, *PJ, *BCI</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.JOBTRCITV"><b>JOBTRCITV</b></a></td>
<td valign="top">Job trace interval</td>
<td valign="top">0.1-9.9, <b><u>0.5</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="8"><a href="#TRCINT.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="8">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">Element 7: Line type</td>
<td valign="top">
*PPP, *OPC</td>
</tr>
<tr>
<td valign="top" rowspan="5"><a href="#TRCINT.SCKDTA"><b>SCKDTA</b></a></td>
<td valign="top">Sockets data</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="5">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Address family</td>
<td valign="top">
*INET, *UNIX, *INET6, *NETBIOS</td>
</tr>
<tr>
<td valign="top">Element 2: Socket type</td>
<td valign="top">
*STREAM, *DGRAM, *RAW, *SEQPACKET</td>
</tr>
<tr>
<td valign="top">Element 3: Descriptor</td>
<td valign="top">
Values (up to 2 repetitions): 0-65535</td>
</tr>
<tr>
<td valign="top">Element 4: Socket option</td>
<td valign="top">
*SODEBUG</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 16 repetitions): <i>Name</i></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.CTL"><b>CTL</b></a></td>
<td valign="top">Controller</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 16 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Controller</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Attached devices</td>
<td valign="top">
<b><u>*NODEV</u></b>, *ALLDEV</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.LIN"><b>LIN</b></a></td>
<td valign="top">Line</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 16 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Line</td>
<td valign="top">
<i>Name</i></td>
</tr>
<tr>
<td valign="top">Element 2: Attached controllers</td>
<td valign="top">
<b><u>*NOCTL</u></b>, *ALLCTL</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.NWI"><b>NWI</b></a></td>
<td valign="top">Network interface</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 16 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.NWS"><b>NWS</b></a></td>
<td valign="top">Network server</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 16 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource name</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 10 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.OUTDEV"><b>OUTDEV</b></a></td>
<td valign="top">Output device</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.TASKINF"><b>TASKINF</b></a></td>
<td valign="top">Task information</td>
<td valign="top">*ALL, <b><u>*TRCREF</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#TRCINT.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*PRINT</u></b>, *OUTFILE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#TRCINT.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="#TRCINT.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" rowspan="4"><a href="#TRCINT.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="#TRCINT.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="#TRCINT.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="#TRCINT.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="#TRCINT.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="#TRCINT.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="#TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="TRCINT.SET"></a>
<h3>Trace option setting (SET)</h3>
<p>Specifies whether internal tracing is started, stopped, ended, held, or saved. You can also specify whether the trace table size is changed.
</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 for the <b>Trace type (TRCTYPE)</b> parameter. If the trace table already contains trace records, the new trace records are added to the table. If the table is full, the action specified for the <b>Trace full (TRCFULL)</b> parameter is taken. If a trace table name other than *SYSDFT is specified for the TRCTBL parameter and the table does not exist, it will be automatically created.
</dd>
<dt><b>*OFF</b></dt>
<dd>Collection of internal trace records requested through previous Trace Internal (TRCINT) commands stops, and the records are written to the spooled printer file QPCSMPRT or sent to a database file as indicated by <b>Output (OUTPUT)</b> parameter.
</dd>
<dt><b>*END</b></dt>
<dd>Internal tracing ends and the internal trace records are deleted. No spooled output is generated. If a trace table name other than *SYSDFT is specified for the TRCTBL parameter, it will be automatically deleted.
</dd>
<dt><b>*HOLD</b></dt>
<dd>Internal traces are stopped, and the collected internal trace records are held in the trace table. Held records can be printed later if another Trace Internal (TRCINT) command is entered that specifies *OFF for this prompt; or, the held records can be put on tape or optical media if *SAVE is specified.
</dd>
<dt><b>*SAVE</b></dt>
<dd>Internal traces are stopped, and the trace records are written to a tape or optical device specified by the OUTDEV parameter.
</dd>
<dt><b>*SIZE</b></dt>
<dd>The size of the trace table is changed. The new size is specified on the <b>Trace table size (SIZE)</b> parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TRCTBL"></a>
<h3>Trace table name (TRCTBL)</h3>
<p>Specifies the trace table to hold the collected trace data.
</p>
<dl>
<dt><b><u>*SYSDFT</u></b></dt>
<dd>The system default trace table is used.
</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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.SIZE"></a>
<h3>Trace table size (SIZE)</h3>
<p>Specifies the size of the trace table. This parameter can be specified only when *SIZE is specified for the <b>Trace option setting (SET)</b> parameter or if SET(*ON) is specified and tracing is not currently active for the trace table specified (TRCTBL parameter).
</p>
<p>
<b>Note: </b>The storage indicated on this parameter is immediately allocated from the system auxiliary storage pool (ASP 1). This storage 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><u>*NOCHG</u></b></dt>
<dd>The trace table size is not changed. If a new trace table is specified (TRCTBL parameter), a default size of 128 kilobytes will be used.
</dd>
<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 128 kilobytes.
</dd>
</dl>
<p><b>Element 1: Number of units</b>
</p>
<p>Specify the size of the trace table.
</p>
<dl>
<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. The valid range is 128 through 998000.
</dd>
<dt><b>*MB</b></dt>
<dd>The trace table size is specified in megabytes. The valid range is 1 through 258048.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TRCFULL"></a>
<h3>Trace full (TRCFULL)</h3>
<p>Specifies whether the trace records wrap (replace the oldest records with new records) or tracing stops when the trace table is full. This parameter can be specified when *ON is specified for the <b>Trace option setting (SET)</b> parameter.
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The trace table full action is not changed. If a new trace table is specified (TRCTBL parameter), the default action is for trace records to wrap when the trace table becomes full.
</dd>
<dt><b>*WRAP</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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TRCTYPE"></a>
<h3>Trace type (TRCTYPE)</h3>
<p>Specifies the type of traces to start. The two groups of trace types are:
</p>
<ul>
<li>Component data trace codes cause active procedures to be traced within the system.
</li>
<li>General trace codes cause the iSeries instruction supervisor linkage, multiprogramming, transaction, or task and thread performance functions to be traced.
</li>
</ul>
<p>If trace code types are specified, *ON must be specified for the <b>Trace option setting (SET)</b> parameter. If a value other than *ON is specified for the SET parameter, TRCTYPE is ignored. Each trace type is identified by a special value or 6-digit code; all 6 digits must be specified. For a complete list of trace codes and special values, position the cursor on this parameter while prompting this command and press F4. Specify up to 50 types from the following code table:
</p>
<p>
<pre>
COMPONENT
OR GENERAL SPECIAL
TYPE OF TRACE TRACE CODE VALUE
MI instruction supervisor 030000 *SVL
linkage (SVL)
Multiprogramming level (MPL) 040000 *MPL
Transaction 080000 *TNS
Task/thread performance 090000 *TTPERF
Activation/Call 014400 *ACTCALL
Alternate TCP/IP stack 016900 *ALTTCP
MPTN - APPC over TCP/IP MPTN 014203 *APPCOVRTCP
APPC presentation services 014301 *APPCPS
APPN -- (all) 012506 *APPNALL
APPN control point management 012501 *APPNCPM
APPN control point 012504 *APPNCPPS
presentation services
APPN directory services 012502 *APPNDS
APPN location management 012505 *APPNLM
APPN management services 012507 *APPNMST
transport
APPN topology and routing 012503 *APPNTRS
services
Authority management 010900 *AUTMGT
Auxiliary storage management 011104 *AUXSTGALL
-- detailedd
Auxiliary storage management 011101 *AUXSTGMGT
Byte string space management 012600 *BSSMGT
Common class input/output 011900 *CCIOM
management (CCIOM)
Cluster engine 016402 *CLUE
Communications access method 015900 *CMNACCMTH
Commit management 011700 *CMTMGT
Communications trace service 012300 *CMNTRC
function
Common functions 011200 *COMMON
Cryptographic services 013600 *CRPSRV
Cluster -- (all) 016400 *CSTALL
Cluster communications 016401 *CSTCMN
Context management 011000 *CTXMGT
Debugger interpreter 014500 *DBGINT
Database management (events 010400 *DBMGT
for all database files are
traced)
Dependent LU Requester 015400 *DLUR
(DLUR) Communication
Display station pass-through 010804 *DSPPASTHR
Environmental recording, 012200 *EREP
editing and printing (EREP)
</pre>
</p>
<p>
<pre>
Error log 012100 *ERRLOG
Event management 010600 *EVTMGT
Exception management 010200 *EXCMGT
Fast Response Cache Accelerator 016600 *FRCA
Hardware resources 014700 *HDWRSC
Heap management 013400 *HEAPMGT
Independent index management 011400 *IDXMGT
Integrated File System (IFS) 014800 *IFS
Inter-process communications 012000 *IPCF
facility (IPCF)
Internet SCSI host adapter 017000 *ISCSI
Communications answer 012700 *ISDN
management (ISDN)
Journal management 011600 *JRNMGT
Link test service function 012400 *LNKTST
Load/dump (save/restore) 010801 *LODDMP
Machine observation 011300 *MCHOBS
Machine Interface (MI) Transformer 015100 *MITFMALL
MI Transformer - expression 015101 *MITFMEVAL
evaluation
MI Transformer - heap operations 015102 *MITFMHEAP
MI Transformer - interpreter 015103 *MITFMINT
instructions
MI Transformer - MI Instructions 015104 *MITFMMI
MI Transformer - storage 015105 *MITFMSTG
management operations
Module management 013100 *MODMGT
Modula-2 run time support 012800 *MOD2
Machine services control 010802 *MSCP
point
Main storage management 011102 *MSMCALL
-- calls
Main storage management 011103 *MSMDTL
-- details
NetBios on TCP/IP 015700 *NTBTCP
OptiConnect 015500 *OPC
Portable Application Solutions 016100 *PASE
Environment
Performance collection services 016200 *PFRCOLSRV
Program binder 013200 *PGMBND
Program management 010300 *PGMMGT
Portability utilities 015200 *PORTUTIL
Process management 010500 *PRCMGT
Process table 015300 *PRCTBL
Pseudo terminal component 016500 *PSEUDOTERM
Power management 012900 *PWRMGT
Queue management 010700 *QMGT
Queue space management 013300 *QSMGT
Recovery management 013500 *RCYMGT
Remote Support 016300 *RMTSPT
Resource management 010100 *RSCMGT
Sockets -- (all APIs) 014000 *SCK
Sockets Asynchronous and Overlapped 014002 *SCKASCIO
Input/Output APIs
Sockets Network APIs 014004 *SCKNET
Other Socket APIs 014007 *SCKOTHER
MPTN AF_INET Sockets over 014201 *SCKOVRMPTN
SNA MPTN
MPTN AF_INET Sockets over 014202 *SCKOVRPEC
SNA PEC
Sockets Berkeley Resolver APIs 014005 *SCKRSLV
Sockets Select API 014003 *SCKSEL
Secure Sockets Layer (SSL) APIs 014006 *SCKSSL
Sockets Standard Input/Output APIs 014001 *SCKSTDIO
Signals 015600 *SIG
SMB server 015800 *SMBSVR
Space object management 011500 *SPCOBJMGT
Source/sink (device support) 010803 *SRCSINK
management
Storage management -- (all) 011105 *STGMGTALL
Streams 013900 *STM
Synchronization management 013700 *SYNCMGT
MI system call 015200 *SYSCALL
System journal management 014100 *SYSJRNMGT
Transmission Control Protocol/ 013800 *TCPIP
Internet Protocol (TCP/IP)
Transport Layer Interface 016000 *TLI
Transaction Management 016800 *TRXMGT
Virtual I/O 016700 *VRTIO
Virtual terminal management 013000 *VRTDEVMGT
</pre>
</p>
<p>
<b>Note: </b>If *TTPERF trace code is specified, it must be the first one in the TRCTYPE parameter list.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the jobs from which trace records are to be collected. Only trace records which are generated in the specified job(s) are collected. A list of up to ten qualified job names can be specified. The trace records will be collected if they were generated from a job that matches any of the qualified job name values.
</p>
<p>This parameter can be specified when *ON is specified for the <b>Trace option setting (SET)</b> parameter. If a value other than *ON is specified on the SET parameter, JOB is ignored.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>If any qualified job names had been specified for the JOB parameter on a previous TRCINT command for an active trace, the job name filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL/*ALL/*ALL for the JOB parameter.
</dd>
</dl>
<p><b>Qualifier 1: Job name</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of what job name the trace record was generated from.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the job from which trace records are to be collected. 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 name that begin with the generic prefix.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job from which trace records are to be collected.
</dd>
</dl>
<p><b>Qualifier 2: User</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of what job user name the trace record was generated from.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic user name of the job from which trace records are to be collected. 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 user names that begin with the generic prefix.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user of the job from which trace records are to be collected.
</dd>
</dl>
<p><b>Qualifier 3: Number</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of what job number the trace record was generated from. *ALL for the job number is considered to be a generic job specification because it will trace all jobs that meet the job name and job user name qualifiers that you specified.
</dd>
<dt><b><i>000000-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 generic user name is specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.SLTTHD"></a>
<h3>Thread ID to include (SLTTHD)</h3>
<p>Specifies the job threads from which trace records are to be collected. Only trace records which are generated in the specified thread(s) are collected. There can be only one job that has thread IDs associated with it. It must be the first qualified job name specified for the JOB parameter, and the job must be active.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>If any thread identifiers had been specified for the SLTTHD parameter on a previous TRCINT command for an active trace, the thread ID filtering information is not changed. If no value was specified on a previous TRCINT command for an active trace, *NOCHG will behave the same as *ALL for this parameter.
</dd>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of what thread ID the trace record was generated from.
</dd>
<dt><b>*SELECT</b></dt>
<dd>A list of thread identifiers is shown from which you can select up to twenty threads. Trace records from any of the selected thread identifiers are to be collected. *SELECT is only valid if the TRCINT command is run in an interactive job.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>hexadecimal-value</i></b></dt>
<dd>Specify the identifier of the thread from which trace records are to be collected. Up to twenty thread identifiers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.SVRTYPE"></a>
<h3>Server type (SVRTYPE)</h3>
<p>Specifies the server type attribute for a job or task which is used to determine whether the trace record is collected. Only trace records which are generated in a job or task with the specified server type are collected. For a list of possible server types, see Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>If a value was specified for the server type on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.
</dd>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of the server type attribute of the job or task the trace record was generated from.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>generic-name</i></b></dt>
<dd>Specifies the generic server type for which trace records are to be collected. 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 server type specifies all jobs with a server type that begins with the generic prefix.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the server type for which trace records are to be collected. A list of up to five server types can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TASK"></a>
<h3>Task name (TASK)</h3>
<p>Specifies the Licensed Internal Code (LIC) tasks from which trace records are to be collected. Only trace records which are generated from the specified LIC tasks are collected.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>If a value was specified for the task name (TASK parameter) on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for the task name.
</dd>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of what LIC task the trace record was generated from.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the LIC tasks for which trace records are to be collected. 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 task name specifies all tasks with task names that begin with the generic prefix.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the LIC task for which trace records are to be collected. Up to ten LIC task names can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TASKNBR"></a>
<h3>Task number (TASKNBR)</h3>
<p>Specifies the Licensed Internal Code (LIC) task numbers from which trace records are to be collected. Only trace records which are generated in the specified LIC tasks are collected.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>If a value was specified for the task number on a previous TRCINT command for an active trace, the value is not changed. If no value was specified on a previous TRCINT command, *NOCHG will behave the same as *ALL for this parameter.
</dd>
<dt><b>*ALL</b></dt>
<dd>All trace records generated by the defined trace are collected, regardless of the task number of the LIC task the trace record was generated from.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>hexadecimal-value</i></b></dt>
<dd>Specify a LIC task number for which trace records are to be collected. A list of up to ten task numbers can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.SLTTRCPNT"></a>
<h3>Select trace points (SLTTRCPNT)</h3>
<p>Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be included. Trace records for trace points not specified on SLTTRCPNT will not be collected. If SLTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are being collected.
</p>
<p>
<b>Note: </b>This parameter and the OMTTRCPNT parameter are mutually exclusive. SLTTRCPNT cannot be specified for an active trace table that is using OMTTRCPNT to exclude specific trace points.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The list of trace points for which trace records are being collected does not change.
</dd>
</dl>
<p><b>Element 1: Trace point qualifier</b>
</p>
<dl>
<dt><b><i>0-65535</i></b></dt>
<dd>Specify a single trace point qualifier or the start of a range of trace point qualifiers whose trace records are to be included. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.
</dd>
</dl>
<p><b>Element 2: To trace point qualifier</b>
</p>
<dl>
<dt><b><i>0-65535</i></b></dt>
<dd>Specify the end of a range of trace point qualifiers whose trace records are to be included. A value should not be specified for this parameter element if only a single trace point is to be included.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.OMTTRCPNT"></a>
<h3>Omit trace points (OMTTRCPNT)</h3>
<p>Specifies a list of up to five individual trace points or trace point ranges whose trace records are to be excluded. Trace records for all trace points not specified on OMTTRCPNT will be collected. If OMTTRCPNT is specified for a trace table that is currently active, the specified trace points will be added to the set of trace points for which trace records are not being collected.
</p>
<p>
<b>Note: </b>This parameter and the SLTTRCPNT parameter are mutually exclusive. OMTTRCPNT cannot be specified for an active trace table that is using SLTTRCPNT to include only specific trace points.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The list of trace points for which trace records are being excluded does not change.
</dd>
</dl>
<p><b>Element 1: Trace point qualifier</b>
</p>
<dl>
<dt><b><i>0-65535</i></b></dt>
<dd>Specify a single trace point qualifier or the start of a range of trace point qualifiers whose trace records are to be excluded. Up to five individual trace point qualifiers or trace point qualifier ranges may be specified.
</dd>
</dl>
<p><b>Element 2: To trace point qualifier</b>
</p>
<dl>
<dt><b><i>0-65535</i></b></dt>
<dd>Specify the end of a range of trace point qualifiers whose trace records are to be excluded. A value should not be specified for this parameter element if only a single trace point is to be excluded.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.STOPTRCPNT"></a>
<h3>Stop trace points (STOPTRCPNT)</h3>
<p>Specifies one or more trace points which, if they are encountered, will cause collection of trace records to stop. The trace table records are not deleted and can later be written to a spooled file or an output device by invoking TRCINT with SET(*OFF) or SET(*SAVE).
</p>
<p>Up to four trace points may be specified. Tracing will be stopped if any of the specified trace points match a trace record being added to the specified trace table.
</p>
<p>A specified trace point can have either two parts (trace point type and trace point qualifier) or five parts (trace point type, trace point qualifier, trace point entry number, trace point entry offset, and trace point match value). A two-part condition will stop trace data collection if any trace record is collected for the specified trace point. A five-part condition will stop trace data collection only if the specified trace point match value exactly matches the data at the specified trace point entry offset.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NOCHG</u></b></dt>
<dd>The list of stop trace points associated with the trace table does not change.
</dd>
</dl>
<p><b>Element 1: Trace point type</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the two-character trace point type.
</dd>
</dl>
<p><b>Element 2: Trace point qualifier</b>
</p>
<dl>
<dt><b><i>0-65535</i></b></dt>
<dd>Specify the trace point qualifier number.
</dd>
</dl>
<p><b>Element 3: Trace point entry</b>
</p>
<dl>
<dt><b><i>1-65535</i></b></dt>
<dd>Specify the trace point entry number.
</dd>
</dl>
<p><b>Element 4: Trace point entry offset</b>
</p>
<dl>
<dt><b><i>hexadecimal-value</i></b></dt>
<dd>Specify the offset (in hexadecimal) in the trace point entry.
</dd>
</dl>
<p><b>Element 5: Trace point match value</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the match value to be compared to the trace record data. The match value may be specified in character or hexadecimal. Character strings will be converted to the equivalent hexadecimal strings.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.JOBTYPE"></a>
<h3>Job types (JOBTYPE)</h3>
<p>Specifies the types of jobs for which trace data is to be collected for use in the batch job trace report. A maximum of 11 job types can be specified. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.
</p>
<p>
<b>Note: </b>The value *DFT includes the values *ASJ, *BCH, *EVK, *MRT, *PDJ, *PJ and *BCI. The value *BCH includes the values *EVK, *MRT, *PDJ, *PJ, and *BCI.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No jobs are traced.
</dd>
<dt><b>*ALL</b></dt>
<dd>All of the job types are traced.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>Batch and autostart jobs are traced.
</dd>
<dt><b>*ASJ</b></dt>
<dd>Autostart jobs are traced.
</dd>
<dt><b>*BCH</b></dt>
<dd>Batch jobs are traced.
</dd>
<dt><b>*EVK</b></dt>
<dd>Jobs started by a procedure start request are traced.
</dd>
<dt><b>*INT</b></dt>
<dd>Interactive jobs are traced.
</dd>
<dt><b>*MRT</b></dt>
<dd>Multiple requester terminal jobs are traced.
</dd>
<dt><b>*RDR</b></dt>
<dd>Reader jobs are traced.
</dd>
<dt><b>*SBS</b></dt>
<dd>Subsystem monitor jobs are traced.
</dd>
<dt><b>*SYS</b></dt>
<dd>System jobs are traced.
</dd>
<dt><b>*WRT</b></dt>
<dd>Writer jobs are traced.
</dd>
<dt><b>*PDJ</b></dt>
<dd>Print driver jobs are traced.
</dd>
<dt><b>*PJ</b></dt>
<dd>Prestart jobs are traced.
</dd>
<dt><b>*BCI</b></dt>
<dd>Batch Immediate jobs are traced.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.JOBTRCITV"></a>
<h3>Job trace interval (JOBTRCITV)</h3>
<p>Specifies the time (in CPU seconds) between each collection of the job trace data. This parameter can be specified only if TRCTYPE(*MPL) or TRCTYPE(040000) is specified.
</p>
<dl>
<dt><b><u>0.5</u></b></dt>
<dd>A time slice interval value of 0.5 CPU seconds is used.
</dd>
<dt><b><i>0.1-9.9</i></b></dt>
<dd>Specify the number of CPU seconds to be used as the trace interval value.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TCPDTA"></a>
<h3>TCP/IP data (TCPDTA)</h3>
<p>Specifies whether a subset of TCP/IP and/or Sockets trace data should be collected. This parameter can be specified only if TRCTYPE(*TCPIP) or TRCTYPE(013800) or TRCTYPE(*SMBSVR) or TRCTYPE(015800) or TRCTYPE(*FRCA) or TRCTYPE(016600) is specified, or if one or more of the socket trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of TCP/IP and/or Sockets trace data is done for that element. For example, if *UDP is specified for element 1, only trace records where the UDP protocol is used are collected. If no value is specified for element 1, trace records using all TCP/IP protocols are collected.
</p>
<p>If no values are specified for any element of TCPDTA and tracing of TCP/IP or Sockets data was not already active, no filtering of TCP/IP or Sockets trace data is done. If tracing of TCP/IP or Sockets data was already active and no TCPDTA values are specified, previous data filtering values will remain in effect.
</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>
<p>Specify one or two local port numbers for which trace data is collected.
</p>
<p><b>Element 3: Remote port</b>
</p>
<p>Specify one or two remote port numbers for which trace data is collected.
</p>
<p><b>Element 4: Local IP address</b>
</p>
<p>Specify a local internet protocol address.
</p>
<p><b>Element 5: Remote IP address</b>
</p>
<p>Specify a remote internet protocol address.
</p>
<p><b>Element 6: Line description</b>
</p>
<p>Specify the name of a line description for which TCP/IP trace data is to be collected.
</p>
<p><b>Element 7: Line type</b>
</p>
<p>Specify whether the collection of trace information should be restricted to the specified line type.
</p>
<dl>
<dt><b>*PPP</b></dt>
<dd>The collection of trace information is restricted to Point-to-point lines.
</dd>
<dt><b>*OPC</b></dt>
<dd>The collection of trace information is restricted to Opticonnect.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.SCKDTA"></a>
<h3>Sockets data (SCKDTA)</h3>
<p>Specifies whether a subset of Sockets trace data should be collected. This parameter can be specified only if one or more of the socket trace types is specified (*SCK, *SCKSTDIO, *SCKASCIO, *SCKSEL, *SCKNET, *SCKRSLV, *SCKSSL, *SCKOTHER or 014000, 014001, 014002, 014003, 014004, 014005, 014006, 014007). Each parameter element is optional; if no element value is specified, no filtering of Sockets trace data is done for that element. For example, if *INET is specified for element 1, only trace records where the AF_INET address family is used are collected. If no value is specified for element 1, trace records using all socket address families are collected.
</p>
<p>If no values are specified for any element of SCKDTA and tracing of Sockets data was not already active, no filtering of Sockets trace data is done. If tracing of Sockets data was already active and no SCKDTA values are specified, previous data filtering values will remain in effect.
</p>
<p>The subset values specified on the SCKDTA parameter are used in combination with any subset values specified on the TCPDTA parameter to generate the complete subsetting criteria.
</p>
<p><b>Element 1: Address family</b>
</p>
<p>Specify a sockets address family for which trace data is collected.
</p>
<dl>
<dt><b>*INET</b></dt>
<dd>Enable trace for AF_INET address family.
</dd>
<dt><b>*UNIX</b></dt>
<dd>Enable trace for AF_UNIX and AF_UNIX_CCSID address families.
</dd>
<dt><b>*INET6</b></dt>
<dd>Enable trace for AF_INET6 address family.
</dd>
<dt><b>*NETBIOS</b></dt>
<dd>Enable trace for AF_NETBIOS address family.
</dd>
</dl>
<p><b>Element 2: Socket type</b>
</p>
<p>Specify a socket type for which trace data is collected.
</p>
<dl>
<dt><b>*STREAM</b></dt>
<dd>Enable trace for SOCK_STREAM (full-duplex stream) socket type.
</dd>
<dt><b>*DGRAM</b></dt>
<dd>Enable trace for SOCK_DGRAM (datagram) socket type.
</dd>
<dt><b>*RAW</b></dt>
<dd>Enable trace for SOCK_RAW (direct to network protocol) socket type.
</dd>
<dt><b>*SEQPACKET</b></dt>
<dd>Enable trace for SOCK_SEQPACKET (full-duplex sequenced packet) socket type.
</dd>
</dl>
<p><b>Element 3: Descriptor</b>
</p>
<p>Specify one or two socket descriptor numbers for which trace data is collected.
</p>
<p><b>Element 4: Socket option</b>
</p>
<p>Specify a socket option for which trace data is collected.
</p>
<dl>
<dt><b>*SODEBUG</b></dt>
<dd>Applications with the SO_DEBUG Socket Option set on will have trace data collected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the names of the devices for which the associated internal events are traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the <b>Trace type (TRCTYPE)</b> parameter. Up to 16 device names may be specified.
</p>
<p>The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the DEV parameter, you cannot enter values for the other parameters.
</p>
<p>The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
</p>
<ul>
<li>specifying SET(*ON) multiple times for the same trace table
</li>
<li>specifying *ALLDEV on the CTL parameter
</li>
<li>specifying *ALLCTL on the LIN parameter
</li>
</ul>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No devices are traced by this command.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the device for which the internal trace is started. The device name must be the same as the name specified in the associated device description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.CTL"></a>
<h3>Controller (CTL)</h3>
<p>Specifies the names of the controllers for which the associated internal events are to be traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the <b>Trace type (TRCTYPE)</b> parameter. Up to 16 controller names may be specified.
</p>
<p>The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the CTL parameter, you cannot enter values for the other parameters.
</p>
<p>The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
</p>
<ul>
<li>specifying SET(*ON) multiple times for the same trace table
</li>
<li>specifying *ALLDEV on the CTL parameter
</li>
<li>specifying *ALLCTL on the LIN parameter
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No controllers are traced by this command.
</dd>
</dl>
<p><b>Element 1: Controller</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the controller for which the internal trace is started. The controller names must be the same as the names specified in the associated controller description.
</dd>
</dl>
<p><b>Element 2: Attached devices</b>
</p>
<p>Specifies if the devices on a controller are traced.
</p>
<dl>
<dt><b><u>*NODEV</u></b></dt>
<dd>No attached devices for the specified controller are traced.
</dd>
<dt><b>*ALLDEV</b></dt>
<dd>All attached devices for the specified controller are traced. The attached devices do not count toward the maximum of 16 source/sink objects that can be named on the DEV,CTL,LIN,NWI and NWS parameters. However, the attached devices do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.LIN"></a>
<h3>Line (LIN)</h3>
<p>Specifies the names of the lines for which the associated internal events are to be traced. This parameter can be specified only if 010803 is specified on the <b>Trace type (TRCTYPE)</b> parameter. Up to 16 line names may be specified.
</p>
<p>The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
</p>
<p>The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
</p>
<ul>
<li>specifying SET(*ON) multiple times for the same trace table
</li>
<li>specifying *ALLDEV on the CTL parameter
</li>
<li>specifying *ALLCTL on the LIN parameter
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No lines are traced by this command.
</dd>
</dl>
<p><b>Element 1: Line</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the line for which the internal trace is started. The line name must be the same as the name specified in the associated line description.
</dd>
</dl>
<p><b>Element 2: Attached controllers</b>
</p>
<p>Specifies if the controllers on a line are traced.
</p>
<dl>
<dt><b><u>*NOCTL</u></b></dt>
<dd>No attached controllers for the specified line are traced.
</dd>
<dt><b>*ALLCTL</b></dt>
<dd>All attached controllers for the specified line are traced. The attached controllers do not count toward the maximum of 16 source/sink objects that can be named on the DEV,CTL,LIN,NWI and NWS parameters. However, the attached controllers do count toward the maximum of 256 source/sink objects that can be traced in a single trace table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.NWI"></a>
<h3>Network interface (NWI)</h3>
<p>Specifies the names of the network interfaces for which the associated internal events are to be traced. This parameter can be specified only if 010803 or *SRCSINK is specified for the <b>Trace type (TRCTYPE)</b> parameter. Up to 16 network interface names may be specified.
</p>
<p>The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
</p>
<p>The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
</p>
<ul>
<li>specifying SET(*ON) multiple times for the same trace table
</li>
<li>specifying *ALLDEV on the CTL parameter
</li>
<li>specifying *ALLCTL on the LIN parameter
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No network interfaces are traced by this command.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the network interface for which the internal trace is started. The network interface name must be the same as the name specified in the associated network interface description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.NWS"></a>
<h3>Network Server (NWS)</h3>
<p>Specifies the names of the network servers for which the associated internal events are traced. This parameter can be specified only if 010803 or *SRCSINK is specified on the <b>Trace type (TRCTYPE)</b> parameter. Up to 16 network server names may be specified.
</p>
<p>The total number of source/sink objects that can be named on the device(DEV), controller(CTL), line(LIN), network interface(NWI) and network server(NWS) parameters is 16. For example, if you enter 16 values for the LIN parameter, you cannot enter values for the other parameters.
</p>
<p>The maximum number of source/sink objects that can be traced in a single trace table is 256. Even if you stay within the limit of 16 named source/sink objects on one TRCINT command, you may exceed the 256 source/sink object limit. Examples of ways to exceed the limit are:
</p>
<ul>
<li>specifying SET(*ON) multiple times for the same trace table
</li>
<li>specifying *ALLDEV on the CTL parameter
</li>
<li>specifying *ALLCTL on the LIN parameter
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No network servers are traced by this command.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the network server for which the internal trace is started. The network server name must be the same as the name specified in the associated network server description.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.RSRCNAME"></a>
<h3>Hardware Resource (RSRCNAME)</h3>
<p>Specifies the names of the hardware resources for which the associated internal events are traced. This parameter can be specified only if 014700 or 011900 is specified on the <b>Trace type (TRCTYPE)</b> parameter.
</p>
<p>
<b>Note: </b>A combined total of 10 hardware resources (RSRCNAME) are allowed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No hardware resources are traced by this command.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the names of up to 10 hardware resources for which the internal trace is started.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.OUTDEV"></a>
<h3>Device (OUTDEV)</h3>
<p>Specifies the tape device or optical device on which the held trace records are written. This parameter must be specified if *SAVE is specified for the <b>Trace option setting (SET)</b> parameter.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the device description of the tape or optical device.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.TASKINF"></a>
<h3>Task information (TASKINF)</h3>
<p>Specifies whether information for all licensed internal code (LIC) tasks is written to a spooled file or output device. This parameter can be specified if SET(*OFF) or SET(*SAVE) is specified.
</p>
<dl>
<dt><b><u>*TRCREF</u></b></dt>
<dd>Write information only for LIC tasks that were referenced by trace records in the specified trace table.
</dd>
<dt><b>*ALL</b></dt>
<dd>Write information for all LIC tasks that were in existence while the trace was active.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is printed with the job's spooled output or sent to a database file.
</p>
<dl>
<dt><b><u>*PRINT</u></b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
<dt><b>*OUTFILE</b></dt>
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for 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><b>Qualifier 1: File to receive output</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file to which the command output is directed.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
<p>
<b>Note: </b>If a new file is created, system file QASCTRCI in system library QSYS is used as a model.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter.
</p>
<p><b>Element 1: Member to receive output</b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
<p>If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
</p>
</dd>
</dl>
<p><b>Element 2: Replace or add records</b>
</p>
<dl>
<dt><b><u>*REPLACE</u></b></dt>
<dd>The existing records in the specified database file member are replaced by the new records.
</dd>
<dt><b>*ADD</b></dt>
<dd>The new records are added to the existing information in the specified database file member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="TRCINT.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="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="TRCINT.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Starting Component Data Traces and Call Traces</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTYPE(010100 010400 050500 051200)
</pre>
</p>
<p>This command starts component data traces and call traces for resource management and database. Database operations associated with database files are used to collect component data trace records.
</p>
<p><b>Example 2: Tracing Lines and Controllers</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTYPE(*SRCSINK) TRCTBL(*SYSDFT)
DEV(WS1 WS2 WS3) CTL((C1) (C2)) LIN((L1) (L2))
</pre>
</p>
<p>This command starts component data traces for source/sink management (device support) operations involving the devices WS1, WS2, and WS3, lines L1 and L2, and controllers C1 and C2.
</p>
<p><b>Example 3: Stopping Traces and Clearing Trace Table</b>
</p>
<p>
<pre>
TRCINT SET(*END) TRCTBL(*SYSDFT)
</pre>
</p>
<p>This command stops all traces and deletes the trace records from the system default trace table.
</p>
<p><b>Example 4: Tracing Communications Trace Service Function</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTYPE(*CMNTRC)
</pre>
</p>
<p>This command starts component data traces for the communications trace service function.
</p>
<p><b>Example 5: Using Job Filtering Capability</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTBL(MYFTPTRACE)
TRCTYPE(*TCPIP) JOB(QTCP/QTFTP*)
</pre>
</p>
<p>This command starts a TCP/IP trace and will only collect trace records for trace points collected in jobs with user name QTCP and job names that begin with the prefix QTFTP. Trace records will be stored in trace table MYFTPTRACE.
</p>
<p><b>Example 6: Start a Trace and Watch for a Message to End the Trace</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTYPE(*CMNTRC) WCHMSG((MCH2804))
WCHMSGQ((*SYSOPR) (*JOBLOG))
WCHJOB((*ALL/MYUSER/MYJOBNAME))
TRCPGM(MYLIB/TRCEXTPGM)
</pre>
</p>
<p>This command starts component data traces for the communications trace service function. 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 7: Start a Trace and Watch for a LIC Log Entry to End the Trace</b>
</p>
<p>
<pre>
TRCINT SET(*ON) TRCTYPE(*CMNTRC)
WCHLICLOG(('99??' 9932 MYJOBNAME))
WCHTIMO(*NOMAX)
</pre>
</p>
<p>This command starts component data traces for the communications trace service function. 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 TRCINT command is issued manually to stop the trace.
</p>
<p><b>Example 8: Sending the Trace Output to an Outfile</b>
</p>
<p>
<pre>
TRCINT SET(*OFF) OUTPUT(*OUTFILE)
OUTFILE(MYOUTFILE) OUTMBR(MYOUTMBR)
</pre>
</p>
<p>This command generates the outfile MYOUTFILE with member MYOUTMBR with the data traces.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="TRCINT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPD3683</b></dt>
<dd>TRCFULL parameter only valid with SET(*ON).
</dd>
<dt><b>CPD3684</b></dt>
<dd>Specified parameters only valid when SET(*ON) is specified.
</dd>
<dt><b>CPD3685</b></dt>
<dd>SLTTRCPNT or OMTTRCPNT parameters are mutually exclusive.
</dd>
<dt><b>CPD3686</b></dt>
<dd>TCPDTA only valid if *TCPIP or *SMBSVR or *FRCA or one or more of the socket TRCTYPE is specified.
</dd>
<dt><b>CPD3687</b></dt>
<dd>SCKDTA only valid if one or more of the socket TRCTYPE values is specified.
</dd>
<dt><b>CPD3688</b></dt>
<dd>Job types (JOBTYPE) parameter only valid with TRCTYPE(*MPL).
</dd>
<dt><b>CPD3689</b></dt>
<dd>Job trace interval (JOBTRCITV) parameter only valid with TRCTYPE(*MPL)
</dd>
<dt><b>CPD368A</b></dt>
<dd>Cannot change trace point selection criteria for active trace table.
</dd>
<dt><b>CPD36C0</b></dt>
<dd>OUTDEV parameter only valid with SET(*SAVE).
</dd>
<dt><b>CPD36C1</b></dt>
<dd>SIZE parameter only valid with SET(*ON) or SET(*SIZE).
</dd>
<dt><b>CPD36CD</b></dt>
<dd>TASKINF parameter only valid with SET(*OFF) or SET(*SAVE).
</dd>
<dt><b>CPD3983</b></dt>
<dd>Range of parameter SIZE not valid.
</dd>
<dt><b>CPD3990</b></dt>
<dd>User number qualifier not valid.
</dd>
<dt><b>CPD3991</b></dt>
<dd>Job, thread identifier or task not active.
</dd>
<dt><b>CPF3515</b></dt>
<dd>Too many trace requests or objects.
</dd>
<dt><b>CPF3516</b></dt>
<dd>Trace table is full.
</dd>
<dt><b>CPF3517</b></dt>
<dd>Cannot specify *SELECT for the thread ID to include.
</dd>
<dt><b>CPF3518</b></dt>
<dd>End time and date earlier than start time and date.
</dd>
<dt><b>CPF3659</b></dt>
<dd>Total of specified CTL, DEV, LIN, NWI, and NWS greater than allowed.
</dd>
<dt><b>CPF3679</b></dt>
<dd>Service function returned completion code &amp;1 qualifier &amp;2.
</dd>
<dt><b>CPF3683</b></dt>
<dd>Error occurred trying to open printer file.
</dd>
<dt><b>CPF3684</b></dt>
<dd>Error occurred while trying to close a print file.
</dd>
<dt><b>CPF3685</b></dt>
<dd>Error occurred while data being put to print file.
</dd>
<dt><b>CPF3686</b></dt>
<dd>Service function ended with error message.
</dd>
<dt><b>CPF3687</b></dt>
<dd>Error occurred while trying to open file.
</dd>
<dt><b>CPF3688</b></dt>
<dd>Error occurred while tape or optical file being closed.
</dd>
<dt><b>CPF3689</b></dt>
<dd>Error occurred while writing data to tape or optical device.
</dd>
<dt><b>CPF368A</b></dt>
<dd>Trace table size not changed.
</dd>
<dt><b>CPF3692</b></dt>
<dd>Error occurred while trying to write data to tape or optical device.
</dd>
<dt><b>CPF3693</b></dt>
<dd>Service function ended because error occurred.
</dd>
<dt><b>CPF3694</b></dt>
<dd>Cannot start service function.
</dd>
<dt><b>CPF3695</b></dt>
<dd>No trace tables exist.
</dd>
<dt><b>CPF3696</b></dt>
<dd>No traces recorded.
</dd>
<dt><b>CPF3697</b></dt>
<dd>Trace type parameter value missing.
</dd>
<dt><b>CPF7A11</b></dt>
<dd>Trace table &amp;1 not found.
</dd>
<dt><b>CPF7A13</b></dt>
<dd>Trace table cannot be created.
</dd>
<dt><b>CPF7A15</b></dt>
<dd>Trace buffer must be cleared.
</dd>
<dt><b>CPF7A17</b></dt>
<dd>Trace already is active.
</dd>
<dt><b>CPF7A1A</b></dt>
<dd>Cannot change trace point selection criteria for active trace table.
</dd>
<dt><b>CPF7A1C</b></dt>
<dd>IP address not valid.
</dd>
<dt><b>CPF98A2</b></dt>
<dd>Not authorized to &amp;1 command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#TRCINT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink