gtpm2m2oMigration Guide: Program Update Tapes

OSA-Express Support (APAR PJ27333)

The following section discusses the migration considerations for Open Systems Adapter (OSA)-Express support.

Prerequisite APARs

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

Functional Overview

An Open Systems Adapter (OSA) is integrated hardware (the OSA-Express card) that combines the functions of an IBM System/390 (S/390) input/output (I/O) channel with the functions of a network port to provide direct connectivity between IBM S/390 applications and remote Transmission Control Protocol/Internet Protocol (TCP/IP) applications on the attached networks. OSA-Express is the third generation of OSA and provides the following enhancements:

In the TPF 4.1 system, there is one unique, real Internet Protocol (IP) address for each OSA-Express connection. In addition there can be VIPAs associated with the TPF 4.1 system across an OSA-Express connection. A real IP address is tied to a fixed connection and to a specific physical network; however, a VIPA can be moved from one connection to another and from one physical network to another. If an OSA-Express card fails or the switch or router connected to the card fails, any TPF VIPAs assigned to that card automatically swing to the alternate OSA-Express connection if one is defined and is active. This enables sockets to remain active and eliminates single points of failure in network-attached hardware.

There are two types of VIPAs: static and movable. A given static VIPA always resides on one specific TPF processor in the loosely coupled complex and can swing from one OSA-Express connection to another, but always on the same TPF processor. Static VIPAs are used to access processor unique TPF applications.

A movable VIPA is also active on one TPF processor at a time, but the VIPA can be moved from one processor to another in the complex. Movable VIPAs are used to access processor shared applications and allow you to load balance TCP/IP traffic in the complex. If you move a VIPA from one processor to another, all existing sockets using that VIPA will fail; when the remote clients reconnect to that VIPA, new sockets will be established on the new processor where that VIPA is now active. By moving a VIPA, you move all traffic for the remote users connected to that VIPA from one processor to another. The moving of a VIPA can occur automatically when a TPF processor fails, or can be done manually by using the ZVIPA command.

See TPF Transmission Control Protocol/Internet Protocol for more information about OSA-Express support. See TPF Operations for more information about the ZOSAE and ZVIPA commands.

Architecture

The QDIO link layer is the code in the TPF 4.1 system that enables the TPF 4.1 system to communicate with the OSA-Express card. The OSA-Express card enables the TPF 4.1 system to connect to high bandwidth TCP/IP networks, specifically GENET networks. Each OSA-Express card has a single port that connects to one GENET network.

OSA-Express cards are supported by IBM S/390 G5 servers or higher. Each IBM G5 server can have a maximum of 12 OSA-Express cards. A host can connect to multiple OSA-Express cards, and each OSA-Express card supports 240 symbolic device addresses (SDAs).

The Internet Protocol (IP) addresses of the host are registered with the OSA-Express card when they are connected. Each OSA-Express card supports a maximum of 512 IP addresses for all the hosts sharing a card. The TPF 4.1 system has one unique real IP address for each OSA-Express connection, and the IP address must be in the subnet of the GENET network in which the OSA-Express card is connected.

See TPF Transmission Control Protocol/Internet Protocol for more information about OSA-Express support.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with OSA-Express support, you must establish the required operating environment. The following section describes hardware and software requirements specific to OSA-Express 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

The following section contains information about hardware requirements.

Processors

The following section discusses processors.

An IBM System/390 G5 processor or higher is required.

Communication Devices

The following section discusses communication devices.

The OSA-Express card is supported. Previous generations of OSA are not supported.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating System for TCP/IP

The following are required for OSA-Express support with TCP/IP:

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 943 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 943. Changes to Build Scripts for OSA-Express Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CRIABS DLM New Routing Information Protocol (RIP) server support.
CRIPBS DLM New Routing Information Protocol (RIP) server support.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 944 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 944. Changes to General Use C/C++ Language Header Files for OSA-Express Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ck2sn.h Changed No
c$syseq.h Changed No
i$pwbl.h Changed No

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

Table 945 summarizes changes to the link-edited modules shipped by IBM, which should go into a data set with attributes DCB=(RECFM=U,LRECL=80,BLKSIZE=1200). This information is presented in alphabetic order by the name of the link-edited module.

Table 945. Changes to Link-Edited Modules for OSA-Express Support

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CPS0 Changed Added the CCOSAE CSECT.

Members (Object Files)

There are no changes.

Object Code Only (OCO) Stubs

