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.