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

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.