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

464 lines
16 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>Copy Job using Job Scheduler (CPYJOBJS)</title>
</head>
<body bgcolor="white">
<a name="CPYJOBJS.Top_Of_Page"></a>
<h2>Copy Job using Job Scheduler (CPYJOBJS)</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="#CPYJOBJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CPYJOBJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CPYJOBJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CPYJOBJS"></a>
<p>The Copy Job using Job Scheduler (CPYJOBJS) command allows you to copy a job or jobs and all its parameters to create a new job or jobs. You can copy the job on the same system or you can copy the job to a remote location name that you specify or you can copy the job to a different data library on the same system. After creating a new job, you can modify and change any or all of the associated parameters.
</p>
<p>You can copy all jobs in a group to a new group that you specify. When copying a group, you must specify *ALL in the <u> Job and Group sequence</u> fields for the From job, and *SAME in the <u> Job and Group sequence</u> fields for the To job.
</p>
<p>You can specify whether to copy dependencies, where you want to copy the job and what actions you should take when copying the job. You can print a report to analyze the effect of copying a job or jobs prior to processing the actual job copy.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYJOBJS.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="#CPYJOBJS.FROMJOB"><b>FROMJOB</b></a></td>
<td valign="top">From job entry</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Job</td>
<td valign="top">
<i>Generic name, name</i>, *ALL</td>
</tr>
<tr>
<td valign="top">Element 2: Group</td>
<td valign="top">
<i>Generic name, name</i>, <b><u>*NONE</u></b>, *ALL</td>
</tr>
<tr>
<td valign="top">Element 3: Group sequence</td>
<td valign="top">
1-99, <b><u>*NONE</u></b>, *ALL</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#CPYJOBJS.TOJOB"><b>TOJOB</b></a></td>
<td valign="top">To job entry</td>
<td valign="top">Single values: *RMTLOCNAME, *DATALIB<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Element 1: Job</td>
<td valign="top">
<i>Name</i>, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Group</td>
<td valign="top">
<i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: Group sequence</td>
<td valign="top">
1-99, <b><u>*SAME</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top"><a href="#CPYJOBJS.CPYDEP"><b>CPYDEP</b></a></td>
<td valign="top">Copy dependencies</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYJOBJS.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location name</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYJOBJS.DTALIB"><b>DTALIB</b></a></td>
<td valign="top">Data library</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYJOBJS.APP"><b>APP</b></a></td>
<td valign="top">Application</td>
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CPYJOBJS.ACTION"><b>ACTION</b></a></td>
<td valign="top">Action</td>
<td valign="top"><b><u>*REPORT</u></b>, *COPY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="8"><a href="#CPYJOBJS.ITMOPT"><b>ITMOPT</b></a></td>
<td valign="top">Item options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="8">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Job definition</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 2: Application</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 3: Calendar</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 4: Holiday calendar</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 5: Fiscal calendar</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 6: Library list</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
<tr>
<td valign="top">Element 7: Parameters</td>
<td valign="top">
<b><u>*ADD</u></b>, *REPLACE</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CPYJOBJS.FROMJOB"></a>
<h3>From job entry (FROMJOB)</h3>
<p>Specifies the name of the job schedule entry that you want to copy to create a new job. You must specify a job and alternately can specify a group to which the job belongs as well as a sequence number for the job within the group.
</p>
<p>
<b>Note: </b>Specifying a generic job name or *ALL is only valid when a remote location name is specified for the <b>Remote location name (RMTLOCNAME)</b> parameter or a data library is specified for the <b>Data library (DTALIB)</b> parameter. These parameters are available when specifying *RMTLOCNAME or *DATALIB, respectively, for the <b>To job entry (TOJOB)</b> Job parameter.
</p>
<p>
<b>Note: </b>If you are copying a group, you must specify *ALL for the job name, a single group name, and *ALL for the group sequence.
</p>
<p>This is a required parameter.
</p>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All jobs that meet that other parameters specified in the command are copied.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the job. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with job names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete job name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the job schedule entry that you want to copy.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The job is not assigned to a group.
</dd>
<dt><b>*ALL</b></dt>
<dd>Copy all groups to which the job belongs.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the group. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with group names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete group name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the group to which the job belongs.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is not a sequence number assigned to the job.
</dd>
<dt><b>*ALL</b></dt>
<dd>Copy all sequence numbers.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number of the job within the group.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.TOJOB"></a>
<h3>To job entry (TOJOB)</h3>
<p>Specifies the name of the job schedule entry that you are creating as a result of copying the job or jobs specified for the <b>From job (FROMJOB)</b> parameter. You must specify a job and alternately you can specify a group to which the job belongs as well as a sequence number for the job within the group.
</p>
<p>
<b>Note: </b>If you are copying a group, you must specify *SAME for the job name, a single group name and *SAME for the group sequence.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*RMTLOCNAME</b></dt>
<dd>The jobs are to be copied to the remote location name specified for the <b>Remote location name (RMTLOCNAME)</b> parameter.
</dd>
<dt><b>*DATALIB</b></dt>
<dd>The jobs are to be copied to the data library specified for the <b>Data library (DTALIB)</b> parameter on the same system.
</dd>
</dl>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current name of the job does not change.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the job schedule entry that you want to create from the job that you are copying.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current name of the group does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>The job is not a member of a group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the user-defined name of the group to which the job belongs.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The sequence number of the job does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is not a sequence number assigned to the job.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number of the job within the group.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.CPYDEP"></a>
<h3>Copy dependencies (CPYDEP)</h3>
<p>Specifies whether you should copy the dependencies from the job specified for the FROMJOB parameter to the job specified for the TOJOB parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The job dependencies from the original job are not copied to the new job.
</dd>
<dt><b>*YES</b></dt>
<dd>The job dependencies from the original job are copied to the new job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.RMTLOCNAME"></a>
<h3>Remote location name (RMTLOCNAME)</h3>
<p>Specifies the location and network identification of the system to which you are copying a job.
</p>
<dl>
<dt><b><i>remote-location-name</i></b></dt>
<dd>Specify the name of the remote location associated with the system to which to copy the job.
</dd>
<dt><b><i>network-ID.remote-location-name</i></b></dt>
<dd>Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.DTALIB"></a>
<h3>Data library (DTALIB)</h3>
<p>Specifies the data library to which you are copying a job.
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the data library to which to copy the job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.APP"></a>
<h3>Application (APP)</h3>
<p>Specifies the name of the application to which the job specified for the FROMJOB parameter belongs.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all applications that contain jobs specified for the FROMJOB parameter.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no application specified for this job.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the application. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with application names that begin with the generic name are displayed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete application name.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the application to which the job that you are copying belongs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.ACTION"></a>
<h3>Action (ACTION)</h3>
<p>Specifies whether you want to create a Copy Job Remote report or perform an actual copy.
</p>
<dl>
<dt><b><u>*REPORT</u></b></dt>
<dd>You want to create the Copy Job Remote Report. This is recommended prior to copying jobs to another system, particularly when using *ALL or a generic selection. The printer file for the report is QPIJS2CJ.
</dd>
<dt><b>*COPY</b></dt>
<dd>You want to copy the requested jobs.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CPYJOBJS.ITMOPT"></a>
<h3>Item options (ITMOPT)</h3>
<p>Specify what action is to be taken for each item specified in the action list.
</p>
<p><b>Element 1: Job definition</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the job definition for the job to which you are copying. If the job definition already exists, this job definition will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the job definition for the job to which you are copying. Replace the job definition if it already exists.
</dd>
</dl>
<p><b>Element 2: Application</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the application for the job to which you are copying. If the application already exists, this application will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the application for the job to which you are copying. Replace the application if it already exists.
</dd>
</dl>
<p><b>Element 3: Calendar</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the calendar for the job to which you are copying. If the calendar already exists, this calendar will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the calendar for the job to which you are copying. Replace the calendar if it already exists.
</dd>
</dl>
<p><b>Element 4: Holiday calendar</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the holiday calendar for the job to which you are copying. If the holiday calendar already exists, this holiday calendar will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the holiday calendar for the job to which you are copying. Replace the holiday calendar if it already exists.
</dd>
</dl>
<p><b>Element 5: Fiscal calendar</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the fiscal calendar for the job to which you are copying. If the fiscal calendar already exists, this fiscal calendar will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the fiscal calendar for the job to which you are copying. Replace the fiscal calendar if it already exists.
</dd>
</dl>
<p><b>Element 6: Library list</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the library list for the job to which you are copying. If the library list already exists, this library list will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the library list for the job to which you are copying. Replace the library list if it already exists.
</dd>
</dl>
<p><b>Element 7: Parameters</b>
</p>
<dl>
<dt><b><u>*ADD</u></b></dt>
<dd>Add the parameters for the job to which you are copying. If the parameters already exists, this parameters will not be copied.
</dd>
<dt><b>*REPLACE</b></dt>
<dd>Add the parameters for the job to which you are copying. Replace the parameters if it already exists.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CPYJOBJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Copying a Job to a New Job</b>
</p>
<p>
<pre>
CPYJOBJS FROMJOB(JOB02) TOJOB(JOB03) CPYDEP(*YES)
</pre>
</p>
<p>This command copies JOB02 to a new job called JOB03. The job dependencies from JOB02 are copied to JOB03.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CPYJOBJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#CPYJOBJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>