gtpm2m1pMigration Guide: Program Update Tapes

High-Performance Routing (HPR) Support (APAR PJ25760)

The following section discusses the migration considerations for HPR support.

Prerequisite APARs

See the APEDIT for APAR PJ25760 for information about prerequisite APARs.

Functional Overview

HPR support allows the TPF 4.1 system to connect to a Systems Network Architecture (SNA) network as an HPR rapid transport protocol (RTP) node. HPR support provides the following benefits:

Before HPR support, if any node along the route of an LU-LU session failed, the LU-LU session failed as well. With HPR support, the LU-LU session is automatically switched to an alternate path and the session remains active. This happens without operator intervention and is transparent to you.

Before HPR support, every node along the route of an LU-LU session performed functions such as segmenting and reassembling messages, detecting lost data, and processing data received out of order. With HPR support, only the two endpoints of the HPR route perform these functions. Intermediate nodes along the HPR route simply forward the message to the next node (hop) along the HPR route without examining it or changing it. Intermediate nodes along the HPR route have no knowledge of sessions, which reduces the amount of storage required in these nodes. Less processing is required by the intermediate HPR nodes, which improves end-to-end throughput and performance.

Before HPR support, flow control was done on a hop-by-hop or node-to-node basis. With HPR support, flow control is done end-to-end, which is a much more effective method for controlling and preventing network congestion.

HPR support requires only new software; no new hardware is required. When an LU-LU session starts, the network automatically determines if HPR support can be used. No new network definitions are required to use HPR support.

All nodes in the network along the route for an LU-LU session do not need to have HPR support installed, but you get the benefits of HPR support only on the HPR-capable part of the route. For example, assume the TPF 4.1 system is connected to a network that has HPR support installed and the remote LU is located in a subarea (PU 5) network. In this example, an LU-LU session can be established between the TPF 4.1 system and the remote LU. However, HPR flows are used only for part of the route, and then subarea flows are used the remainder of the way out to the remote LU.

See the TPF ACF/SNA Data Communications Reference for more information about HPR support.

Architecture

HPR support is an extension to the Advanced Peer-to-Peer Networking (APPN) architecture. See the TPF ACF/SNA Data Communications Reference for more information about TPF/APPN support. Each node in the network has one of the following levels of HPR support:

Logical pipelines called RTP connections are set up between a pair of RTP nodes. These two nodes are called the RTP endpoints for the RTP connection. All of the nodes along the route between the RTP endpoints must have HPR support installed. One or more LU-LU sessions use an RTP connection. Each RTP connection is associated with a specific class of service (COS), which means all LU-LU sessions using a given RTP connection must have the same COS. The RTP endpoint is not necessarily the node where the LU resides, which is the condition when only part of the route between two LUs supports HPR.

When an LU-LU session is being activated, an APPN search is performed to calculate a route between the primary logical unit (PLU) and the secondary logical unit (SLU). If the node owning the PLU is an RTP node, that node examines the route calculated by the APPN search to determine if HPR support can be used for this LU-LU session. For HPR support to be used, there must be another RTP node along the route, and all nodes between that RTP node and the node owning the PLU must have HPR support installed. If HPR support can be used, the node owning the PLU either uses an existing RTP connection or starts a new RTP connection.

If an intermediate node along the route of an RTP connection fails, one of the RTP endpoints will detect the failure and start the path switch process to obtain a new route for the RTP connection. No data or sessions are lost when a path switch occurs. All of the LU-LU sessions using an RTP connection switch to the new route when a path switch occurs.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with HPR support, you must establish the required operating environment. The following section describes hardware and software requirements specific to HPR support.

Operating Environment Requirements and Planning Information provides information about the minimum system configuration requirements that are necessary to operate the TPF 4.1 system. You may find it helpful to review that chapter along with the following information.

Hardware

There are no hardware requirements.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating Environment for SNA-Based Communication

To use HPR support, you must install it in the TPF 4.1 system. HPR support allows the TPF 4.1 system to be one endpoint for an RTP connection. You must also install HPR support in the other components in your network between the TPF 4.1 system and the remote LUs. One of those components must be an RTP node so that it can be the other endpoint of the RTP connection.

See Migration Scenarios for information about installing HPR support in the TPF 4.1 system. See the appropriate product documentation for information about installing HPR support in the other components of your network.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 452 summarizes changes to the build scripts used by the build tool. This information is presented in alphabetic order by the name of the build script.

