gtpm2m2eMigration Guide: Program Update Tapes

Turbo Enhancements for TPF Support of MQSeries Local Queue Manager (APAR PJ27023 and APAR PJ27050)

The following section discusses the migration considerations for turbo enhancements for TPF support of MQSeries local queue manager.

Prerequisite APARs

See the APEDIT for APAR PJ27023 and APAR PJ27050 for information about prerequisite APARs.

Functional Overview

The following turbo enhancements for TPF support of MQSeries local queue manager are provided to improve the usability of TPF MQSeries local queue manager support:

Architecture

Two architectural issues are addressed with turbo enhancements for TPF support of MQSeries local queue manager:

Transaction Manager: Previously, when an application established a commit scope around any MQSeries API, the queues being serviced were locked until the commit scope ended. Because the application maintained a commit scope for an extended period of time, the queue could be inaccessible for as long as the application determined.

A resource manager (RM) was implemented for MQSeries. Now, MQSeries APIs do not lock queues within the commit scope, so they are not left inaccessible for an indefinite period of time.

Performance: To access processor unique queues at a faster rate, the queues are now resident in memory. They are checkpointed on a time-initiated basis to fixed file records while using the recovery log to log all changes to the queues that occur between checkpoints. The logged changes will then be available during TPF 4.1 system restart and will be applied to the checkpointed copy of the queues so that the queue is restored to the state it was in before the system was IPLed.

Processor unique queues are now memory queues, while processor shared queues remain TPF collection support queues. Memory queues reside in system work blocks (SWBs) that have been increased in size from 512 to 1024 bytes.

Because applications can stall or network links can become disabled, it is possible for queues to increase in size for an extended period of time without being serviced. For memory queues (this means TPF 4.1 system resources) SWBs may become depleted and cause the TPF 4.1 system to enter input list shutdown without a way to free those resources. A sweep function was implemented that permits memory queues to be filed to TPF collection support binary large objects (BLOBs) when the queue has not been serviced (messages have not been removed from the queue) within a specified period of time.

Nonpersistent messages, which were made persistent previously, will no longer survive an IPL of the TPF 4.1 system.

In addition to the above performance and resource manager architectural changes, the following enhancements have been made to the support of TPF MQSeries local queue manager:

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with turbo enhancements for TPF support of MQSeries local queue manager, you must establish the required operating environment. The following section describes hardware and software requirements specific to turbo enhancements for TPF support of MQSeries local queue manager.

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

There are no changes.

Software (Programming Requirements)

The following section contains information about software requirements.

You must use the IBM OS/390 C/C++ Version 2 Release 8 compiler or later version or release to compile the TPF MQSeries programs. See the OS/390 C/C++ User's Guide for more information about C and C++ compilers.

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 785 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 785. Changes to Build Scripts for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Build Script Type New, Changed, or No Longer Supported? Description of Change
CISOBS LLM Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQFBS DLM New Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQKBS DLL New Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMBS DLM New Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQSBS DLL Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQXBS DLM New Added for turbo enhancements for TPF support of MQSeries local queue manager.
COMXBS LLM Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CTALBS LLM Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIBBS DLM New Added for turbo enhancements for TPF support of MQSeries local queue manager.
CUIEBS DLM No Longer Supported Deleted for turbo enhancements for TPF support of MQSeries local queue manager.
CUIKBS DLM Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIUBS DLM Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.

Dynamic Load Module (DLM) Stubs

Table 786 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 786. Changes to Dynamic Load Module (DLM) Stubs for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

DLM Stub New, Changed, or No Longer Supported?
CL23 New
CL26 New
CUIU New

General Use C/C++ Language Header Files

Table 787 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 787. Changes to General Use C/C++ Language Header Files for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$cinfc.h Changed Yes
c$ipbt.h Changed Yes
cmqc.h Changed Yes
c$syseq.h Changed Yes
sysapi.h Changed Yes

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 788 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 788. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
amquscrw.h Changed Yes
c$mqcp.h New Yes
c$mqdc.h Changed Yes
c$mqmg.h Changed Yes
c$mqmi.h New Yes
c$mqrm.h New Yes
c$mqs.h Changed Yes
i$fsqu.h Changed Yes
i$glue.h Changed Yes
i$mqrt.h New Yes
i$netd.h Changed No
i$tmcr.h Changed Yes (CL12, CL13, CL14, CL15, CXARCV)

