otma_send_receivex API
The otma_send_receivex API has the same functionality as the otma_send_receive API, but adds the extended ability to pass OTMA user data.
Invocation
Same as for the otma_send_receive API.
Input
Same as for the otma_send_receive API, with the following additional parameter:
- *otma_user_data
- Pointer to the OTMA user data. The OTMA user data field can contain
any user data that is used to identify the user input, or to correlate
input with output. If a value is specified in this field, the data
is sent to IMS. IMS user exits OTMAIOED and DFSYDRU0 can read
or change the data. The data is returned to the user if the otma_receive_async API
with otma_user_data is issued.
If there is no OTMA user data, specify a NULL for this field.
Output
Same as for the otma_send_receive API.
C-language function prototype
otma_send_receivex(
otma_anchor_t *anchor, [in]
otma_retrsn_t *retrsn, [out]
ecb_t *ecb, [out]
sess_handle_t *session_handle, [in]
lterm_name_t *lterm, [in/out]
mod_name_t *modname, [in/out]
char *send_buffer, [in]
data_leng_t *send_length, [in]
data_leng_t *send_segment_list, [in]
char *receive buffer, [in]
data_leng_t *receive_length, [in]
data_leng_t *received_length, [out]
data_leng_t *receive_segment_list, [in/out]
context_t *context_id, [in]
char *error_message, [out]
otma_user_t *otma_userdata); [in/out]
Post codes
Same as for the otma_send_receive API.
Return values (rc value)
Same as for the otma_send_receive API.