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

CPI-C Calls
Specify_Local_TP_Name (cmsltp)
Chapter 3 295
TP_name This parameter specifies the starting address of the TP
name. The name can contain up to 64 characters. The
following characters are allowed:
• Uppercase and lowercase letters
• Numerals 0–9
• The special characters: .<>()+-&*;/,
% _ ? : ' = "
You cannot use the Specify_Local_TP_Name call to
specify the name of an SNA service TP, which contains
characters that are not allowed for this call.
Double-byte character sets, such as Kanji, are not
supported.
TP_name_length This parameter specifies the length of the name.
The range for this value is 1–64.
Returned Parameters
After the verb executes, SNAplus2 returns the following parameters:
return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK One of the following
has occurred:
• The value specified by TP_name is
a reserved name, or contains one
or more characters that are not
valid.
• The value specified by
TP_name_length is out of range.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
This call is not associated with a conversation.