OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
4-8
GPI_INITIALIZE_
In addition to specifying maximum length of string data space for object trees,
max-table-data specifies the maximum size of inbound and outbound
messages that can be handled without using a temporary file. The value of max-
table-data cannot exceed 10,485,760. If max-table-data has a value in the
range from the minimum allowed (2,048) through the default value (2,097,152),
messages with size greater than 2MB will be transferred through use of a temporary
file. For values of max-table-data that are greater than the default (2,097,152)
through the maximum allowed (10,485,760), messages with size greater than that
value will be transferred through use of a temporary file.
For example,
If max-table-data equals 1,048,304:
•
Messages with size less than 2 MB are transferred directly.
•
Messages with size greater than 2 MB are transferred through use of a
temporary file.
If max-table-data equals 4,194,304:
•
Messages with size less than 4 MB are transferred directly.
•
Messages with size greater than 4 MB will be transferred through use of a
temporary file.
max-string-length input
INT(32):value
specifies the maximum length (in octets) of a string that the GPI is to allow to be
passed in an attribute descriptor. Strings that are longer than the length specified are
known as long strings. Long strings can only be accessed by using
GPI_OM_READ_ or GPI_OM_WRITE_.
The minimum value for this parameter is ZGPI-MIN-LONG-STRING-LEN (1024)
octets. The default value of ZGPI-DEFAULT-LONG-STRING-LEN (32,767) is
used, if you omit this parameter.
Considerations
•
If a client has open sessions with the GPI service when the program calls
GPI_INITIALIZE_, the sessions are closed, session-related data is discarded, and
any objects reserved by the client are made unreserved. Normally, you should end
all sessions by calling GPI_CLOSE_ before calling GPI_INITIALIZE_ again.
•
The practical limit on the total length of a communication’s string data is less than
ZGPI-MAX-OT-DATA-LEN even though this amount of string data can be
supplied. If an encoded communication exceeds the maximum message limit
specified by max-table-data, OSI/MHS generates a nondelivery report.
•
The GPI allows a client program to process at most 15 root objects at a time,
regardless of the number of open sessions. The root objects can be a combination of
reserved root objects and newly created root objects. The number of root objects is