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

Writing CPI-C Applications

Side Information

Chapter 2 85

Application-Speciﬁed Side Information

NOTE The functions described in this section are not available in Java CPI-C. A

Java CPI-C application cannot maintain its own CPI-C side information

entries. However, it can override individual parameters in the side

information, or determine their values, by using Set_* or Extract_*

functions for each required parameter.

An application can override the side information stored in the

conﬁguration ﬁle to maintain its own side information entries, using the

following calls:

• Set_CPIC_Side_Information (to deﬁne a side information entry

associated with a speciﬁed

sym_dest_name

; if the

sym_dest_name

already deﬁned in the conﬁguration ﬁle, the new information

overrides the conﬁguration ﬁle)

• Delete_CPIC_Side_Information (to indicate that an entry deﬁned by

the application, or one deﬁned in the conﬁguration ﬁle, is no longer

available for use by this application)

• Extract_CPIC_Side_Information (to return the contents of a side

information entry—either an entry deﬁned by the application, or one

deﬁned in the conﬁguration ﬁle)

The modiﬁed information then applies only to this application; it does

not affect other applications, and does not change the conﬁguration ﬁle.

The modiﬁed information is discarded when the application ends.

These calls are not part of IBM CPI-C 2.0; they are provided for

compatibility with X/Open CPI-C. In addition, in the side information

structure used by these calls, the user ID and password parameters are

deﬁned as eight characters (as in X/Open CPI-C) instead of 10 (as in IBM

CPI-C 2.0). This leads to the following restrictions:

• If the partner application requires a user ID or password of more

than eight characters, you cannot specify it using

Set_CPIC_Side_Information. You must either use a side information

entry deﬁned in the conﬁguration ﬁle, or deﬁne one using

Set_CPIC_Side_Information and then override the user ID or

password using the Set_Conversation_Security_User_ID or

Set_Conversation_Security_Password call.