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

Procedure Calls
OSI/MHS P7 Application Programmatic Interface (P7 API) Manual—424825-001
3-10
LOS_DT_SEND_
Considerations
•
After a send file number is returned from AWAITIOX, the client application must
call this procedure before it can issue another call to LOS_DT_SEND_ .
•
status can indicate that the application association has been aborted. In this case,
call LOS_CLOSE_ , followed by LOS_OPEN_ to reestablish the session, then
LOS_DT_SEND_ to bind to an MS group.
Example
This example shows how to check for completion on the send file.
long int status; /* Check status of LOS_DT_FINISH_SEND_ */
int sendFile; /* File number completion occurred on */
char *buffer[]; /* Associated Completion Data */
status = LOS_DT_FINISH_SEND_(sendFile, (int *) buffer);
LOS_DT_SEND_
Use the LOS_DT_SEND_ data-transfer procedure to bind the client application to an
MS group, to send data from the client application to OSI/MHS, or to unbind the client
application from an MS group. When a client application is bound to an MS group, the
client is said to have an application association with an MS group.
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.”
sendFileNum input
int
specifies the file number of the file for sending data to OSI/MHS. This file number
is returned by the LOS_OPEN_ procedure.
bufferPtr input
extptr int *
specifies the buffer containing the data to be sent to OSI/MHS. The data starts at
byte 25. You must allocate a buffer equal to the length of the data that you want to
status = LOS_DT_SEND_ ( sendFileNum,
bufferPtr,
bufferLen,
maxBufferLen,
moreData,
dataType );