Table 452. Changes to Build Scripts for High-Performance Routing (HPR) Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CSFXBS DLM Changed The CSFU segment is no longer supported.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 453 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 453. Changes to General Use C/C++ Language Header Files for High-Performance Routing (HPR) Support

General Use C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ck2sn.h Changed No
c$fer0.h Changed No
c$fva0.h Changed No
c$iptbl.h Changed No
i$rtpb.h New No
c$rv1vt.h Changed See the APEDIT for APAR PJ25760 for a list of segments that must be reassembled.

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

There are no changes.

Library Interface Scripts

There are no changes.

Library Members (Object Files)

There are no changes.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 454 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 454. Changes to Members (Object Files) for High-Performance Routing (HPR) Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CSFU CSFX No Longer Supported C Language Replaced by the CSFW segment. .
CSFW CSFX Changed C Language Updated the ZNPIU command with the FORMAT or LONG parameter specified to produce a formatted display of HPR network layer packets (NLPs).
CSFX CSFX Changed C Language Updated the ZNPIU command with new parameters for HPR support.
CSF6 CSFX Changed C Language Updated the ZNPIU command with the COMPACT parameter specified to produce a compacted display of HPR NLPs.
CSF7 CSFX Changed C Language Updated the comments for HPR support in the print_RU function of the ZNPIU command.
CSF9 CSFX Changed C Language Updated the ZNPIU command with the FORMAT or LONG parameter specified to display the RU name in HPR NLPs.
CSRA CSRA Changed C Language Updated the ZNTRP command with new parameters for HPR support.
CSRB CSRA Changed C Language Updated the ZNTRP command with the START parameter specified to support the HPR and RTP parameters.
CSRD CSRA Changed C Language Updated the ZNTRP command to clear the trace indicators in the rapid transport protocol control block (RTPCB) table entries.
CSRF CSRA Changed C Language Updated the ZNTRP command with the STOP parameter specified to support the HPR and RTP parameters.
CSRG CSRA Changed C Language Updated the ZNTRP command with the DISPLAY parameter specified for HPR support.
CSRH CSRA Changed C Language Updated the ZNTRP command to display new informational messages for HPR support.
CSRI CSRA Changed C Language Updated the ZNTRP command to display new error messages for HPR support.
CSRJ CSRA Changed C Language Updated the ZNTRP command to trace a single RTP connection.
CSRK CSRA Changed C Language Updated the ZNTRP command with minor changes for HPR support.
CSRL CSRA Changed C Language Updated the ZNTRP command with minor changes for HPR support.

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

Table 455 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 455. Changes to Copy Members for High-Performance Routing (HPR) Support

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CLVB Control Program CCCCP1 Changed Updated the BSCQC macro with the new HPRCHAIN parameter to return chained blocks.
CPSF Control Program CCCPSF Changed Updated catastrophic error processing to keypoint the new records that were added for HPR support.
CSX0 Control Program CCSNA1 Changed Updated XID processing to build CV X'61' (HPR capabilities) for PU 2.1 links if HPR support is enabled.
CSX2 Control Program CCSNA1 Changed Updated XID processing to process CV X'61' (HPR capabilities) for PU 2.1 links if HPR support is enabled.
CS0B Control Program CCSNA4 Changed Updated RVTSCAN to run new functions for HPR support by calling routines in the CS0S copy segment.
CS0C Control Program CCSNA4 Changed Updated RVTSCAN so that the CSNASPIU routine can be called from places other than the CS0B copy segment.
CS0E Control Program CCSNA4 Changed Updated RVTSCAN with a new save area for the base register of the routines that call the CSNASPIU routine.
CS0M Control Program CCSNA1 New Manages the high-performance routing message table (HPRMT).
CS0N Control Program CCSNA2 New HPR OPZERO, which contains routines that process data received out of order, transport header (THDR) chaining, and transmission header (TH) chaining for HPR NLPs.
CS0P Control Program CCSNA1 New Performs new path information unit (PIU) trace functions for HPR support.
CS0R Control Program CCSNA1 New Performs new SOUTC functions for HPR support.
CS0S Control Program CCSNA4 New Performs new RVTSCAN functions for HPR support.
CS06 Control Program CCSNA1 Changed Updated PIU trace to call routines in the CS0P copy segment that process HPR NLPs when they are received from the network.
CS07 Control Program CCSNA1 Changed Updated the SOUTC macro to process HPR NLPs.
CS10 Control Program CCSNA2 Changed Updated SNA OPZERO to call routines in HPR OPZERO (copy segment CS0N) to process HPR NLPs.

