TAA Tools
CVTALLSPCA      CONVERT ALL SPECIAL AUTHORITIES        TAASELE

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
					

Added to TAA Productivity tools January 15, 2014


Home Page Up to Top