OSI/MHS P7 Application Programmatic Interface (P7 API) Manual

Procedure Calls
OSI/MHS P7 Application Programmatic Interface (P7 API) Manual—424825-001
3-14
LOS_OPEN_
status returned value
long int
indicates the outcome of the call. A value of 0 indicates a successful call. For
additional values, see Appendix B, “Return Codes.”
Considerations
•
LOS_INITIALIZE_ allocates an area of extended memory to hold session-related
data.
•
If a client has open sessions with the P7 API when the program calls
LOS_INITIALIZE_ , these sessions are closed and all session-related data is lost.
Under these circumstances, the LO process aborts all application associations and
any outstanding operations. Normally, you should end all sessions by calling
LOS_CLOSE_ before calling LOS_INITIALIZE_ again.
Example
This example shows a call to LOS_INITIALIZE_ .
status = LOS_INITIALIZE_();
LOS_OPEN_
Use the LOS_OPEN_ environment-management procedure to establish a P7 API session
between a client application and the P7 API. This procedure establishes communication
through the LO group in the local OSI/MHS subsystem. You must call this procedure
once for each session that you intend to establish. The maximum number of concurrent
sessions is determined by the value specified in
ZMHS-VAL-LOUAPI-MAX-NUM-SESS. Within each session, you must call this
procedure before calling any data-transfer procedures.
status returned value
long int
indicates the outcome of the call. A value of 0 indicates a successful call. For
additional values, see Appendix B, “Return Codes.”
mhsMgrName input
extptr int *
status = LOS_OPEN_ ( mhsMgrName,
waitFlag,
buffer1Ptr,
buffer2Ptr,
sendFileNum,
resultFileNum )