TAA Tools
DLTLIB2         DELETE LIBRARY 2                       TAALICV

The Delete  Library 2 command  is like the  system DLTLIB command,  but
also deletes  objects that can  cause DLTLIB to fail  such as dependent
logical   files  in  a  different  library,  constraints  specified  by
ADDPFCST, receivers that  have not been  saved, and output queues  with
entries.   Some  exceptions exist  that  may prevent  the library  from
being deleted.

You must have *ALLOBJ authority to use DLTLIB2.

The  intent of  DLTLIB2  is that  it should  be used  when you  want to
force a library to be deleted.

A typical command would be:

             DLTLIB2   LIB(ABC)

The ABC library would be deleted.

Libraries can be protected using the PROLIB tool.

Exceptions
----------

Objects which are allocated will prevent a deletion.

The  DLTJRNRCV  command  specifies  DLTOPT(*IGNINQMSG),  but  does  not
request DLTOPT(*IGNEXITPGM) nor DLTOPT(*IGNTGTRCV).

Damaged objects may prevent a deletion.

The command  may not  be used on  a library owned  by a  system provide
user profile other than QPGMR.

Sequence of processing
----------------------

  **   An  outfile of all objects  in the library is  created in QTEMP.

  **   The file is read by a sub program which:

         --   Deletes any LFs read

         --   Deletes any dependent  LFs for physical  files (they  may
              be in a different library).

         --   Ends journaling for objects if a *JRN object is read

  **   Uses a sub program to delete *JRN objects

  **   The main program:

         --   Deletes any *JRNRCV objects with DLTOPT(*IGNINQMSG)

         --   Clears any spooled files in *OUTQ objects

         --   Clears any jobs in *JOBQ objects

         --   Deletes any remaining objects

         --   Deletes the library object.

If the library cannot  be deleted (an object may be  locked), a listing
is output of the errors and an escape message is issued.

DLTLIB2 escape messages you can monitor for
-------------------------------------------

      TAA9896    The library could not be deleted.

Escape messages from based on functions will be re-sent.

DLTLIB2 Command parameters                            *CMD
--------------------------

   LIB           The library to be deleted.

   CMD           The  command  being  run.    The default  is  DLTLIB2.
                 This  is  intended  as  an  internal  use  function to
                 allow the sharing of code with CLRLIB2.


Restrictions
------------

You must have *ALLOBJ authority to use DLTLIB2.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     DLTDEPLGL       Delete dependent logical
     DLTOBJ          Delete object
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDSTSMSG       Send status message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DLTLIB2       *CMD                   TAALICV       QATTCMD
   TAALICVC      *PGM       CLP         TAALICVC      QATTCL
   TAALICVC2     *PGM       CLP         TAALICVC2     QATTCL
   TAALICVC3     *PGM       CLP         TAALICVC3     QATTCL
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top