Table 954 summarizes changes to stubs that are object code only (OCO) only. This information is presented in alphabetic order by the name of the OCO stub.

Table 946. Changes to OCO Stubs for OSA-Express Support

Object Code Only (OCO) Stub New, Changed, or No Longer Supported?
CRIB New

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

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

Table 947. Changes to Copy Members for OSA-Express Support

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CEDT Control Program CCCPSE Not Applicable Changed Updated to disable program controlled interruptions (PCIs) during dump processing.
CLHL Control Program CCCLHR Not Applicable Changed Updated to run OSA-Express polling.
CPSF Control Program CCCPSF Not Applicable Changed Updated processing to break active OSA-Express links.
CTI2 Control Program CCTCP2 Not Applicable Changed Updated for OSA-Express support.
CTI4 Control Program CCTCP2 Not Applicable Changed Updated RAW opzero to process ICMP redirects and PING responses from OSA-Express gateways.
CTME Control Program CCNUCL Not Applicable Changed Updated for OSA-Express polling.
CTSM Control Program CCTCP3 Not Applicable Changed Updated the return socket block routine for OSA-Express Internet Protocol (IP) addresses.
CTSS Control Program CCTCP3 Not Applicable Changed Updated Internet Protocol (IP) scan to process OSA-Express gateways.
CTTO Control Program CCTCP1 Not Applicable Changed Updated output message processing for OSA-Express support.
CTT6 Control Program CCTCP1 Not Applicable Changed Updated Internet Protocol (IP) trace for OSA-Express support.
CT15 Control Program CCCTIN Not Applicable Changed Updated to carve OSA-Express tables.

Fixed File Records

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

Table 948. Changes to Fixed File Records for OSA-Express Support

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#IBMMP4 Changed Updated with ordinal numbers 13 - 17 for the OSA configuration record.
#OSIT New New processor shared fixed file record for the OSA shared IP address table.

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 949 summarizes changes to the communication macros and statements. This information is presented in alphabetic order by the name of the SNA communication macro or statement.

Table 949. Changes to Communication Macros and Statements for OSA-Express Support

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

Data Macros

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

Table 950. Changes to Data Macros for OSA-Express Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
CFMDC Changed No
CK2SN Changed No
IOSAB New Not Applicable
IOSCR New Not Applicable
IOSIT New Not Applicable
IPMTE Changed No
IPWBL Changed No
ISOCK Changed See Migration Scenarios.
ISTAK Changed No

General Macros

There are no changes.

Selected Equate Macros

Table 951 summarizes the selected equate macro changes. This information is presented in alphabetic order by the name of the selected equate macro.

Table 951. Changes to Selected Equate Macros for OSA-Express Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CZ1SE Changed No
SYSEQ Changed No

Structured Programming Macros (SPMs)

There are no changes.

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

Table 952 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 952. Changes to SIP Skeleton and Internal Macros for OSA-Express Support

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 953 summarizes system initialization program (SIP) Stage I macro and statement changes. This information is presented in alphabetic order by the name of the SIP Stage I macro. See TPF System Generation for a complete description of the SIP Stage I macros. If the SIP Stage I macro is changed, you must run the appropriate job control language (JCL) jobs from the SIP Stage II deck

See System Initialization Program (SIP) and System Generation Changes for a description of other system generation changes you must make.

Table 953. Changes to SIP Stage I Macros and Statements for OSA-Express Support

SIP Stage I Macro New, Changed, or No Longer Supported?
GENSIP Changed

System Initialization Program (SIP) Stage II Macros

Table 954 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 954. Changes to SIP Stage II Macros for OSA-Express 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

There are no changes.

System Macros (IBM Use Only)

Table 955 summarizes system macro changes that are for IBM use only. This information is presented in alphabetic order by the name of the system macro.

Table 955. Changes to System Macros (IBM Use Only) for OSA-Express Support

