257 lines
10 KiB
HTML
257 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>Transfer Job (TFRJOB)</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="TFRJOB.Top_Of_Page"></a>
|
||
|
|
<h2>Transfer Job (TFRJOB)</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="#TFRJOB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#TFRJOB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#TFRJOB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="TFRJOB"></a>
|
||
|
|
<p>The Transfer Job (TFRJOB) command transfers a job to the specified job queue. The job that is transferred is the one where this command is issued. If the job being transferred is an interactive job, it is given the highest priority on the job queue. New routing data and request data can be specified for the job when it is transferred.
|
||
|
|
</p>
|
||
|
|
<p>If objects allocated to the previous routing step are needed in the new routing step, they must be allocated again. If files opened in the previous routing step are needed in the new routing step, they must be opened again.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>To use this command, you must have:
|
||
|
|
<ul>
|
||
|
|
<li>use (*USE) authority to the job queue and execute (*EXECUTE) authority to the library that contains that job queue.
|
||
|
|
</li>
|
||
|
|
<li>use (*USE) authority to the subsystem description associated with the subsystem that has the job queue allocated. This restriction only applies if the job being transferred is an interactive job.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>If the job being transferred is an interactive job, the following restrictions apply:
|
||
|
|
<ul>
|
||
|
|
<li>The job queue on which the job is placed must be associated with an active subsystem.
|
||
|
|
</li>
|
||
|
|
<li>The work station associated with the job must have a corresponding work station entry in the subsystem description associated with the new subsystem.
|
||
|
|
</li>
|
||
|
|
<li>The work station associated with the job must not have another job associated with it that has been suspended by means of the Sys Req (system request) key. The suspended job must be canceled before the Transfer Job command can be run.
|
||
|
|
</li>
|
||
|
|
<li>The job must not be a group job.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The job must not be a communications batch job (started as a result of a program start request), unless it meets one of the following criteria:
|
||
|
|
<ul>
|
||
|
|
<li>It was started from an APPC communications device.
|
||
|
|
</li>
|
||
|
|
<li>The session on the communications device has ended.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Running this command in a batch job causes loss of spooled inline files because they cannot be accessed in the new routing step.
|
||
|
|
</li>
|
||
|
|
<li>If the target subsystem is ended (by running the End Subsystem (ENDSBS) command, the End System (ENDSYS) command, or the Power Down System (PWRDWNSYS) command) while an interactive transferring job is on a job queue, the job is canceled as part of subsystem ending.
|
||
|
|
</li>
|
||
|
|
<li>Because a PWRDWNSYS command inhibits new jobs or routing steps from being started by any subsystem, a batch job transferred to a job queue (by the TFRJOB command) is not completed before the system is powered down.
|
||
|
|
</li>
|
||
|
|
<li>The temporary objects associated with a transferring job (such as the library list, the QTEMP library, and all objects in it) are destroyed during the PWRDWNSYS command, so that during a re-initial program load (IPL), the system is unable to restore the job to its previous state. During re-IPL, the system removes the job from the job queue and produces its job log.
|
||
|
|
</li>
|
||
|
|
<li>If the TFRJOB command is issued in a CL program, all subsequent commands in the CL program are bypassed.
|
||
|
|
</li>
|
||
|
|
<li>When the new routing step is started, the current user must have use (*USE) authority to the subsystem description for the subsystem in which the routing step runs.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="TFRJOB.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="3"><a href="#TFRJOB.JOBQ"><b>JOBQ</b></a></td>
|
||
|
|
<td valign="top">Job queue</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job queue</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#TFRJOB.RTGDTA"><b>RTGDTA</b></a></td>
|
||
|
|
<td valign="top">Routing data</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>QCMDI</u></b>, *RQSDTA</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#TFRJOB.RQSDTA"><b>RQSDTA</b></a></td>
|
||
|
|
<td valign="top">Request data or command</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *RTGDTA</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="TFRJOB.JOBQ"></a>
|
||
|
|
<h3>Job queue (JOBQ)</h3>
|
||
|
|
<p>Specifies the qualified name of the job queue to which the job is transferred.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Job queue</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the job queue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the thread's library list are searched until a match is found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the library where the job queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TFRJOB.RTGDTA"></a>
|
||
|
|
<h3>Routing data (RTGDTA)</h3>
|
||
|
|
<p>Specifies the routing data used to start the next routing step in the job. The routing data is used to determine the routing entry that identifies the program that the job runs.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QCMDI</u></b></dt>
|
||
|
|
<dd>This routing data matches a routing entry in the IBM-supplied subsystem descriptions, which starts a routing step processed by the IBM-supplied control language processor, QCMD, in the QSYS library.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RQSDTA</b></dt>
|
||
|
|
<dd>The first 80 characters of the request data specified in the <b>Request data or command (RQSDTA)</b> parameter of this command are also used as the routing data for the routing step.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the character string that is used as the routing data for starting the routing step. A maximum of 80 characters can be entered, enclosed in apostrophes if necessary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="TFRJOB.RQSDTA"></a>
|
||
|
|
<h3>Request data or command (RQSDTA)</h3>
|
||
|
|
<p>Specifies the request data that is placed as the last entry in this job's message queue. The request data can be a CL command to be run or a string of characters used by another program.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No request data is placed in the job's message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTGDTA</b></dt>
|
||
|
|
<dd>The routing data specified in the <b>Routing data (RTGDTA)</b> parameter is also placed at the end of the job's message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the character string that is placed at the end of the job's message queue for use by the new routing step or some subsequent routing step in the job. A maximum of 256 characters can be entered, enclosed in apostrophes if necessary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="TFRJOB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
TFRJOB JOBQ(QGPL/APPLICQ) RTGDTA(APPLICS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command transfers the job in which the command is entered to the APPLICQ job queue in the QGPL library. The job is routed using the routing data APPLICS. If the job is an interactive job, the job queue must be allocated by an active subsystem.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="TFRJOB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF1289</b></dt>
|
||
|
|
<dd>Transfer job is not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1315</b></dt>
|
||
|
|
<dd>Command &1 not allowed in this environment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1357</b></dt>
|
||
|
|
<dd>Job not transferred.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1364</b></dt>
|
||
|
|
<dd>Job not transferred. Job queue &1 in library &2 not active.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1365</b></dt>
|
||
|
|
<dd>Job not transferred. Subsystem &1 ending.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1366</b></dt>
|
||
|
|
<dd>Subsystem &1 has no usable work station entry for &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1367</b></dt>
|
||
|
|
<dd>User &1 not authorized to subsystem &2
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1368</b></dt>
|
||
|
|
<dd>&1 not authorized to job queue &2 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1369</b></dt>
|
||
|
|
<dd>Job queue &1 in &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1370</b></dt>
|
||
|
|
<dd>Job queue &1 in &2 not accessible.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1372</b></dt>
|
||
|
|
<dd>Job not transferred. Job currently being ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1373</b></dt>
|
||
|
|
<dd>Job not transferred. System request in effect for job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF1375</b></dt>
|
||
|
|
<dd>Job not transferred. Single active job not allowed to transfer.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#TFRJOB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|