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

Planning and Writing Your Application
OSI/MHS P7 Application Programmatic Interface (P7 API) Manual—424825-001
2-7
Transferring Data
Closing a Session
You call the LOS_CLOSE_ procedure to close a P7 API session. LOS_CLOSE_ takes
the send file number and result file number as input parameters. After this procedure,
these file numbers become invalid, even if an error occurs while the procedure is
executing.
You should close a session:
1. After you have unbound from an MS group. (“Transferring Data,” the next
subsection, describes how to unbind from an MS group.)
2. Whenever the status parameter of another P7 API procedure call indicates that an
application association has been aborted.
Transferring Data
After a P7 API session has been established, the client application can send data to and
retrieve data from the OSI/MHS subsystem. The data sent by the client application can
be a P7 administration, submission, or retrieval argument the data retrieved can be a
result or error.
The following subsections describe the data transfer operations in the order that your
client application would perform them. Specifically, the tasks described are:
•
Binding to an MS group
•
Sending P7 submission and retrieval arguments
•
Retrieving P7 results and errors
Figure 2-2. Opening a Session
202CDT .CDD
OSI/MHS Subsystem
MHSMGR
LO Group
Client
Application
P7
API
12
45
3
6 + 7