gtpm2m1p | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for HPR support.
See the APEDIT for APAR PJ25760 for information about prerequisite APARs.
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.
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.
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.
There are no hardware requirements.
The following section contains information about software requirements.
The following section summarizes the communication changes.
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.
The following section summarizes interface changes.
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.
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. |
There are no changes.
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.
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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Table 454 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
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. |
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
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 |
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. |
There are no changes.
There are no changes.
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
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. |
There are no changes.
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.
There are no changes.
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. |
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.
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. |
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 |
See the TPF ACF/SNA Data Communications Reference for information about the tuning 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:
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.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install HPR support in your TPF 4.1 system.
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.
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.