Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-51
_FOBJECT^INIT
•
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 above as the parent-
fobject. The new object is different if it differs in any of subsystem, object type,
name, or manager from its name parent (the name from which the new object was
derived by expanding a “*” or through the subsystem hierarchy). In this case, use
the following syntax to initialize the new FOBJECT structure:
error := _FOBJECT^INIT (new-fobject,,parent-fobject);
The following fields from the source FOBJECT structure are copied to
new-fobject when the parent-fobject argument is supplied:
Z^SUBSYS
Z^MANAGER^OCCURS
Z^MANAGER
Z^OBJTYPE, Z^OBJNAME, and Z^OBJNAME^OCCURS are set to null values (0
or blanks, as appropriate). You must supply values for Z^OBJTYPE and
Z^OBJNAME. Suppling a value for Z^OBJNAME^OCCURS is optional.
In both cases, all required internal information is entered into the new-fobject
structure.
Considerations
Parent means the parent of the new object in a name hierarchy, which includes the
subsystem hierarchy and a “*” object name, if supported by your I process. 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 by processing a hierarchy modifier (HMOD).
2. The input object is a “*,” and new object names are produced by expanding the “*.”
In either case, the input object is the parent of the new object in the name hierarchy
(which includes the subsystem hierarchy).
Note. Outside the I process, there are higher levels possible in the name hierarchy: DNS
groups (possibly nested) and composites.