System Macro (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
DLTEC Changed Yes
IPSDC Changed No

Segments

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

Table 956. Changes to Segments for OSA-Express Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCOSAE Object Code Only CPS0 New Created for OSA-Express activation and data flow.
CMVO Real-Time Assembler Not Applicable New Created for OSIT find or file subroutine processing.
CMVP Real-Time Assembler Not Applicable New Created for VIPA timer-initiated processing.
CMVQ Real-Time Assembler Not Applicable New Created for VIPA receive request processing.
CMVR Real-Time Assembler Not Applicable New Created for movable VIPA restart processing.
CMVS Real-Time Assembler Not Applicable New Created for VIPA send request processing.
CMVT Real-Time Assembler Not Applicable New Created for processor deactivation processing.
CMVV Real-Time Assembler Not Applicable New Created for start move VIPA processing.
CMVW Real-Time Assembler Not Applicable New Created to release the VIPAs on a given processor.
CMVX Real-Time Assembler Not Applicable New Created to process a released VIPA.
CMV1 Real-Time Assembler Not Applicable New Created for ZVIPA error processing and to process the ZVIPA command with the MOVE parameter.
CMV2 Real-Time Assembler Not Applicable New Created to process the ZVIPA command with the DISPLAY parameter.
CMV3 Real-Time Assembler Not Applicable New Created to process the ZVIPA command with the SUMMARY parameter.
COED Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DISPLAY parameter.
COEF Real-Time Assembler Not Applicable New Created to file the OSA configuration record.
COEM Real-Time Assembler Not Applicable New Created for error message processing.
COER Real-Time Assembler Not Applicable New Created for processing OSA restart.
COES Object Code Only Not Applicable New Created to build QDIO structures.
COE1 Real-Time Assembler Not Applicable New Created for the ZOSAE command parser.
COE2 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DEFINE, MODIFY, or DELETE parameter.
COE3 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the ADD and VIPA parameters.
COE4 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the REMOVE and VIPA parameters.
COE5 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the SWING parameter.
COE6 Real-Time Assembler Not Applicable New Created to process the ZTTCP command with the ACT or INACT parameter specified for OSA-Express connections.
COE7 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DEFINE or MODIFY parameter.
COE8 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DEFINE or MODIFY parameter.
COE9 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DEFINE or MODIFY parameter.
COE9 Real-Time Assembler Not Applicable New Created to process the ZOSAE command with the DEFINE or MODIFY parameter.
CPLKMP CSECT Not Applicable Changed Updated to add the new CSECT CCOSAE to the CP link map.
CRIA C Language Not Applicable New Created for the Routing Information Protocol (RIP) server.
CRIB Real-Time Assembler Not Applicable New Created for the Routing Information Protocol (RIP) server.
CRIC Real-Time Assembler Not Applicable New Created for the Routing Information Protocol (RIP) client.
CRIP C Language Not Applicable New Created for the Routing Information Protocol (RIP) server.
CSK0 Real-Time Assembler Not Applicable Changed Updated with the new ZNKEY command parameter.
CTFA Real-Time Assembler Not Applicable Changed Updated to display the next hop and round-trip time fields to the ZSOCK command display.
CTFE Real-Time Assembler Not Applicable Changed Updated to display the next hop and round-trip time fields to the ZSOCK command display.
CTF1 Real-Time Assembler Not Applicable Changed Updated the parser with new parameters to the ZTTCP command.
CTF2 Real-Time Assembler Not Applicable Changed Updated the ZTTCP DEFINE command to search for duplicate IP addresses.
CTF3 Real-Time Assembler Not Applicable Changed Updated the ZTTCP TRACE command for OSA-Express support.
CTF4 Real-Time Assembler Not Applicable Changed Updated the ZTTCP ACTIVATE and ZTTCP INACTIVATE commands to handle OSA-Express connections.
CTF5 Real-Time Assembler Not Applicable Changed Updated the ZTTCP DISPLAY command for OSA-Express support.
CTF7 Real-Time Assembler Not Applicable New Updated the ZTTCP DISPLAY command for OSA-Express support.
CTKT Real-Time Assembler Not Applicable Changed Updated the cycle-up scheduler to start the Routing Information Protocol (RIP) server, RIP client, and movable VIPA timer-initiated processing.
CTSI Real-Time Assembler Not Applicable Changed Updated the ioctl function to include OSA IP addresses on some calls.
CTSJ Real-Time Assembler Not Applicable Changed Updated the gethostid function to search the OSA IP addresses.
CTSR Real-Time Assembler Not Applicable Changed Added hooks in TCP/IP native stack support restart to call OSA restart.
CTSW Real-Time Assembler Not Applicable Changed Updated the socket sweeper to process OSA-Express connections and IP addresses.
CTSZ Real-Time Assembler Not Applicable Changed IP routing table entries.
CTS0 Real-Time Assembler Not Applicable Changed Updated the socket function for OSA-Express support.
CTS1 Real-Time Assembler Not Applicable Changed Updated the bind function to support binding to an OSA IP address.
CTS2 Real-Time Assembler Not Applicable Changed Updated the connect function for OSA-Express support.
CVAB Real-Time Assembler Not Applicable Changed Updated to add the ZOSAE and ZVIPA commands.

System Equates

The following section summarizes system equate changes.

SYSEQ Tags

Table 957 summarizes changes to equates that are not configuration dependent (in SYSEQ). This information is presented in alphabetic order by the name of the SYSEQ tag.

Table 957. Changes to SYSEQ Tags for OSA-Express Support

SYSEQ Tag Equate Value New, Changed, or No Longer Supported?
#OSADEF X'0D' New
#OSAIPF X'0E' New
#OSAIPL X'11' New

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) 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 958. Changes to ECB User Exits for OSA-Express Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
VIPA processor deactivation CMVR and CMVT UVIP New Allows you to specify if you have to move a movable VIPA and to where you have to move it if a processor outage occurs.

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 959 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 959. Changes to Commands for OSA-Express Support

