ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/strsrvjob.htm

178 lines
5.6 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Start Service Job (STRSRVJOB)</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="STRSRVJOB.Top_Of_Page"></a>
<h2>Start Service Job (STRSRVJOB)</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="#STRSRVJOB.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRSRVJOB.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRSRVJOB.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRSRVJOB"></a>
<p>The Start Service Job (STRSRVJOB) command starts the remote service operation for a specified job (other than the job issuing the command) so that other service commands can be entered to service the specified job. Any dump, debug, and trace commands can be run in that job until service operation ends. Service operation continues until the End Service Job (ENDSRVJOB) command is run.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>To use this command, you must be signed on as QPGMR, QSYSOPR, QSRV, or QSRVBAS, or have use (*USE) authority to the user profile of the job being serviced.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRSRVJOB.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" rowspan="4"><a href="#STRSRVJOB.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top"><i>Qualified job name</i></td>
<td valign="top" rowspan="4">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job name</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: User</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 3: Number</td>
<td valign="top">000000-999999</td>
</tr><tr>
<td valign="top"><a href="#STRSRVJOB.DUPJOBOPT"><b>DUPJOBOPT</b></a></td>
<td valign="top">Duplicate job option</td>
<td valign="top"><b><u>*SELECT</u></b>, *MSG</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRSRVJOB.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the job to be serviced. If no job number is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, messages are sent to the user, and user name and job number must be specified. The job name entered cannot be the name of the job issuing the command.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Job name</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job.
</dd>
</dl>
<p><b>Qualifier 2: User</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the user name that identifies the user profile under which the job was run.
</dd>
</dl>
<p><b>Qualifier 3: Number</b>
</p>
<dl>
<dt><b><i>000000-999999</i></b></dt>
<dd>Specify the system-assigned job number of the job to be serviced.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRSRVJOB.DUPJOBOPT"></a>
<h3>Duplicate job option (DUPJOBOPT)</h3>
<p>Specifies the action taken when duplicate jobs are found by this command.
</p>
<dl>
<dt><b><u>*SELECT</u></b></dt>
<dd>The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, an escape message is issued.
</dd>
<dt><b>*MSG</b></dt>
<dd>An escape message is issued when duplicate jobs are found.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRSRVJOB.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
STRSRVJOB JOB(ABCD)
</pre>
</p>
<p>This command starts the remote service operation so that any trace, debug, or dump commands entered in this job are applied to the job named ABCD.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRSRVJOB.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3501</b></dt>
<dd>Job is already being serviced, traced, or debugged.
</dd>
<dt><b>CPF3520</b></dt>
<dd>Job not found.
</dd>
<dt><b>CPF3524</b></dt>
<dd>More than one job with specified name found.
</dd>
<dt><b>CPF3531</b></dt>
<dd>Job cannot be serviced.
</dd>
<dt><b>CPF3536</b></dt>
<dd>Job completed and cannot be serviced.
</dd>
<dt><b>CPF3549</b></dt>
<dd>Job &amp;1/&amp;2/&amp;3 cannot be serviced.
</dd>
<dt><b>CPF3676</b></dt>
<dd>Not authorized to service specified job.
</dd>
<dt><b>CPF3909</b></dt>
<dd>Service command will not be processed.
</dd>
<dt><b>CPF3918</b></dt>
<dd>Service request canceled.
</dd>
<dt><b>CPF3938</b></dt>
<dd>Already servicing another job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRSRVJOB.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>