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

424 lines
16 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change Managed System Atr (CHGMGDSYSA)</title>
</head>
<body bgcolor="white">
<a name="CHGMGDSYSA.Top_Of_Page"></a>
<h2>Change Managed System Atr (CHGMGDSYSA)</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="#CHGMGDSYSA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGMGDSYSA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGMGDSYSA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGMGDSYSA"></a>
<p>The Change Managed System Attributes (CHGMGDSYSA) command updates the system wide configuration attributes that are unique to the Managed System Services licensed program.
</p>
<p>These attributes enable the user to control which activities are accepted by the managed system and under which user profile the activity is run.
</p>
<p>If the change control server attributes are changed while the managed system functions are active, you must do the following:
</p>
<ol>
<li>End the managed system functions (ENDMGDSYS command).
</li>
<li>Start the managed system functions (STRMGDSYS command).
</li>
</ol>
<p><b>Restrictions:</b>
</p>
<ol>
<li>The distribution security program, the default user profile, and the remote command security program must exist when the command is processed.
</li>
<li>You must have *ALLOBJ special authority to the security program, the default user profile, and the remote command security program.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGMGDSYSA.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="#CHGMGDSYSA.ACCRCVCRQA"><b>ACCRCVCRQA</b></a></td>
<td valign="top">Accept received activities</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGMGDSYSA.SECPGM"><b>SECPGM</b></a></td>
<td valign="top">Distribution security pgm</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *DFT, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Distribution security pgm</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="#CHGMGDSYSA.DFTUSRPRF"><b>DFTUSRPRF</b></a></td>
<td valign="top">Default user profile</td>
<td valign="top"><i>Simple name</i>, <b><u>*SAME</u></b>, *NONE, *REQUESTER</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMGDSYSA.INACTITV"><b>INACTITV</b></a></td>
<td valign="top">Inactive user time-out</td>
<td valign="top">0-999, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMGDSYSA.SNDINTRSP"><b>SNDINTRSP</b></a></td>
<td valign="top">Send intermediate responses</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMGDSYSA.PFXTOKEN"><b>PFXTOKEN</b></a></td>
<td valign="top">Global name prefix tokens</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 4 repetitions): <i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGMGDSYSA.RMTSECPGM"><b>RMTSECPGM</b></a></td>
<td valign="top">Remote command security pgm</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *DFT<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Remote command security pgm</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="#CHGMGDSYSA.MAXDTA"><b>MAXDTA</b></a></td>
<td valign="top">Maximum return data</td>
<td valign="top">1-99999, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMGDSYSA.DLTSPLF"><b>DLTSPLF</b></a></td>
<td valign="top">Delete spool file</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO, *SUCCESS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGMGDSYSA.KEY"><b>KEY</b></a></td>
<td valign="top">Remote command key</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGMGDSYSA.ACCRCVCRQA"></a>
<h3>Accept received activities (ACCRCVCRQA)</h3>
<p>Specifies whether change request activities are to be accepted for processing.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Change request activities received from remote systems are accepted.
</dd>
<dt><b>*NO</b></dt>
<dd>Change request activities are not accepted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.SECPGM"></a>
<h3>Distribution security pgm (SECPGM)</h3>
<p>Specifies the distribution security program to be used. The specified program is run when a request is received to determine which requests are accepted.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default distribution security program is used. This distribution security program allows PTFs and products to be received but not applied to the system. The program does not allow other objects to be manipulated.
</dd>
<dt><b>*NONE</b></dt>
<dd>No distribution security program is specified. All activities are accepted when ACCRCVACT(*YES) is specified. The default user profile is used to process the activity.
<p>The name of the object can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</dd>
<dt><b><i>program-name</i></b></dt>
<dd>Specify the name of the distribution security program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.DFTUSRPRF"></a>
<h3>Default user profile (DFTUSRPRF)</h3>
<p>Specify the default user profile used for the change request activity if no distribution security program has been specified. The user profiles QSECOFR, QSPL, QDOC, QDBSHR, QRJE, QSYS, QLPAUTO, QLPINSTALL, QTSTRQS, and QDFTOWN are not valid entries for this parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*REQUESTER</b></dt>
<dd>Activities will be processed using the same user profile that initiated the request at the central site system. If the originating user profile does not exist in this managed system, the activities are not accepted.
</dd>
<dt><b>*NONE</b></dt>
<dd>No default user profile is specified for processing requests. A distribution security program must be specified and must indicate the name of the user profile to use if activities are to be processed.
</dd>
<dt><b><i>user-profile-name</i></b></dt>
<dd>Specify the name of the user profile object to be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.INACTITV"></a>
<h3>Inactive user time-out (INACTITV)</h3>
<p>Specifies the number of minutes jobs should wait to receive a remote command request or a change request activity. If no activity is received during the specified time period, the job processing the activity is ended. A new job is started when a new activity is received.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No time-out value is specified.
</dd>
<dt><b><i>time-out interval</i></b></dt>
<dd>Specify the number of minutes for an inactive job to wait for additional requests. Valid values range from 0 through 999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.SNDINTRSP"></a>
<h3>Send intermediate responses (SNDINTRSP)</h3>
<p>Specifies whether intermediate responses are sent to the central site system. Intermediate responses may require activation of a switched communication link.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>Intermediate responses are sent.
</dd>
<dt><b>*NO</b></dt>
<dd>Intermediate responses are not sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.PFXTOKEN"></a>
<h3>Global name prefix tokens (PFXTOKEN)</h3>
<p>Specifies the set of tokens which, when found at the beginning of a global name, indicate a standard iSeries object name can be found in the global name. In order to use standard iSeries object names for distribution, a consistent set of tokens must be used on all systems in the network. Token names must be unique to ensure they are not used in global names being added to the distribution catalog.
</p>
<p>You can enter multiple values for this parameter.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No prefix tokens are used. All objects to be changed are identified in the catalog.
</dd>
<dt><b><i>prefix-token-value</i></b></dt>
<dd>Specifies a set of tokens which indicate a standard iSeries name can be found in the global name. The SystemView Distribution catalog is not used for objects with global names starting with these prefix tokens. One to four tokens may be specified with a total length not to exceed 20 characters. The first token is recommended to be an enterprise ID or network ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.RMTSECPGM"></a>
<h3>Remote command security pgm (RMTSECPGM)</h3>
<p>Specifies the remote command security program to be used. The specified program is run when a request to run a command is received from a central site system. This program determines if the request is accepted and under which user profile it should be run.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*DFT</b></dt>
<dd>The default remote command security program is used. This security program allows all commands to be received and run on the system.
<p>The name of the object can be qualified by one of the following library values:
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the job's library list are searched until the first match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</dd>
<dt><b><i>program-name</i></b></dt>
<dd>Specify the name of the security program.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.MAXDTA"></a>
<h3>Maximum return data (MAXDTA)</h3>
<p>Specifies the limitation in Kbytes for the maximum amount of data that can be returned to the central site system when a remote command request is processed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>No limitation for the amount of returned data.
</dd>
<dt><b><i>number-of-kilobytes</i></b></dt>
<dd>Specify the number of kilobytes for the amount of data that can be returned to the central site system when a remote command request is processed. Valid values range from 1 through 99999.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.DLTSPLF"></a>
<h3>Delete spool file (DLTSPLF)</h3>
<p>Specifies whether the spooled file is deleted after a remote command request is completed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*YES</b></dt>
<dd>The spooled file is deleted.
</dd>
<dt><b>*NO</b></dt>
<dd>The spooled file is not deleted.
</dd>
<dt><b>*SUCCESS</b></dt>
<dd>The spooled file is deleted only when the request completes successfully. The request is successful if no escape messages are received while running the command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGMGDSYSA.KEY"></a>
<h3>Remote command key (KEY)</h3>
<p>Specifies the key that is used for encoding or decoding the remote command request. The values must be the same for the system that sends the remote command and for the system that receives the remote command.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No encoding or decoding key is used.
</dd>
<dt><b><i>key</i></b></dt>
<dd>Specify a 64-byte character string as a character string or hexadecimal string.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMGDSYSA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Configuring the Central Site System</b>
</p>
<p>
<pre>
CHGMGDSYSA ACCRCVACT(*YES) SECPGM(*NONE) DFTUSRPRF(QUSER)
INACTITV(30) SNDINTRSP(*YES)
PFXTOKEN(ABCCO AUTOMAP)
</pre>
</p>
<p>This command configures the central site system to support change request activities and run them under the QUSER user profile. Intermediate responses are sent. Global names beginning with ABCCO AUTOMAP are reserved for sending objects using standard i5/OS object names. If a request is not received for 30 minutes, any jobs waiting to process requests are ended.
</p>
<p><b>Example 2: Configuring the Remote Command Function</b>
</p>
<p>
<pre>
CHGMGDSYSA RMTSECPGM(*DFT) DLTSPLF(*SUCCESS)
MAXDTA(*NOMAX) KEY(*NONE)
</pre>
</p>
<p>This command configures the remote command function to use the default remote command security program, deletes spooled files when the request is run successfully, and specifies no limitation for the amount of returned data.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGMGDSYSA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>MSS0413</b></dt>
<dd>Default user profile &amp;1 not found.
</dd>
<dt><b>MSS0414</b></dt>
<dd>Program &amp;1 in library &amp;2 not found.
</dd>
<dt><b>MSS0415</b></dt>
<dd>Managed system attributes not found or damaged.
</dd>
<dt><b>MSS0417</b></dt>
<dd>Global name prefix token length &amp;1 too long.
</dd>
<dt><b>MSS0418</b></dt>
<dd>*NONE not valid for both DFTUSRPRF and SECPGM.
</dd>
<dt><b>MSS0419</b></dt>
<dd>Global name prefix token &amp;1 not valid.
</dd>
<dt><b>MSS041A</b></dt>
<dd>*ALLOBJ special authority required.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGMGDSYSA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>