OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide

Writing Your Program
OSI/MHS Gateway Programmatic Interface (GPI) Programming Guide—424822-001
5-21
Building a Root Object
Example: Inserting an Attribute
The following TAL example shows a call to GPI_OM_INSERT_ . The call inserts one
single-valued attribute of type MH-T-BUILTIN-EITS. Note that, for a single-valued
attribute, value-position is ignored. The following literal is used to make this
more clear to the reader.
literal IGNORED_FOR_SINGLE_VALUED_ATT = 0D;
Data Declarations:
INT
status; -- STATUS code
INT(32)
object_id, -- ID of object
-- into which descriptors
-- are inserted
value_position := IGNORED_FOR_SINGLE_VALUED_ATT,
descriptor_count := 1D; -- Number of descriptors to
-- be inserted
STRUCT
.EXT descriptor_list(OM_descriptor)[0:0];
--defines descriptor list, which is initialized as:
Figure 5-3. Using GPI_OM_INSERT_
503CDT .CDD
Input Parameters
descriptor count: 3
descriptor-list
Attribute Type C
Attribute Type C
Syntax of C
Syntax of C
Value 2 of C
Value 3 of C
Attribute Type H Syntax of H Value of H
OBJECT X (OBJECT_X_ID)
• • •
1
0
OBJECT Y (OBJECT_Y_ID)
1
0
2
18
OBJECT X (OBJECT_X_ID)
1
0
OBJECT Y (OBJECT_Y_ID)
1
0
2
• • •
18
3
object: OBJECT_X_ID
value-position: OM-POSITION-AT-END
OM-T-Class
OM-S-Integer
Object X
Attribute Type A
OM-S-Object
Object_Y_ID
Attribute Type C
Syntax of C
Value 0 of C
Value 1 of C
Attribute Type W
Syntax of W
Value of W
OM-T-Class
OM-S-Integer
Object Y
Attribute Type F
Syntax of F
Value of F
OM-T-Class
OM-S-Integer
Object X
Attribute Type A
OM-S-Object
Object_Y_ID
Attribute Type H
Syntax of H
Value of H
Attribute Type W
Syntax of W
Value of W
Attribute Type C
Syntax of C
Value 0 of C
Value 1 of C
Value 2 of C
Value 3 of C
OM-T-Class
OM-S-Integer
Object Y
Attribute Type F
Syntax of F
Value of F