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

143 lines
3.7 KiB
HTML

<!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>getjobid - Display job information</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>getjobid - Display job information</h2>
<strong>Synopsis</strong>
<p>
<strong>getjobid [-csv]</strong> [<em>pid ...</em>]</p>
<p><strong>getjobid -j [-csv]</strong> [<em>qualified-job ...</em>]
</p>
<p><strong>Description</strong></p>
<p>The <strong>getjobid</strong> utility writes the qualified job
name and process ID for the specified process to standard output.
The qualified job name 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.
<p>In the first synopsis form, the process is identified using the process ID.
In the second synopsis form, the process is identified using the qualified
job name.
<p>When the <strong>-v</strong> option is specified, <strong>getjobid</strong>
displays the process ID, parent's process ID, process group, current status, and
qualified job name for the specified process. </p>
<table>
<tr>
<td valign="top"><strong>Note:</strong></td>
<td>This utility is unique to i5/OS<SUP>(TM)</SUP>.</td>
</tr>
</table>
<p><strong>Options</strong></p>
<dl>
<dd></dd>
<dt><strong>-c</strong></dt>
<dd>Display information about all of the current child processes of the
specified process.
</dd>
<dt><strong>-j</strong></dt>
<dd>Processes are identified using the qualified job name.
</dd>
<dt><strong>-s</strong></dt>
<dd>Display a short form with just the qualified job name.</dd>
<dt><strong>-v</strong></dt>
<dd>Display detailed information about the specified process, including the
process ID, the parent's process ID, process group,
current status, and qualified job name.</dd>
</dl>
<p><strong>Operands</strong></p>
<p>Each <em>pid</em> is the decimal process ID of an active process on the system.
When <em>pid</em> is not specified, <strong>getjobid</strong>
displays information for the current process.</p>
<p>
Each <em>qualified-job</em> is the qualified job name of an active process on the system.
The qualified job name 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.
</p>
<p><strong>Exit Status</strong></p>
<ul>
<li>0 when successful.</li>
<li>&gt;0 when an error occurred. The exit status is the number of
processes for which information could not be obtained.</li>
</ul>
<p><strong>Related information</strong></p>
<ul>
<li><a href="jobs.htm">jobs - Display status of jobs in current session</a></li>
<li><a href="ps.htm">ps - Display process status</a></li>
</ul>
<p><strong>Examples</strong></p>
<ol>
<li>Display the qualified job name of the current process.
<pre>
getjobid
</pre>
</li>
<li>Display detailed information for three processes.
<pre>
getjobid -v 318 942 1130
</pre>
</li>
<li>Display the short form of the qualified job name for one process.
<pre>
getjobid -s 325
</pre>
</li>
<li>Display detailed information for a process identified with the
qualified job name.
<pre>
getjobid -jv 325411/SHELLTST/QZSHCHLD
</pre>
</li>
</ol>
<!-- end ibmbody========================================================= -->
</body>
</html>