Command New, Changed, or No Longer Supported? Description of Change
ZNKEY Changed Added the MAXOSA parameter for OSA-Express support.
ZOSAE New Created to manage OSA-Express support.
ZSOCK Changed Updated to display OSA-Express values in the formatted socket display.
ZTTCP ACTIVATE Changed Updated to activate OSA-Express connections.
ZTTCP CHANGE Changed Updated to change the default IP address to an OSA-Express IP address.
ZTTCP DISPLAY Changed Updated to display OSA-Express connections.
ZTTCP INACTIVATE Changed Updated to deactivate OSA-Express connections.
ZTTCP TRACE Changed Updated to trace OSA-Express connections and OSA-Express IP addresses.
ZVIPA New Displays OSA-Express IP information, summarizes system and OSA-Express IP address statistics, and moves a movable VIPA from one processor to another processor in the same loosely coupled complex.

Messages and System Errors

Table 960 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 960. Changes to Messages and System Errors for OSA-Express Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
007850 System Error New
007851 System Error New
007852 System Error New
007853 System Error New
007854 System Error New
007855 System Error New
007856 System Error New
007857 System Error New
007858 System Error New
007859 System Error New
00785A System Error New
00785B System Error New
0078E0 System Error New
0078E1 System Error New
CMVR0001I Online New
CMVR0002I Online New
CMVR0003W Online New
OSAE0001I Online New
OSAE0002I Online New
OSAE0003I Online New
OSAE0004I Online New
OSAE0005I Online New
OSAE0006I Online New
OSAE0007I Online New
OSAE0012I Online New
OSAE0020E Online New
OSAE0021E Online New
OSAE0022E Online New
OSAE0024E Online New
OSAE0025E Online New
OSAE0026E Online New
OSAE0028E Online New
OSAE0029E Online New
OSAE0031E Online New
OSAE0032E Online New
OSAE0033E Online New
OSAE0034E Online New
OSAE0035E Online New
OSAE0036E Online New
OSAE0037E Online New
OSAE0038E Online New
OSAE0039E Online New
OSAE0040E Online New
OSAE0041E Online New
OSAE0042E Online New
OSAE0043E Online New
OSAE0044E Online New
OSAE0045E Online New
OSAE0046E Online New
OSAE0047E Online New
OSAE0048E Online New
OSAE0049E Online New
OSAE0050E Online New
OSAE0051E Online New
OSAE0052E Online New
OSAE0053E Online New
OSAE0054E Online New
OSAE0055E Online New
OSAE0056E Online New
OSAE0057E Online New
OSAE0058E Online New
OSAE0060E Online New
OSAE0061E Online New
OSAE0062E Online New
OSAE0063E Online New
OSAE0064E Online New
OSAE0065E Online New
OSAE0066E Online New
OSAE0067E Online New
OSAE0068E Online New
OSAE0069E Online New
OSAE0070E Online New
OSAE0071E Online New
OSAE0073E Online New
OSAE0074E Online New
OSAE0075E Online New
OSAE0076E Online New
OSAE0077E Online New
OSAE0100E Online New
OSAE0101E Online New
OSAE0102E Online New
OSAE0103E Online New
OSAE0104E Online New
OSA00001I Online New
OSA00002I Online New
OSA00024E Online New
OSA00025E Online New
OSA00026A Online New
OSA00027I Online New
OSA00072E Online New
TTCP0023I Online New
TTCP0030I Online New
TTCP0032I Online New
TTCP0040I Online New
TTCP0042I Online New
TTCP0060I Online New
TTCP0061I Online New
TTCP0062I Online New
TTCP0065I Online New
TTCP0066I Online New
TTCP0151E Online New
TTCP0152E Online New
TTCP0153E Online New
TTCP0154E Online New
TTCP0155E Online New
TTCP0156E Online New
TTCP0157E Online New
TTCP0158E Online New
TTCP0162E Online New
TTCP0163E Online New
TTCP0185I Online New
TTCP0186I Online New
TTCP0187I Online New
TTCP0188I Online New
TTCP0301E Online New
TTCP0302E Online New
TTCP0303E Online New
TTCP0304E Online New
TTCP0305E Online New
TTCP0306E Online New
TTCP0307E Online New
TTCP0308E Online New
TTCP0309E Online New
TTCP0310E Online New
TTCP0312E Online New
TTCP0313E Online New
TTCP0314E Online New
TTCP0315E Online New
TTCP0316E Online New
VIPA0001I Online New
VIPA0002I Online New
VIPA0003I Online New
VIPA0004I Online New
VIPA0005I Online New
VIPA0006I Online New
VIPA0050E Online New
VIPA0051E Online New
VIPA0052E Online New
VIPA0053E Online New
VIPA0054E Online New
VIPA0055E Online New
VIPA0057E Online New
VIPA0058E Online New
VIPA0059E Online New
VIPA0061E Online New
VIPA0062E Online New
VIPA0063E Online New
VIPA0064E Online New
VIPA0065E Online New
VIPA0066E Online New
VIPA0067E Online New

