DLTOBJ2 DELETE OBJECT 2 TAAOBJH |
Note that in V7R1M0 the system added a DLTOBJ command thus causing
the TAA tool and command to be renamed to DLTOBJ2.
The Delete Object 2 command provides a single command to delete any
named object or generic object names. All supported object types
(common programming objects) are deleted. *ALL objects of a specific
type or types may be deleted.
Typical commands would be:
DLTOBJ2 OBJ(ABC)
All supported object types with the name of ABC would be deleted that
were found on the user portion of the library list.
DLTOBJ2 OBJ(xxx/ABC*)
All supported object types with a name beginning with ABC would be
deleted in the named library.
DLTOBJ2 OBJ(xxx/ABC*) OBJTYPE(*PGM *FILE)
All *PGM and *FILE object types with a name beginning with ABC would
be deleted in the named library.
DLTOBJ2 OBJ(xxx/*ALL) OBJTYPE(*PGM) OBJATTR(CLP)
All *PGM object types with a CLP attribute would be deleted in the
named library.
DLTOBJ2 OBJ(xxx/*ALL) OBJTYPE(*DTAQ)
All *DTAQ objects in the named library would be deleted.
DLTOBJ2 OBJ(*ALL) OBJTYPE(*ALL)
Requesting all objects, all types, and all attributes is considered
an error (if allowed it would delete all user objects in the user
portion of the library list). Specifying a library (rather than
*USRLIBL) will also cause an error (this is the equivalent of
CLRLIB). CLRLIB is recommended in the message text.
If any errors are found (such as not authorized to delete or the
object is locked), the default is to end the command immediately. If
IGNDLTERR(*YES) is specified, the command completes (deleting what it
can) and issues a diagnostic message describing how many errors were
found and referring the user to the previous messages.
A count of the objects deleted is included in the completion message
Low level messages describe the individual objects deleted.
The following escape message can be monitored for if you take the
default for IGNDLTERR:
TAA9891 No object exists of the type named or no object exists
of the supported types
Command parameters *CMD
------------------
OBJ The qualified name or generic name to be deleted.
*ALL may be specified for all object names, but
OBJTYPE(*ALL) may not be used (this would delete all
objects in a library or the user portion of the
library list and is prevented).
The library defaults to *USRLIBL. *CURLIB may also
be used or a specific library.
OBJTYPE A list of object types to be deleted. *ALL is the
default which includes all of the individual types
which are valid. *ALL may not be specified if
OBJ(*ALL) is used. One or more of the individual
types may be specified. See the command prompt for
the supported types.
OBJATTR The object attribute to be deleted. *ALL is the
default.
A specific attribute such as LF or CLP may be
specified. No check is made whether the attribute
is valid.
IGNDLTERR Whether to ignore the escape messages sent by DLT
commands. *NO is the default.
*YES may be specified to ignore any error messages
from DLT commands. This allows the command to
delete what it can and produce error messages for
the objects that cannot be deleted.
OWNER The owner of the objects to be deleted.
*ALL is the default to not check for the owner of
the object.
A user name may be entered to delete only those
objects owned by the specified user.
CRTUSER The create user of the objects to be deleted.
*ALL is the default to not check for the user who
created the object.
A user name may be entered to delete only those
objects created by the specified user.
Restrictions
------------
Not all object types are supported.
Prerequisites
-------------
The following TAA Tools must be on your system.
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list
RSNLSTMSG Resend last message
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DLTOBJ2 *CMD TAAOBJH QATTCMD
TAAOBJHC *PGM CLP TAAOBJHC QATTCL
TAAOBJHC2 *PGM CLP TAAOBJHC2 QATTCL
|
Added to TAA Productivity tools April 1, 1995