VMS Help LGI Routines, LGI$ICB_VALIDATE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The LGI$ICB_VALIDATE callback routine validates the user name and
    passwords against the system authorization file.

    Format

      LGI$ICB_VALIDATE  username ,pwd1 ,pwd2

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

    Condition value in R0.

2 - Arguments

 username

    OpenVMS usage:character string
    type:         string descriptor
    access:       read only
    mechanism:    by reference
    User name.

 pwd1

    OpenVMS usage:character string
    type:         string descriptor
    access:       read only
    mechanism:    by reference
    Primary password.

 pwd2

    OpenVMS usage:character string
    type:         string descriptor
    access:       read only
    mechanism:    by reference
    Secondary password.

3 - Description

    The site can use this callback routine to validate the user name
    and the user's primary and secondary passwords against the system
    authorization file (SYSUAF.DAT). The routine also:

    o  Updates the user authorization (UAF) record with information
       about login failures

    o  Performs security auditing

    o  Performs break-in detection and intrusion evasion

4 - Condition Values Returned

    Success, or an error indicating the reason for the failure.