The LGI$ICR_CHKRESTRICT callout routine may be used to check
    site-specific access restrictions that are not usually included
    in the OpenVMS login.

    Format

      LGI$ICR_CHKRESTRICT  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

    All logins call this routine after the password is authenticated
    to allow the site to check other access restrictions. The site
    may check its own access restrictions and any of the following
    OpenVMS access restrictions:

    Access
    Restriction        Callback Routine Used to Check Restriction

    Account            LGI$ICB_ACCTEXPIRED
    expiration
    Password           LGI$ICB_PWDEXPIRED
    expiration
    Account disabled   LGI$ICB_DISUSER
    Access modes and   LGI$ICB_MODALHOURS
    times

4  –  Typical Condition Values

    SS$_NORMAL         Access permitted; continue policy checks,
                       including all of the normal OpenVMS policy
                       functions associated with the callback
                       routines used to check restrictions.
    LGI$_SKIPRELATED   Access permitted; omit calls to the LGI$ICR_
                       CHKRESTRICT callout routine in subsequent
                       images and calls to the associated OpenVMS
                       policy functions.
    Other              Disallow the login.

5  –  Associated OpenVMS Policy Functions

    Check password expiration, check DISUSER flag, check account
    expiration, and check restrictions on access time.