Fixed File Records

Table 456 summarizes fixed file record changes. This information is presented in alphabetic order by the name of the fixed file record.

Table 456. Changes to Fixed File Records for High-Performance Routing (HPR) Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#RT1RI New RTPCB table, part 1.
#RT2RI New RTPCB table, part 2.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

Table 457 summarizes changes to the communication macros. This information is presented in alphabetic order by the name of the communication macro or statement.

Table 457. Changes to Communication Macros and Statements for High-Performance Routing (HPR) Support

Communication Macro or Statement New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
SNAKEY Changed Yes

Data Macros

Table 458 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 458. Changes to Data Macros for High-Performance Routing (HPR) Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
CK2SN Changed No
CVTEQ Changed No
CW0CC Changed No
CZ1SE Changed No
IHPMT New Not Applicable
IHPSA New Not Applicable
IPCID Changed No
IPTBL Changed No
IRTPB New Not Applicable
ISCB Changed Yes
ITAPST Changed No
PIUEQ Changed No
PIUTR Changed No
RV1VT Changed See the APEDIT for APAR PJ25760 for a list of segments that must be reassembled.

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 459 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

Table 459. Changes to SIP Skeleton and Internal Macros for High-Performance Routing (HPR) Support

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 460 summarizes system initialization program (SIP) Stage II macro changes. This information is presented in alphabetic order by the name of the SIP Stage II macro. If IBMPAL is changed, you must run the system allocator (SALO) and load the new program allocation table (PAT) to the TPF 4.1 system.

Table 460. Changes to SIP Stage II Macros for High-Performance Routing (HPR) Support

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 461 summarizes system macro changes. This information is presented in alphabetic order by the name of the system macro. See TPF System Macros for a complete description of all system macros.

Table 461. Changes to System Macros for High-Performance Routing (HPR) Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
BSCQC Changed No
SOUTC Changed No

System Macros (IBM Use Only)

There are no changes.

Segments

