gtpm2m1xMigration Guide: Program Update Tapes

16-Way Tightly Coupled Multiprocessor (APAR PJ26146)

The following section discusses the migration considerations for the 16-way tightly coupled multiprocessor.

Prerequisite APARs

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

Functional Overview

The following function has been added by 16-way tightly coupled multiprocessor:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with 16-way tightly coupled multiprocessor, you must establish the required operating environment. The following section describes hardware and software requirements specific to 16-way tightly coupled multiprocessor.

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.

Central Processing Complexes (CPCs)

Requests for Price Quotations (RPQs) and Product Features for Central Processing Complexes (CPCs):
Important Note

The time-of-day (TOD) clock synchronization RPQ uses a synchronization selection address that is tied to the CPU address. TOD clock synchronization will not support more than 8 I-streams. The sysplex timer (STR) must be used with 16-way tightly coupled multiprocessor to support TOD clock synchronization in a loosely coupled complex.

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 572 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 572. Changes to Build Scripts for 16-Way Tightly Coupled Multiprocessor

Build Script Type New, Changed, or No Longer Supported? Description of Change
CRDWBS DLM Changed Build script for TPFAR ZSTTD ISO-C DLM CRDW.
CZXKBS DLM Changed Build script for the ZDECD command DLM.

Dynamic Load Module (DLM) Stubs

Table 573 summarizes changes to the dynamic load module (DLM) stubs. This information is presented in alphabetic order by the name of the DLM stub. See TPF Application Programming for more information about the DLM stubs.

Table 573. Changes to Dynamic Load Module (DLM) Stubs for 16-Way Tightly Coupled Multiprocessor

DLM Stub New, Changed, or No Longer Supported?
CZXM Changed

General Use C/C++ Language Header Files

Table 574 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 574. Changes to General Use C/C++ Language Header Files for 16-Way Tightly Coupled Multiprocessor

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$ifc2.h Changed Yes (FTBD01 and FTBD09)
c$ms0ut.h Changed Yes (CRDW and CZXK)

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 575 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 575. Changes to Link-Edited Modules for 16-Way Tightly Coupled Multiprocessor

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CPS0 Changed Updated CP load module.

Members (Object Files)

There are no changes.

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 576 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 576. Changes to Copy Members for 16-Way Tightly Coupled Multiprocessor

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CEDI Control Program CCNUCL Not Applicable Changed Updated WTOPC message writer.
CFAC Control Program CCDBAF Not Applicable Changed Updated CP version of FACE and FACS.
CPSE Control Program CCCPSE Not Applicable Changed Updated system error detection code.
CPSM Control Program CCCPSE Not Applicable Changed Updated monitor call service.
CT38 Control Program CCCTIN Not Applicable Changed Updated working storage initializer.
CT40 Control Program CCCTIN Not Applicable Changed Updated working storage initializer.
CT81 Control Program CCCTIN Not Applicable Changed Updated machine check support initialization.
CTIN Control Program CCCTIN Not Applicable Changed Updated CP initializer control segment.
IB07 Control Program IPLB Not Applicable Changed Updated the face table generator main program to define the I-stream value.
RTCU Control Program CCDBAF Not Applicable Changed Updated CP version of FACE and FACS.

Fixed File Records

There are no changes.

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

There are no changes.

Data Macros

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

Table 577. Changes to Data Macros for 16-Way Tightly Coupled Multiprocessor

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
IDFET Changed No
IFC2SC Changed Yes (CCDBAF and CZXM)

General Macros

There are no changes.

Selected Equate Macros

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

Table 578. Changes to Selected Equate Macros for 16-Way Tightly Coupled Multiprocessor

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
TPFGLB Changed Yes
SYGLB No Changes - Copies in TPFGLB Yes

Structured Programming Macros (SPMs)

There are no changes.

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

Table 579 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 579. Changes to SIP Skeleton and Internal Macros for 16-Way Tightly Coupled Multiprocessor

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

System Initialization Program (SIP) Stage I Macros and Statements

Table 580 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 580. Changes to SIP Stage I Macros and Statements for 16-Way Tightly Coupled Multiprocessor

SIP Stage I Macro New, Changed, or No Longer Supported?
#GLOBL Changed
RAMFIL Changed

System Initialization Program (SIP) Stage II Macros

There are no changes.

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 581 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 581. Changes to System Macros for 16-Way Tightly Coupled Multiprocessor

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
$ADPC Changed No; publication updates only.
$CRISC Changed No; publication updates only.
DLTEC Changed No; comments only.

System Macros (IBM Use Only)

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

Table 582. Changes to System Macros (IBM Use Only) for 16-Way Tightly Coupled Multiprocessor

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

Segments

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

