IV10996: NEW OPTION TO DYNAMICALLY UPDATE LOCAL_LU WITH REMOTE API CLIENT HOSTNAME

Communications Server for AIX, Version 6.4 -- Latest PTFs
Communications Server for Linux, Version 6.4 -- Latest Fixpack

APAR status

• Closed as program error.

Error description

• Communications Server for AIX and Linux
  ---------------------------------------
  NEW FUNCTION:
  Add option to dynamically append the client's hostname to
  the Local TP Name when an application starts (issues TP_STARTED
  or CMINIT) for outbound conversations, and then on the server
  update the local LU parameter sys_name with this hostname.
  

Local fix

Problem summary

• USERS AFFECTED: All using the Remote API Client.
  
  PROBLEM DESCRIPTION:
    NEW FUNCTION:
    Add option to automatically append the client's hostname to
    the Local TP Name when an application starts (issues
  TP_STARTED
    or CMINIT) for outbound conversations, and then on the server
    update the local LU parameter sys_name with this hostname.
  
  PROBLEM SUMMARY:
    New function described above has been added.
  

Problem conclusion

• This new function has been added to the server and client code
  and can only be used if both the server and client have been
  updated with this new code.
  
  To use the enhancement:
   - First, query the existing setting for ptf_flags:
     snaadmin  query_node | grep ptf_flag
     + if the response shows a setting, for example:
         ptf_flags = SUPPRESS_PU_NAME_ON_REQACTPU
       then use a "+" to add the CLI_OVERWRITE_SYS_NAME flag
  
     Second, issue either of the following as needed:
       snaadmin -c define_node,ptf_flags=CLI_OVERWRITE_SYS_NAME
     or as for the example above
       snaadmin -c define_node,ptf_flags=SUPPRESS_PU_NAME_ON_REQAC
  TPU+CLI_OVERWRITE_SYS_NAME
  
    Optionally, edit the configuration file, sna_node.cfg:
    + Stop the server using the command "sna stop".
    + Edit the sna_node.cfg configuration file to update the
      ptf_flags parameter of the [define_node] record. This file
      is found in /etc/sna on AIX and /etc/opt/ibm/sna on Linux.
    + Restart server using the command "sna start".
  
   - On the client create an empty file in the install directory
     (default C:\ibmcs\w64cli) called tpnamehost (the content of
     the file does not matter so it can be small or even empty;
     for example:
     echo > c:\ibmcs\w64cli\tpnamehost
  
  Then all the TP_STARTED messages from the client will append the
  full hostname after to the value of the tp_name parameter, using
  a separator of "%" (in EBCDIC). The sys_name parameter of the
  local LU will then be updated to this client hostname. This is
  then used for routing subsequent incoming conversations on this
  LU to the appropriate client.
  
  Note that if there is a file tpnameipv4 (see APAR LI76288)
  already present on the client install directory then this new
  fix has no effect. The IP address is added in preference to the
  system name, and the sys_name is not altered.
  

Temporary fix

• sna_v5router, libpe.o, libpe64_5.o
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  LI76288

• APAR is sysrouted TO one or more of the following:

  LI76797 LI76799 LI76805

Fix information

• Fixed component name

  CS AIX V6.X

• Fixed component ID

  5765E5100

Applicable component levels

• R640 PSY U851826

     UP12/09/11 I 1000