gtpm2m0yMigration Guide: Program Update Tapes

Multiple I-Stream DASD I/O Support (APAR PJ21313)

The following section discusses the migration considerations for multiple I-stream DASD I/O support.

Prerequisite APARs

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

Functional Overview

Multiple I-stream DASD I/O support allows the TPF 4.1 system to process most DASD input/output requests from any I-stream. This support allows you to take advantage of processors with more I-streams by not overloading the main I-stream with DASD I/O related work.

Architecture

Multiple I-stream DASD I/O support is implemented by allowing DASD I/O requests to be started on any I-stream and by enabling DASD I/O interrupts to occur on any I-stream. Because any I-stream now has the ability to update certain DASD tables, locking is used to serialize updates to these tables.

Operating Environment Requirements and Planning Information

There are none.

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

There are no changes.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C Language Header Files

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

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

Table 136. Changes to General Use C Language Header Files for Multiple I-Stream DASD I/O Support

General Use C Language Header File TARGET (TPF) ISO-C New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$cinfc.h X X 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

There are no changes.

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

Table 137 summarizes the control program interface (CINFC) tag changes. The information in this table is ordered numerically by the equate value.

Table 137. Changes to CINFC Tags for Multiple I-Stream DASD I/O Support

CINFC Tag Equate Value New, Changed, or No Longer Supported?
CMMECT 354 New

Copy Members

The following section summarizes copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 138. Changes to Copy Members for Multiple I-Stream DASD I/O Support

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CCIO Control Program IPLB Changed Put I-stream number in trace; locking changes.
CCIT Control Program CCNUCL Changed Set up I/O new PSW for I-streams 3 and higher.
CEFH Control Program CCSONA Changed Interface change.
CEFJ Control Program CCFADC Changed Interface change.
CICR Control Program CCNUCL Changed Added CMMECT CINFC information.
CJIC Control Program CCSONS Changed Added the DLCKC service routine; lost interrupt processing (from CYED); locking changes.
CJIE Control Program CCSONS Changed Locking changes; reentrancy updates; asynchronous queue scan of SSST.
CJIF Control Program CCSONS Changed Reentrancy changes.
CJII Control Program CCSONS Changed Set up prime/duplicate MFST lock pointers; set up subclass 7.
CJIL Control Program CCSONA Changed Interface change.
CJIM Control Program CCSONS Changed Interface changes; locking changes.
CJIO Control Program CCSONS Changed Locking changes; reentrancy changes.
CJIP Control Program CCSONS Changed Interface changes.
CJIQ Control Program CCSONS Changed Reentrancy changes.
CJIT Control Program CCSONS Changed Reentrancy changes.
CJIV Control Program CCRCSC Changed Update emergency unlock routine with new tables to be unlocked; locking changes; interface updates.
CJIW Control Program CCSONS Changed Locking changes.
CJIX Control Program CCSONS Changed Reentrancy changes; locking changes; interface changes.
CJIY Control Program CCSONS Changed Reentrancy changes; locking changes.
CMKH Control Program CCMCKH Changed Set up I/O subclass 7 for DASD I/O.
CPSF Control Program CCCPSF Changed Reset I/O subclass.
CPSL Control Program CCCPSE Changed Set up I/O dump trace.
CT40 Control Program CCCTIN Changed Set up the CMMECT CINFC tag.
CT85 Control Program CCCTIN Changed Set up the I-stream control area.
CVF3 Control Program CCVFAC Changed Virtual file access (VFA) to DASD interface changes; DASD table locking changes

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 139 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 139. Changes to Data Macros for Multiple I-Stream DASD I/O Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
DCTMDR Changed Yes
DCTMFS Changed Yes
DCTMIO Changed Yes
IDSECT Changed Yes
IDSTTR Changed Yes
LDEVBK Changed Yes
MRLNQ Changed Yes

General Macros

There are no changes.

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

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

There are no changes.

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

There are no changes.

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 140 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 140. Changes to System Macros for Multiple I-Stream DASD I/O Support

System Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
DLCKC New Yes
FCTLC Changed No

System Macros (IBM Use Only)

There are no changes.

Segments

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

Table 141. Changes to Segments for Multiple I-Stream DASD I/O Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CAC1 Real-Time Assembler Not Applicable Changed Locking changes.
CAC2 Real-Time Assembler Not Applicable Changed Locking changes.
CAC4 Real-Time Assembler Not Applicable Changed Locking changes.
CACA Real-Time Assembler Not Applicable Changed Locking changes.
CLM1 Real-Time Assembler Not Applicable Changed Locking changes.
CLM2 Real-Time Assembler Not Applicable Changed Locking changes.
CLMF Real-Time Assembler Not Applicable Changed Locking changes.
CLMI Real-Time Assembler Not Applicable Changed Locking changes.
CLMM Real-Time Assembler Not Applicable Changed Locking changes.
CLMN Real-Time Assembler Not Applicable Changed Locking changes.
CLOK Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CML2 Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CMUB Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CMUC Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CPAA Real-Time Assembler Not Applicable Changed Locking changes.
CPAB Real-Time Assembler Not Applicable Changed Locking changes.
CPAD Real-Time Assembler Not Applicable Changed Locking changes.
CPAF Real-Time Assembler Not Applicable Changed Locking changes.
CPAG Real-Time Assembler Not Applicable Changed Locking changes.
CPAH Real-Time Assembler Not Applicable Changed Locking changes.
CPAI Real-Time Assembler Not Applicable Changed Locking changes.
CRM0 Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CSGB Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CSS0 Real-Time Assembler Not Applicable Changed Locking changes.
CSS1 Real-Time Assembler Not Applicable Changed Locking changes.
CSS2 Real-Time Assembler Not Applicable Changed Locking changes.
CSS3 Real-Time Assembler Not Applicable Changed Locking changes.
CSS4 Real-Time Assembler Not Applicable Changed Locking changes.
CSS5 Real-Time Assembler Not Applicable Changed Locking changes.
CSSA Real-Time Assembler Not Applicable Changed Locking changes.
CVKM Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CVLC Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CVPX Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CVLD Real-Time Assembler Not Applicable Changed Indicate no locking to CIO.
CYEA Real-Time Assembler Not Applicable Changed Locking changes.
CYED Real-Time Assembler Not Applicable Changed Removed most lost interrupt scanning code.
CYEP Real-Time Assembler Not Applicable Changed Locking changes.
CYGN Real-Time Assembler Not Applicable Changed Locking changes.
CYMA Real-Time Assembler Not Applicable Changed Locking changes.
CYPA Real-Time Assembler Not Applicable Changed Locking changes.
CYPB Real-Time Assembler Not Applicable Changed Locking changes.
CYPC Real-Time Assembler Not Applicable Changed Locking changes.
CYPD Real-Time Assembler Not Applicable Changed Locking changes.
CYPE Real-Time Assembler Not Applicable Changed Locking changes.
CYPF Real-Time Assembler Not Applicable Changed Locking changes.
CYPH Real-Time Assembler Not Applicable Changed Locking changes.
CYPI Real-Time Assembler Not Applicable Changed Locking changes.
CYPL Real-Time Assembler Not Applicable Changed Locking changes.
CYPR Real-Time Assembler Not Applicable Changed Locking changes.
JCD4 Real-Time Assembler Not Applicable Changed Locking changes.
JCF0 Real-Time Assembler Not Applicable Changed Locking changes.

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

There are no changes.

Messages and System Errors

Table 142 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.

Table 142. Changes to Messages and System Errors for Multiple I-Stream DASD I/O Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
000576 System Error No Longer Supported

Performance or Tuning Changes

Multiple I-Stream DASD I/O support will not impact performance. There are no recommended tuning changes for multiple I-stream DASD I/O support.

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 143 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 143. Changes to TPF Publications for Multiple I-Stream DASD I/O Support

Publication Title Softcopy File Name Description of Change
TPF Concepts and Structures GTPCON04 Updated references to DASD I/O on main I-stream only.
TPF Library Guide GTPDOC04 Updated with definitions for new terminology in the master glossary.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about the messages and system errors that were added, changed, and no longer supported for multiple I-stream DASD I/O.
TPF Migration Guide: Program Update Tapes GTPMIG04 Updated with migration considerations for multiple I-stream DASD I/O.
TPF System Macros GTPSYS04 Added the new DLCKC macro and updated the FLTLC macro.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Databases Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

To verify that multiple I-stream DASD I/O support has been installed in a system with multiple I-streams, enter ZDUMP SEL while the TPF 4.1 system is busy. The I/O trace will show the I/O being processed on multiple I-streams.

Migration Scenarios

There are no migration scenarios.