282 lines
10 KiB
HTML
282 lines
10 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>Disconnect Job (DSCJOB)</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="DSCJOB.Top_Of_Page"></a>
|
|
<h2>Disconnect Job (DSCJOB)</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="#DSCJOB.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSCJOB.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSCJOB.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSCJOB"></a>
|
|
<p>The Disconnect Job (DSCJOB) command allows the interactive user to disconnect all interactive jobs at the workstation and return to the sign-on display.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>A job being disconnected must be an interactive job.
|
|
</li>
|
|
<li>A job which is being held cannot be disconnected.
|
|
</li>
|
|
<li>A pass-through job cannot be disconnected unless the user has used the system request function to return to the source system from the pass-through target system.
|
|
</li>
|
|
<li>The command must be issued from within the job being disconnected, or the issuer of the command must be running under a user profile which is the same as the job user identity of the job being disconnected, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority. The job user identity is the name of the user profile by which a job is known to other jobs. It is described in more detail in the Work Management book.
|
|
</li>
|
|
<li>A job cannot be disconnected if PC organizer is active.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSCJOB.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="#DSCJOB.LOG"><b>LOG</b></a></td>
|
|
<td valign="top">Job log</td>
|
|
<td valign="top"><b><u>*NOLIST</u></b>, *LIST</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSCJOB.DROP"><b>DROP</b></a></td>
|
|
<td valign="top">Drop line</td>
|
|
<td valign="top"><b><u>*DEVD</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#DSCJOB.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 3</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="#DSCJOB.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="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSCJOB.LOG"></a>
|
|
<h3>Job log (LOG)</h3>
|
|
<p>Specifies whether the job log for this interactive job is deleted or is included in the job's spooled output for printing. This entry takes precedence over the LOG parameter value specified for the job. This parameter has meaning only if the disconnected job is canceled due to the disconnect time interval being exceeded. The time interval is defined by system value QDSCJOBITV.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOLIST</u></b></dt>
|
|
<dd>The information in the job log is deleted.
|
|
</dd>
|
|
<dt><b>*LIST</b></dt>
|
|
<dd>The job log, and the rest of the job's spooled output, is spooled for printing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSCJOB.DROP"></a>
|
|
<h3>Drop line (DROP)</h3>
|
|
<p>Specifies whether the switched line attached to the work station is disconnected (dropped) if no other work stations on the same line are signed on. This parameter is ignored if the work station is attached to a nonswitched line.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*DEVD</u></b></dt>
|
|
<dd>The value specified in the <b>Drop line at signoff (DROP)</b> parameter of the work station's device description is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The switched line is disconnected when the job is ended if no other work stations are signed on the line.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The switched line is not disconnected when the job is ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSCJOB.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of a job being disconnected from a work station. The job or jobs that are disconnected from a work station can be reconnected if the same user signs on the same work station.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>You must have job control (*JOBCTL) special authority to specify the name of an active or interactive job.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The jobs associated with the work station that issued this command are disconnected.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job. If no additional job qualifiers are given, all of the jobs currently in the system are searched for the name of the job. If duplicates of the specified name are found, a qualified job name must be specified.
|
|
</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 is started. Specifying the user as a qualifier is only necessary if a duplicate job name exists for different users. If a duplicate job name exists for the same user, the job must be qualified with the job number.
|
|
</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. Specifying the job number as a qualifier is only necessary if a duplicate job name exists for the same user.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSCJOB.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, a message is issued.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>A message is issued when duplicate jobs are found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSCJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Disconnecting All Interactive Jobs</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSCJOB
|
|
</pre>
|
|
</p>
|
|
<p>This command enables the user of the work station to disconnect all the interactive jobs associated with the work station. The switched line is dropped only if that is specified in the work station device description of this work station and if no other work station on this line is active. If the job is disconnected when the disconnect interval in the QDSCJOBITV system value is reached, the job is ended and the job log is not included with the job's spooled output.
|
|
</p>
|
|
<p><b>Example 2: Disconnecting Job Without Releasing Switched Line</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSCJOB LOG(*LIST) DROP(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command disconnects the interactive job, but the switched line is not released. If the job is ended due to the QDSCJOBITV system value, the job log is included with the job's spooled output.
|
|
</p>
|
|
<p><b>Example 3: Deleting Information in Job Log</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSCJOB LOG(*NOLIST) DROP(*DEVD) JOB(123497/DEPT1/DSP04)
|
|
</pre>
|
|
</p>
|
|
<p>This command disconnects the interactive job 123497/DEPT1/DSP04 and any other jobs on that work station, for example, secondary jobs or group jobs. If the job is disconnected when the disconnect interval in the QDSCJOBITV system value is reached, the job is ended and the job log is not included with the job's spooled output. The work station device description is checked to determine whether the switched line is disconnected.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSCJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1317</b></dt>
|
|
<dd>No response from subsystem for job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1321</b></dt>
|
|
<dd>Job &1 user &2 job number &3 not found.
|
|
</dd>
|
|
<dt><b>CPF1332</b></dt>
|
|
<dd>End of duplicate job names.
|
|
</dd>
|
|
<dt><b>CPF1333</b></dt>
|
|
<dd>Disconnect Job (DSCJOB) command not allowed for this job at this time.
|
|
</dd>
|
|
<dt><b>CPF1344</b></dt>
|
|
<dd>Not authorized to control job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1351</b></dt>
|
|
<dd>Function check occurred in subsystem for job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF1353</b></dt>
|
|
<dd>DSCJOB command not allowed for this job now.
|
|
</dd>
|
|
<dt><b>CPF1354</b></dt>
|
|
<dd>DSCJOB command not allowed for this job now.
|
|
</dd>
|
|
<dt><b>CPF1355</b></dt>
|
|
<dd>DSCJOB command not allowed for this job.
|
|
</dd>
|
|
<dt><b>CPF1358</b></dt>
|
|
<dd>DSCJOB not allowed.
|
|
</dd>
|
|
<dt><b>CPF1385</b></dt>
|
|
<dd>Disconnect Job (DSCJOB) command not allowed for this job at this time.
|
|
</dd>
|
|
<dt><b>CPF1386</b></dt>
|
|
<dd>DSCJOB is not valid.
|
|
</dd>
|
|
<dt><b>CPF1387</b></dt>
|
|
<dd>DSCJOB is not valid.
|
|
</dd>
|
|
<dt><b>CPF1388</b></dt>
|
|
<dd>DSCJOB command not allowed at this device.
|
|
</dd>
|
|
<dt><b>CPF1389</b></dt>
|
|
<dd>Disconnect Job (DSCJOB) command not allowed for this job at this time.
|
|
</dd>
|
|
<dt><b>CPF1391</b></dt>
|
|
<dd>DSCJOB command not allowed for this job now.
|
|
</dd>
|
|
<dt><b>CPF1656</b></dt>
|
|
<dd>Disconnect job not allowed for test request jobs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSCJOB.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|