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

Concepts
Side Information
Chapter 1 49
Side Information
The information required for two programs to communicate is stored in
CPI-C side information entries in the SNAplus2 configuration file. Each
side information entry is identified by a Symbolic Destination Name,
which is the sym_dest_name parameter specified by the
Initialize_Conversation call. The parameter sym_dest_name is an 8-byte
ASCII character string and can contain any displayable characters. It
contains the following fields:
• Partner LU name
• Partner program type and name
• Mode name
• Conversation security type (see “Multiple Conversations”)
• Security user ID and password required to access the partner
program
CPI-C also provides two mechanisms for an application to override the
configured side information entries, as follows. Both of these
mechanisms apply only to the application's own use of this information,
and do not modify the original version stored in the configuration file.
• The application can use the Set_CPIC_Side_Information,
Extract_CPIC_Side_Information, and
Delete_CPIC_Side_Information calls to manage its own local copy of
complete side information entries. (These functions are not available
in Java CPI-C.)
• The application can use CPI-C Set_* functions (such as
Set_Partner_LU_Name) to override an individual parameter from
the side information before allocating the conversation.
For more information, see “Side Information” in Chapter 2.