The Delete System Manager Object (DLTSMGOBJ) command provides the capability of deleting an i5/OS object on a managed system.

Note:

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.

Restrictions:

1. Only i5/OS program objects or file members such as *CL, *REXX, and *UNSPEC can be run.
2. The *LIBL object library cannot be specified.
3. The object cannot reside in the QTEMP library.
4. 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.

Parameters

Keyword	Description	Choices	Notes
OBJ	Object	Qualified object name	Required, Positional 1
	Qualifier 1: Object	Name
	Qualifier 2: Library	Name, *CURLIB
OBJTYPE	Object type	Character value	Required, Positional 2
MBR	Member	Name, *ALL, *FIRST, *LAST	Optional
NODL	Managed systems node list	Element list	Optional
	Element 1: Node list	Single values: *NONE Other values: Qualified object name
	Qualifier 1: Node list	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
CPNAME	Managed system node names	Single values: *NONE Other values (up to 50 repetitions): Element list	Optional
	Element 1: Network identifier	Communications name, *NETATR
	Element 2: Control point	Communications name

Top

Object (OBJ)

Specifies the qualified name that is to be deleted.

The possible library values are one of the following:

*CURLIB

The current library for the job is used to locate the object.

library-name

Specify only the library named in this parameter is searched.

The possible object name value is:

object-name

Specify only characters A through Z, 0 through 9, dollar sign, at sign, and number sign are used in the object name.

Object type (OBJTYPE)

Specifies the object.

object-type

Specify the object type.

Member (MBR)

Specifies the i5/OS file member name. It is ignored unless the object type is *FILE.

*ALL

The entire file is deleted. *ALL must be used if the file is not a physical file.

*FIRST

The first member is deleted. The member name is determined when the activity is run.

*LAST

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.

member-name

Specify the name of the member to be deleted.

Managed systems node list (NODL)

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.

The possible value is:

*NONE

The systems on which this activity is to be performed are not identified by a node list. Individual control point names must be specified.

The possible values are:

*LIBL

All of the libraries in the user and system portions of the job's library list are searched for the node list object.

*CURLIB

The current library for the job is used to locate the node list object.

library-name

Specify that only the library named in the parameter is searched.

The possible node list name value is:

node-list-name

Specify the node list object name containing the list of systems on which the command is performed.

Managed system node names (CPNAME)

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.

The possible value is:

*NONE

The systems on which this request is to be performed are not identified individually. A node list must be specified.

The possible values are:

*NETATR

The local system network ID is used. This is useful when the node being specified is in the same network as the local system.

network-identifier

Specify the managed system APPN network identifier on which the request is performed.

The possible control point name value is:

control-point-name

Specify the managed system APPN control point name on which the request is performed.

Examples

Example 1: Delete Object from Systems in Node List

DLTSMGOBJ   OBJ(PAYROLL/BACKUP)  OBJTYPE(*FILE)
            NODL(MYLIB/ALLSYS)

This command deletes the payroll backup file on all systems listed in node list ALLSYS.

Example 2: Delete Object from Specific Systems

DLTSMGOBJ   OBJ(PGMLIB/PROCPGM)  OBJTYPE(*PGM)
            CPNAME((*NETATR SYS1) (*NETATR SYS2))

This command deletes the program PROCPGM from the library PGMLIB on systems SYS1 and SYS2 in the local network.

Error messages

None