VMS Help  —  LGI Routines, LGI$ICR_IACT_START
    The LGI$ICR_IACT_START callout routine may perform initialization
    functions for logins from interactive character-cell terminals.

    Format

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

 context

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

3  –  Description

    This routine makes the first contact for all interactive logins
    from other than DECwindows terminals after opening the input and
    output files but before any other dialogue with the user.

    At this point, the site should be preparing to augment or replace
    the OpenVMS system password routine. The callback routine
    LGI$ICB_GET_SYSPWD provides access to the system password
    routine. However, because LGI$ICB_GET_SYSPWD returns only on
    success, the site design should consider what action to take in
    case LGI$ICB_GET_SYSPWD does not return control to LGI$ICR_IACT_
    START.

    The LGI$ICR_IACT_START routine can use the LGI$ICB_GET_INPUT
    callback routine to:

    o  Get input from the user

    o  Use an OpenVMS RMS record access block (RAB) to establish
       appropriate terminal mode settings

4  –  Typical Condition Values

    SS$_NORMAL         Access permitted; continue OpenVMS system
                       password routine.
    LGI$_SKIPRELATED   Access permitted; omit calls to the LGI$ICR_
                       IACT_START callout routine in subsequent
                       images and calls to the associated OpenVMS
                       policy function.
    Other              Exit quietly to preserve the illusion of an
                       inactive line.

5  –  Associated OpenVMS Policy Function

    Get the system
    password.
Close Help