The LGI$ICR_DECWINIT callout routine enables site-specific
    initialization functions for logins from the DECwindows session
    manager.

    Format

      LGI$ICR_DECWINIT  arg_vector ,context

1  –  Returns

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

    Returns status indicating whether and how to proceed with the
    login.

2  –  Arguments

 arg_vector

    OpenVMS usage:vector
    type:         vector_longword_unsigned
    access:       modify
    mechanism:    by reference
    Vector containing site-specified callbacks and login information.

 context

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Pointer to site's local context.

3  –  Description

    LOGINOUT invokes the LGI$ICR_DECWINIT callout routine at the
    start of a DECwindows session login. This callout routine does
    not support a return status of LGI$_SKIPRELATED. Returning
    LGI$_SKIPRELATED for this callout causes unpredictable results.
    Use the LGI$ICR_DECWINIT callout routine only to prepare other
    callout routines for a DECwindows login.

    After issuing the LGI$ICR_DECWINIT callout, LOGINOUT performs the
    following tasks:

    o  Creates the DECwindows login dialog box and reads the user
       name and password entered by the user

    o  Calls the LGI$ICR_IDENTIFY callout

    o  Obtains the user authorization file (UAF) record

       If the UAF record specifies two passwords, the DECwindows
       login dialog box is amended to prompt for the second password,
       and the listed tasks are repeated.

    o  Issues the LGI$ICR_AUTHENTICATE callout

    o  If the LGI$ICR_AUTHENTICATE callout routine did not return
       LGI$_SKIPRELATED, validates the passwords against the UAF
       record

    The LGI$ICR_IDENTIFY and LGI$ICR_AUTHENTICATE callouts may create
    additional DECwindows dialog boxes to communicate with the user,
    but the initial dialog box must be created by LOGINOUT.

4  –  Typical Condition Values

    SS$_NORMAL         Access permitted; continue policy checks.
    LGI$_SKIPRELATED   Not supported. Returning this status will
                       cause unpredictable behavior.
    Other              Disallow the login.

5  –  Associated OpenVMS Policy Function

    Create dialog box, read user name and password, and call the
    identification and authentication routines.