Library Interface Scripts

Table 789 summarizes changes to the library interface scripts used by the library interface tool and the build tool. This information is presented in alphabetic order by the name of the library interface script.

Table 789. Changes to Library Interface Scripts for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Library Interface Script New, Changed, or No Longer Supported? Description of Change
CTALXV Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.

Library Members (Object Files)

Table 790 summarizes the library member (object file) changes. This information is presented in alphabetic order by the name of the library member (object file).

Table 790. Changes to Library Members (Object Files) for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
CCOMIC CTAL Changed C Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CFACZC CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQPCM CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.
CTMCCR CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.
CXQCMT CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.
CXQPRP CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.
CXQRCV CTAL New C Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CXQRLB CTAL New Assembler Added for turbo enhancements for TPF support of MQSeries local queue manager.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 791 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).

Notes:

  1. You must recompile or reassemble a member (object file) if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 791. Changes to Members (Object Files) for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CCCCXA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CCCITA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CCCMXA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CCERRA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CCLIBA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQAPI CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQBAT CMQS New Object Code Only Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQBLD CMQK New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQCKC CMQK New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQCKP CUIU New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQCKQ CMQK New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQCOL CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQERR CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQFRM CMQF New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQFTR CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQGBL CMQS No Longer Supported Object Code Only Deleted for turbo enhancements for TPF support of MQSeries local queue manager.
CMQGRU CUIU Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQHSH CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQL CMQL Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMCA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMGC CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMGR CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMRM CMQM New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQMTR CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQNPM CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQNPS CMQS No Longer Supported C++ Language Deleted for turbo enhancements for TPF support of MQSeries local queue manager.
CMQQUE CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQR CMQR Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQRCV CMQS New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQRM CMQS New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQSWP CMQS New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQUTL CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMQXLR CMQX New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CMQXRM CMQX New C++ Language Added for turbo enhancements for TPF support of MQSeries local queue manager.
CRCCCA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRCMNA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRCMSA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRCRSA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRCSIA CMQS Not Applicable Object Code Only This member was not updated; however, it was recompiled.
CRERRA CMQS Not Applicable Object Code Only This member was not updated; however, it was recompiled.
CREXTA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRFPTA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMCLA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMCVA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMMQA CMQS Not Applicable Object Code Only This member was not updated; however, it was recompiled.
CRMRCA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMRSA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMSAA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMSSA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CRMTRA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIB CUIB New Object Code Only Added for turbo enhancements for TPF support of MQSeries local queue manager.
CUIE CUIE No Longer Supported Object Code Only Deleted for turbo enhancements for TPF support of MQSeries local queue manager.
CUIF CUIF Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIM CUIM Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIQ CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIS CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUIX CUIX Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCCA CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCCD CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCPF CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCQL CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCQM CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCQR CMQS Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CUSCRW CUSC Changed C++ Language Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CXCSMW CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CXCSSW CMQS Changed Object Code Only Updated for turbo enhancements for TPF support of MQSeries local queue manager.

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

Table 792. Changes to Copy Members for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Copy Member Type CSECT Where Copy Member Is Located DLM Where CSECT Is Located New, Changed, or No Longer Supported? Description of Change
CFMCC Control Program ICDF Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CICR Control Program CCNUCL Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CL10 Control Program CCTLOG Not Applicable Changed Updated TPF log manager to support turbo enhancements for TPF support of MQSeries local queue manager.
CL20 Control Program CCTLOG Not Applicable Changed Updated TPF log manager to support turbo enhancements for TPF support of MQSeries local queue manager.
CL30 Control Program CCTLOG Not Applicable Changed Updated TPF log manager to support turbo enhancements for TPF support of MQSeries local queue manager.
CLHL Control Program CCLHR Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CMIS Control Program CCNUCL Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CT05 Control Program CCCTIN Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.
CT41 Control Program CCCTIN Not Applicable Changed Updated for turbo enhancements for TPF support of MQSeries local queue manager.

