Fixes are available
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 number
IV10996
Reported component name
CS AIX V6.X
Reported component ID
5765E5100
Reported release
640
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-11-18
Closed date
2012-02-16
Last modified date
2012-09-11
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
CS AIX V6.X
Fixed component ID
5765E5100
Applicable component levels
R640 PSY U851826
UP12/09/11 I 1000
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPQKF","label":"Communications Server for AIX"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"640","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
11 September 2012