OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual

Procedure Calls
OSI/MHS Gateway Programmatic Interface (GPI) Reference Manual—522223-001
4-48
GPI_OPEN_
gateway-password-length input
INT:value
specifies the length (in octets) of the gateway-password string. If you specify a
gateway password, you must include this parameter. If you omit the gateway
password, this parameter is ignored. The minimum value you can specify is 0.
Considerations
•
After initializing the environment, you can call the GPI_OPEN_ procedure at any
time that your client application needs to start GPI operations with the GPI service
and the X.400 MTA.
•
The time required to complete this procedure might be significantly longer than that
required for the other procedures.
•
See the OSI/MHS Configuration and Management Manual for more information
about GATEWAY objects, the MHS manager process, and gateway passwords.
•
A client application may open up to 15 sessions. Sessions can be connected to the
same gateway, or to different gateways which are configured in the same or different
subsystem(s).
•
The GPI components in the current release are not compatible with components in
the previous release. Attempts to use incompatible releases of the GPI result in the
return of the ZGPI-RC-INCOMPATIBLE-GIP error in response to GPI_OPEN_.
•
If an entry manager is configured with a “terminal” as output, and if the entry
manager is trying to output an error to that impaired terminal, then the open may
hang as the GIP tries to open the entry manager.