1294 lines
50 KiB
HTML
1294 lines
50 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 Object CRQ Activity (CHGOBJCRQA)</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="CHGOBJCRQA.Top_Of_Page"></a>
|
||
|
|
<h2>Change Object CRQ Activity (CHGOBJCRQA)</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="#CHGOBJCRQA.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGOBJCRQA.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGOBJCRQA.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGOBJCRQA"></a>
|
||
|
|
<p>The Change Object Change Request Activity (CHGOBJCRQA) command changes an object distribution activity in a change request description. The object referred to in the activity can be an i5/OS object identified by an i5/OS object name or a global name, or a non-i5/OS object such as a PS/2 file which is identified by a global name.
|
||
|
|
</p>
|
||
|
|
<p>The activity can be conditioned so that it only runs after one or more other activities have completed (successfully or unsuccessfully). The activity can also be scheduled to run at a date and time in the future.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have *CHANGE authority to the change request description and *EXECUTE authority to the library.
|
||
|
|
</li>
|
||
|
|
<li>An object can be specified using an i5/OS object name or a global name but not both.
|
||
|
|
</li>
|
||
|
|
<li>The global name can be a maximum of 65-<i>n</i> characters in length, where <i>n</i> is the number of tokens. A maximum of 10 tokens can be specified.
|
||
|
|
</li>
|
||
|
|
<li>Only i5/OS program objects or file members such as CL and REXX can be run.
|
||
|
|
</li>
|
||
|
|
<li>The object to be distributed cannot reside in the QTEMP library.
|
||
|
|
</li>
|
||
|
|
<li>If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<p>The following notes provide information on how the command works.
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>When you add the activity, you do not need to be authorized to any objects that are to be manipulated. When you submit a change request, you must be authorized to any objects that are manipulated.
|
||
|
|
</li>
|
||
|
|
<li>The save and restore history for the object is not updated when it is sent or retrieved.
|
||
|
|
</li>
|
||
|
|
<li>Active message queues are not saved when libraries (*LIB) are sent or retrieved.
|
||
|
|
</li>
|
||
|
|
<li>All conditions must be satisfied before the activity can be run.
|
||
|
|
</li>
|
||
|
|
<li>The start times indicate when the activity can be started. Actual start times can be later due to network delays and system delays.
|
||
|
|
</li>
|
||
|
|
<li>If a global name is to be used, the Add Distribution Catalog Entry (ADDDSTCLGE) command can be used to indicate where the object is located or is to be stored.
|
||
|
|
</li>
|
||
|
|
<li>Authorization to the object specified on the activity is not verified until the activity runs.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGOBJCRQA.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="#CHGOBJCRQA.CRQD"><b>CRQD</b></a></td>
|
||
|
|
<td valign="top">Change request description</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Change request description</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="#CHGOBJCRQA.ACTIVITY"><b>ACTIVITY</b></a></td>
|
||
|
|
<td valign="top">Activity</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LAST</td>
|
||
|
|
<td valign="top">Required, Key, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.ACTION"><b>ACTION</b></a></td>
|
||
|
|
<td valign="top">Action</td>
|
||
|
|
<td valign="top">*SND, *RTV, *DLT, *RUN, *SNDRUN, *INS, *SNDINS, *UNINS, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGOBJCRQA.OBJ"><b>OBJ</b></a></td>
|
||
|
|
<td valign="top">Object</td>
|
||
|
|
<td valign="top">Single values: *GLOBAL, *COMPNAME, <b><u>*SAME</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Object</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="11"><a href="#CHGOBJCRQA.GLBNAME"><b>GLBNAME</b></a></td>
|
||
|
|
<td valign="top">Global name</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="11">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Global name token 1</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Global name token 2</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Global name token 3</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Global name token 4</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 5: Global name token 5</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 6: Global name token 6</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 7: Global name token 7</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 8: Global name token 8</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 9: Global name token 9</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 10: Global name token 10</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.OBJTYPE"><b>OBJTYPE</b></a></td>
|
||
|
|
<td valign="top">Object type</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.MBR"><b>MBR</b></a></td>
|
||
|
|
<td valign="top">Member</td>
|
||
|
|
<td valign="top"><i>Name</i>, *FIRST, *LAST, *ALL, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.DATATYPE"><b>DATATYPE</b></a></td>
|
||
|
|
<td valign="top">Data type</td>
|
||
|
|
<td valign="top">*UNSPEC, *CL, *REXX, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="8"><a href="#CHGOBJCRQA.COMPNAME"><b>COMPNAME</b></a></td>
|
||
|
|
<td valign="top">Component name</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="8">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Component name token 1</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Component name token 2</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Component name token 3</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Component name token 4</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 5: Component name token 5</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 6: Component name token 6</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 7: Component name token 7</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *NETID, *CPNAME</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.REFLVL"><b>REFLVL</b></a></td>
|
||
|
|
<td valign="top">Refresh level</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CHGOBJCRQA.NODL"><b>NODL</b></a></td>
|
||
|
|
<td valign="top">Managed systems node list</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Node list</td>
|
||
|
|
<td valign="top">
|
||
|
|
Single values: *NONE, <b><u>*SAME</u></b><br>Other values: <i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Node list</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGOBJCRQA.CPNAME"><b>CPNAME</b></a></td>
|
||
|
|
<td valign="top">Managed system node names</td>
|
||
|
|
<td valign="top">Single values: *NONE, <b><u>*SAME</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Network identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, *NETATR</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Control point</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top">*CURRENT, *PRV, V5R2M0, V5R3M0, V5R4M0, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.REPLACE"><b>REPLACE</b></a></td>
|
||
|
|
<td valign="top">Replace object</td>
|
||
|
|
<td valign="top">*NO, *YES, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top">*SNA, *NONE, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.KEEPCLGE"><b>KEEPCLGE</b></a></td>
|
||
|
|
<td valign="top">Keep catalog entry</td>
|
||
|
|
<td valign="top">*YES, *NO, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.PARM"><b>PARM</b></a></td>
|
||
|
|
<td valign="top">Parameters</td>
|
||
|
|
<td valign="top">Values (up to 20 repetitions): <i>Not restricted</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#CHGOBJCRQA.RMTSTRTIME"><b>RMTSTRTIME</b></a></td>
|
||
|
|
<td valign="top">Start time on managed system</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Time zone</td>
|
||
|
|
<td valign="top">
|
||
|
|
*LCLSYS, *MGDSYS, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Start after</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, *CURRENT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, *CURRENT, *NEXT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, *GEN, *BLANK, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#CHGOBJCRQA.COND"><b>COND</b></a></td>
|
||
|
|
<td valign="top">Activity conditions</td>
|
||
|
|
<td valign="top">Single values: *NONE, <b><u>*SAME</u></b><br>Other values (up to 5 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Activity</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Generic name, name</i>, <b><u>*PRV</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Relational operator</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*EQ</u></b>, *GT, *LT, *LE, *NE, *GE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: End code</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99, <b><u>*SUCCESS</u></b>, *FAIL, *NOTRUN, *ANY</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Condition mode</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*ALLNODES</u></b>, *SAMENODE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#CHGOBJCRQA.STRTIME"><b>STRTIME</b></a></td>
|
||
|
|
<td valign="top">Activity start time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Start after</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, *CURRENT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, *CURRENT, *NEXT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Start before</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, *ANY, *CURRENT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, *ANY, *CURRENT, *NEXT, <b><u>*SAME</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGOBJCRQA.HOLD"><b>HOLD</b></a></td>
|
||
|
|
<td valign="top">Hold activity</td>
|
||
|
|
<td valign="top">*NO, *YES, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGOBJCRQA.CRQD"></a>
|
||
|
|
<h3>Change request description (CRQD)</h3>
|
||
|
|
<p>Specifies the change request description object name. CRQD is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p>The possible library values are the following:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All of the libraries in the user and in the system portions of the job's library list are searched.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job used to locate the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify only the library named in this parameter is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>change-request-description</i></b></dt>
|
||
|
|
<dd>Specify the name of the change request description object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.ACTIVITY"></a>
|
||
|
|
<h3>Activity (ACTIVITY)</h3>
|
||
|
|
<p>Specifies the name of the activity to change in the change request description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The activity is the last to run in the change request. When *LAST is specified for the activity (ACTIVITY) parameter, the condition (COND) parameter and the start time (STRTIME) parameter cannot be specified. Only one activity named *LAST can exist in the change request description.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>activity-name</i></b></dt>
|
||
|
|
<dd>Specify a 10-character activity name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.ACTION"></a>
|
||
|
|
<h3>Action (ACTION)</h3>
|
||
|
|
<p>Specifies the object distribution functions to be performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SND</b></dt>
|
||
|
|
<dd>Sends the specified object to the specified managed system or systems.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTV</b></dt>
|
||
|
|
<dd>Retrieves the specified object from the specified managed system or systems. To retrieve an object from more than one system, a global name with an *ANY token is required so that each retrieved object has a unique global name. Global names with unspecified tokens (*ALL, *HIGHEST, or *LOWEST) are stored in the distribution repository when they are retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DLT</b></dt>
|
||
|
|
<dd>Deletes the specified object on the specified system or systems.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RUN</b></dt>
|
||
|
|
<dd>Runs the specified program on the specified system or systems. i5/OS program objects (*PGM), REXX programs, or file members, containing a CL input stream or an REXX procedure, can be run on iSeries managed systems.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SNDRUN</b></dt>
|
||
|
|
<dd>Sends the specified program and runs it on the specified system or systems. The program that is sent deletes on completion.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*INS</b></dt>
|
||
|
|
<dd>Sends the specified program and runs it on the specified managed system or systems. Only installable objects can be installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SNDINS</b></dt>
|
||
|
|
<dd>Sends the objects, previously packaged for installation, on the specified managed system or systems, and installs them. Only objects identified by global names can be installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNINS</b></dt>
|
||
|
|
<dd>Removes the objects installed on the specified managed system or systems. Only objects identified by global names can be deleted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.OBJ"></a>
|
||
|
|
<h3>Object (OBJ)</h3>
|
||
|
|
<p>Specifies the name of the object that is run, sent, retrieved, or deleted. For send and retrieve actions, the object name represents the name of the object on both the central site system and the managed systems.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GLOBAL</b></dt>
|
||
|
|
<dd>The object is identified by the global name specified on GLBNAME parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are one of the following:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>All of the libraries in the user and in the system portions of the job's library list are searched.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify that only the library named in this parameter is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible object name value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>object-name</i></b></dt>
|
||
|
|
<dd>Specify the object name. Only characters A through Z, 0 through 9, dollar sign, at sign, and number sign can be used in the object names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.GLBNAME"></a>
|
||
|
|
<h3>Global name (GLBNAME)</h3>
|
||
|
|
<p>Specifies a global name, which is a series of tokens that uniquely identify an object in an SNA network. The global name represents the name that is used to locate the appropriate catalog entry on both the central site system and the managed systems. The catalog entry specifies the object that is used on that system. For example, if a retrieve action is specified, the global name is used to determine the object that is retrieved on the managed system. Also, the global name shows the location where it is to be stored on the central site system.
|
||
|
|
</p>
|
||
|
|
<p>Special values in a token position indicate how to search for the object. By specifying *ANY in a token position, the token is ignored when searching for the correct object. If multiple objects are found matching the tokens specified, an error is returned.
|
||
|
|
</p>
|
||
|
|
<p>If an object is sent, the global name must have been previously cataloged so that it is associated with a local object name or loaded into the distribution repository. Retrieved objects for which no catalog entry exists are placed in the distribution repository. The GLBNAME parameter is are ignored if the object name is not *GLOBAL.
|
||
|
|
</p>
|
||
|
|
<p>The GLBNAME parameter is not valid when the ACTION value is *UNINS. When the OBJ is *GLOBAL and the global name maps to an installable object, the global name must have the following structure.
|
||
|
|
</p>
|
||
|
|
<p>ComponentName REF RefreshLevel
|
||
|
|
</p>
|
||
|
|
<p>In this example,
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Component names are the tokens before the token with the REF value. It is used to distinguish objects of an installable object from those from another. The component can be between 1 and 7 tokens.
|
||
|
|
</li>
|
||
|
|
<li>The REF token is required to identify the global name as an installable object. It can only be specified from token 2 through 8 in the global name.
|
||
|
|
</li>
|
||
|
|
<li>The refresh level is a token with a numeric value. The refresh level shows the level of the installable object and must follow the token with the REF value.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The possible single value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Token 1</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETID</b></dt>
|
||
|
|
<dd>The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>global-name-token</i></b></dt>
|
||
|
|
<dd>Specify the first token of the global name. The first token is recommended to be the registered enterprise ID or network ID.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Elements 2-10: Tokens 2-10</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>Any token value matches when searching for the object where the action is performed. This is useful when retrieving objects for which some of the tokens in the global name are not known or vary between systems.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HIGHEST</b></dt>
|
||
|
|
<dd>The object with the highest token value has the action performed on it. The token must be ordered. This is useful when a token in a global name is used to indicate a different version of the object and you need to manipulate the object with the highest version level.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOWEST</b></dt>
|
||
|
|
<dd>The object with the lowest token value has the action performed on it. The token must be ordered. This is useful when a token in a global name is used to indicate a different version of the object and you need to manipulate the object with the lowest version level.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NETID</b></dt>
|
||
|
|
<dd>The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CPNAME</b></dt>
|
||
|
|
<dd>The control point name of this system is used. The control point is determined by the current value of the LCLCPNAME network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SERVER</b></dt>
|
||
|
|
<dd>This token is stored within the change request activity with the value &SERVER, and is replaced by the short name of the change control server when the object is distributed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*TARGET</b></dt>
|
||
|
|
<dd>This token is stored within the change request activity with the value &TARGET, and is replaced by the short name of the target when the object is distributed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MDDATE</b></dt>
|
||
|
|
<dd>This token is stored within the change request activity with the value &DATE, and is replaced when distributed by the date the object was last modified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MDTIME</b></dt>
|
||
|
|
<dd>This token is stored within the change request activity with the value &TIME, and is replaced when distributed by the time the object was last modified.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>For more detailed information about the Change Control Server support see the Managed System Services/400 Use book.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>global-name-token</i></b></dt>
|
||
|
|
<dd>Specify one of a series of 1 to 16 character tokens that uniquely identify the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.OBJTYPE"></a>
|
||
|
|
<h3>Object type (OBJTYPE)</h3>
|
||
|
|
<p>Specifies the object type. It is ignored if a global name is used.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FILEDATA</b></dt>
|
||
|
|
<dd>A file member should be transferred without the file attributes. This is used to move files between an iSeries system and non-iSeries systems. The *FILE object type can be used with iSeries systems to preserve the file attributes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>object-type</i></b></dt>
|
||
|
|
<dd>Specify the i5/OS object type.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.MBR"></a>
|
||
|
|
<h3>Member (MBR)</h3>
|
||
|
|
<p>Specifies the physical file member name. This is ignored unless the object type is *FILE or *FILEDATA.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The action should be performed on all members within the physical file. The object type must be *FILE. *ALL must be used for file types that do not have members such as device files. *ALL is not allowed when the action is *SNDRUN or *RUN, or *FIRST and *LAST for the *RUN action.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FIRST</b></dt>
|
||
|
|
<dd>The action should be performed on the first member (by date added) in the physical file. The member name is determined when the activity is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LAST</b></dt>
|
||
|
|
<dd>The action should be performed on the last member (by date added) in the physical file. The member name is determined when the activity is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>Specify the member name on which the action should be performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.DATATYPE"></a>
|
||
|
|
<h3>Data type (DATATYPE)</h3>
|
||
|
|
<p>Specifies the data type of the member. It is used to specify the type of source file that is run on the managed system. This parameter is ignored when a file is not being sent or run.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*UNSPEC</b></dt>
|
||
|
|
<dd>Unspecified file member type. If the data type cannot be determined at the managed system, or if the name of the file where this member resides is QCLSRC, then the file member is treated as a CL batch input stream. If the source file is named QREXSRC, the file member is treated as a REXX procedure.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CL</b></dt>
|
||
|
|
<dd>The file member contains control language, in other words, a CL batch input stream.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REXX</b></dt>
|
||
|
|
<dd>The file member contains a REXX procedure.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.COMPNAME"></a>
|
||
|
|
<h3>Component name (COMPNAME)</h3>
|
||
|
|
<p>A component name, which is the set of tokens of a global name previous to the REF token. It is the object on which the *UNINS action acts on. COMPNAME is only valid when ACTION(*UNINS) and OBJ(*COMPNAME) are specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible single value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Token 1</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETID</b></dt>
|
||
|
|
<dd>The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>component-name-token</i></b></dt>
|
||
|
|
<dd>One of a series of 1 to 16 character tokens that uniquely identifies the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Elements 2-7: Tokens 2-7</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETID</b></dt>
|
||
|
|
<dd>The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CPNAME</b></dt>
|
||
|
|
<dd>The control point name of this system is used. The network ID is determined by the current value of the LCLCPNAME network attribute value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>component-name-token</i></b></dt>
|
||
|
|
<dd>One of a series of 1 to 16 character tokens that uniquely identifies the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.REFLVL"></a>
|
||
|
|
<h3>Refresh level (RFRLVL)</h3>
|
||
|
|
<p>The refresh level is the level of the installable object that will be uninstalled. REFLVL is only valid when ACTION(*UNINS) and OBJ(*COMPNAME) are specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the installable objects with different levels will be uninstalled.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>refresh-level</i></b></dt>
|
||
|
|
<dd>Specify the level of the installable object to be uninstalled. The level is a numeric value up to 16 characters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.NODL"></a>
|
||
|
|
<h3>Managed systems node list (NODL)</h3>
|
||
|
|
<p>Specifies the node list parameter is the object name that contains a list of systems which are the destinations for the activity. This parameter cannot be specified if the control point name (CPNAME) parameter is also specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The systems on which this activity is to be performed are not specified by a node list. Individual control point names must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are one of the following:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All of the libraries in the user and system portions of the job's library list are searched for the node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name.</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible node list name value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>node-list-name</i></b></dt>
|
||
|
|
<dd>Specify the node list object name containing the list of systems on which the activity is to be performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.CPNAME"></a>
|
||
|
|
<h3>Managed system node names (CPNAME)</h3>
|
||
|
|
<p>Specifies the APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if a node list is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The systems on which this activity is performed are not identified individually. A node list must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The network ID of the local system is used. This is useful when the node being specified is in the same network as the local system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-identifier</i></b></dt>
|
||
|
|
<dd>Specify the APPN network identifier of the managed system on which the activity is to be performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible control point name value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>control-point-name</i></b></dt>
|
||
|
|
<dd>Specify the APPN control point name of the managed system on which the activity is to be performed. For NetView Distribution Management Agents, the control point name is the change control client which supports numeric characters (0-9) in the first position of control point names that are valid in other platforms.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release of the operating system on which you intend to use the object. This parameter is ignored for objects with global names that are in the SystemView distribution repository or for actions other than send or retrieve.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The object is used on the release of the operating system currently running on your system. If V5R4M0 is running on your system, *CURRENT means that you intend to use the object on a system with V5R4M0 installed. The object can also be used on a system with any later release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The object is intended for a system which is at the previous release level compared to the local system.
|
||
|
|
<p><b>Note:</b> Modification levels are not supported.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>release-level</i></b></dt>
|
||
|
|
<dd>Specify the release level in the VxRxMx format. The object is used on a system with the specified release or with any later release of the operating system installed.
|
||
|
|
<p>Valid values depend on the current version, release, and modification level, and they change with each new release.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.REPLACE"></a>
|
||
|
|
<h3>Replace object (REPLACE)</h3>
|
||
|
|
<p>Specifies whether the object should be replaced if it already exists. This parameter is ignored for actions other than for send, send and run, or retrieve.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>An error is returned if the object already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The object is replaced if it already exists.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies that data be compressed when sending or retrieving. This parameter is ignored for actions other than for *SND, *SNDRUN, and *RTV of *FILEDATA object types. SNA compression with a prime compression character of blank is performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The file data is not compressed when sent or when retrieved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SNA</b></dt>
|
||
|
|
<dd>The file data is compressed when sent or when retrieved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>Objects that are globally named can also have compression information specified when they were added to the distribution catalog (ADDDSTCLGE command).
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.KEEPCLGE"></a>
|
||
|
|
<h3>Keep catalog entry (KEEPCLGE)</h3>
|
||
|
|
<p>Specifies if the catalog entry and associated save file corresponding to the installable object will be kept in the specified system or systems. The KEEPCLGE parameter is only valid when ACTION(*SNDINS) or ACTION(*INS) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The catalog entry and associated save file are not kept.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The catalog entry and associated save file are kept.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.PARM"></a>
|
||
|
|
<h3>Parameters (PARM)</h3>
|
||
|
|
<p>Specifies parameters to be passed when starting the program. This is ignored if the action is not *RUN or *SNDRUN. Up to 20 parameters can be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>parameter</i></b></dt>
|
||
|
|
<dd>Specify a 1 to 253 character parameter. The prompt panel initially allows 50 characters to be entered. By entering an ampersand (&) in position 1, the field expands for larger parameters.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.RMTSTRTIME"></a>
|
||
|
|
<h3>Start time on managed system (RMTSTRTIME)</h3>
|
||
|
|
<p>Specifies the date and time when the activity can begin running on the managed system. The current date and time values and the next date values are determined when the activity begins running at the central site system based on the central site date and time.
|
||
|
|
</p>
|
||
|
|
<p>The possible time zone of the remote start time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LCLSYS</b></dt>
|
||
|
|
<dd>The remote start time is specified in the time zone of the central site system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MGDSYS</b></dt>
|
||
|
|
<dd>The remote start time is specified in the time zone of the managed system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after time values are:
|
||
|
|
</p>
|
||
|
|
<p>This is the definition of the time after which the activity is to start.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This function can start on the managed system at any time on or after the time this activity is started on the central site system on the date specified in element 2.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-time</i></b></dt>
|
||
|
|
<dd>Specify the time when this function can start on the managed system. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This function starts on the managed system on any date on or after the activity starts on the central site system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>This function starts on the managed system on any date after the activity starts on the central site system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-date</i></b></dt>
|
||
|
|
<dd>Specify the date after the functions start on the managed system. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The special values *CURRENT and *NEXT are specified for the date and the time if the time zone value *MGDSYS is specified.
|
||
|
|
</li>
|
||
|
|
<li>This parameter can only specified if *RUN or *SNDRUN actions are specified.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the activity description.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GEN</b></dt>
|
||
|
|
<dd>A description is generated based on the action selected.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>text-description</i></b></dt>
|
||
|
|
<dd>Specify a 50-character description of the activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.COND"></a>
|
||
|
|
<h3>Activity conditions (COND)</h3>
|
||
|
|
<p>Specifies which conditions must be met before this activity can be performed. Each condition identifies an activity that must be run before this activity and the value the end code from that activity must have to allow this activity to run. The default condition is that the previous activity (in alphabetical order) must complete successfully before this activity can be run.
|
||
|
|
</p>
|
||
|
|
<p>The possible single values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>There are no conditions for this activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible conditioning activity values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>This activity is conditioned on the previous activity. Activities are ordered alphabetically by activity name. If the activity being added is the first activity, a previous activity does not exist and any condition with *PRV is marked as having been met.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>conditioning-activity-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the activity which must be run before this activity. The activity name specified in the activity (ACTIVITY) parameter cannot be specified in the conditioning activity name. An activity cannot be conditioned on itself.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-activity-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the activities which must run before this activity.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible relational operator values are:
|
||
|
|
</p>
|
||
|
|
<p>This element is the relational operator to use when comparing the end code from an activity.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EQ</b></dt>
|
||
|
|
<dd>Equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GT</b></dt>
|
||
|
|
<dd>Greater than
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LT</b></dt>
|
||
|
|
<dd>Less than
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NE</b></dt>
|
||
|
|
<dd>Not equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*GE</b></dt>
|
||
|
|
<dd>Greater than or equal
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LE</b></dt>
|
||
|
|
<dd>Less than or equal
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible condition code results are:
|
||
|
|
</p>
|
||
|
|
<p>This element is value compared to the actual end code of the conditioning activity.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SUCCESS</b></dt>
|
||
|
|
<dd>The activity ended successfully (0 <= end code <= 9). This end code can only be specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FAIL</b></dt>
|
||
|
|
<dd>The activity failed (10 <= end code <= 89). This end code can only be specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOTRUN</b></dt>
|
||
|
|
<dd>The activity never started (90 <= end code <= 99). This end code is only specified with relational operator *EQ or *NE.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity ended with any end code. This end code is only specified with relational operator *EQ.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-code</i></b></dt>
|
||
|
|
<dd>Specify an integer value (0-99) that indicates the result of an activity (success or failure). The end code ranges and descriptions are:
|
||
|
|
<dl>
|
||
|
|
<dt><b>00</b></dt>
|
||
|
|
<dd>Activity completed successfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>01-09</b></dt>
|
||
|
|
<dd>Activity completed with warning messages.
|
||
|
|
</dd>
|
||
|
|
<dt><b>10-29</b></dt>
|
||
|
|
<dd>Activity did not complete successfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>30-39</b></dt>
|
||
|
|
<dd>Activity was canceled by a user before it completed.
|
||
|
|
<ul>
|
||
|
|
<li>30 = Activity ended with *CNTRLD option
|
||
|
|
</li>
|
||
|
|
<li>35 = Activity ended with *IMMED option
|
||
|
|
</li>
|
||
|
|
<li>39 = Activity ended with *FRCFAIL option
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>40-49</b></dt>
|
||
|
|
<dd>Activity was not run due to errors detected by the application.
|
||
|
|
<ul>
|
||
|
|
<li>40 = Activity not run for security reasons
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>90-99</b></dt>
|
||
|
|
<dd>Activity was not run because conditions or schedules were not met.
|
||
|
|
<ul>
|
||
|
|
<li>95 = Scheduled start time expired
|
||
|
|
</li>
|
||
|
|
<li>99 = Conditions cannot be met
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible condition mode values are:
|
||
|
|
</p>
|
||
|
|
<p>This element indicates which systems the conditioning activity must have completed on before this activity can be performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLNODES</b></dt>
|
||
|
|
<dd>The conditioning activity specified must complete on all nodes before this activity runs.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SAMENODE</b></dt>
|
||
|
|
<dd>When the conditioning activity specified completes for a given node, the activity specified on the ACTIVITY parameter can run for that same node even though the conditioning activity specified cannot have completed for all other nodes. In the case where this activity can run for that node; the condition is ignored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.STRTIME"></a>
|
||
|
|
<h3>Activity start time (STRTIME)</h3>
|
||
|
|
<p>Specifies the date and the time when this activity can be started on the central site system. The current date and time values, and the next date values are determined when the change request is submitted.
|
||
|
|
</p>
|
||
|
|
<p>The possible start after time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This activity can start any time on or after the time when the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-time</i></b></dt>
|
||
|
|
<dd>Specify the time when this activity can start. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>This activity can start on or after the date on which the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>The activity can start on any date after the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-date</i></b></dt>
|
||
|
|
<dd>Specify the date after this activity can start. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start before time values are:
|
||
|
|
</p>
|
||
|
|
<p>This element is ignored if the start before date is *ANY.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity can start at any time on or before the start before date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The activity must start before the time on which the change request was submitted on the date specified on the start before data element. This value cannot be specified if the start before date is *CURRENT.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-before-time</i></b></dt>
|
||
|
|
<dd>Specify the time before which the activity must start. If the activity cannot be started before this time, then it never starts. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start before date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>The activity can start at any time after the start after time and the start after date.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The activity must start on the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>The activity must start by the day after the date the change request is submitted.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-before-date</i></b></dt>
|
||
|
|
<dd>Specify the date before the activity must start. If the activity cannot be started by this date, it never starts. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGOBJCRQA.HOLD"></a>
|
||
|
|
<h3>Hold activity (HOLD)</h3>
|
||
|
|
<p>Specifies that the activity be held when the change request is submitted.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The activity is not held. It runs when all conditions and the start time are met.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The activity is held for all nodes when the change request is submitted. It must be released by you before it runs.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGOBJCRQA.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Retrieving a Job Description</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR1) ACTIVITY(ACT01)
|
||
|
|
ACTION(*RTV) OBJ(QGPL/QXYZ)
|
||
|
|
OBJTYPE(*JOBD) CPNAME((*NETATR SYS1))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes an activity to retrieve the QGPL/QXYZ job description from the iSeries server SYS1.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Sending a File to All Systems in the Network</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR2) ACTIVITY(ACT02)
|
||
|
|
ACTION(*SND) OBJ(ACCTLIB/TAXFILE)
|
||
|
|
OBJTYPE(*FILE) TGTRLS(*PRV) MBR(DEDUCTIONS)
|
||
|
|
STRTIME(23:00:00 9/30/02))
|
||
|
|
NODL(MYLIB/ACCTSYS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes an activity to send a tax table to all of the iSeries accounting servers identified in the ACCTSYS node list at 11 p.m. on 30 September 2002. The accounting systems are at the previous release level.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Retrieving a Program</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR3) ACTIVITY(ACT03)
|
||
|
|
ACTION(*RTV) OBJ(*GLOBAL)
|
||
|
|
GLBNAME(CUSTNET PCSOFT WDWAPP VER5 020314)
|
||
|
|
CPNAME((CUSTNET DEVPS2))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR3) ACTIVITY(ACT03)
|
||
|
|
ACTION(*SND) OBJ(*GLOBAL)
|
||
|
|
GLBNAME(CUSTNET PCSOFT WDWAPP VER5 020314)
|
||
|
|
NODL(MYLIB/PS2SE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR3) ACTIVITY(ACT03)
|
||
|
|
ACTION(*RUN) OBJ(*GLOBAL)
|
||
|
|
GLBNAME(CUSTNET PCSOFT WDWAPP VER5 020314)
|
||
|
|
COND((*PRV *EQ *SUCCESS *SAMENODE))
|
||
|
|
RMTSTRTIME(*MGDSYS (23:00 10/21/02))
|
||
|
|
NODL(MYLIB/PS2SE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes activities to retrieve a program from a PS/2, send it to all of the PS/2s in the PS2SE node list, and run it on the PS/2s at 11 p.m. in the time zone where the PS/2 is located. The program runs at each PS/2 after October 21, 2002.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Retrieving a File after 10 p.m.</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR4) ACTIVITY(ACT04)
|
||
|
|
ACTION(*RTV) OBJ(*GLOBAL)
|
||
|
|
GLBNAME(CUSTNET SALES *ANY *HIGHEST)
|
||
|
|
STRTIME((22:00:00 *CURRENT)
|
||
|
|
(06:00:00 *NEXT))
|
||
|
|
NODL(MYLIB/STORES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes an activity to retrieve the most recent nightly sales file from each system identified in the STORES node list. The files are cataloged as CUSTNET SALES system-name date-created. The file must be retrieved after 10 p.m. on the day the request is submitted but before 6 a.m. the next morning when the stores open.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Changing an Activity to Send and Install an Object</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGOBJCRQA CRQD(MYLIB/CR1) ACTIVITY(ACT01)
|
||
|
|
ACTION(*SNDINS)
|
||
|
|
TEXT('New text for changed CRQ')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes an activity from sending the object to sending and installing the object. The text is also changed.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGOBJCRQA.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGOBJCRQA.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|