gtpc2mbb | C/C++ Language Support User's Guide |
This function sets the sync_level characteristic. It
overrides the default value set by the cminit function.
Format
#include <tpfmap.h>
void cmssl(unsigned char *conversation_ID,
signed int *sync_level,
signed int *return_code);
- conversation_ID
- This is a pointer to an 8-byte character array that contains the
conversation ID. This conversation ID must be the ID returned by the
cminit (INITIALIZE) that started this conversation.
- sync_level
- This is a pointer to a 4-byte field that specifies the synchronization
level the local and remote programs can use for this conversation. Use
one of the following values:
- CM_NONE
- This value specifies that no synchronization processing is to be
done. Parameters, characteristics, and functions related to
confirmation are not recognized.
- CM_CONFIRM
- This value specifies that programs can perform confirmation processing for
this conversation.
- return_code
- This is a pointer to a 4-byte field where the return code is to be
placed.
Return Codes
The following is a list of return codes that can be returned to the program
that called the cmssl function. A complete list of the
return codes and their definitions can be found in Table 45.
- CM_OK
- CM_PROGRAM_PARAMETER_CHECK -- This indicates one of the
following:
- The specified conversation_ID is invalid.
- The specified sync_level is invalid.
- The sync_level characteristic is CM_NONE, and
send_type, prepare_to_receive_type, or
deallocate_type is set to use confirmation.
- CM_PROGRAM_STATE_CHECK -- The program is not in initialize
state.
Programming Considerations
- You can execute this function on any I-stream.
- The conversation must be in initialize state.
- The value supplied in conversation_ID must be the conversation ID
returned by the cminit function.
- This function changes the value of the sync_level
characteristic.
- This function causes no state change.
- If return_code is not CM_OK, the sync_level
characteristic remains unchanged.
Examples
The following example changes the sync_level
characteristic.
#include <tpfmap.h>
unsigned char convid[8];
signed int sync;
signed int rcode;
.
.
/* set conversation_ID with value returned from initialize */
.
.
cmssl(convid,&sync,&rcode);
. /* normal processing path */
.
.
Related Information