CVTLIBAUT CONVERT LIBRARY AUTHORITY TAASEII |
The Convert Library Authority command converts the object authority
information of one, all or generic objects within a library and the
library object to an outfile. The system command DSPOBJAUT operates
on only a single object. The outfile name is OBJAUTP. The model
file is QAOBJAUT in QSYS with a format name of QSYDSAUT.
See the PRTLIBAUT tool for a simple means of printing the authorities
with selection.
See the CVTLIBAUT2 tool for converting authorities to library objects
(not the objects within a library).
A typical command would be:
CVTLIBAUT LIB(xxx) OUTLIB(QTEMP)
If you have *ALLOBJ special authority, all authorities will be
converted. If you do not have *ALLOBJ special authority, not all of
the information may be converted (objects are bypassed if you are not
authorized).
OBJAUTP outfile
---------------
The file will contain one record for each object that describes the
*PUBLIC authority. There will also be one record for each user who
is authorized (including the owner).
Contrast with CVTLIBAUT2
------------------------
The CVTLIBAUT2 command provides similar information for library
objects (not the objects within the library). For example, you can
output the authorities for all libraries, user libraries, libraries
on the user library list, etc.
CVTLIBAUT escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTLIBAUT Command parameters *CMD
-----------------------------
LIB The library containing the objects.
OBJ The object to be converted. The default is *ALL for
all objects in the library. An object or generic
object may also be named.
OBJTYPE The object type to be converted. The default is
*ALL. A specific object type may be named. The
command prompt includes the valid object types.
OBJATTR The object attribute to be converted. The default
is *ALL. Object attributes such as PF or RPG may be
entered. There is no check to ensure a valid
attribute exists or that it is meaningful if a
specific object type is entered.
OUTLIB The library to output the OBJAUTP file to. The
default is *LIBL which may only be used if the
OBJAUTP file may be found on the library list. If
the file does not exist, a library must be named.
OUTMBR The member to be written to. The default is
OBJAUTP.
REPLACE A *YES/*NO parameter for whether to replace the data
in the outfile.
*YES is the default which will clear the member
before writing any records.
*NO may be specified to add to the existing data.
PFTYPE If the object attribute is PF, a PFTYPE of *DTA or
*SRC may be entered to convert only data or source
files. The default is *ALL for all PF types.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check all object special authority
EDTVAR Edit variable
RTVOBJLST Retrieve object list
SNDCOMPMSG Send completion message
SNDESCMSG Send escape 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
------ ---- --------- ---------- ----------
CVTLIBAUT *CMD TAASEII QATTCMD
TAASEIIC *PGM CLP TAASEIIC QATTCL
TAASEIIP *FILE PF TAASEIIP QATTDDS
TAASEIIL *FILE LF TAASEIIL QATTDDS
The TAASEIIP and TAASEIIL files are used to allow a program to
process the file in keyed order by library, object, and object type.
The files are created by CRTTAATOOL, but not used during CVTLIBAUT.
|
Added to TAA Productivity tools April 15, 2010