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

CPI-C Calls

Release_Local_TP_Name (cmrltp)

Chapter 3 213

CM_OK The call executed successfully.

CM_PROGRAM_PARAMETER_CHECK One of the following

has occurred:

• The value speciﬁed by

TP_name

not a TP name associated with

this program

• The value speciﬁed 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.

State Change

There is no state change.

Usage Notes

If the

return_code

is not CM_OK, the names associated with the program

remain unchanged.

If an Accept_Incoming call is outstanding at the time this call is issued,

it may accept an incoming Allocate for the name speciﬁed on this call.

However, subsequent Accept_Conversation or Accept_Incoming calls will

not accept incoming Allocates for this name.

If a program releases all its TP names, including the name speciﬁed by

the APPCTPN environment variable (if any), then it cannot issue any

further Accept_Conversation or Accept_Incoming calls unless it ﬁrst

speciﬁes a new local TP name. For more information, see “Specifying the

Local TP Name” in Chapter 2.

End of Section