Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services

Distributed Systems Network Management (DSNM) Subsystem Interface Development

Guide—109759 A-7

_ADD^SUBSYS

_ADD^SUBSYS retrieves subsystem and object type configuration information from

the DSNM configuration file (DSNMCONF). It allocates the memory for and

completes a predefined subsystem configuration structure with this information. It then

returns the address of the completed structure.

You must declare an extended pointer to a subsystem configuration structure defined by

_SUBSYS^DEF in your global definitions for each subsystem your I-process handles.

You must call _ADD^SUBSYS in your _STARTUP procedure for each subsystem your

I-process handles.

ss-config output

INT .EXT ! (_SUBSYS^DEF) !

receives the address of the _SUBSYS^DEF-defined subsystem configuration

structure that _ADD^SUBSYS completed with configuration parameter values for

the specified subsystem. If an error occurs or no configuration is found for this

subsystem, a null value is returned.

ssname input

STRING .EXT

is the subsystem name. The subsystem name is the name in the COMPONENT field

of the SUBSYSTEM class records in the DSNMCONF configuration file that

specifies the subsystem configuration parameters.

error output

INT .EXT

is the ZDSN or file-system error, if an error occurs.

error-filename output

STRING .EXT ! (ZDSN^DDL^OBJNAME^DEF) !

is the name of the DSNM configuration file associated with the returned error

value.

@ss-config := _ADD^SUBSYS ( ssname

,[ error ]

,[ error-filename ] );