737 lines
28 KiB
HTML
737 lines
28 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>Vary Configuration (VRYCFG)</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="VRYCFG.Top_Of_Page"></a>
|
||
|
|
<h2>Vary Configuration (VRYCFG)</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="#VRYCFG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#VRYCFG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#VRYCFG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="VRYCFG"></a>
|
||
|
|
<p>The Vary Configuration (VRYCFG) command varies on or off one or more configuration objects, with the capability of also varying on the downline attached configuration objects. The VRYCFG command also optionally resets the input/output processor (IOP) associated with the specified object.
|
||
|
|
</p>
|
||
|
|
<p>The configuration objects that can be varied on or off are network server, network interfaces, lines, controllers, and devices. This command applies to all network interfaces, lines, controllers and devices on the system.
|
||
|
|
</p>
|
||
|
|
<p>For the configuration object type of media library resource, this command can be used to reset the drives within a tape media library device or change the allocation of drives within a tape media library device or an optical media library device. To determine the current allocation of drive resources, use the Work with Media Library Status (WRKMLBSTS) command.
|
||
|
|
</p>
|
||
|
|
<p>External LAN TCP/IP interfaces attached to network server objects of type *WINDOWSNT are automatically started by default and can optionally be controlled with the <b>Start TCP/IP interfaces (STRTCPIFC)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>Downline attached objects can be varied on or off along with the specified object by specifying the value *NET for the <b>Range (RANGE)</b> parameter. Downline attached objects of a network interface description are all the lines attached to the network interface, all the controllers attached to the lines, and all the devices attached to the controllers. Downline attached objects of a line are all the attached controllers and all the devices attached to the controllers. Downline attached objects of a controller are all the attached devices. Devices do not have downline attachments. The RANGE parameter has no affect when varying devices.
|
||
|
|
</p>
|
||
|
|
<p>Varying on network interfaces, and lines synchronously or asynchronously can be controlled by the <b>Vary on wait (VRYWAIT)</b> parameter. This applies only to Token-Ring, Ethernet, X.25, or switched SDLC, IDLC, BSC, and Async line descriptions. The value specified for the VRYWAIT parameter determines how long the system will wait until either the object goes to varied on before completing the vary on command, or until the timer expires.
|
||
|
|
</p>
|
||
|
|
<p>The VRYCFG command can also be used to reset input/output processors. An IOP can be a communications controller, a local work station controller, or a magnetic media controller. An IOP reset is valid only when the following are being varied on:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Network Interface Descriptions
|
||
|
|
</li>
|
||
|
|
<li>Lines (except twinaxial data link control (TDLC) lines)
|
||
|
|
</li>
|
||
|
|
<li>Local work station controllers
|
||
|
|
</li>
|
||
|
|
<li>Tapes
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A network server object of type *ISCSI cannot be varied on:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Until the Network Server Host Adapter Device Description is varied on.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A line cannot be varied on:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Until the Network Interface Description is varied on, in the case of IDLC lines.
|
||
|
|
</li>
|
||
|
|
<li>Until the Network Server Description is varied on.
|
||
|
|
</li>
|
||
|
|
<li>Until a dial connection has been completed, in the case of switched lines.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A controller cannot be varied on:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If the line to which it is attached is varied off, in the case of nonswitched lines.
|
||
|
|
</li>
|
||
|
|
<li>Until a dial connection has been completed, in the case of switched lines.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A device cannot be varied on:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If the controller to which it is attached is varied offline. In the case of some tape devices, they are not attached to a controller, so this restriction does not apply.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A network server cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Until all attached devices and controllers are varied off. Varying off the server also varies off the attached line descriptions.
|
||
|
|
</li>
|
||
|
|
<li>If any system clients have files open on the server.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Use the Work with Network Service Status (WRKNWSSTS) command (available from Work with Configuration Status display) to determine the status of network server sessions with other clients.
|
||
|
|
</p>
|
||
|
|
<p>A network interface description cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Until all attached lines, controllers and devices are varied off.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A line cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Until all the attached controllers and devices are varied off.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A controller cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If it is being used, or is allocated for use.
|
||
|
|
</li>
|
||
|
|
<li>Until all the attached devices are varied off.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A device cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If it is being used, or is allocated for use.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>A network server host adapter device cannot be varied off:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If any network server description that is using it is varied on.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>When the RANGE parameter is used:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>For devices: The value *NET to vary on or off downline attached objects has no effect. Devices do not have downline attached objects.
|
||
|
|
</li>
|
||
|
|
<li>For switched lines: The value *NET, only when varying on, has no effect. The value *NET, when varying off, will vary off the line and its downline attached objects.
|
||
|
|
</li>
|
||
|
|
<li>For Network Interface Descriptions: When varying on, the value *NET varies on all nonswitched attachments, and when varying off, *NET varies off all nonswitched attachments.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>When the VRYWAIT parameter is used:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The time to vary on a line or network interface is the time it takes to put tasks in place to manage the line, the time to activate the communications I/O processor (IOP), including download of the IOP program, the time to establish communications with the data circuit-terminating equipment (DCE), and so on.
|
||
|
|
</li>
|
||
|
|
<li>Line or network interface vary on time does not include telephone dialing time; however, a powered off modem may prevent vary on completion and cause the wait time to expire. If the timer expires, an informational message will be sent to the QSYSOPR message queue. This will be followed by the vary on completion message.
|
||
|
|
</li>
|
||
|
|
<li>If the VRYWAIT parameter is specified on the VRYCFG command for a line description that is not Token-Ring, Ethernet, X.25, or switched SDLC, BSC, or Async, the parameter is accepted but ignored.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>When the <b>Reset system (RESETSYS)</b> parameter is used:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>For Network Server Descriptions: When varying on, the value *YES will force IBM Director to interface with the xSeries system and validate the xSeries is available for activity.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="VRYCFG.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="#VRYCFG.CFGOBJ"><b>CFGOBJ</b></a></td>
|
||
|
|
<td valign="top">Configuration object</td>
|
||
|
|
<td valign="top">Single values: *ANYNW, *APPN, *PRVCFGTYPE<br>Other values (up to 256 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.CFGTYPE"><b>CFGTYPE</b></a></td>
|
||
|
|
<td valign="top">Type</td>
|
||
|
|
<td valign="top">*NWS, *NWI, *LIN, *CTL, *DEV, *MLBRSC</td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.STATUS"><b>STATUS</b></a></td>
|
||
|
|
<td valign="top">Status</td>
|
||
|
|
<td valign="top">*ON, *OFF, *RESET, *ALLOCATE, *UNPROTECTED, *DEALLOCATE</td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.RANGE"><b>RANGE</b></a></td>
|
||
|
|
<td valign="top">Range</td>
|
||
|
|
<td valign="top"><b><u>*NET</u></b>, *OBJ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.VRYWAIT"><b>VRYWAIT</b></a></td>
|
||
|
|
<td valign="top">Vary on wait</td>
|
||
|
|
<td valign="top">15-180, <b><u>*CFGOBJ</u></b>, *NOWAIT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.ASCVRYOFF"><b>ASCVRYOFF</b></a></td>
|
||
|
|
<td valign="top">Asynchronous vary off</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.RESET"><b>RESET</b></a></td>
|
||
|
|
<td valign="top">Reset</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.RSRCNAME"><b>RSRCNAME</b></a></td>
|
||
|
|
<td valign="top">Resource name</td>
|
||
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 16 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.FRCVRYOFF"><b>FRCVRYOFF</b></a></td>
|
||
|
|
<td valign="top">Forced vary off</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES, *LOCK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.SBMMLTJOB"><b>SBMMLTJOB</b></a></td>
|
||
|
|
<td valign="top">Submit multiple jobs</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#VRYCFG.JOBD"><b>JOBD</b></a></td>
|
||
|
|
<td valign="top">Job description</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Job description</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>QBATCH</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.GENPTHCERT"><b>GENPTHCERT</b></a></td>
|
||
|
|
<td valign="top">Generate path certificate</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#VRYCFG.RESETSYS"><b>RESETSYS</b></a></td>
|
||
|
|
<td valign="top">Reset system</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="VRYCFG.CFGOBJ"></a>
|
||
|
|
<h3>Configuration object (CFGOBJ)</h3>
|
||
|
|
<p>Specifies the configuration objects to be varied.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANYNW</b></dt>
|
||
|
|
<dd>All controller descriptions that specify a link type of *ANYNW will be varied on or off. This value is only valid if CFGTYPE is *CTL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPN</b></dt>
|
||
|
|
<dd>All objects that use Advanced Peer-to-Peer Networking (APPN) will be varied on or off. This value is only valid if CFGTYPE is *CTL or *DEV.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRVCFGTYPE</b></dt>
|
||
|
|
<dd>Process all objects that were processed the last time this command was run in this job for the specified configuration object type.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 256 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify a generic name of the configuration objects to be varied.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the configuration object to be varied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.CFGTYPE"></a>
|
||
|
|
<h3>Type (CFGTYPE)</h3>
|
||
|
|
<p>Specifies the type of object to be varied.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NWS</b></dt>
|
||
|
|
<dd>The network server is varied on or off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NWI</b></dt>
|
||
|
|
<dd>A network interface description is varied on or off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIN</b></dt>
|
||
|
|
<dd>A line description is varied on or off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CTL</b></dt>
|
||
|
|
<dd>A controller description is varied on or off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEV</b></dt>
|
||
|
|
<dd>A device description is varied on or off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MLBRSC</b></dt>
|
||
|
|
<dd>The status for drives within a media library is changed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.STATUS"></a>
|
||
|
|
<h3>Status (STATUS)</h3>
|
||
|
|
<p>Specifies whether to vary the object on or off.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ON</b></dt>
|
||
|
|
<dd>The object is varied on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OFF</b></dt>
|
||
|
|
<dd>The object is varied off.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RESET</b></dt>
|
||
|
|
<dd>The drive resources of the tape media library device are reset.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The drive resources must be specified for the <b>Resource name (RSRCNAME)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>The media library device must be varied on before this value can be specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLOCATE</b></dt>
|
||
|
|
<dd>For tape, the drive resources of the tape media library device are allocated for use only by this system. If the library device is shared by multiple systems, other systems cannot use these drives while this device description is varied on. For optical, the drive resources of the optical media library device are allocated for use. The drive resources are only available for use by this media library device.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The drive resources must be specified for the <b>Resource name (RSRCNAME)</b> parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNPROTECTED</b></dt>
|
||
|
|
<dd>The drive resources of the tape media library device can be used by all systems that share this library device.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value is not recommended. When the drive resources are in unprotected mode, each system can access the resource at the same time. Unpredictable results can occur.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEALLOCATE</b></dt>
|
||
|
|
<dd>For tape, the drive resources of the tape media library device are deallocated for this system. If the tape media library is shared by multiple systems, the drives cannot be used by this system, but can be used by other systems. For optical, the drive resources of the optical media library resource are deallocated for the media library resource. The drives are not available for use by another optical media library device.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The drive resources must be specified for the <b>Resource name (RSRCNAME)</b> parameter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.RANGE"></a>
|
||
|
|
<h3>Range (RANGE)</h3>
|
||
|
|
<p>Specifies what configuration elements are varied.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NET</u></b></dt>
|
||
|
|
<dd>All downline attached configuration elements are varied.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OBJ</b></dt>
|
||
|
|
<dd>Only the specified object is varied.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.VRYWAIT"></a>
|
||
|
|
<h3>Vary on wait (VRYWAIT)</h3>
|
||
|
|
<p>Specifies whether the object is varied on asynchronously or synchronously. For synchronous vary on, specifies how long the system waits for the vary on to complete.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CFGOBJ</u></b></dt>
|
||
|
|
<dd>The system uses the value specified for the <b>Vary on wait (VRYWAIT)</b> parameter in the network interface or line description.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOWAIT</b></dt>
|
||
|
|
<dd>Do not wait for vary on completion. The network interface or line will vary on asynchronously.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>15-180</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait. The system will wait until either the timer expires or until the line or network interface goes to varied on, before completing the VRYCFG command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.ASCVRYOFF"></a>
|
||
|
|
<h3>Asynchronous vary off (ASCVRYOFF)</h3>
|
||
|
|
<p>Specifies whether the object is varied off synchronously or asynchronously.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The object is varied off synchronously.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The object is varied off asynchronously.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.RESET"></a>
|
||
|
|
<h3>Reset (RESET)</h3>
|
||
|
|
<p>Specifies if a reset is to be done for the IOP associated with the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The associated IOP is not reset.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The associated IOP is reset.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.RSRCNAME"></a>
|
||
|
|
<h3>Resource name (RSRCNAME)</h3>
|
||
|
|
<p>Specifies the drives within the media library device to be reset or reallocated.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All drives within the media library device are to be reset or reallocated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 16 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the drive within the media library device to be reset or reallocated.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.FRCVRYOFF"></a>
|
||
|
|
<h3>Forced vary off (FRCVRYOFF)</h3>
|
||
|
|
<p>Specifies whether inquiry messages for active jobs will be issued. This parameter is not allowed when STATUS(*ON) is specified.
|
||
|
|
</p>
|
||
|
|
<p><b><u> Notes: </u></b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This parameter is valid for STATUS(*DEALLOCATE) only when a tape media library object is specified for the <b>Configuration object (CFGOBJ)</b> parameter.
|
||
|
|
</li>
|
||
|
|
<li>For any value other than *NO, the ability to reject the vary request through a user exit program is revoked. See the QIBM_QDC_VRYEXIT exit point documentation in the iSeries Information Center for additional information on vary configuration exit point processing.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Inquiry messages for active jobs will be issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Inquiry messages for active jobs will not be issued and the jobs will be ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOCK</b></dt>
|
||
|
|
<dd>For devices other than APPC, Intra, NWSH, and MLB an attempt will be made to get a lock on the device description no matter what its current status might be. If the lock is successfully obtained, it will be transferred to the system job assigned to hold the device description lock when the device is in a varied off state. If the device is in a state other than varied off, an attempt to vary off the device description will also be made.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.SBMMLTJOB"></a>
|
||
|
|
<h3>Submit multiple jobs (SBMMLTJOB)</h3>
|
||
|
|
<p>Specifies whether or not to submit multiple batch jobs to vary the specified network server or auxiliary storage pool (ASP) device description objects. This parameter is valid only when *NWS or *DEV is specified for the <b>Type (CFGTYPE)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>All specified network server or auxiliary storage pool (ASP) device descriptions will be varied synchronously in the job under which the original VRYCFG command was issued.
|
||
|
|
</dd>
|
||
|
|
<dt><b> *YES</b></dt>
|
||
|
|
<dd>A new VRYCFG command will be submitted in batch for each network server or auxiliary storage pool (ASP) description specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.JOBD"></a>
|
||
|
|
<h3>Job description (JOBD)</h3>
|
||
|
|
<p>Specifies the job description to which multiple VRYCFG commands will be submitted in batch. This parameter is valid only when CFGTYPE is *NWS or *DEV and SBMMLTJOB is *YES.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Job description</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QBATCH</u></b></dt>
|
||
|
|
<dd>Job description QBATCH is used as the job description of the submitted job. Note that the QBATCH job description, as shipped with the system, specifies job queue QBATCH which is configured to allow a maximum of 1 job to run at a time.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the job description used for the submitted job. In order to run several varies in parallel a job description could be created to pass jobs to the job queue QSYS/QUSRNOMAX which is shipped with no maximum on the number of active jobs:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTJOBD JOBD(QSYS/QUSRNOMAX) JOBQ(QSYS/QUSRNOMAX)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Other considerations are that the subsystem that allocates the job queue should not have the queue in a held state and the system should not be in a restricted state.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the job description is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.GENPTHCERT"></a>
|
||
|
|
<h3>Generate path certificate (GENPTHCERT)</h3>
|
||
|
|
<p>Specifies whether to generate a new set of certificates on a remote network server system. This parameter is valid only when CFGTYPE is *NWS and the network server description is of type *ISCSI and the STATUS is *ON.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The set of certificates is not generated.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The set of certificates is generated.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You must have input/output system configuration (*IOSYSCFG) special authority to use this parameter value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="VRYCFG.RESETSYS"></a>
|
||
|
|
<h3>Reset system (RESETSYS)</h3>
|
||
|
|
<p>Specifies whether to force a reset of the remote network server system, regardless of its current power state. This is an advanced function, caution is advised when this option is selected. This parameter is valid only when CFGTYPE is *NWS and the network server description is of type *ISCSI and the STATUS is *ON.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The system is not reset.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The system is reset.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You must have all object (*ALLOBJ) special authority to use this parameter value.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="VRYCFG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Varying On the Network Interface and Downline Attachments</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(NWI1) CFGTYPE(*NWI) STATUS(*ON)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on the network interface and all downline attachments.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Varying Off the Line and Attached Downline Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(LINE1) CFGTYPE(*LIN) STATUS(*OFF)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies off the line and all attached downline objects. The RANGE parameter took the default value of *NET.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Varying on the Controller</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(CONTROLLER1) CFGTYPE(*CTL) STATUS(*ON)
|
||
|
|
RANGE(*OBJ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on only the controller.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Varying on the Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(DEVICE1) CFGTYPE(*DEV)
|
||
|
|
STATUS(*ON) RANGE(*NET)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on only the device. Note the RANGE parameter value has no effect on devices.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Varying on the Line and Resetting the IOP</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(LINE1) CFGTYPE(*LIN) STATUS(*ON)
|
||
|
|
RANGE(*OBJ) RESET(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on only the line and resets the associated IOP.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Using Line Description Value for Wait Time</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(LINE1) OJBTYPE(*LIN) STATUS(*ON)
|
||
|
|
RANGE(*OBJ) VRYWAIT(*CFGOBJ)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on only the line and uses the vary wait time value specified in the line description for LINE1.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Using 80 Seconds as Vary Wait Time</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(LINE1) CFGTYPE(*LIN) STATUS(*ON)
|
||
|
|
RANGE(*OBJ) VRYWAIT(80)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on only the line using 80 seconds as the vary wait time value.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 8: Varying on a Network Server</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(SERVER1) CFGTYPE(*NWS) STATUS(*ON)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command varies on the network server description named SERVER1 and its attached line descriptions. The vary on wait value specified in the network server description is used. Note that the RANGE and RESET parameters are ignored for network servers if they are specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 9: Resetting Drives Within a Media Library</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(MYLIBRARY) CFGTYPE(*MLBRSC) STATUS(*RESET)
|
||
|
|
RSRCNAME(TAP01 TAP02)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command resets the drives TAP01 and TAP02 within the media library device MYLIBRARY. The device MYLIBRARY must be varied on to perform this action.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 10: Deallocating Drives Within a Media Library</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(MYLIBRARY) CFGTYPE(*MLBRSC)
|
||
|
|
STATUS(*DEALLOCATE) RSRCNAME(OPT02)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command deallocates drive OPT02 within the media library device MYLIBRARY. The device MYLIBRARY must be varied on to perform this action.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 11: Varying On Multiple Network Servers in Parallel</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(IPCS*) CFGTYPE(*NWS) STATUS(*ON)
|
||
|
|
SBMMLTJOB(*YES) JOBD(*LIBL/QBATCH)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command submits a separate batch job to perform the vary on for each network server which has a name that begins with IPCS. The number of jobs that run in parallel depends on the configuration of the subsystem being used.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 12: Reset Certificates when Varying On Network Server</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(SERVER1) CFGTYPE(*NWS) STATUS(*ON)
|
||
|
|
GENPTHCERT(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command will vary on the network server and request that a new set of certificates are generated during the vary on.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 13: Restart Remote Network Server at Vary on of Server</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
VRYCFG CFGOBJ(SERVER1) CFGTYPE(*NWS) STATUS(*ON)
|
||
|
|
RESETSYS(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command will vary on the network server and request a reset of the remote network server during the vary on of SERVER1.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="VRYCFG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF26AF</b></dt>
|
||
|
|
<dd>Status of drive resources in device description &1 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF26B6</b></dt>
|
||
|
|
<dd>Initialization program has ended with a hard error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF26B7</b></dt>
|
||
|
|
<dd>Initialization program ended with soft error.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF262E</b></dt>
|
||
|
|
<dd>Error occurred during vary on at IPL processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF262F</b></dt>
|
||
|
|
<dd>QDCTRF stopped due to failure.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2640</b></dt>
|
||
|
|
<dd>Vary command not processed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2659</b></dt>
|
||
|
|
<dd>Vary command may not have completed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#VRYCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|