Fixed File Records

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

Table 793. Changes to Fixed File Records for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Fixed File Record New, Changed, or No Longer Supported? Description of Change
#IMQCK New Added for turbo enhancements for TPF support of MQSeries local queue manager checkpoint record.

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

Table 794. Changes to Data Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro?
ICRCR Changed Yes. CL31, CXACMT, CXAEND, CXAPRP, CXARLB, CXASTR, CXPCMT, and CXPRLB.
ICRCT Changed Yes. CL31, CXACMT, CXAEND, CXAPRP, CXARLB, CXASTR, CXPCMT, and CXPRLB.
IMQRM New Yes

General Macros

Table 795 summarizes the general macro changes. This information is presented in alphabetic order by the name of the general macro. See TPF General Macros for a complete description of all general macros.

Table 795. Changes to General Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs?
CINFC Changed Yes

Selected Equate Macros

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

Table 796. Changes to Selected Equate Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

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

Structured Programming Macros (SPMs)

There are no changes.

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

Table 797 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 797. Changes to SIP Skeleton and Internal Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

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

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 798 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 798. Changes to SIP Stage II Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

Table 799 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 799. Changes to System Macros for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

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

System Macros (IBM Use Only)

There are no changes.

Segments

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

Table 800. Changes to Segments for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CBR0 Real-Time Assembler Not Applicable Changed Updated to support the SWB size change in MPIF.
CL11 Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CL21 Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CL22 Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CL23 Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CL24 Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CL26 Real-Time Assembler Not Applicable New Added to support turbo enhancements for TPF support of MQSeries local queue manager transaction services.
CTKS Real-Time Assembler Not Applicable Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager cycle scheduler.
JRA2 Offline PL/I DATAREAD Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager.
JRM1 Offline PL/I DATAREAD Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager.
JRM5 Offline PL/I DATAREAD Changed Updated to support turbo enhancements for TPF support of MQSeries local queue manager.

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 801 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 801. Changes to Commands for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Command New, Changed, or No Longer Supported? Description of Change
ZMQSC ALT CHL Changed Updated to restrict changes to the transmission queue name associated with a channel.
ZMQSC ALT MQP Changed Updated the examples.
ZMQSC ALT QA Changed Updated the examples.
ZMQSC ALT QL Changed Updated to add the MAXDEPTH and SWEEPTIME parameters.
ZMQSC ALT QR Changed Updated the examples.
ZMQSC DEF MQP Changed Updated to remove the MAXMCA and MAXQUE parameters, and add the MAXDEPTH and SWEEPTIME parameters.
ZMQSC DEF QA Changed Updated the examples.
ZMQSC DEF QL Changed Updated to add the MAXDEPTH and SWEEPTIME parameters.
ZMQSC DEF QR Changed Updated the examples.
ZMQSC DEL Changed Updated to add the PURGE parameter.
ZMQSC DISPLAY Changed The output of the display queue was updated to add the MAXDEPTH and SWEEPTIME parameters, and to delete the MAXMCA and MAXQUE parameters. The output of the display queue manager was updated to remove the MAXMCA and MAXQUE parameters and add the SWEEPTIME and MAXDEPTH default parameters.
ZMQSC MIGRATE New This command is used to migrate TPF MQSeries to turbo enhancements for TPF support of MQSeries local queue manager.
ZMQSC START Changed Updated to ensure that a queue manager that is started will automatically start during the next cycle to NORM state.
ZMQSC STOP Changed Updated to ensure that a queue manager that is stopped will not automatically start the next time the TPF 4.1 system cycles to NORM state.
ZMQSC SWQ Changed Updated to restrict a swing queue from the transmission queues associated with channels that are not in doubt; and so channels associated with the transmission queue must be stopped and not in doubt. Also updated so a queue that is the subject of a swing cannot also be the object of a swing and vice versa.

Messages and System Errors

