friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/sndsmgobj.htm

423 lines
15 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Send SMG Object (SNDSMGOBJ)</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="SNDSMGOBJ.Top_Of_Page"></a>
<h2>Send SMG Object (SNDSMGOBJ)</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="#SNDSMGOBJ.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SNDSMGOBJ.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SNDSMGOBJ.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SNDSMGOBJ"></a>
<p>The Send System Manager Object (SNDSMGOBJ) command provides the capability of sending an i5/OS object from the central site system to one or more managed systems.
</p>
<p><b>Note:</b> A change request is submitted that can be viewed to determine the status of this command. A message is returned identifying the name of the change request.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>Only i5/OS program objects or file members such as *REXX, *CL, and *UNSPEC can be run.
</li>
<li>The object 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>
<h3>Error messages for SNDSMGOBJ</h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SNDSMGOBJ.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="#SNDSMGOBJ.OBJ"><b>OBJ</b></a></td>
<td valign="top">Object</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</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>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#SNDSMGOBJ.OBJTYPE"><b>OBJTYPE</b></a></td>
<td valign="top">Object type</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *FIRST, *LAST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.DATATYPE"><b>DATATYPE</b></a></td>
<td valign="top">Data type</td>
<td valign="top"><b><u>*UNSPEC</u></b>, *CL, *REXX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#SNDSMGOBJ.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: <b><u>*NONE</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="#SNDSMGOBJ.CPNAME"><b>CPNAME</b></a></td>
<td valign="top">Managed system node names</td>
<td valign="top">Single values: <b><u>*NONE</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>, <b><u>*NETATR</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Control point</td>
<td valign="top">
<i>Communications name</i></td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.TGTRLS"><b>TGTRLS</b></a></td>
<td valign="top">Target release</td>
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace object</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">Data compression</td>
<td valign="top"><b><u>*NONE</u></b>, *SNA</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.RUNPGM"><b>RUNPGM</b></a></td>
<td valign="top">Run program</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#SNDSMGOBJ.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>
</table>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SNDSMGOBJ.OBJ"></a>
<h3>Object (OBJ)</h3>
<p>Specifies the qualified name to be sent.
</p>
<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.
</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 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 that characters A through Z, 0 through 9, dollar sign, at sign, and number sign are used in the object names.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.OBJTYPE"></a>
<h3>Object type (OBJTYPE)</h3>
<p>Specifies the object.
</p>
<dl>
<dt><b>*FILEDATA</b></dt>
<dd>A file member should be sent without the file attributes.
</dd>
<dt><b><i>object-type</i></b></dt>
<dd>Specify the object type.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the i5/OS physical file member name. It is ignored unless the object type is *FILE or *FILEDATA.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>The entire file is sent. *ALL must be used if the file is not a physical file. *ALL cannot be used if RUNPGM(*YES) is selected or if *FILEDATA is selected.
</dd>
<dt><b>*FIRST</b></dt>
<dd>This is used only if the first member is sent. The member name is determined when the activity is run.
</dd>
<dt><b>*LAST</b></dt>
<dd>Only the last member is sent. The member name is determined when the activity is run by the date the member was added to the physical file.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the member to be sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.DATATYPE"></a>
<h3>Data type (DATATYPE)</h3>
<p>Specifies the data type of the member. This parameter needs to be specified only when sending a source file that runs on the managed system. DATATYPE is specified only when running *FILEDATA.
</p>
<dl>
<dt><b><u>*UNSPEC</u></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 such as the i5/OS CL batch input stream.
</dd>
<dt><b>*REXX</b></dt>
<dd>Specifies the file member contains a REXX procedure.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.NODL"></a>
<h3>Managed systems node list (NODL)</h3>
<p>Specifies the node list name contains a list of systems which are the destinations for the activities. This parameter cannot be specified if control point name (CPNAME) parameter is also specified.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The systems on which this activity is performed are not identified 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>*LIBL</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 that only the library named in the parameter is 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="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.CPNAME"></a>
<h3>Managed system node names (CPNAME)</h3>
<p>Specifies the managed systems APPN control point names on which this request is performed. Control point names cannot be specified if a node list is specified.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The systems on which this request is performed are not identified individually. A node list must be specified.
</dd>
<dt><b>*NETATR</b></dt>
<dd>The local system network ID is used. This is useful when the node specified is in the same network as the local system.
</dd>
<dt><b><i>network-identifier</i></b></dt>
<dd>Specify the managed system APPN network identifier on which the request is 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 managed system APPN control point name on which the request is performed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.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>*CURRENT</u></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.
</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="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.REPLACE"></a>
<h3>Replace object (REPLACE)</h3>
<p>Specifies that the object should be replaced if it already exists.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>An error is returned if the object already exists.
</dd>
<dt><b><u>*YES</u></b></dt>
<dd>The object is replaced if it already exists.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.DTACPR"></a>
<h3>Data compression (DTACPR)</h3>
<p>Specifies that the data is compressed when sent. This parameter is valid only if the object type *FILEDATA is specified. SNA compression character or blank is performed.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The file data is not compressed when sent.
</dd>
<dt><b>*SNA</b></dt>
<dd>The file data is compressed when sent.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.RUNPGM"></a>
<h3>Run program (RUNPGM)</h3>
<p>Specifies running the program when it arrives at the managed system. This parameter can only be specified if the object type is *PGM or if the object type is *FILEDATA and the data type is *CL or *REXX.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The program is not run.
</dd>
<dt><b>*YES</b></dt>
<dd>Specify that the program is run as soon as it is received by the managed system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SNDSMGOBJ.PARM"></a>
<h3>Parameters (PARM)</h3>
<p>Specifies the parameters to be passed when starting the program. Up to 20 parameters can be specified.
</p>
<dl>
<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 (&amp;) in position 1, the field expands for larger parameters.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDSMGOBJ.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Sending a Library to Systems in a Node List</b>
</p>
<p>
<pre>
SNDSMGOBJ OBJ(ACCTLIB) OBJTYPE(*LIB) NODL(SYSLIB/SALESOFC)
</pre>
</p>
<p>This command sends library ACCTLIB to 20 systems identified in node list SALESOFC.
</p>
<p><b>Example 2: Sending a Program to All Systems in the Node List</b>
</p>
<p>
<pre>
SNDSMGOBJ OBJ(SALESLIB/GENRPTS) OBJTYPE(*PGM)
NODL(SYSLIB/ALLSTORES)
RUNPGM(*YES) PARM(SALES 'ONE DAY')
</pre>
</p>
<p>This command sends the program GENRPTS in library SYSLIB to all the systems listed in node list ALLSTORES in library SYSLIB. It then runs the program on each of those systems. Two parameters are passed as input to the program. The first has the value SALES and the second has the value 'ONE DAY'.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SNDSMGOBJ.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SNDSMGOBJ.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink