CMSMN — Set_Mode_Name


CMSMN (conversation_ID, mode_name, mode_name_length, return_code),
       [LOGGING log_byte]

Where

conversation_ID (character input) specifies the conversation identifier of the desired conversation.

mode_name (character input) specifies the mode name designating the network properties for the session to be allocated to the conversation. The network properties include, for example, the class of service to be used, and whether data is encrypted. The mode name must be from character set 01134. (A program must have special authority to specify a mode name that is used by SNA service transaction programs only, such as SNASVCMG.)

mode_name_length (numeric input) specifies the length of the mode name. The length can be from zero to eight bytes. If zero, the mode name for this conversation is set to null and the mode_name parameter included with this statement is not significant.

return_code (numeric output) specifies the result of the statement execution.

log_byte is a 1-byte string constant or a string expression that specifies a byte of user data to be associated with this CPI-C statement during logging. The log_byte remains active until another CPI-C statement is issued. Only the first character or first two hexadecimal digits of the string expression are used. The default log_byte is X'00'.

Function

A program uses the CMSMN statement to simulate the CPI-C CMSMN call, which is used to set the mode_name and mode_name_length characteristics for a conversation. The CMSMN statement overrides the current values, which were originally acquired from the side information using the sym_dest_name. Issuing this statement does not change the values in the side information. It only changes the mode_name and mode_name_length for this conversation.

Note: The CMSMN statement can be issued onlyafter the CMINIT for the conversation has completed, and before the CMALLC is issued.

For more information on CMSMN and its parameters, refer to the Set_Mode_Name (CMSMN) call description in the “Call Reference” chapter of Systems Application Architecture Common Programming Interface Communications Reference.