Table 802 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 802. Changes to Messages and System Errors for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
009307 System Error New
009308 System Error New
009309 System Error New
009310 System Error New
009311 System Error New
009312 System Error New
009313 System Error New
009314 System Error New
009315 System Error New
009316 System Error New
009317 System Error New
009318 System Error New
009319 System Error New
009320 System Error New
MQSC0008I Online No Longer Supported
MQSC0015I Online No Longer Supported
MQSC0016I Online No Longer Supported
MQSC0017I Online No Longer Supported
MQSC0023W Online No Longer Supported
MQSC0024W Online No Longer Supported
MQSC0025E Online No Longer Supported
MQSC0034E Online No Longer Supported
MQSC0040E Online No Longer Supported
MQSC0041E Online No Longer Supported
MQSC0044I Online No Longer Supported
MQSC0050E Online New
MQSC0051E Online No Longer Supported
MQSC0052I Online No Longer Supported
MQSC0053E Online No Longer Supported
MQSC0054E Online No Longer Supported
MQSC0055I Online No Longer Supported
MQSC0056I Online No Longer Supported
MQSC0057I Online New
MQSC0058E Online New
MQSC0059W Online No Longer Supported
MQSC0060E Online New
MQSC0062E Online No Longer Supported
MQSC0063E Online No Longer Supported
MQSC0064E Online New
MQSC0065W Online New
MQSC0067E Online New
MQSC0069I Online New
MQSC0070E Online New
MQSC0071E Online No Longer Supported
MQSC0072E Online No Longer Supported
MQSC0074E Online No Longer Supported
MQSC0077E Online No Longer Supported
MQSC0078E Online Changed
MQSC0079E Online Changed
MQSC0082E Online No Longer Supported
MQSC0084E Online No Longer Supported
MQSC0089E Online No Longer Supported
MQSC0086E Online New
MQSC0088I Online New
MQSC0091E Online No Longer Supported
MQSC0092E Online New
MQSC0093E Online New
MQSC0094E Online New
MQSC0095E Online New
MQSC0096E Online New
MQSC0097E Online New
MQSC0098E Online New
MQSC0099E Online New
MQSC0100E Online New
MQSC0119E Online New
MQSC0135E Online New
MQSC0137E Online New
MQSC0141E Online New
MQSC0142E Online New
MQSC0143I Online New
MQSC0145I Online New
MQSC0146I Online New
MQSC0147E Online New
MQSC0148I Online New
MQSC0149I Online New
MQSC0154E Online No Longer Supported
MQSC0155E Online No Longer Supported
MQSC0157E Online Changed
MQSC0165E Online No Longer Supported
MQSC0167E Online New
MQSC0168E Online New
MQSC0169E Online New
MQSC0170E Online New
MQSC0171E Online New
MQSC0172E Online New
MQSC0173I Online New
MQSC0174E Online New
MQSC0175E Online New
MQSC0176E Online New
MQSC0178E Online New
MQSC0179E Online No Longer Supported
MQSC0210E Online New
MQSC0211E Online New
MQSC0212E Online New
MQSC0213E Online New
MQSC0302E Online No Longer Supported
MQSC0303E Online No Longer Supported
MQSC0341E Online New
MQSC0342E Online New
MQSC0343E Online New
MQSC0344E Online New
MQSC0345W Online New
MQSC0346E Online New
MQSC0347E Online New
MQSC0348E Online New
MQSC0501E Online No Longer Supported
MQSC0502E Online No Longer Supported
MQSC0504E Online No Longer Supported
MQSC0507E Online No Longer Supported
MQSC0511W Online No Longer Supported
MQSC0512W Online New
MQSC0600E Online New
MQSC0601E Online New
MQSC0602E Online New
MQSC0603E Online New
MQSC0604E Online New
MQSC0605E Online New
MQSC0606E Online New
MQSC0607I Online New
MQSC0608I Online New
MQSC0609I Online New
MQSC0610I Online New
MQSC0611I Online New
MQSC0612I Online New
MQSC0613E Online New
MQSC0614E Online New
MQSC0615E Online New
MQSC0616E Online New
MQSC0617E Online New
MQSC0618E Online New
MQSC0619E Online New
MQSC0701I Online New
MQSC0702W Online New
MQSC0703W Online New
MQSC0706I Online New
MQSC0707E Online New
MQSC0801I Online New
MQSC0802I Online New

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 803 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 803. Changes to TPF Publications for Turbo Enhancements for TPF Support of MQSeries Local Queue Manager