Table 462 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 462. Changes to Segments for High-Performance Routing (HPR) Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCSNA1 CSECT CPS0 Changed Updated SNA I/O with new copy segments for HPR support.
CCSNA2 CSECT CPS0 Changed Updated SNA OPZERO with a new copy segment for HPR support.
CCSNA4 CSECT CPS0 Changed Updated RVT scan with a new copy segment for HPR support.
CHKA Real-Time Assembler Not Applicable Changed Updated session control block (SCB) keypointing to accommodate the increased size of the RVT and SCB.
CHKB Real-Time Assembler Not Applicable Changed Updated the routine for building and filing SCB entries to accommodate the increased size of the RVT and SCB.
CHKR Real-Time Assembler Not Applicable Changed Updated the routine for reloading SCB entries from file to accommodate the increased size of the RVT and SCB.
CHRR Real-Time Assembler Not Applicable Changed Updated the routine for returning an SCB entry to issue the BSCQC macro if that SCB entry has a pointer to a TH chained message. Also updated to clean up new SCB indicators.
CHSB Real-Time Assembler Not Applicable Changed Updated the PU 2.1 BIND response handler to call the CSHQ segment to process CV X'62' for HPR LU-LU sessions.
CHZS Real-Time Assembler Not Applicable Changed Updated the ZNSCB INITIALIZE command with the ALL parameter specified to accommodate the increased size of the RVT and SCB.
COVU Real-Time Assembler Not Applicable Changed Updated the ZNCVT command with a new parameter for HPR support.
CSBB Real-Time Assembler Not Applicable Changed Updated the routine for building a BIND request to set up the current hop count (CHC) field for HPR LU-LU sessions.
CSBE Real-Time Assembler Not Applicable Changed Updated the TPF APPN processor shared table (TAPST) handler to indicate whether the link is HPR-capable and whether the control point (CP) that owns the link supports the RTP tower.
CSBI Real-Time Assembler Not Applicable Changed Updated the routine that processes APPN LOCATE commands to indicate whether an APPN LOCATE command is for a normal LU-LU session or a TPF-initiated path switch.
CSBK Real-Time Assembler Not Applicable Changed Updated the routine for transmission group (TG) registration to indicate whether the link supports HPR.
CSBL Real-Time Assembler Not Applicable Changed Updated the routine for building APPN LOCATE commands to clear the path switch flag before calling the CSBP segment.
CSBM Real-Time Assembler Not Applicable Changed Updated the APPN cycle-up routine to pass control to the CSHL segment after an IPL to restart path switches.
CSBN Real-Time Assembler Not Applicable Changed Updated comments in the routine that builds general data stream (GDS) variables for APPN LOCATE commands.
CSBO Real-Time Assembler Not Applicable Changed Updated the routine that sends data over CP-CP sessions to handle the condition where CP-CP sessions are not available when an RTP connection is performing a path switch.
CSBP Real-Time Assembler Not Applicable Changed Updated the routine that processes APPN LOCATE commands to handle the condition where an RTP connection is performing a path switch.
CSBQ Real-Time Assembler Not Applicable Changed Updated the routine that processes APPN LOCATE commands to call the CSHP segment to see if HPR support can be used for the LU-LU session that is starting.
CSBR Real-Time Assembler Not Applicable Changed Updated the APPN SIPCC receiver with new function codes for HPR support.
CSBS Real-Time Assembler Not Applicable Changed Updated the APPN SIPCC sender with new function codes for HPR support.
CSBT Real-Time Assembler Not Applicable Changed Updated the routine that processes APPN LOCATE commands received from another TPF processor to indicate in the procedure correlation identification (PCID) table whether the PCID table entry is being added for a path switch.
CSBU Real-Time Assembler Not Applicable Changed Updated to support APAR PJ25331.
CSBW Real-Time Assembler Not Applicable Changed Updated the routine that builds control vectors for APPN LOCATE commands to include HPR information in the control vectors.
CSBX Real-Time Assembler Not Applicable Changed Updated the routine called when CP-CP sessions are started to call the CSHL segment to restart any path switches that need to be restarted.
CSBZ Real-Time Assembler Not Applicable Changed Updated the APPN cleanup routine to handle RTP connections that are currently performing a path switch.
CSB0 Real-Time Assembler Not Applicable Changed Updated the ZNAPN command with the TOPOLOGY parameter specified for HPR support.
CSCD Real-Time Assembler Not Applicable Changed Updated the SNA command scheduler for HPR support.
CSCI Real-Time Assembler Not Applicable Changed Updated the routine that processes a PU 2.1 BIND response for HPR support.
CSCQ Real-Time Assembler Not Applicable Changed Updated Lost Terminal processing for HPR support.
CSDT Real-Time Assembler Not Applicable Changed Updated the SNA command timeout routine for HPR support.
CSEJ Real-Time Assembler Not Applicable Changed Updated the link failure routine for HPR support. If an ALS fails, do not mark HPR LU-LU sessions for cleanup. Instead, start a path switch for all RTP connections that used the failing ALS.
CSE3 Real-Time Assembler Not Applicable Changed Updated the routine that performs conflict checking for the ZNETW commands to no longer check the status of the owning ALS when deactivating HPR LU-LU sessions.
CSFP Real-Time Assembler Not Applicable Changed Updated the ZNETW DISPLAY command to no longer check whether PIU trace is active.
CSFQ Real-Time Assembler Not Applicable Changed Updated the ZNDLU command for HPR support.
CSFR Real-Time Assembler Not Applicable Changed Updated the ZNDLU command for HPR support.
CSFV Real-Time Assembler Not Applicable Changed Updated the ZNDLU command for HPR support.
CSGA Real-Time Assembler Not Applicable Changed Updated the SNA cycle-up scheduler for HPR time-initiated processing.
CSGB Real-Time Assembler Not Applicable Changed Updated the link processing routines in SNA restart for HPR support.
CSGD Real-Time Assembler Not Applicable Changed Updated SNA restart to no longer check whether PIU trace is active.
CSGH Real-Time Assembler Not Applicable New Creates the RTPCB table for HPR support.
CSGJ Real-Time Assembler Not Applicable New Creates the HPRMT and high-performance routing session address table (HPRSAT) for HPR support.
CSG0 Real-Time Assembler Not Applicable Changed Updated SNA restart to call new segments for HPR support.
CSG4 Real-Time Assembler Not Applicable Changed Updated the SNA restart error processor with new messages for HPR support.
CSG7 Real-Time Assembler Not Applicable Changed Updated SNA restart to update the HPRSAT with information about HPR LU-LU sessions.
CSG9 Real-Time Assembler Not Applicable Changed Updated SNA restart to indicate in the TAPST whether HPR support is supported on the TPF processor.
CSHI Real-Time Assembler Not Applicable New Processes an APPN LOCATE reply for an RTP connection that is performing a path switch.
CSHJ Real-Time Assembler Not Applicable New Performs the cleanup routines for RTP connections.
CSHL Real-Time Assembler Not Applicable New Builds an APPN LOCATE request for an RTP connection that is performing a path switch.
CSHP Real-Time Assembler Not Applicable New Determines whether to start a new RTP connection, use an existing RTP connection, or start a PU 2.1 LU-LU session.
CSHQ Real-Time Assembler Not Applicable New Manages the HPRSAT.
CSHR Real-Time Assembler Not Applicable New Builds a ROUTE_SETUP request for a new RTP connection or a path switch.
CSHS Real-Time Assembler Not Applicable New Processes a ROUTE_SETUP reply for an RTP connection.
CSHT Real-Time Assembler Not Applicable New Performs time-initiated processes for HPR support.
CSHW Real-Time Assembler Not Applicable New Processes a path switch that was directed to the wrong TPF processor.
CSHY Real-Time Assembler Not Applicable New Detects TPF outages for HPR support.
CSH1 Real-Time Assembler Not Applicable New Parses the ZNRTP commands.
CSH2 Real-Time Assembler Not Applicable New Processes the ZNRTP DISPLAY command.
CSH3 Real-Time Assembler Not Applicable New Processes the ZNRTP INACT, ZNRTP INITIALIZE, ZNRTP ROUTE, and ZNRTP SWITCH commands.
CSH4 Real-Time Assembler Not Applicable New Processes a ROUTE_SETUP request for an RTP connection.
CSH5 Real-Time Assembler Not Applicable New Processes the ZNRTP SUMMARY command.
CSH6 Real-Time Assembler Not Applicable New Processes the ZNRTP DISPLAY command with the FORMAT parameter specified.
CSJK Real-Time Assembler Not Applicable Changed Updated the routine that processes a PU 2.1 UNBIND request for HPR support.
CSKH Real-Time Assembler Not Applicable New Keypoints the RTPCB table.
CSK0 Real-Time Assembler Not Applicable Changed Updated the ZNKEY command for HPR support.
CSMA Real-Time Assembler Not Applicable Changed Updated the ZNMON command for HPR support.
CSM0 Real-Time Assembler Not Applicable Changed Updated the ZNALS command to no longer check whether PIU trace is active.
CSN0 Real-Time Assembler Not Applicable Changed Updated the SNA command table with the new ZNRTP commands for HPR support.
CSPA Real-Time Assembler Not Applicable Changed Updated the SNA keypointing routine to keypoint the RTPCB table during cycle-down for HPR support.
CSTC Real-Time Assembler Not Applicable Changed Updated the routine that processes a PU 2.1 BIND request for HPR support.
CSTJ Real-Time Assembler Not Applicable Changed Updated the routine that processes a PU 2.1 LU 6.2 BIND request for HPR support.
CVYA Real-Time Assembler Not Applicable Changed Updated the help information for HPR support.
CVYB Real-Time Assembler Not Applicable Changed Updated the help information for HPR support.
CVYD Real-Time Assembler Not Applicable Changed Updated the help information for HPR support.
CVYE Real-Time Assembler Not Applicable New Display help information for the new ZNRTP commands.
FTER00 Offline C Language Not Applicable Changed Added new error messages for processor-unique records.
FTVA02 Offline C Language Not Applicable Changed Updated for processor-unique records.
FTVA03 Offline C Language Not Applicable Changed Added new record definitions for HPR support.
PIUPRT Offline C Language PIUPRT Changed Updated the offline PIU trace facility for HPR support.

