BEA eLink for Mainframe SNA 3.2   Information Center     

        HOME   |   SEARCH   |   CONTACT   |   PDF FILES |   WHAT'S NEW 
 
        TABLE OF CONTENTS   |   PREVIOUS TOPIC   |   NEXT TOPIC  

Appendix C. CPI-C Parameters and Values

CPI-C Verbs

The following tables show the parameters required for each CPI-C verb and the permissible values when used with BEA eLink for Mainframe SNA software.

Table C-1 CMINIT
Parameter In/Out Value Usage

conversation_ID

Output

Returned by the SNA Stack

Used on every other call

sym_dest_name

Input

Symbolic name that represents the partner LU, the modename, and the TP (TUXEDO service)

If blank, SET calls must be made to initialize conversation parameters

return code

Output

See list of CPI-C return codes

If not CM_OK, conversation fails.

Table C-2 CMALLC
Parameter In/Out Value Usage

conversation_ID

Input

Value returned from CMINIT

return_code

Output

See list of CPI-C return codes

If not CM_OK, or CM_ALLOCATION_FAILURE_RETRY, conversation fails

Table C-3 CMRCV
Parameter In/Out Value Usage

conversation_ID

Input

Value returned from CMINIT

buffer

Input

Name of variable to be populated by data received

requested_length

Input

Name of variable where amount of data to be received is posted

0 <= requested_length < 32K

data_received

Output

CM_COMPLETE

CM_INCOMPLETE

Indicates enough data in LU buffer to satisfy requested length

Another CMRCV must be issued to get enough data to satisfy the requested length

received-length

Output

Name of variable where amount of data returned is posted

Returned data may be shorter than requested amount including zero

status_received

Output

CM_NO_STATUS

CM_SEND_RECEIVED

No state change.

State of the conversation is changed to send

request_to_send_received

Output

CM_REQ_TO_SEND_ RECEIVED

CM_REQ_TO_SEND_ NOT_RECEIVED

Receiver enters send state.

Partner has not requested a state change

return_code

Output

See list of CPI-C return codes

If not CM_OK or CM_DEALLOCATE_NORMAL, the conversation is deallocated.

Table C-4 CMSEND
Parameter In/Out Value Usage

conversation_ID

Input

Value returned from CMINIT

buffer

Input

Name of buffer area containing data to be sent

send_length

Input

Length of data in buffer to be sent

0 <= data < 32K

req_to_send_received

Output

The name of the variable that contains the indication that indicates CM_REQ_TO_SEND_ RECEIVED

CM_REQ_TO_SEND_ NOT_RECEIVED

Partner request to change state to send

Partner has not requested a state change

return_code

Output

See list of CPI-C return codes

If not CM_OK, the conversation is deallocated

Table C-5 CMACCP
Parameter In/Out Value Usage

conversation _ID

Output

Returned from the LU

return_code

Output

See list of CPI-C return codes

If not CM_OK, the accept fails and no conversation is started

Copyright © 1999 BEA Systems, Inc. All Rights Reserved.
Required browser version: Netscape Communicator version 4.0 or higher, or Microsoft Internet Explorer version 4.0 or higher.
Last update: October 1, 1999.