VMS Help  —  LGI Routines, LGI$ICR_FINISH
    The LGI$ICR_FINISH callout routine permits the site program to
    take final local action before exiting from LOGINOUT.

    Format

      LGI$ICR_FINISH  arg_vector ,context ,user_cond_value

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 callbacks and login information.

 context

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

 user_cond_value

    OpenVMS usage:cond_value
    type:         longword_unsigned
    access:       read only
    mechanism:    by value
    SS$_NORMAL for successful login; otherwise, reason for failure.

3  –  Description

    The site program calls this routine immediately before exiting to
    take any final local actions relative to the login process. There
    is no OpenVMS login security policy associated with LGI$ICR_
    FINISH.

    LGI$ICR_FINISH does not affect login completions because the
    login is audited before the routine is invoked. The routine has
    no effect on error recovery when a login fails, and it cannot
    cause a successful login to fail.

    Typical site action may include the following:

    o  Override job quotas

    o  Stack CLI command procedures by examining and modifying the
       logicals PROC1 through PROC9

                                    CAUTION

          For DECwindows session manager logins, be careful
          modifying the command procedure stack to avoid adversely
          affecting the command file that invokes the session
          manager.

    o  Other postlogin processing

4  –  Typical Condition Values

    LGI$_SKIPRELATED   Access permitted; omit calls to the LGI$ICR_
                       FINISH callout routine in subsequent images.

5  –  Associated OpenVMS Policy Function

    None.
Close Help