TAA Tools
RTVPWDSTS       RETRIEVE PASSWORD STATUS               TAASEFF

The Retrieve  Password Status command  retrieves information  about the
status  of a  users  password (not  the password).    RTVPWDSTS returns
information  that is not  available using RTVUSRPRF.   For example, you
can determine if a password is valid for a profile.

The command defaults to  retrieve status information about the  current
user.   If a specific user  profile is entered, you  must be authorized
to that profile.

A  typical command to retrieve whether the  current user has a password
would be:

             DCL           &PWDASGN *CHAR LEN(4)
              .
             RTVPWDSTS     PWDASGN(&PWDASGN)
             IF            (&PWDASGN *EQ '*YES') DO ...

RTVPWDSTS escape messages you can monitor for
---------------------------------------------

      TAA9892    Not authorized to user profile

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   USRPRF        The name  of  the user  profile to  retrieve  password
                 status  information  for.   The  default  is  *CURRENT
                 meaning the current user profile of the job.

                 If a  name is entered, you must  be authorized to *USE
                 authority of the user profile.

   PRVSGNDAT     An optional return  variable for  the previous  signon
                 date  (if  any)  in CYYMMDD  format.    If  used,  the
                 return variable must be specified as *CHAR LEN(7).

   PRVSGNTIM     An  optional return variable  for the  previous signon
                 time  (if any) in HHMMSS format.   If used, the return
                 variable must be specified as *CHAR LEN(6).

   STATUS        An optional  return variable  for whether the  profile
                 is  *ENABLED  or  *DISABLED.    If  used,  the  return
                 variable must be specified as *CHAR LEN(10).

   INVALIDSGN    An   optional  return  variable  for   the  number  of
                 invalid signon  attempts.   The value  is  reset on  a
                 successful  signon.    If used,  the  return  variable
                 must be specified as *DEC LEN(9 0).

   PWDCHGDAT     An  optional  return variable  for  the  last password
                 change date in  CYYMMDD format.   If used, the  return
                 variable must be specified as *CHAR LEN(7).

   PWDCHGTIM     An  optional return  variable  for the  last  password
                 change  time in HHMMSS  format.   If used,  the return
                 variable must be specified as *CHAR LEN(6).

   PWDASGN       An  optional  return variable  for whether  a password
                 is assigned to  the profile.   A *YES  or *NO will  be
                 returned.    *NO  is  returned  if  CRT/CHGUSRPRF  was
                 specified  as PASSWORD(*NONE).    If used,  the return
                 variable must be specified as *CHAR LEN(4).

   PWDEXP        An optional return variable  for whether the  password
                 has expired  for the profile.   A *YES or *NO  will be
                 returned.    If  used,  the  return  variable must  be
                 specified as *CHAR LEN(4).

   PWDEXPITV     An  optional   return   variable  for   the   password
                 expiration interval.   *NOMAX  or the  number of  days
                 will be  returned (1-366).   If the internal  value is
                 *SYSVAL,  the value  from the  system value QPWDEXPITV
                 is returned.   If  used, the return  variable must  be
                 specified as *CHAR LEN(6).

   PWDEXPDAT     An   optional  return   variable   for  the   password
                 expiration  date in  CYYMMDD format.   If there  is no
                 expiration date, a  value of  *NONE will be  returned.
                 If  used, the  return variable  must  be specified  as
                 *CHAR LEN(7).

   PWDEXPDAYS    An  optional return  variable for  the number  of days
                 before the password expires.   If the expiration  date
                 has past, a  value of 0s  will be returned.   If there
                 is  no  expiration date,  a  value of  *NOMAX  will be
                 returned.    If  used,  the  return  variable  must be
                 specified as *CHAR LEN(6).

   SETPWDEXP     An optional return  variable for whether the  password
                 will  be set  to expire  when the  user signs  on.   A
                 value  of  *YES  or  *NO will  be  returned.    If the
                 profile has  no  password,  a  value of  *NO  will  be
                 returned.    If  used,  the return  variable  must  be
                 specified as *CHAR LEN(6).

   DSPSGNON      An  optional return  variable  for whether  to display
                 the Signon  information when  the user  signs on.    A
                 value  of *YES  or  *NO  will  be returned.    If  the
                 internal value  is *SYSVAL, the value  from the system
                 value  QDSPSGNINF is  returned.   If used,  the return
                 variable must be specified as *CHAR LEN(4).

   GRPTYP        An optional  return variable  for whether the  profile
                 has members in  a group.  A value of  *YES or *NO will
                 be  returned with  *NO  meaning the  profile is  not a
                 Group Profile.  If used,  the return variable must  be
                 specified as *CHAR LEN(4).

Restrictions
------------

Because the  command returns  variables, it may  only be  used in  a CL
program.

If a  specific user profile is entered, you  must be authorized to that
profile.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CLCDATDIF       Calculate date difference
     CVTDTS          Convert date/time stamp
     RTVDAT          Retrieve date
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVPWDSTS     *CMD                   TAASEFF       QATTCMD
   TAASEFFC      *PGM       CLP         TAASEFFC      QATTCL
					

Added to TAA Productivity tools January 15, 2002


Home Page Up to Top