285 lines
9.2 KiB
HTML
285 lines
9.2 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>Delete SMG Object (DLTSMGOBJ)</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="DLTSMGOBJ.Top_Of_Page"></a>
|
|
<h2>Delete SMG Object (DLTSMGOBJ)</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="#DLTSMGOBJ.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DLTSMGOBJ.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DLTSMGOBJ.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DLTSMGOBJ"></a>
|
|
<p>The Delete System Manager Object (DLTSMGOBJ) command provides the capability of deleting an i5/OS object on a managed system.
|
|
</p>
|
|
<p><b>Note:</b>
|
|
</p>
|
|
<p>A change request is automatically submitted which 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 *CL, *REXX, and *UNSPEC can be run.
|
|
</li>
|
|
<li>The *LIBL object library cannot be specified.
|
|
</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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DLTSMGOBJ.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="#DLTSMGOBJ.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>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#DLTSMGOBJ.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="#DLTSMGOBJ.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" rowspan="4"><a href="#DLTSMGOBJ.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>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#DLTSMGOBJ.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DLTSMGOBJ.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies the qualified name that is to be deleted.
|
|
</p>
|
|
<p>The possible library values are one of the following:
|
|
</p>
|
|
<dl>
|
|
<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 only characters A through Z, 0 through 9, dollar sign, at sign, and number sign are used in the object name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTSMGOBJ.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the object.
|
|
</p>
|
|
<dl>
|
|
<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="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTSMGOBJ.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the i5/OS file member name. It is ignored unless the object type is *FILE.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The entire file is deleted. *ALL must be used if the file is not a physical file.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>The first member is deleted. The member name is determined when the activity is run.
|
|
</dd>
|
|
<dt><b>*LAST</b></dt>
|
|
<dd>The last member is deleted. The member name is determined when the activity is run by the date the member is added to the physical file.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the name of the member to be deleted.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTSMGOBJ.NODL"></a>
|
|
<h3>Managed systems node list (NODL)</h3>
|
|
<p>Specifies the node list name that contains a list of systems which are the destinations for the request. This parameter cannot be specified if the control point name (CPNAME parameter) is also specified.
|
|
</p>
|
|
<p>The possible value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The systems on which this activity is to be performed are not identified by a node list. Individual control point names must be specified.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible values are:
|
|
</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 command is performed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DLTSMGOBJ.CPNAME"></a>
|
|
<h3>Managed system node names (CPNAME)</h3>
|
|
<p>Specifies the managed systems APPN control point names on which this request is to be performed. Control point names cannot be specified if the node list (NODL) parameter is specified.
|
|
</p>
|
|
<p>The possible value is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The systems on which this request is to be 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 local system network ID 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 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="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTSMGOBJ.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Delete Object from Systems in Node List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTSMGOBJ OBJ(PAYROLL/BACKUP) OBJTYPE(*FILE)
|
|
NODL(MYLIB/ALLSYS)
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes the payroll backup file on all systems listed in node list ALLSYS.
|
|
</p>
|
|
<p><b>Example 2: Delete Object from Specific Systems</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DLTSMGOBJ OBJ(PGMLIB/PROCPGM) OBJTYPE(*PGM)
|
|
CPNAME((*NETATR SYS1) (*NETATR SYS2))
|
|
</pre>
|
|
</p>
|
|
<p>This command deletes the program PROCPGM from the library PGMLIB on systems SYS1 and SYS2 in the local network.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DLTSMGOBJ.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p>None
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DLTSMGOBJ.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|