ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahz_5.4.0.1/catsplf.htm

118 lines
3.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8">
<title>catsplf - Concatenate and print spool files</title>
<LINK rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</HEAD>
<body bgcolor="#FFFFFF">
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h2>catsplf - Concatenate and print spool files</h2>
<strong>Synopsis</strong>
<p><strong>catsplf -j</strong> <em>qualified-job</em> <strong>[-aen]</strong> <em>splfname splfnum</em></p>
<p><strong>catsplf -p</strong> <em>pid</em> <strong>[-aen]</strong> <em>splfname splfnum</em></p>
<p><strong>Description</strong></p>
<p>The <strong>catsplf</strong> utility reads the specified spool
file and writes it to standard output.</p>
<p>In the first synopsis form, <strong>catsplf</strong> finds the spool files associated
with the job specified by <em>qualified-job</em>.</p>
<p>In the second synopsis form, <strong>catsplf</strong> finds the spool files associated
with the job specified by <em>pid</em>.</p>
<p><strong>Options</strong></p>
<dl>
<dt><strong>-a</strong></dt>
<dd>Print all of the spool files associated with the specified job.</dd>
<dt><strong>-e</strong></dt>
<dd>Number the output lines starting at 1 and display a dollar sign ($) at the
end of each line.</dd>
<dt><strong>-j</strong> <em>qualified-job</em></dt>
<dd>Find the spool files associated with the job identified by <em>qualified-job</em>,
where <em>qualified-job</em> is a string in the form <em>number</em>/<em>user</em>/<em>name</em>.
The <em>number</em> is a six-digit decimal number, <em>user</em> is the user profile under which
the job was started, and <em>name</em> is the name of job.</dd>
<dt><strong>-n</strong></dt>
<dd>Number the output lines starting at 1.</dd>
<dt><strong>-p</strong> <em>pid</em></dt>
<dd>Find the spool files associated with the job identified by <em>pid</em>,
where <em>pid</em> is the decimal process ID of the job.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>The <em>splfname</em> operand specifies the name of the spool file and the
<em>splfnum</em> operand specifies the number of the spool file. Both operands
are required to uniquely identify a spool file.</p>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 when successful</li>
<li>&gt;0 when unsuccessful</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="cat.htm">cat - Concatenate and print files</a></li>
<li><a href="rfile.htm">Rfile - Read or write record files</a></li>
<li><a href="zcat.htm">zcat - Expand and concatenate data</a></li>
</ul>
<p><strong>Examples</strong></p>
<ol>
<li>Print the spool file named QPRINT and number 1 for a job using a
qualified job name.
<pre>
catsplf -j 386687/SHELLTST/QZSHCHLD QPRINT 1
</pre>
</li>
<li>Print the spool file named QPRINT and number 1 for a job using a pid.
<pre>
catsplf -p 942 QPRINT 1
</pre>
</li>
<li>Print all of the spool files for a job.
<pre>
catsplf -a -j 386687/SHELLTST/QZSHCHLD
</pre>
</li>
</ol>
</body>
</html>