System Equates

There are no changes.

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 463. Changes to ECB User Exits for High-Performance Routing (HPR) Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
Select an RTP Connection CSHP URTP New Contains the Select an RTP Connection user exit.

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 464 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 464. Changes to Commands for High-Performance Routing (HPR) Support

Command New, Changed, or No Longer Supported? Description of Change
ZNAPN Changed Updated the information that is displayed when the TOPOLOGY parameter is specified to indicate whether the link supports HPR.
ZNCVT Changed Added the H parameter to convert a session address (SA).
ZNDLU Changed Added the RTP parameter to display the LU-LU sessions using an RTP connection.
ZNKEY Changed Added the HPRALIVE, HPRMTSIZ, HPRPST, MAXHPRSA, MAXRTPCB, and RTPRSYNC parameters for HPR support.
ZNMON Changed Updated the information that is displayed to include the current number of RTP connections and HPR LU-LU sessions.
ZNPIU Changed Added new parameters that allow you to suppress or display HPR control messages, the NHDR and THDR in HPR NLPs, or data.
ZNRTP DISPLAY New Displays information about RTP connections.
ZNRTP HPR New Enables or disables HPR support and displays the status of HPR support in the TPF 4.1 system.
ZNRTP INACT New Deactivates RTP connections.
ZNRTP INITIALIZE New Initializes the entries in the RTPCB table.
ZNRTP ROUTE New Displays the route of an RTP connection.
ZNRTP SUMMARY New Displays summary information about RTP connections and the resources that they use.
ZNRTP SWITCH New Changes the route of an RTP connection by starting a path switch.
ZNTRP Changed Added new parameters that allow you to trace only HPR traffic, only HPR state changes, or a specific RTP connection. Also added a parameter that allows you to specify the number of bytes of the RU being stored in the PIU trace table for SNA commands, data flowing on CDRM-CDRM sessions, and data flowing on CP-CP sessions.

