CMSPLN — Set_Partner_LU_Name


CMSPLN (conversation_ID, partner_LU_name,partner_LU_name_length,,
        return_code) [LOGGING log_byte]

Where

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

partner_LU_name (character input) specifies the name of the remote LU at which the remote program is located. This LU name is any name by which the local LU knows the remote LU for purposes of allocating a conversation. The partner LU name must be from character set 01134.

partner_LU_name_length (numeric input) specifies the length of the partner LU name. This value can be from 1 to 17.

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 CMSPLN statement to simulate the CPI-C CMSPLN call, which is used to set the partner_LU_name and partner_LU_name_length characteristics for a given conversation. The CMSPLN 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 partner_LU_name and partner_LU_name_length for this conversation.

Note: The CMSPLN statement can be issued only after the CMINIT for the conversation has completed,and before the CMALLC is issued.

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