CMEMN — Extract_Mode_Name

CMEMN (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 output) specifies the variable containing the mode name. The mode name designates the network properties for the session allocated, or to be allocated, which will carry the conversation specified by the conversation_ID.

mode_name_length (numeric output) specifies the variable containing the length of the returned mode_name parameter.

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 CMEMN statement to simulate the CPI-C CMEMN call, which is usedto extract the mode_name and mode_name_lengthcharacteristics' values for a given conversation. The values are returned in the mode_name and mode_name_lengthparameters.

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