309 lines
10 KiB
HTML
309 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>Change Job MLB Attributes (CHGJOBMLBA)</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="CHGJOBMLBA.Top_Of_Page"></a>
|
|
<h2>Change Job MLB Attributes (CHGJOBMLBA)</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="#CHGJOBMLBA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGJOBMLBA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGJOBMLBA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGJOBMLBA"></a>
|
|
<p>The Change Job MLB Attributes (CHGJOBMLBA) command allows a user to change the media library resource allocation attributes for a job.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The job being changed must use the same user profile as the user issuing the command, or the issuer must have job control special authority (*JOBCTL).
|
|
</li>
|
|
<li>Only a user with job control special authority (*JOBCTL) can change the resource allocation priority.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGJOBMLBA.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="#CHGJOBMLBA.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, Key, 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="#CHGJOBMLBA.MLB"><b>MLB</b></a></td>
|
|
<td valign="top">Library device</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional, Key, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGJOBMLBA.RSCALCPTY"><b>RSCALCPTY</b></a></td>
|
|
<td valign="top">Resource allocation priority</td>
|
|
<td valign="top">1-99, <b><u>*SAME</u></b>, *DEV, *JOB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGJOBMLBA.INLMNTWAIT"><b>INLMNTWAIT</b></a></td>
|
|
<td valign="top">Initial mount wait time</td>
|
|
<td valign="top">1-600, <b><u>*SAME</u></b>, *DEV, *JOB, *IMMED, *NOMAX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGJOBMLBA.EOVMNTWAIT"><b>EOVMNTWAIT</b></a></td>
|
|
<td valign="top">End of volume mount wait time</td>
|
|
<td valign="top">1-600, <b><u>*SAME</u></b>, *DEV, *JOB, *IMMED, *NOMAX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGJOBMLBA.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the name of the job whose attributes are being changed.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The job whose information is changed is the job from which this command is entered.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Job name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the job name of the job whose attributes are to be changed.
|
|
<p>If no job qualifier is given, all jobs currently in the system are searched for the job name. If more than one occurrence of the specified name is found, a qualified job name must be specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: User</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the user name of the job whose attributes are to be changed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 3: Number</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>000000-999999</i></b></dt>
|
|
<dd>Specify the job number of the job whose attributes are to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGJOBMLBA.MLB"></a>
|
|
<h3>Library device (MLB)</h3>
|
|
<p>Specifies the name of the tape media library device whose attributes are to be changed. The device name must have been created previously on the system using the Create Device Media Library (CRTDEVMLB) command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The attribute change is to apply to all the media library devices.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the tape media library device whose attributes are to be changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGJOBMLBA.RSCALCPTY"></a>
|
|
<h3>Resource allocation priority (RSCALCPTY)</h3>
|
|
<p>Specifies the media library device resource allocation priority for this job. If the resource allocation priority has not been changed for a media library device for the job, *DEV is used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*DEV</b></dt>
|
|
<dd>The resource allocation priority will be retrieved from the device description.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>The priority of the job is used as the resource allocation priority.
|
|
</dd>
|
|
<dt><b><i>1-99</i></b></dt>
|
|
<dd>Specify the priority this job is given when requesting a resource, from 1 (highest) through 99 (lowest).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGJOBMLBA.INLMNTWAIT"></a>
|
|
<h3>Initial mount wait time (INLMNTWAIT)</h3>
|
|
<p>Specifies the maximum amount of time a request will wait for the allocation of a tape resource for the initial mount. If the initial mount wait time has not changed for a media library device for the job, *DEV is used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*DEV</b></dt>
|
|
<dd>The initial mount wait time will be retrieved from the device description.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>The initial mount wait time is determined by rounding the default wait time attribute of the job requesting the allocation to the next highest minute.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The request will not wait for a tape resource to become available.
|
|
</dd>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>The request will wait until a tape resource is available.
|
|
</dd>
|
|
<dt><b><i>1-600</i></b></dt>
|
|
<dd>Specify the number of minutes a request will wait for allocation of a tape resource.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGJOBMLBA.EOVMNTWAIT"></a>
|
|
<h3>End of volume mount wait time (EOVMNTWAIT)</h3>
|
|
<p>Specifies the maximum amount of time a request will wait for allocation of a tape resource to mount the next volume. If the end of volume mount wait time has not changed for a media library device for the job, *DEV is used.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*DEV</b></dt>
|
|
<dd>The end of volume mount wait time will be retrieved from the device description.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>The end of volume mount wait time is determined by rounding the default wait time attribute of the job requesting the allocation to the next highest minute.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The request will not wait for a tape resource to become available.
|
|
</dd>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>The request will wait until a tape resource is available.
|
|
</dd>
|
|
<dt><b><i>1-600</i></b></dt>
|
|
<dd>Specify the number of minutes a request will wait for allocation of a tape resource.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGJOBMLBA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the resource allocation priority for the current job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGJOBMLBA RSCALCPTY(50)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the resource allocation priority for all tape media library devices for the current job to 50.
|
|
</p>
|
|
<p><b>Example 2: Changing the initial mount wait time for a specific job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGJOBMLBA JOB(002345/USERX/QDFTJOBD) INLMNTWAIT(2)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the initial mount wait time for all tape media library devices for the specified job to 2 minutes.
|
|
</p>
|
|
<p><b>Example 3: Changing the resource allocation priority for all tape media libraries used by the current job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGJOBMLBA MLB(*ALL) RSCALCPTY(50)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the resource allocation priority for all tape media library devices for the current job to 50.
|
|
</p>
|
|
<p><b>Example 4: Changing the resource allocation priority for a specific tape media library used by the current job</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGJOBMLBA MLB(TAPMLB01) RSCALCPTY(50)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the resource allocation priority for TAPMLB01 for the current job to 50.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGJOBMLBA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1069</b></dt>
|
|
<dd>End of duplicate names.
|
|
</dd>
|
|
<dt><b>CPF1070</b></dt>
|
|
<dd>Job &3/&2/&1 not found.
|
|
</dd>
|
|
<dt><b>CPF1343</b></dt>
|
|
<dd>Job &3/&2/&1 not valid job type for function.
|
|
</dd>
|
|
<dt><b>CPF1344</b></dt>
|
|
<dd>Not authorized to control job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF6708</b></dt>
|
|
<dd>Command ended due to error.
|
|
</dd>
|
|
<dt><b>CPF6745</b></dt>
|
|
<dd>Device &1 not a media library device.
|
|
</dd>
|
|
<dt><b>CPF67B5</b></dt>
|
|
<dd>&3/&2/&1 not authorized to change attribute.
|
|
</dd>
|
|
<dt><b>CPF9814</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGJOBMLBA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|