Messages and System Errors

Table 465 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 465. Changes to Messages and System Errors for High-Performance Routing (HPR) Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
0004A8 System Error Changed
0004A9 System Error Changed
0004AA System Error Changed
C62200 System Error New
C62201 System Error New
C62202 System Error New
C62203 System Error New
C62204 System Error New
C62205 System Error New
C62206 System Error New
C62207 System Error New
C62209 System Error New
C6220A System Error New
C6220B System Error New
C6220C System Error New
CSGH0001I Online New
CSGH0002I Online New
CSGH0003I Online New
CSGJ0001I Online New
CSGJ0002I Online New
CSGJ0003I Online New
FCTB0115E Offline New
FCTB0116E Offline New
HPR00001I Online New
HPR00002I Online New
HPR00003I Online New
HPR00004I Online New
HPR00009E Online New
HPR00010W Online New
HPR00011E Online New
NAPPN0011I Online New
NAPPN0012I Online No Longer Supported
NCVT0007I Online New
NDLU0029E Online New
NMON0001I Online No Longer Supported
NMON0002I Online New
NPIU0001I Online No Longer Supported
NPIU0002I Online No Longer Supported
NPIU0003I Online No Longer Supported
NPIU0004I Online New
NPIU0005I Online New
NRTP0001I Online New
NRTP0002I Online New
NRTP0003I Online New
NRTP0004I Online New
NRTP0005I Online New
NRTP0006I Online New
NRTP0007I Online New
NRTP0008I Online New
NRTP0011I Online New
NRTP0012I Online New
NRTP0015I Online New
NRTP0016I Online New
NRTP0018I Online New
NRTP0019I Online New
NRTP0020I Online New
NRTP0021I Online New
NRTP0040E Online New
NRTP0041E Online New
NRTP0042E Online New
NRTP0043E Online New
NRTP0044E Online New
NRTP0045E Online New
NRTP0046E Online New
NRTP0047E Online New
NRTP0048E Online New
NRTP0050E Online New
NRTP0051E Online New
NRTP0052E Online New
NRTP0053E Online New
NRTP0054E Online New
NRTP0055E Online New
NRTP0056E Online New
NRTP0057I Online New
NTRP0007I Online No Longer Supported
NTRP0011I Online New
NTRP0012I Online New
NTRP0013I Online New
NTRP0014I Online New
NTRP0015I Online New
NTRP0016I Online New
NTRP0017I Online New
NTRP0018I Online New
NTRP0019I Online New
NTRP0038I Online New
NTRP0039I Online New
NTRP0040I Online No Longer Supported
NTRP0044I Online No Longer Supported
NTRP0045I Online New
NTRP0046I Online New
NTRP0047I Online New
NTRP0048I Online New
NTRP0052E Online No Longer Supported
NTRP0062E Online New
NTRP0063E Online New
NTRP0064E Online New
NTRP0065E Online New
NTRP0066E Online New

Performance or Tuning Changes

See the TPF ACF/SNA Data Communications Reference for information about the tuning changes.

Storage Considerations and Changes

Two of the new core memory tables introduced by HPR support can become quite large if HPR support is heavily used:

