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

Writing CPI-C Applications
Side Information
Chapter 2 83
Side Information
The information required for two programs to communicate is stored in
CPI-C side information entries in the SNAplus2 configuration file. You
will need to coordinate with your System Administrator to ensure that it
contains what you need. For additional information about configuration,
refer to the SNAplus2 Administration Guide.
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.
If you are developing commercial programs or programs that will be
installed on multiple machines within your organization, you may want
to include logic to use a different sym_dest_name for each copy of the
program.
Each side information entry contains the following fields:
• Local LU alias
• Partner LU name
• Partner program type and name
• Mode name
• Conversation security type
• Security user ID and password
• Application-specified side information
Local LU Alias
This is the alias of the local LU to be used to allocate conversations. It
consists of up to eight ASCII characters. For the allowed characters, see
“Set_Local_LU_Name (cmslln)” in Chapter 3.