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