TAA Tools
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


Home Page Up to Top