Table 583. Changes to Segments for 16-Way Tightly Coupled Multiprocessor

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
BAM1 Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor to indicate a range of 1-16 I-streams.
BDB5 Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor to indicate a range of 1-16 I-streams.
BDBA Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor to indicate a range of 1-16 I-streams.
BDBF Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor database reorganization.
BDBN Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor.
BRPT Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor.
CDE1 Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor.
CDE3 Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor.
CFD1 Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZDADD command.
CIPZ Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZDREC and ZAREC commands.
CIQY Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZRPGM command.
CPSI Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor for SNAPC dump processing.
CQAD Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor time-of-day (TOD) SYNC check.
CQAU Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor TOD clock messages.
CRDW C Language Not Applicable Changed Updated a parameter to handle 2-character input for the ZSTTD command.
CRDX C Language Not Applicable Changed Updated a parameter to handle 2-character input for the ZSTTD command.
CVAN Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZDCOR and ZACOR commands.
CVAX Real-Time Assembler Not Applicable Changed Updated for ZACOR command processing.
CVOO Real-Time Assembler Not Applicable Changed Updated for 16-way tightly coupled multiprocessor.
CYBD Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZIFIL command.
CZXK C Language Not Applicable Changed Updated a parameter to handle 2-character input for the ZDECD command.
CZXM Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZDECD commands.
CZXR Real-Time Assembler Not Applicable Changed Updated a parameter to handle 2-character input for the ZDDCA and ZADCA commands.
FTBD01 Offline C Language FCTBG Changed Updated for 16-way tightly coupled multiprocessor FACE table generator (FCTBG).
FTBD09 Offline C Language FCTBG Changed Updated for 16-way tightly coupled multiprocessor FACE table generator.
FTGN00 Offline C Language FCTBG Changed Updated the FACE table generator main program to define the I-stream value.
GOGO Real-Time Assembler Not Applicable Changed Updated face table generator main program to define the I-stream value.
ICDF Real-Time Assembler Not Applicable Not Changed Although this segment was not changed, the CFMCC macro was changed so the ICDF segment must be assembled.
JRA0 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA1 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA2 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA3 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA4 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA5 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRA6 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRF1 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRF4 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRF5 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRF6 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRM1 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRM2 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRM4 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRM5 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRP1 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRP3 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRS1 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
JRS3 Offline PL/I DATAREAD Changed Support for 16-way tightly coupled multiprocessor data reduction reports.
STPP Offline Assembler PPCP Not Changed Although this segment was not changed, the CFMCC macro was changed so the STPP segment must be assembled.

System Equates

There are no changes.

User Exits

There are no changes.

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 584 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 584. Changes to Commands for 16-Way Tightly Coupled Multiprocessor

Command New, Changed, or No Longer Supported? Description of Change
ZACOR Changed Updated a parameter to handle 2-character input.
ZADCA Changed Updated a parameter to handle 2-character input.
ZAREC Changed Updated a parameter to handle 2-character input.
ZDADD Changed Updated a parameter to handle 2-character input.
ZDBRO INIT Changed Updated a parameter to handle 2-character input.
ZDCOR Changed Updated a parameter to handle 2-character input.
ZDDCA Changed Updated a parameter to handle 2-character input.
ZDECD Changed Updated a parameter to handle 2-character input.
ZDREC Changed Updated a parameter to handle 2-character input.
ZIFIL Changed Updated a parameter to handle 2-character input.
ZRPGM Changed Updated a parameter to handle 2-character input.
ZSTTD Changed Updated a parameter to handle 2-character input.

Messages and System Errors

Table 585 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 585. Changes to Messages and System Errors for 16-Way Tightly Coupled Multiprocessor

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
000000000 Online No Longer Supported
CLKS0058E Online Changed
CLKS0059E Online Changed
CLKS0068E Online Changed
CPSE0015I Online Changed
CPSE0050E Online Changed
CPSE0051T Online Changed
CPSE0052E Online Changed
CPSE0053T Online Changed
CPSE0055T Online Changed
CRDW0004I Online Changed
CSMP0097I Online Changed
DBRI0087I Online Changed
DBR00096E Online Changed
DDCA0008I Online Changed
FECB0006I Online Changed
FECB0007I Online Changed
GOGO0005E Online Changed
IPLB00D2I Online Changed
RECP0000I Online Changed
RPGM0015E Online Changed
RPGM0017I Online Changed
RPGM0033I Online Changed
SNAP0001I Online Changed
STAT0011I Online Changed

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

There are no changes.

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 586 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See theTPF Library Guide for more information about the TPF library.

Table 586. Changes to TPF Publications for 16-Way Tightly Coupled Multiprocessor

