NET/MASTER Network Control Language (NCL) Reference Manual
SECCALL EXIT
Verbs
106126 Tandem Computers Incorporated 3–171
variable*
specifies a set of input variables. See “Frequently Occurring Operands,” at the
beginning of this section, for more information.
RANGE=(
start
,
end
)
determines the range of variables specified by the VARS operand. See
“Frequently Occurring Operands,” at the beginning of this section, for
more information.
SEGMENT=
n
specifies the amount of data (in bytes) to be put into the variables
specified. See “Frequently Occurring Operands,” at the beginning of this
section, for more information.
Considerations
SECCALL EXIT statement allows a procedure to pass the contents of supplied
variables to the security exit for processing. The security exit may return
information to the procedure in the same variables. The content and processing of
the information exchanged is determined by the installation. The NCL procedure
must specify sufficient variables to hold all expected information returned from
the installation’s security exit procedure. The installation’s security exit procedure
can pass variables with null values when it returns to the SECCALL EXIT. If the
security exit deletes information from a variable, that variable is returned as a null
variable. The procedure must be written to allow for this possibility.
If the security exit returns with an error message, such as the details of an illegal
use of the exit, such information is contained in the variable &SYSMSG.
If the SECCALL EXIT verb is improperly coded, and an error handler has been
supplied, error information is contained in the &SYS.ERROR.TEXT system
variable.
The &SYS.RETCODE system variable can be set by the installation’s security exit
procedure and can range from 0 (zero) through 99. The site determines the
interpretation of these return codes.
For more information on security exits and SECCALL verbs, refer to the NonStop
NET/MASTER NCL Programmer's Guide.
Example
The following example takes the data EXIT REQUEST and passes it to the exit. The
data returned from the exit is placed in the variables &1 through &
n
:
SECCALL EXIT DATA=EXIT REQUEST
TO
ARGS