Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

I Process Development Process
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 3-29
Initializing Object List Members: _FOBJECT^INIT
You can produce new objects from objects on the input list in two ways:
1. The input object is a subsystem object, and new object names are subordinate
objects produced as a result of processing a hierarchy modifier (HMOD).
2. The input object is an wild card (*), and new object names are produced as a result
of expanding the wild card.
In either case, the input object is the parent of the new object in the name hierarchy
(which includes the subsystem hierarchy).
_FOBJECT^INIT initializes a new FOBJECT structure and determines required fields
from its source FOBJECT structure.
One of same-fobject or parent-fobject must be supplied in the call, but not
both:
•
Use the same-fobject argument if the new FOBJECT structure is to define the
same object as an existing FOBJECT structure. The new object is the same if it has
the same subsystem, object type, name, and manager. Use the following syntax to
initialize the new FOBJECT structure:
error := _FOBJECT^INIT (new-fobject, same-fobject);
The following fields from the source FOBJECT structure are copied to
new-fobject when the same-fobject argument is supplied:
Z^SUBSYS
Z^OBJTYPE
Z^OBJNAME^OCCURS
Z^OBJNAME
Z^MANAGER^OCCURS
Z^MANAGER
•
Use the parent-fobject argument if the new FOBJECT structure is to define a
different object from any previously initialized FOBJECT structure. Specify the
new object’s parent in the name hierarchy; as described earlier, as
parent-fobject. The new object is different if it differs in either object, type,
or name from its “name parent” (the name from which the new object was derived
by expanding a wild card or through the subsystem hierarchy). Use the following
syntax to initialize the new FOBJECT structure:
error := _FOBJECT^INIT (new-fobject,,parent-fobject);
Note. Outside the I process, there are higher levels possible in the name hierarchy made up of
(possibly nested) DNS groups and composites.
error := _FOBJECT^INIT ( new-fobject
,[ same-fobject ]
,[ parent-fobject ]);