OW25950: HPR ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Implement HPR enhancements
  Additional Symptoms: rtpfind fails
  sense 084f0000 081e0002 0897000A
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: HPR users who want new functions.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: P125594                                 *
  *                      ________                                *
  *                                                              *
  *                      Add support for HPRNCPBF function       *
  *                                                              *
  *                                                              *
  *                      P125395                                 *
  *                      ________                                *
  *                                                              *
  *                      Add HPR support for VRTG over LSA       *
  *                                                              *
  *                                                              *
  *                      P125667                                 *
  *                      ________                                *
  *                                                              *
  *                      ABEND0C4 in IOSVIRBA accessing pageable *
  *                      storage from a disabled process.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  P125594
  ________
  
  Implement HPRNCPBF support so that the customer can choose
  to always set up a session via HPR even if it means we must
  transverse the NCP twice. In other words, allow the customer
  to weigh the importance of performance vs availability.
  
  
  P125395
  ________
  
  Add HPR support for an LSA, DIAL=NO connection between two
  V4R4 HPR capable hosts by way of a VRTG.
  
  
  P125667
  ________
  
  Allocate SRM and SAP control blocks from fixed storage.
  

Problem conclusion

• P125594
  ________
  
  This PTM implements a new VTAM start option, HPRNCPBF=YES/NO
  (default is NO). This option allows a customer to decide whether
  HPR should be used when it will cause session data to travel
  through an NCP twice. The following examples illustrate this.
  In each case, the RTP path is AA=>NCP3=>1A. Session traffic for
  sessions using the RTP will be AA=>NCP3=>1A=>NCP3=>(fid2/LEN
  LU/dep LU/subarea).
  
  **rtp**               **rtp**             **rtp**
  AA     1A     2A      AA     1A           AA(EN) 1A     2A
   \_    ||    _/        \_    ||            \_    ||    _/
     \_  ||  _/ fid2       \_  ||              \_  ||  _/ fid4
       \NCP3/                \NCP3--LEN or       \NCP3/  subarea
                                    dep LU
  
  HPRNCPBF is modifiable. If the value is changed from YES to NO,
  new sessions may use existing RTPs, but no new RTPs will be set
  up that cause the traffic to go through an NCP twice.
  
  Parts Hit:
  ________
  
  ISTACMDT
  ISTCICOM
  ISTCICPP
  ISTCICS2
  ISTRCCRB
  ISTRCCRE
  ISTSSCDX
  ISTSSCEF
  ISTSSCRA
  IST1050C
  IST400C
  
  
  P125395
  ________
  
  This PTM corrects a problem in V4R4 in that if you have an LSA,
  DIAL=NO connection between two V4R4 HPR capable hosts, as part
  of a VRTG 'group', a path switch attempt to this non-HPR capable
  LSA connection may be made. This will, of course, fail - taking
  the HPR connection, and consequently the VRTG down.
  
  Since the correction of this problem introduces new function to
  V4R4, some mention of this needs to be made in the pubs.  An
  update is needed in the V4R4 RDR on P156 for the PUTYPE operand
  in the External Communications Adapter Major Node section.
  
  An additional note is needed to say something to the effect:
  
  If coding this operand results in a VR_TG connection between
  two hosts and HPR=YES is coded on the CDRM statements for those
  hosts, HPR may be used over this connection.
  
  Parts Hit:
  ________
  
  ISTLLCCU
  ISTLSCAL
  ISTLSCKL
  ISTLSCKN
  ISTLSCLI
  ISTLSCNA
  ISTLSCNC
  ISTLSC6I
  ISTLSC6V
  ISTRPCDU
  ISTTGCB
  ISTTSCAR
  ISTTSCAZ
  ISTTSCCN
  ISTTSCCX
  ISTTSCND
  ISTTSCUC
  ISTTSCXD
  ISTTSCXS
  ISTTSC8X
  IUTLLCII
  
  
  P125667
  ________
  
  This PTM corrects a problem in V4R4 in which LSA modules request
  pageable storage while running disabled. This causes an ABEND0C4
  in IOSVIRBA and causes the XCA major node to be INOPed. The
  problem is fixed by obtaining SRM and SAP control blocks from
  fixed storage only.
  
  Parts Hit:
  ________
  
  ISTLSCAP
  ISTLSCAS
  ISTLSCQE
  
  
  ______________________________________________________________
  
  The following information will be added to the VTAM V4R4
  Resource Definition Reference (SC31-8377-00) and the VTAM V4R4
  Network Implementation  Guide (SC31-8370-00). The formal
  publication changes for the new HPRNCPBF function included in
  this APAR will be in II10381 (Resource Definition Reference)
  and II10383 (Network Implementation Guide).
  
  This function assists customers who want to determine the path
  used for session setup for LUs whose entry to the HPR network is
  via NCP/FID4 connections.  Reference the following diagram:
  
   +--------+                                 +--------+
   |  VTAM1 | - - - - - - - - - - - - - - - - |  VTAM2 |
   |  V4R4  |             HPRb                |  V4R4  |
   |        |                                 |        |
   |        |                                 |        |
   |        |                                 |  appla |
   +--------+                                 +--------+
       |               HPRa (VRTG)                 |
       |                +-----+                    |
       +----------------| NCP |--------------------+
                        |     |
                        +-----+
                           |
                           |
                .  .  .  .  .  .  .  .
  
                  LU (local or remote)
  
  
  Both VTAM's are RTP-capable nodes.  The connection via NCP is a
  VR-TG over HPR.  A more optimal HPR TG between the VTAM nodes
  exists. When the LU requests a session with appla, the session
  typically would be setup directly through the NCP to appla on
  VTAM2. While this path may perform better, it cannot take
  advantage of features of HPR, such as dynamic re-routing or
  the high availability offered by multinode persistent sessions
  (MNPS).
  
  To give customers a choice over the path used for session setup,
  APAR OW25950 provides a new start option, HPRNCPBF = YES|NO.
  Using HPRNCPBF=NO continues to allow the session to be setup
  over the direct path.  Using HPRNCPBF=YES allows the session
  to be setup over the HPR pipe between the two VTAM nodes,
  specifically using the VR=TG path. In this case, should the
  connection between the NCP and VTAM fail, the session would be
  redirected without disruption over an alternate route.
  
  Note that using HPRNCPBF=YES provided by APAR OW25950 means that
  session requests from the NCP-attached LU would be routed
  through the NCP twice. APAR OW26906 will make VTAM1 choose a
  more optimal HPR path for session setup path in this scenario.
  Referring to the diagram above, HPRNCPBF=YES with APAR OW29606
  applied will result in session setup through the NCP, to VTAM1,
  then over the path labeled HPRb, bypassing the HPR path that
  goes back through the NCP (HPRa).
  

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:

  UW38590

Modules/Macros

• ISTACMDT ISTCICOM ISTCICPP ISTCICS2 ISTLLCCU
  ISTLSCAL ISTLSCAP ISTLSCAS ISTLSCKL ISTLSCKN ISTLSCLI ISTLSCNA
  ISTLSCNC ISTLSCQE ISTLSC6I ISTLSC6V ISTRCCRB ISTRCCRE ISTRPCDU
  ISTSSCDX ISTSSCEF ISTSSCRA ISTTGCB  ISTTSCAR ISTTSCAZ ISTTSCCN
  ISTTSCCX ISTTSCND ISTTSCUC ISTTSCXD ISTTSCXS ISTTSC8X IST1050C
  IST400C  IUTLLCII
  

Fix information

• Fixed component name

  VTAM V4 MVS/ESA

• Fixed component ID

  569511701

Applicable component levels

• R401 PSY UW38590

     UP97/07/10 P F707

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.