Publication Title Softcopy File Name Description of Change
TPF Concepts and Structures GTPCON07 Updated with 16-way tightly coupled multiprocessor information.
TPF Database Reference GTPDBR08 Updated with 16-way tightly coupled multiprocessor information.
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 16-way tightly coupled multiprocessor.
TPF Migration Guide: Program Update Tapes GTPMG200 Updated with migration considerations for 16-way tightly coupled multiprocessor.
TPF Operations GTPOPR0A Updated with information about the commands that were added and changed for 16-way tightly coupled multiprocessor.
TPF System Installation Support Reference GTPINR0A Updated with 16-way tightly coupled multiprocessor information.
TPF System Generation GTPSYG0A Updated with 16-way tightly coupled multiprocessor information.
TPF System Macros GTPSYS0A Updated with 16-way tightly coupled multiprocessor information.
TPF System Performance and Measurement Reference GTPSPR09 Updated with 16-way tightly coupled multiprocessor information.

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 add 16-way tightly coupled multiprocessor to your existing TPF 4.1 system.

  1. Install program update tape (PUT) 10.
  2. Run CBLD for the build scripts listed in Table 572.
  3. Install the following:
  4. Reassemble or recompile the following:
    • All CPS0 CSECTS to ensure displacements within CAPT that are affected by &SAISTRM are consistent throughout the CP.
    • CSECTS listed in Table 576
    • Segments listed in Table 583.
  5. Continue with the next set of required steps to prepare the TPF 4.1 system for more than 16 I-streams:
    1. Add a SIP definition for an additional super GOA ordinal. See TPF System Generation for more information about adding a SIP definition.

      The existing super GOA (#GLOBL ordinal 0) can accommodate a processor complex with as many as 8 loosely coupled processors times 10 I-streams each. The super GOA is a 1055-byte record, and each entry is 12 bytes long. There is one entry for each I-stream on each loosely coupled processor. If more entries are needed to define additional I-streams or processors, additional super GOA records are needed. A second ordinal will handle as many as 8 loosely coupled processors by 16 I-streams.

      To add a second super GOA, the SIP Stage I deck must include another RAMFIL statement for #GLOBL, which defines the additional ordinals using the PRIOR parameter.

    2. Build and load the new FACE table. A new FACE table is needed primarily because of the table format changes to conserve space, but also to include any new #GLOBL records.

      Notes:

      1. In addition to recompiling all changed FACE table generator segments (FCTBG), the DASD table (DASDTB) must be regenerated and FCTBG relinked. DASDTB must be regenerated to pick up the new maximum number of I-streams defined in TPFGLB. To regenerate DASDTB, see the JCL in the compiling the FACE table generator information in TPF System Generation.

      2. Failure to load a new format FACE table with 16-way tightly coupled multiprocessor will result in database corruption.
    3. Create or load the new PILOT tape for global load.

      The STC input deck that defines the global allocator records must be modified to include super GOA definitions for additional I-streams. If more than 86 entries are defined, you will need a second super GOA. Using the definitions for #GLOBL 0 as a skeleton, define the second SUPER GOA for the ordinal created in step 5a. The ENTIT entries will start again from 1 for the new record.

    4. Reassemble or load the new system interprocessor global table (SIGT).
    5. Reassemble or load the following programs that were not modified by 16-way tightly coupled multiprocessor, but use tables or values that were modified:
      • GOG1
      • GLBL
      • CNPS
      • CONN.
    6. Reassemble or load the following segments (or any user-defined code) that were not modified by 16-way tightly coupled multiprocessor, but use the modified &SAISTRM value.

      Notes:

      1. &SAISTRM is defined in TPFGLB, which is copied by SYGLB in some cases.

      2. Reassemble any segments, programs, or user-defined code that use any of the following macros or segments.
      • SIP assembly:
        • SIGT
        • SKDASD
          • FTBD05
          • FTBD07
          • FTVA01.
      • CSECTS (copy segments that use &SAISTRM):

         ACPL 
        CCCLHR

         CCCPSF 
        CCCSAS

         CCDCOL 
        CCIISC

         CCLANG 
        CCMCDC

         CCMCKH 
        CCSNA0

         CCSTOR 
        CCTHDS

         CCVFAC 
         
      • E-type (the following call a macro that uses &SAISTRM, arranged by macro):
        • DC0DC
          • JCS0.
        • GL0BP:
          • RLCH.
        • SI1GT:

           CGLOBA 
          CNPR

           CNPS 
          CNPU

           C179 
           
        • SYNCC:

           BAM2 
          BCAI

           BKB0 
          BKPA

           BKP4 
          BKP5

           BRCP 
          BRPA

           BRPE 
          BRPI

           BRPX 
          BRSH

           BRYO 
          CSAI

           CJ12 
          CJ13

           CJ16 
          CJ17

           CNPU 
           
        • MS0UT, c$ms0ut.h (also callers of GDATX, GCALX, GCLKX):

           BDBY 
          BSSU

           BSSW 
          BSSX

           CBQ0 
          CDTC

           CDTD 
          CEBM

           CGLOBM 
          CHSZ

           CL11 
          CNAF

           CONN 
          CS0M

           CS0P 
          CS06

           CVCT 
          GLBL

           GOG1 
          GOG3

           JCD4 
          JCD6
        • DLTEC:

          CTK0
          CTKS
    7. Assemble all CSECTS and link-edit CPS0 (see Table 575).
    8. Check the commands listed in Table 584 for changes that were made to allow a 2-character decimal I-stream number.
    9. Check the online messages listed in Table 585 for changes that were made to allow a 2-character decimal I-stream number.
  6. Perform an initial program load (IPL). The migration is completed.
Note:
Because the logical record length (LRECL) of STEMPIS and STEMPID varies according to the number of I-streams specified in JPC0, the JCL must be changed when you actually increase the number of I-streams. See TPF Operations for an updated sample of JCL for 16 I-streams.