DLTSMGOBJ (Delete System Manager Object)

Note: To use this command, have the 5722-SM1 (System Manager for iSeries) licensed program installed.

DLTSMGOBJ Command syntax diagram

 

Purpose

The Delete System Manager Object (DLTSMGOBJ) command provides the capability of deleting an OS/400 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. The *LIBL object library cannot be specified.
   
   
2. The object cannot reside in the QTEMP library.
   
   
3. 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.

 

Required Parameters

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 the name of the library to be searched.

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

OBJTYPE

Specifies the object.

object-type: Specify the object type.

 

Optional Parameters

MBR

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

*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.

NODL

Specifies the node list name that contains a list of systems that are the destinations for the activity. This parameter cannot be specified if the control point name (CPNAME) parameter is also specified.

*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 library 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.

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

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.

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

The possible library 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.

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

Examples for DLTSMGOBJ

Example 1

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

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 for DLTSMGOBJ

*ESCAPE Messages

None