! Editted for V2.0 of GETUAF at Fermilab, Frank J. Nagy  04-Apr-83
!
1 GETUAF
 The function of this program is to fetch information from the System
 User Authorization File.  The access key may be either a username or a
 UIC (for multiply-defined UIC's only the first user record is returned).

 Calling Procedure:

    $ GETUAF :== $FERMI$EXE:GETUAF
    $ GETUAF access_key

 This program requires suitable privilege to access the system User
 Authorization File (SYSPRV).

2 Parameter
 access_key
    This is the 'username' or the '[uic]' of the UAF record that
    is desired.  If it is the '[uic]' it must be enclosed in []
    to distinguish it from a 'username'.

    If the '[uic]' specified has more that one record associated
    with it only the information on the first record found is
    returned.

2 Qualifiers
/ACCOUNT=symbol
 will return the account name from the record, selected by the
 access_key, in the local 'symbol' supplied.

/CTRLY=symbol
 will return "NO" if Control-Y is disabled for the account at login
 (the DISCTLY flag is set), otherwise "YES" will be returned in the
 local 'symbol' supplied.

/CAPTIVE=symbol
 will return "YES" if this is a captive (or turnkey) account
 (the CAPTIVE flag is set), otherwise "NO" will be returned in the
 local 'symbol' supplied.

/DEVICE=symbol
 will return the default disk device from the record, selected by
 the access_key, in the local 'symbol' supplied.

/DIRECTORY=symbol
 will return the default directory from the record, selected by the
 access_key, in the local 'symbol' supplied.

/DISUSER=symbol
 will return "YES" if this account is disabled from interactive
 logins (the DISUSER flag is set) in the local 'symbol' supplied.
 Normally, "NO" will be returned for an "enabled" account.

/EXACT (D)
/NOEXACT
 This qualifier specifies whether the username access_key specified 
 is to match the name of a user in the User Authorization File 
 exactly or if only the leading characters specified need match.

 If /NOEXACT is specified then the access_key need only match the 
 leading characters of the record key.  This is useful in 
 determining if a potential username to be added to the UAF will 
 generate a directory name which matches an existing directory on 
 the system.  The /NOEXACT will only return the first match.

 The default is /EXACT.

/NEWMAIL=symbol
 will return "YES" if "New Mail" messages are to be generated for
 for the account at login.  Otherwise, (if the DISNEWMAIL flag is
 is set) "NO" is returned in the local 'symbol' supplied.

/NEXT_UIC_MEMBER=symbol
 will return the next available (un-used) member number (in octal).
 The group and the lower limit for the search are specified by the
 access_key which must be a UIC specification when this qualifier is
 specified.

 An error will be generated if any of /USERNAME, /UIC, /ACCOUNT,
 /DEVICE, /DIRECTORY, /OWNER, /CTRLY, /CAPTIVE, /DISUSER, /NEWMAIL
 or /WELCOME are specified along with this qualifier.

/OWNER=symbol
 will return the owner name from the record, selected by the
 access_key, in the local 'symbol' supplied.

/UAF=file_spec
 This qualifier will specify then name of an alternate User 
 Authorization File.

 By default the program will translate the logical name SYSUAF and
 append the translated value to SYS$SYSTEM: to find the User
 Authorization File. 

/UIC=symbol
 will return the UIC from the record, selected by the access_key, in
 the local 'symbol' supplied.  The UIC is returned in the format
 "[ggg,mmm]".

/USERNAME=symbol
 will return the username from the record, selected by the
 access_key, in the local 'symbol' supplied.

/WELCOME=symbol
 will return "YES" if welcoming messages are to be displayed
 for the account at login.  Otherwise, (if the DISWELCOM flag
 is set) "NO" is returned in the local 'symbol' supplied.

