IV10996: NEW OPTION TO DYNAMICALLY UPDATE LOCAL_LU WITH REMOTE API CLIENT HOSTNAME
Closed as program error.
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.
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.
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.
sna_v5router, libpe.o, libpe64_5.o
Reported component name
CS AIX V6.X
Reported component ID
Last modified date
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fixed component name
CS AIX V6.X
Fixed component ID
Applicable component levels
R640 PSY U851826
UP12/09/11 I 1000