The Generate Random Password 2 command returns a random password
which adheres to the current password rules found in the system
values.

Generate Random Password 2 can be helpful when needing to setup new
user profiles, or resetting passwords for users.  In addition, the
TAA command, INZPWD uses GENRANPWD2 to generate passwords the system
will accept.

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

   RTNPWD        The variable name for the generated password that is
                 returned.  This is a required parameter.  It must be
                 declared as a CHAR(75).

   PWDLEN        The length of the password to be returned.  This
                 defaults to *SYSVAL which specifies that the
                 returned password length should fall within the
                 range specified by the system values.

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

All password levels are supported.  Most password rules are
supported.

  The following QPWDRULES are supported:
    *PWDSYSVAL
    *MAXLENnnn    *MINLENnnn
    *REQANY3      *MIXCASEn
    *CHRLMTAJC    *CHRLMTREP
    *LTRMIN       *DGTMIN      *SPCCHRMIN
    *LTRMAX       *DGTMAX      *SPCCHRMAX
    *LTRLMTAJC    *DGTLMTAJC   *SPCCHRLMTAJC
    *LTRLMTFST    *DGTLMTFST   *SPCCHRLMTFST
    *LTRLMTLST    *DGTLMTLST   *SPCCLHRMTLST

  The following QPWDRULES are ignored since these are run-time
  checks that can only be made when the password changes.
    *LMTSAMPOS    *LMTPRFNAME  *ALLCRTCHG

  IF QPWDRULES is set to *PWDSYSVAL --
   The following system password rules are supported:
     QPWDMAXLEN - like *MAXLENnnn
     QPWDMINLEN - like *MINLENnnn
     QPWDLMTREP - like *CHRLMTAJC or *CHRLMTREP
     QPWDRQDDGT - like *DGTMINn (n is 0 or 1)
     QPWDLMTAJC - like *DGTLMTAJC
     QPWDLMTCHR - no corresponding rule in QPWDRULES
                  This is only used if the password level is 0 or 1.

If a Password Approval Program is specified, its logic could
invalidate the password generated by this tool.  In this case, the
Password Approval Program should be changed to remove unsupported
password rules, as noted above.

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

The following TAA Tools must be on your system:

     SNDESCMSG       Send escape message
     SNDESCINF       Send escape info

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

None, the tool is ready to use.

Exceptions that can be monitored for:
--------------

CPF9898 - An error condition was met in the program.  Specific error
should be found in the job log.

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

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

   GENRANPWD2    *CMD                   TAASEHO       QATTCMD
   TAASEHOC      *PGM       CLLE        TAASEHOC      QATTCL
   TAASEHOR      *PGM       RPGLE       TAASEHOR      QATTRPG