The following information describes additional storage considerations that are true regardless of whether or not you use HPR support:

System Initialization Program (SIP) and System Generation Changes

Define the following new parameters on the SNAKEY macro in keypoint 2 (CTK2):

See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

Define the #RT1RI and #RT2RI fixed file records that are used to keypoint parts 1 and 2 of the RTPCB table entries. See the TPF ACF/SNA Data Communications Reference for more information about the #RT1RI and RT2RI fixed file records.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 466 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 466. Changes to TPF Publications for High-Performance Routing (HPR) Support

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Data Communications Reference GTPSNR06 Added detailed, task-oriented information about HPR support.
TPF ACF/SNA Network Generation GTPACF08 Updated the description of the SNAKEY macro to include information about the new parameters that were added for HPR support.
TPF Library Guide GTPDOC09 Updated with definitions for new terminology in the master glossary.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added, changed, and no longer supported for HPR support.
TPF Migration Guide: Program Update Tapes GTPMIG09 Updated with migration considerations for HPR support.
TPF Operations GTPOPR09 Updated with information about the commands that were added and changed for HPR support.
TPF Program Development Support Reference GTPPDR09 Updated with information about the new dump labels that were added for HPR support.
TPF System Generation GTPSYG09 Updated with information about the new records for HPR support that are checked by the FACE table generator (FCTBG).
TPF System Installation Support Reference GTPINR09 Updated with information about the new ECB-controlled program user exit (URTP) that was added for HPR support.
TPF System Macros GTPSYS09 Updated the description of the BSCQC macro and SOUTC macro to include information about the new parameters that were added for HPR support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install HPR support in your TPF 4.1 system.

  1. Install TPF/APPN support to the TPF 4.1 system. See TPF Advanced Peer-to-Peer Networking (TPF/APPN) Support (APAR PJ19949) for more information about TPF/APPN support.
  2. Install program update tape (PUT) 9, which contains APAR PJ25760 for HPR support, to the TPF 4.1 system.
  3. Define the following parameters on the SNAKEY macro in keypoint 2 (CTK2):
    • HPRALIVE
    • HPRMTSIZ
    • HPRPST
    • ILWPE
    • ILWPF
    • ILWPI
    • ILWPS
    • MAXHPRSA
    • MAXRTPCB
    • RTPRSYNC
    • UNITSZ.

    See the TPF ACF/SNA Data Communications Reference for more information about determining appropriate values for these SNAKEY parameters. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

  4. Define the #RT1RI and #RT2RI fixed file records that are used to keypoint parts 1 and 2 of the RTPCB table entries. See the TPF ACF/SNA Data Communications Reference for more information about the #RT1RI and #RT2RI fixed file records.
  5. Determine whether you need to define more #RV1RI records to accommodate the increased size of the RVT entries.
  6. Determine whether you need to define more #SC1RI records to accommodate the increased size of the SCB entries.
  7. Code the Select an RTP Connection user exit (URTP), if necessary. See TPF System Installation Support Reference for more information about the URTP user exit.
  8. Load the updated CTK2 to your TPF 4.1 system.
  9. IPL the TPF 4.1 system.
  10. Once all TPF processors in the loosely coupled complex that can have network connections have been brought up on the image with HPR support, enter ZNAPN APPN to enable TPF/APPN support in the TPF 4.1 system. See TPF Operations for more information about the ZNAPN command.
  11. Enter ZNRTP HPR ENABLE to enable HPR support in the TPF 4.1 system. See TPF Operations for more information about the ZNRTP HPR command.
  12. Enter the ZNTRP command to start the PIU trace facility and specify the data that you want to trace. See TPF Operations for more information about the ZNTRP commnd. See the TPF ACF/SNA Data Communications Reference for more information about the PIU trace facility.
  13. Activate the PU 2.1 links to the TPF 4.1 system.
  14. Activate the LU-LU sessions in the network.

Fallback Scenarios

If the conversion to HPR support is not successful, you will need to fall back to your previous network environment, correct the problem, and try the conversion again.

Use the following procedure to fall back your complex from HPR support.

  1. Enter ZNRTP HPR DISABLE to disable HPR support. See TPF Operations for more information about the ZNRTP HPR command.
  2. Deactivate each PU 2.1 link to the TPF 4.1 system.
  3. Activate each PU 2.1 link to the TPF 4.1 system again. At this point, HPR support is disabled.
  4. Activate the LU-LU sessions in the network again.