Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

_STARTUP
A-114
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_STARTUP
_STARTUP is a user-provided initialization procedure called by the frame. It supplies
the lengths of the user context area and input list members, and retrieves and places
subsystem and CI configuration parameters into predefined structures for use by the
frame.
You must call _ADD^SUBSYS in your _STARTUP procedure for each subsystem your
I process handles, as well as _ADD^CI for each CI class with which your I process
communicates.
context-length output
INT:ref
is the length of the command context structure, in bytes.
input-lm-length output
INT:ref
is the length of an input list member, in bytes.
The frame must know the lengths of the user-defined command context and input list
member structures, since it allocates these areas before it creates the first instance of the
command thread.
If no values are provided for context-length and input-lm-length, the frame
allocates only the space required for its own use (as defined by
__COMMAND^CONTEXT^HEADER and _INPUT^LM^HEADER). No space is
reserved for user data.
Example
The following example of an initialization procedure assumes that the user has defined
structure templates for the command context area (command^context^def), an input list
member (input^lm^def), pointers to a _CI^DEF-defined CI configuration structure (scp),
and a _SUBSYS^DEF-defined subsystem configuration structure (snaxcdf):
INT PROC _STARTUP (cx^length, in^lm^length) EXTENSIBLE;
INT .cx^length, .in^lm^length;
BEGIN
cx^length := $LEN (command^context^def);
in^lm^length := $LEN (input^lm^def);
INT PROC _STARTUP ( context-length , input-lm-length )
EXTENSIBLE;