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

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.