CMSTPN — Set_TP_Name


CMSTPN (conversation_ID, TP_name, TP_name_length, return_code),
        [LOGGING log_byte]

Where

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

TP_name (character input) specifies the name of the remote program. A program with the appropriate privilege can specify the name of an SNA service transaction program. The TP name must be from character set 00640.

TP_name_length (numeric input) specifies the length of the TP_name. The value can be from 1 to 64.

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 CMSTPN statement to simulate the CPI-C CMSTPN call, which is used to set the TP_name and TP_name_length characteristics for a given conversation. The CMSTPN statement overrides the current value that was originally acquired from the side information using the sym_dest_name. Issuing this statement does not change the value of TP_name in the side information. It only changes the TP_name for this conversation.

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

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