VMS Help
LGI Routines, LGI$ICR_IACT_START
*Conan The Librarian
|
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
OpenVMS usage:cond_value
type: longword (unsigned)
access: write only
mechanism: by value
Returns status indicating whether and how to proceed with the
login.
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.
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.