The Convert All Special Authorities command creates an outfile of all
special authorities for one or more users. By default, multiple
records are written for each user profile: one record for the user,
one for his group profile (if any), one for each supplementary group
(if any), and a summary record combining all special authority
information.
By default, only those users with special authorities either in their
own profile or via adopted profiles are converted.
The outfile is always ALLSPCP. The model file is TAASELEP with a
format name of ALLSPCR.
An option exists to output only the summary record.
You must have *ALLOBJ special authority to use CVTALLSPCA.
See also the DSPALLSPCA command.
A typical command would be:
CVTALLSPCA USRPRF(*ALL) SUMONLY(*YES) OUTLIB(QTEMP)
One summary record would be written for each user who has any special
authority either specified for his user profile or any of his group
profiles.
Output record format
--------------------
Use DSPFMT TAASELEP to display the format.
Each record has a code in the SACODE field that describes the record
1=User, 2=Group profile of the user, 3=Supplementary group profile of
the user (there can be up to 15), 4=Summary. The summary record will
contain a combination of all special authorities for the user. The
type of record is also described in the SATYPE field.
Each special authority (such as SASAVS) has a one position field
containing Y or N for whether the special authority exists. The
SAANYS field contains *YES or *NO for whether any special authorities
exist for the record.
The summary record combines all the Y/N values and contains two extra
fields: 1) the name of the group profile record for the user (if any)
and 2) the number of supplementary group profiles.
CVTALLSPCA escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTALLSPCA Command parameters *CMD
-----------------------------
USRPRF The user profile to convert special authorities for.
A specific user profile, a generic name, or the
special value *ALL may be entered.
BYPASS A *YES/*NO value for whether to bypass any user
profiles that do not have any special authority in
their own profile or any group profiles.
*YES is the default to bypass any users without
special authority.
*NO may be specified to output records for all
users.
SUMONLY A *YES/*NO value for whether to output only a
summary record for each user.
*NO is the default which will cause multiple records
to be written for each user: One record for the
user, one for his group profile (if any), one for
each supplementary group (if any), and a summary
record combining all special authority information.
OUTLIB The library in which the ALLSPCP file will be
placed. The default is *LIBL. If the file does not
already exist, a library must be specified.
OUTMBR The member of the ALLSPCP file to be used. If the
member does not exist, it is added. The default is
ALLSPCP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
*NO may be specified to add records to an existing
file.
Restrictions
------------
You must have *ALLOBJ special authority to use CVTALLSPCA.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVDAT Retrieve date
RTVSPCAUT Retrieve special authority
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
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
------ ---- --------- ---------- ----------
CVTALLSPCA *CMD TAASELE QATTCMD
TAASELEC *PGM CLP TAASELEC QATTCL
TAASELER *PGM RPG TAASELER QATTRPG
TAASELEP *FILE PF TAASELEP QATTDDS
|
