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.