Performance or Tuning Changes

If you have a loosely coupled TPF 4.1 system and want to use movable VIPAs, you must determine the following:

For more information about workload balancing with movable VIPAs, see TPF Transmission Control Protocol/Internet Protocol.

Storage Considerations and Changes

The MAXOSA parameter on the SNAKEY macro specifies the maximum number of OSA-Express connections that can be active on the TPF 4.1 system. The total amount of storage required is approximately:

1 MB × the value of the MAXOSA parameter

For more information about the SNAKEY macro, see TPF ACF/SNA Network Generation.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 961 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 961. Changes to TPF Publications for OSA-Express Support

Publication Title Softcopy File Name Description of Change
TPF ACF/SNA Network Generation GTPACF0C Updated with the MAXOSA parameter on the SNAKEY macro.
TPF Library Guide GTPDOC0D 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 OSA-Express support.
TPF Migration Guide: Program Update Tapes GTPMG203 Updated with migration considerations for OSA-Express support.
TPF Operations GTPOPR0D Updated with information about the commands that were added and changed for OSA-Express support.
TPF Program Development Support Reference GTPPDR0D Updated with main storage dump labels that were added for OSA-Express support.
TPF System Generation GTPSYG0D Updated with #OSIT processor shared file records in the FACE table (FCTB) for movable VIPA support.
TPF System Installation Support Reference GTPINR0D Updated with the VIPA processor deactivation user exit (UVIP) for movable VIPA support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW09 Updated to include information about OSA-Express support and TCP/IP workload balancing with movable VIPA 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 OSA-Express support on your existing TPF 4.1 system:

  1. Install program update tape (PUT) 13.
  2. Reassemble any segment that references the ISOK_ENTRY_LEN equate in the ISOCK data macro, including the following segments:
    • CTFB
    • CTFD
    • CTS0
    • CTSK
    • CTSN.
  3. Define the #OSIT processor shared file record to your TPF 4.1 system in the FACE table (FCTB).
  4. Define the MAXOSA parameter on the SNAKEY macro in keypoint 2 (CTK2).
  5. Reassemble and load updated CTK2 to your TPF 4.1 system.
  6. Code the virtual IP address (VIPA) processor deactivation user exit, UVIP, if you are using movable VIPAs and do not want to use the default logic provided by this user exit.
  7. IPL the TPF 4.1 system and cycle the system to NORM state.
  8. Define the OSA-Express connections to the TPF 4.1 system by entering the ZOSAE command with the DEFINE and MODIFY parameters specified.
  9. Define the VIPAs (if you are using them) to the TPF 4.1 system by entering the ZOSAE command with the ADD parameter specified.
  10. Activate OSA-Express connections by entering the ZTTCP ACTIVATE command.

Additional Information: