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-8
Transferring Data
•
Unbinding from an MS group
Binding to an MS Group
All application associations are opened using an MSBIND request. You call
LOS_DT_SEND_ with an MSBIND argument to bind to the MS group and open the
association. The MS bind argument is an encoded P7 MS bind operation. Only the
client application can initiate an association with OSI/MHS; OSI/MHS cannot initiate an
association with a P7 API client application.
When a client application calls LOS_DT_SEND_ with an MSBIND request, the
following steps occur:
1. The client application sends the MSBIND request to the P7 API service.
2. The P7 API sends the request to an LO group in the local subsystem.
3. The LO group directs the incoming MSBIND request to the correct MS group for
that user, using the O/R name of that user.
During configuration of the OSI/MHS subsystem, each MS user is assigned to a
particular MS group. The LO group checks the identity of the user who sent the
BIND request and determines in which MS group the mailbox for that user is
located. Any LO group can send data to any MS group within the same subsystem.
4. The MS group returns an MSBIND result or error to the LO group.
5. The client application retrieves the MSBIND result or error from the LO group. If
the client application retrieves an MSBIND result, the client application is said to
have established an application association with the MS APPL object.
Figure 2-3 shows a client application binding to an MS group.
Note. Because the administration operations, MSBIND and MSUNBIND, bracket all other P7
operations, they are presented in their own subsections below.
Additionally, you should note that the following subsections do not describe the SUBMISSION
CONTROL operation. For more information on this operation, see Section 3 and X.419 MHS:
Protocol Specifications in Recommendations X.400-X.420 (1988).