gtpm2m1x | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for the 16-way tightly coupled multiprocessor.
See the APEDIT for APAR PJ26146 for information about prerequisite APARs.
The following function has been added by 16-way tightly coupled multiprocessor:
There are no changes.
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.
The following section contains information about hardware requirements.
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. |
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 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. |
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 |
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.
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) |
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
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) |
There are no changes.
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 |
There are no changes.
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 |
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 |
There are no changes.
There are no changes.
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. |
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 |
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. |
There are no changes.
There are no 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.
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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
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 add 16-way tightly coupled multiprocessor to your existing TPF 4.1 system.
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.
Notes:
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.
Notes: