Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

_FOBJECT^INIT
A-50
109759—Distributed Systems Network Management (DSNM) Subsystem Interface
Development Guide
DSNM Library Services
_FOBJECT^INIT
_FOBJECT^INIT initializes a new FOBJECT structure and determines required fields
from its source FOBJECT structure. _FOBJECT^INIT does not allocate memory;
memory for the new formatted object must be allocated previously.
error returned value
INT
is a ZDSN^ERR value, indicating the outcome of the call. See Appendix B,
“DSNM Error Codes,” for error code definitions.
new-fobject user-provided identifier
is the name (a valid TAL identifier) of the new FOBJECT structure to initialize.
same-fobject input
is the name of an FOBJECT structure that contains the same object information as
new-fobject. In this case, new-fobject is identical to its source object.
parent-fobject input
is the name of an FOBJECT structure from which new-fobject is derived when
processing a hierarchy modifier or expanding a “*” object name.
Either same-fobject or parent-fobject must be supplied in the call, but not
both. In both cases, all required internal information is entered in the new-fobject
structure.
•
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. In this case, 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
error := _FOBJECT^INIT ( new-fobject
,[ same-fobject ]
,[ parent-fobject ]);