131 lines
6.9 KiB
HTML
131 lines
6.9 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow"/>
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<title>Trace Common Programming Interface (CPI) Communications (TRCCPIC) command</title>
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
|
</head>
|
|
<body>
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
|
|
<a name="rzajtprb-comtraceinstss"></a>
|
|
<h4 id="rzajtprb-comtraceinstss">Trace Common Programming Interface (CPI) Communications (TRCCPIC) command</h4>
|
|
<p>You can start to trace Common Programming Interface (CPI) Communications
|
|
either before running a job or after a job is active to find out where the
|
|
error might have occurred. The TRCCPIC command captures information about
|
|
CPI-Communications calls that are processed by your program. The system collects
|
|
trace information in a current job, or in a job that is serviced by a Start
|
|
Service Job (STRSRVJOB) command. (For a CPI Communication program you could
|
|
trace a job that is started as a result of a received program start request.)
|
|
You can issue the TRCCPIC command in one of the following ways: </p>
|
|
<ul>
|
|
<li>Using the System Menu</li>
|
|
<li>Typing TRCCPIC *ON on a command line</li>
|
|
<li>Adding the TRCCPIC command to a control language (CL) or a REstructured
|
|
eXtended eXecutor (REXX) program</li>
|
|
<li>Typing TRCCPIC on the command line and pressing F4 (Prompt)</li></ul><p class="indatacontent">If you type TRCCPIC on the command line and press F4, an initial prompt
|
|
is displayed for the <span class="italic">Trace Option Setting</span>. If *ON
|
|
is specified and you press enter, the Trace CPI Communications display appears.</p>
|
|
<p>This display enables you to set the following parameters: </p>
|
|
<dl class="parml">
|
|
<dt class="bold">Trace option setting</dt>
|
|
<dd>Specifies whether the collection of trace information is to be started,
|
|
stopped, or ended.
|
|
<dl class="parml">
|
|
<dt class="bold"><span class="pkdef">*ON</span></dt>
|
|
<dd>Starts Trace CPI Communications. This is the default value for the command.
|
|
</dd>
|
|
<dt class="bold">*OFF</dt>
|
|
<dd>Stops Trace CPI Communications. The current information is written to
|
|
the spooled printer file or to the database file, and the trace table. The
|
|
trace information is then deleted.
|
|
</dd>
|
|
<dt class="bold">*END</dt>
|
|
<dd>Ends Trace CPI Communications. The trace table and all trace information
|
|
are destroyed.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt class="bold">Maximum storage to use</dt>
|
|
<dd>Specifies the maximum amount of storage to use for the trace information
|
|
collected. The prompt appears only if you have selected *ON for the <span class="italic">Trace option setting</span> prompt.
|
|
<dl class="parml">
|
|
<dt class="bold"><span class="pkdef">200 K</span></dt>
|
|
<dd>The number of bytes (1 K equals 1024 bytes) of storage. This is the
|
|
default value.
|
|
</dd>
|
|
<dt class="bold">1-16000 K</dt>
|
|
<dd>The valid range for the maximum number of bytes used for storing collected
|
|
trace information.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt class="bold">Trace full</dt>
|
|
<dd>Specifies whether new trace records replace old trace records or whether
|
|
the trace is stopped when the maximum storage that you specified has been
|
|
reached. This prompt appears only if you have selected *ON for the <span class="italic">Trace option setting</span> prompt.
|
|
<dl class="parml">
|
|
<dt class="bold"><span class="pkdef">*WRAP</span></dt>
|
|
<dd>When the trace storage area is full, new trace information is written
|
|
over the old trace information, starting at the beginning of the storage area.
|
|
This is the default value.
|
|
</dd>
|
|
<dt class="bold">*STOPTRC</dt>
|
|
<dd>No new trace information is saved when the trace storage area is full.
|
|
You must reissue the TRCCPIC command, specifying (*OFF) for the SET parameter,
|
|
to retrieve the output of the trace information collected in the trace storage
|
|
area.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
<dt class="bold">User data length</dt>
|
|
<dd>Specifies the maximum length of user data to be saved for each trace
|
|
record in the storage area. This prompt affects only the tracing of user data
|
|
on the Send_Data and Receive calls. This parameter does not affect the tracing
|
|
of log data on Set_Log_Data, Send_Error, or Deallocate calls. This prompt
|
|
appears only if you specified *ON on the <span class="italic">Trace option setting</span> prompt.
|
|
<dl class="parml">
|
|
<dt class="bold"><span class="pkdef">128</span></dt>
|
|
<dd>The number of bytes for the user data length. This is the default value.
|
|
</dd>
|
|
<dt class="bold">0-4096</dt>
|
|
<dd>The valid range of bytes for the user data length.
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
<p>Trace Common Programming Interface (CPI) Communications continues to collect
|
|
trace records until you stop the trace or until the trace storage area becomes
|
|
full. The amount of trace storage depends on the value that is specified on
|
|
the <span class="italic">Trace full</span> prompt. If the trace storage area becomes
|
|
full and the collection of trace records stops, you must enter the TRCCPIC
|
|
command again to create output. The output that is created by the TRCCPIC
|
|
command is directed either to the spooled printer file, QSYSPRT, or to a database
|
|
output file that you specify. If the output file that you specify already
|
|
exists, it must have the same attributes as the system-supplied file, QACM0TRC.</p>
|
|
<p>You can stop a trace procedure in one of the following ways: </p>
|
|
<ul>
|
|
<li>Using the System Menu</li>
|
|
<li>Typing TRCCPIC *OFF on the command line</li>
|
|
<li>Adding the TRCCPIC command to a CL or a REXX program</li>
|
|
<li>Typing TRCCPIC on the command line and pressing F4 (Prompt)</li></ul><p class="indatacontent">Type TRCCPIC on the command line and press F4. Specify *OFF for the <span class="italic">Trace option setting</span> and you are prompted for the OUTPUT
|
|
parameter.</p>
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|