OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Information Architecture and Data Structures
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
2-11
String Segments
Figure 2-7 shows an example of reading segments of a string value at attribute
position 5, beginning at value position 0. The maximum number of octets read at one
time is 32,767. The string offset is incremented by 32,767 at each call.
You can use GPI_OM_READ_ to read any string, but it is usually used to read long
strings. To insert a long string value in an object you are creating, you must call the
GPI_OM_WRITE_ procedure successively and specify a string offset in each call.
Figure 2-7. Example of Retrieving String Segments
String Value
at Attribute Position 5
Value Position 0
String Offset 65,534
GPI_OM_READ_
String Buffer
First
Call
Second
Call
Maximum-
Number
(32,767 Octets)
String Offset 0
String Offset 32,767
Maximum-
Number
(32,767 Octets)
207VST .VSD