Publication Title Softcopy File Name Description of Change
TPF Application Programming GTPAPP0A Updated with a new MQSeries overview chapter.
TPF C/C++ Language Support User's Guide GTPCLU0B Updated with C language function information that was added and changed for turbo enhancements for TPF support of MQSeries local queue manager.
TPF Concepts and Structures GTPCON08 Updated with with a high-level overview of MQSeries.
TPF Database Reference GTPDBR09 Updated TPF Transaction Services chapter with changes for turbo enhancements for TPF support of MQSeries local queue manager.
TPF Library Guide GTPDOC0B 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 turbo enhancements for TPF support of MQSeries local queue manager.
TPF Migration Guide: Program Update Tapes GTPMG201 Updated with migration considerations for turbo enhancements for TPF support of MQSeries local queue manager.
TPF Operations GTPOPR0B Updated with information about the commands that were added and changed for turbo enhancements for TPF support of MQSeries local queue manager.
TPF System Generation GTPSYG0B Updated with information about fixed file records and system work blocks (SWBs) for turbo enhancements for TPF support of MQSeries local queue manager.
TPF System Macros GTPSYS0B Updated system macro information for turbo enhancements for TPF support of MQSeries local queue manager.
TPF System Performance and Measurement Reference GTPSPR0A Updated data collection reduction reports that were changed for turbo enhancements for TPF support of MQSeries local queue manager.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

MQPUT, MQGET, and MQPUT1 functions all participate in transaction scopes. The MQINQ function was changed to allow applications to inquire about the current and maximum depth of a processor unique queue.

Database Changes

The following section summarizes the database changes for turbo enhancements for TPF support of MQSeries local queue manager.

Recovery Log DASD Requirements for MQSeries

To calculate the required number of records, use the following formula:

(ECBs per second (300) * the average size of the commit scope for each ECB
(100 KB) * TPF queue manager checkpoint interval(5 seconds)) +
(MQPUT/MQGET requests per second (1000) * the average size of a message
(4 KB) * TPF queue manager checkpoint interval(5 seconds)) *
(factor for padding (1.5))

For example, (300 * 100 KB * 5 = 150 000 KB) + (1000 * 4 KB * 5 = 20 000 KB) * 1.5 = 255 MB.

Checkpoint Record Requirements for MQSeries

