OW11762: TSO/VTAM SUPPORT OF NQN - ENHANCED NETWORK QUALIFIED NAMES - USES THE FIELD TSBTRMID FOR THE REAL TERMINAL NAME

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Support for Enhanced Network Qualified Names was incorporated
  into the base release of VTAM V4R1. Now the UECB passed to appl-
  ication's logon exit contains a plist for the NQNs in addition
  to the previously passed information. TSO/VTAM stores the NQN
  using the TSBTRMID and the TSBXNET fields of the TSB and TSBX
  control blocks. In the past if an alias name were used (i.e.
  NETVIEW alias) to start the session, then TSO/VTAM would use the
  TSBTRMID field to store this name. Some applications rely on
  this alias name for various functions (mostly session
  validation).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All TSO users using alias names              *
  *                 (e.g. NetView alias).                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: TSO/VTAM support of NQN - enhanced      *
  *                      network qualified names - uses the      *
  *                      field TSBTRMID for the real terminal    *
  *                      name                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Support for Enhanced Network Qualified Names was incorporated
  into the base release of VTAM V4R1. Now the UECB passed to
  application's logon exit contains a plist for the NQNs in
  addition to the previously passed information. TSO/VTAM stores
  the NQN using the TSBTRMID and the TSBXNET fields of the TSB
  and TSBX control blocks. In the past if an alias name were
  used (i.e. NETVIEW alias) to start the session, then TSO/VTAM
  would use the TSBTRMID field to store this name. Some
  applications rely on this alias name for various functions
  (mostly session validation).
  

Problem conclusion

• A new field has been created in IKTTSBX (TSBXTRMR) to store the
  REAL terminal name, allowing the alias name to be kept in
  TSBTRMID. The following TSO/VTAM modules were changed to
  reference TSBXTRMR instead of TSBTRMID for the real terminal
  name.
  
     IKTCAS23    IKTMSIFR
     IKTCAS31    IKTVTGTF
     IKTIOFRR    IKTXINIT
     IKTLOGR     IKT09411
     IKTLTERM    ISTNOCDT
  
  New fields in IKTWESTD were created to pass the real name to
  the routine posted to build the TSB and TSBX. A new field was
  also added to IKTDOCTV for documentation of both names in the
  SDWA during FRR processing. The following modules have been
  recompiled to pick up changes to the three macros.
  
     IKTCASCX    IKTCAS24
     IKTCASOX    IKTCAS40
     IKTCASOY    IKTCAS41
     IKTCASSX    IKTCAS42
     IKTCAS10    IKTCAS52
     IKTCAS22    IKTCAS55
  

Temporary fix

Comments

APAR Information

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

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

  UW18865 UW18866 OW15167

Modules/Macros

• IKTAY8   IKTCASCX IKTCASNX IKTCASOX IKTCASOY
  IKTCASSX IKTCAS00 IKTCAS20 IKTCAS22 IKTCAS23 IKTCAS24 IKTCAS30
  IKTCAS31 IKTCAS32 IKTCAS33 IKTCAS40 IKTCAS41 IKTCAS42 IKTCAS52
  IKTCAS55 IKTDOCTV IKTIOFRR IKTLOGR  IKTLTERM IKTMSIFR IKTTSBX
  IKTVTGTF IKTWESTD IKTXINIT IKT09411 ISTNOCDT
  

Fix information

• Fixed component name

  VTAM V4 MVS/ESA

• Fixed component ID

  569511701

Applicable component levels

• R101 PSY UW18865

     UP95/08/07 P F508

• R201 PSY UW18866

     UP95/08/07 P F508

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.