The Clear Library 2 command is like the system CLRLIB command, but
also clears objects that can cause CLRLIB 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 a cleared library.
You must have *ALLOBJ authority to use CLRLIB2.
The intent of CLRLIB2 is that it should be used when you want to
force a library to be clear.
A typical command would be:
CLRLIB2 LIB(ABC)
The ABC library would be cleared.
Exceptions
----------
Objects which are allocated will prevent a clear.
The DLTJRNRCV command specifies DLTOPT(*IGNINQMSG), but does not
request DLTOPT(*IGNEXITPGM) nor DLTOPT(*IGNTGTRCV).
Damaged objects may prevent a clear.
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
CLRLIB2 escape messages you can monitor for
-------------------------------------------
None. Escape messages from based on functions will be re-sent.
CLRLIB2 Command parameters *CMD
--------------------------
LIB The library to be cleared.
Restrictions
------------
You must have *ALLOBJ authority to use CLRLIB2.
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
------ ---- --------- ---------- ----------
CLRLIB2 *CMD TAALICU QATTCMD
TAALICUC *PGM CLP TAALICUC QATTCL
TAALICUC2 *PGM CLP TAALICUC2 QATTCL
TAALICUC3 *PGM CLP TAALICUC3 QATTCL
|