The suggested number of #IMQCK records is at least twice the number of allocated system work blocks (SWBs).

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to migrate your existing TPF 4.1 system to turbo enhancements for TPF support of MQSeries local queue manager. You must perform the following steps on each subsystem.

  1. Install program update tape (PUT) 12.
  2. Use the IBM OS/390 Assembler to assemble the following control program modules: CCCLHR, CCCPSE, CCCPSF, CCCTIN, CCFADC, CCIISC, CCNUCL, CCSTOR, CCTAPE, CCTHDS, CCTLOG, CCVFAC.
  3. Use the IBM OS/390 Assembler to assemble the following modules: CBR0, CEL9, CFACZC, CL11, CL21, CL22, CL23, CL24, CL26, CL31, CMQPCM, COA4, CTKS, CTMCCR, CXACMT, CXAEND, CXAPRP, CXARLB, CXASTR, CXPCMT, CXPRLB, CXQCMT, CXQPRP, CXQRLB, ICDF, JCD4.
  4. Use the IBM OS/390 C Version 2 Release 8 compiler or later version to compile the following programs: CCOMIC, CFS107, CFS110, CL12, CL13, CL14, CL15, CXARCV, CXQRCV.
  5. Use the IBM OS/390 C++ Version 2 Release 8 compiler or later version to compile the following segments: CMQAPI, CMQBLD, CMQCKC, CMQCKP, CMQCKQ, CMQCOL, CMQFRM, CMQFTR, CMQGRU, CMQHSH, CMQMGC, CMQMGR, CMQMRM, CMQNPM, CMQQUE, CMQRCV, CMQRM, CMQSWP, CMQUTL, CMQXLR, CMQXRM, CUIK, CUIM, CUIQ, CUIR, CUIS, CUIT, CUIV, CUIW, CUSCPF, CUSCQL, CUSCQM, CUSCQR, CUSCRW, CUSCUL.
  6. Use the following build scripts to link-edit the following C libraries: CTALBS, COMXBS, CISOBS.
  7. Use the following build scripts to link-edit and produce definition side-decks for the following dynamic link libraries (DLLs): CMQSBS, CMQKBS.
    Note:
    The CMQS DLL imports side-deck information from the CMQK DLL, and the CMQK DLL imports side-deck information from the CMQS DLL. It is necessary to submit the link-edit twice for these DLLs to get a link-edit with no errors.
  8. Use the following build scripts to link-edit the following dynamic load modules (DLMs): CL12BS, CL13BS, CL14BS, CL15BS, CMQFBS, CMQLBS, CMQMBS, CMQRBS, CMQXBS, CUIBBS, CUIEBS, CUIFBS, CUIKBS, CUIMBS, CUIRBS, CUIUBS, CUIXBS, CUSCBS. Most of these DLMs import side-deck information from the CMQS DLL. Make sure the CMQS DLL has been link-edited and has produced a side-deck before link-editing any of these DLMs.
  9. Use the PL/I compiler to compile the following PL/I programs: JRA2, JRM1, JRM5. Then, link-edit the DATAREAD execution module.
  10. The size of the system work block (SWB) has increased from 512 to 1024 bytes. Any customer applications or user modifications that reference fields _SWB_SIZE, or _SWB_SIZE_SYS in header file c$syseq.h will need to be compiled. Any customer applications or user modifications that reference fields CPSWB1 or CPSWB2 in macro CZOCP will need to be assembled. Any user programs where logic depends on the size of the SWB being 512 bytes will need to be modified to handle a 1024 byte SWB.
  11. Enter ZINET STOP S-MQS to stop the MQSeries listener.
  12. Enter ZMQSC STOP CHL-ALL to stop all MQSeries channels (it may take a while to shut down all channels).
  13. Enter ZMQSC DISPLAY CHS-ALL INDOUBT to find any sender channels that are stopped and in doubt.
  14. Enter ZMQSC RESOLVE CHL to resolve the channel, and then continue repeating this step until there are no more in-doubt channels shown on the display.
  15. Enter ZMQSC DISPLAY CHS-ALL to ensure no more channels are active in the processor.
  16. Enter ZMQSC STOP QMGR to stop the queue manager.
  17. Allocate the correct log size. See Recovery Log DASD Requirements for MQSeries for more information.
  18. Create a file address compute (FACE) table with the new #IMQCK records. See Checkpoint Record Requirements for MQSeries for more information.
  19. Recalculate the number of SWBs required by your system to support processor unique memory queues, because messages now reside in SWBs. Also, recalculate storage allocations to account for the size change in SWBs from 512 to 1024 bytes.
  20. Set your sweeptime interval.
  21. Load all the necessary programs to a new image on the TPF 4.1 system.
  22. Perform an initial program load (IPL) of the new image and cycle up the TPF 4.1 system to NORM state.
  23. Enter ZMQSC MIGRATE BEGIN to begin a migration mode on an individual processor in the loosely coupled complex where existing queues are converted to the turbo enhancements for TPF support of MQSeries local queue manager. You must enter ZMQSC MIGRATE BEGIN on each subsystem and each processor in the loosely coupled complex the first time it is IPLed with turbo enhancements for TPF support of MQSeries local queue manager applied and prior to starting the queue manager.
  24. Enter ZMQSC MIGRATE FALLBACK on each subsystem if you want to fall back a processor to the previous version of TPF MQSeries local queue manager.
  25. Enter ZMQSC MIGRATE COMMIT on each subsystem of any one processor in the loosely coupled complex when all processors in the loosely coupled complex have been migrated and you will not fall back any processor in the complex to a system without turbo enhancements for TPF support of MQSeries local queue manager.

Additional Information: See TPF Operations for more information about the ZMQSC DISPLAY, ZMQSC RESOLVE, ZMQSC MIGRATE, and ZMQSC STOP commands.