Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

I Process Development Process

Distributed Systems Network Management (DSNM) Subsystem Interface Development

Guide—109759 3-13

The _STARTUP Procedure

The frame must supply the lengths of the command context space and the input list

member structures for which it allocates memory each time it creates an instance of a

thread. _STARTUP declares an initialization procedure that is called by the frame to

provide this information before it creates the first instance of the command thread.

_STARTUP also retrieves subsystem and CI configuration parameters from the

DSNMCONF file and places them into predefined structures for use by the frame. (See

“Command Context Space” on page 3-15 for a definition of the command context

space.)

The format of the _STARTUP procedure is as follows:

context-length

is the length, in bytes, of the user-defined command context structure.

input-lm-length

is the length, in bytes, of the user-defined input list member structure.

If no values are provided, the frame allocates only the space required for its own use; no

space is made available for user data.

The following procedures must be called in your _STARTUP procedure:

_ADD^SUBSYS

fills in a predefined structure with subsystem configuration parameters for the

subsystem(s) the I process handles. The frame uses this information when it gets a

command for that subsystem.

_ADD^CI

fills in a predefined structure with CI configuration parameters for the CI class with

which your I process communicates.

The _STARTUP procedure is described in more detail in Section 5, “DSNM Process

Startup Functions.”

INT PROC _STARTUP ( context-length,input-lm-length )

EXTENSIBLE;