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