343 lines
12 KiB
HTML
343 lines
12 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 CPI Communications (TRCCPIC)</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="TRCCPIC.Top_Of_Page"></a>
|
|
<h2>Trace CPI Communications (TRCCPIC)</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="#TRCCPIC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#TRCCPIC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#TRCCPIC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="TRCCPIC"></a>
|
|
<p>The Trace Common Programming Interface Communications (TRCCPIC) command controls tracing of all CPI Communications that occur in the job in which the command is entered. The command sets a trace on or off, and traces (1) CPI Communications calls issued by a program and (2) data that is sent and received.
|
|
</p>
|
|
<p>As trace records are collected, they are stored in an internal trace storage area. When the trace is ended, the trace records can be directed to a spooled output file or a database physical file.
|
|
</p>
|
|
<p>If the Start Service Job (STRSRVJOB) command is entered before the TRCCPIC command, the job that is traced is the one specified on the STRSRVJOB command. The trace output from the serviced job is returned to the servicing job after the trace is set off or after the serviced job has ended.
|
|
</p>
|
|
<p><b>Restrictions:</b> (1) The record format of the database output file must match the record format of the IBM-supplied output file, QACM0TRC. (2) The user must have specific authority from the security officer to use this command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="TRCCPIC.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="#TRCCPIC.SET"><b>SET</b></a></td>
|
|
<td valign="top">Trace option setting</td>
|
|
<td valign="top"><b><u>*ON</u></b>, *OFF, *END</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCCPIC.MAXSTG"><b>MAXSTG</b></a></td>
|
|
<td valign="top">Maximum storage to use</td>
|
|
<td valign="top">1-16000, <b><u>200</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCCPIC.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, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCCPIC.DTALEN"><b>DTALEN</b></a></td>
|
|
<td valign="top">User data length</td>
|
|
<td valign="top">0-4096, <b><u>128</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#TRCCPIC.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="#TRCCPIC.OUTFILE"><b>OUTFILE</b></a></td>
|
|
<td valign="top">Output file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Output file</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="#TRCCPIC.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="TRCCPIC.SET"></a>
|
|
<h3>Trace option setting (SET)</h3>
|
|
<p>Specifies whether a CPI Communications trace is started or ended.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ON</u></b></dt>
|
|
<dd>The trace is started. If the trace storage area becomes full, the action specified on the TRCFULL parameter is taken.
|
|
</dd>
|
|
<dt><b>*OFF</b></dt>
|
|
<dd>The trace is ended. No other trace information is recorded, and the current information is written to the spooled output file or a database file.
|
|
</dd>
|
|
<dt><b>*END</b></dt>
|
|
<dd>The trace ends. No other trace information is recorded and all current trace information is deleted. No output is generated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.MAXSTG"></a>
|
|
<h3>Maximum storage to use (MAXSTG)</h3>
|
|
<p>Specifies the maximum amount of storage (in kilobytes) used for the created trace records.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>200</u></b></dt>
|
|
<dd>Up to 200KB of storage is used for trace records.
|
|
</dd>
|
|
<dt><b><i>number-of-kilobytes</i></b></dt>
|
|
<dd>Specify the number of kilobytes of storage to use for trace records. Valid values range from 1 through 16000.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.TRCFULL"></a>
|
|
<h3>Trace full (TRCFULL)</h3>
|
|
<p>Specifies the action taken when the maximum storage specified is full.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*WRAP</u></b></dt>
|
|
<dd>When the trace storage area is full, new trace information is written over the old information, starting at the beginning of the storage area.
|
|
</dd>
|
|
<dt><b>*STOPTRC</b></dt>
|
|
<dd>When the trace storage area is full, no new trace information is saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.DTALEN"></a>
|
|
<h3>User data length (DTALEN)</h3>
|
|
<p>Specifies the maximum length (in bytes) of user data that can be saved for each trace entry in the storage area. If the value specified is greater than the length of data received or sent across the communications line, only the actual data is traced. If the value specified is less than the data length received or sent, only the data length specified on this parameter is traced.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>128</u></b></dt>
|
|
<dd>The maximum length of user data saved is 128 bytes.
|
|
</dd>
|
|
<dt><b><i>number-of-bytes</i></b></dt>
|
|
<dd>Specify the maximum length of user data saved. Valid values range from 0 through 4096.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</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>
|
|
<dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.OUTFILE"></a>
|
|
<h3>Output file (OUTFILE)</h3>
|
|
<p>Specifies the qualified name of the physical file to which the trace output is directed. If the file already exists, the system uses it. If the file does not exist, the system creates it. If the file is created, the text is "Output file for TRCCPIC." The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the database file.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the database file. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the database file is located.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specify the name of the physical database file to which the trace output is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="TRCCPIC.OUTMBR"></a>
|
|
<h3>Output member options (OUTMBR)</h3>
|
|
<p>Specifies the name of the member in the physical file that receives the trace output. If the file is created by the system, a member is created with the name specified on this parameter. If the file exists but the member does not, a member with the specified name is created.
|
|
</p>
|
|
<p><b>Element 1: Member to Receive Output</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>The first member of the specified file is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member in the file that receives the trace output.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Operation to Perform on Member</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The new data replaces the existing data.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The system adds the new records to the end of the existing records.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCCPIC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Starting Trace Operation</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCCPIC MAXSTG(350) DTALEN(256)
|
|
</pre>
|
|
</p>
|
|
<p>This command traces the CPI Communications calls of the current job. The trace file contains 350KB of storage and wraps to the beginning if that amount of storage is filled with trace records. In addition, this command traces up to 256 bytes of user data on each input/output operation.
|
|
</p>
|
|
<p><b>Example 2: Stopping Trace Operation</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
TRCCPIC SET(*OFF) OUTPUT(*OUTFILE) OUTFILE(TRACELIB/CPICTRACE)
|
|
OUTMBR(TRACEMBR)
|
|
</pre>
|
|
</p>
|
|
<p>This command stops the trace and directs the output to the database file CPICTRACE in library TRACELIB. The output is directed to the member TRACEMBR.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="TRCCPIC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2C90</b></dt>
|
|
<dd>Maximum storage specified too small.
|
|
</dd>
|
|
<dt><b>CPF2C94</b></dt>
|
|
<dd>Error occurred during OUTFILE processing. Trace stopped.
|
|
</dd>
|
|
<dt><b>CPF3B30</b></dt>
|
|
<dd>No CPI-Communications calls were run. Trace ended.
|
|
</dd>
|
|
<dt><b>CPF3B31</b></dt>
|
|
<dd>Job is already being serviced or traced.
|
|
</dd>
|
|
<dt><b>CPF3B32</b></dt>
|
|
<dd>Trace already off.
|
|
</dd>
|
|
<dt><b>CPF3B33</b></dt>
|
|
<dd>Unexpected Trace CPI Communications error occurred.
|
|
</dd>
|
|
<dt><b>CPF3B34</b></dt>
|
|
<dd>Cannot deactivate trace, trace started from another job.
|
|
</dd>
|
|
<dt><b>CPF3548</b></dt>
|
|
<dd>Serviced job completed running.
|
|
</dd>
|
|
<dt><b>CPF3936</b></dt>
|
|
<dd>Job being serviced ended before trace started.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9848</b></dt>
|
|
<dd>Cannot open file &1 in library &2 member &3.
|
|
</dd>
|
|
<dt><b>CPF9849</b></dt>
|
|
<dd>Error while processing file &1 in library &2 member &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#TRCCPIC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|