HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Set_TP_Name (cmstpn)
Chapter 3292
TP_name
This parameter specifies the starting address of the
partner program name. The program name can contain
up to 64 characters. The following characters are
allowed:
Uppercase and lowercase letters
Numerals 09 and . (period)
The following special characters: < > ( ) + - &
*; / , % _ ? : ' = " (valid only if the partner
program is a CPI-C program) $ # @ (valid only if
the partner program is an APPC program)
You cannot use the Set_TP_Name call to specify the
name of an SNA service TP, which contains characters
that are not allowed for this call. You can, however, use
the Set_CPIC_Side_Information call to do this.
Double-byte character sets, such as Kanji, are not
supported.
TP_name_length
This parameter specifies the length of the partner
program name.
The range for this value is 164.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
return_code
Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_STATE_CHECK The conversation is not in
Initialize state.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
The value specified by
conversation_ID
is not valid
The value specified by
TP_name_length
is out of range