gtpm2m2qMigration Guide: Program Update Tapes

TPF MQSeries Enhancements (APARs PJ27230, PJ27231, PJ27351, and PJ27431)

The following section discusses the migration considerations for TPF MQSeries enhancements.

Prerequisite APARs

See the APEDIT for APARs PJ27230, PJ27231, PJ27351, and PJ27431 for information about prerequisite APARs.

Functional Overview

TPF MQSeries enhancements include the following:

Operating Environment Requirements and Planning Information

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

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 hardware requirements.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating Environment for TCP/IP-Based Communication

TPF MQSeries TCP/IP support will work with TCP/IP native stack support or TCP/IP offload support. See TCP/IP Native Stack Support (APAR PJ26683) and Transmission Control Protocol/Internet Protocol (TCP/IP) Offload Support (APAR PJ21791) for more information.

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 980 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 980. Changes to Build Scripts for TPF MQSeries Enhancements

Build Script Type New, Changed, or No Longer Supported? Description of Change
APAR PJ27230
CMQIBS DLM Changed Updated for MQSeries TCP/IP support.
APAR PJ27351, PJ27431
CMQSBS DLL Changed Updated for MQSeries slow queue sweeper and move support.
APAR PJ27231
CMQSBS DLL Changed Deleted user exit segments for MQSeries user exit support.
CMQUBS DLL New Created to contain user exit segments for MQSeries user exit support.
CUIMBS DLM Changed Updated for MQSeries user exit support.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

There are no changes.

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

Table 981 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 981. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF MQSeries Enhancements

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
APAR PJ27230
amqcccha.h Changed Yes (see note)
amqcciha.h Changed Yes (see note)
amqccxha.h Changed Yes (see note)
amqrrcha.h Changed Yes (see note)
c$mqcd.h Changed Yes (see note)
c$mqpr.h Changed Yes (see note)
Note:
Compile CNMQD, CNMQI, CNMQJ, CQCCCX, CQCCIC, CQCCMX, CQCLIB, CQREXT, CQRFPT, CQRMSS, and CQRREQ with these header files and compile option RENT.
APAR PJ27351, PJ27431
amquscrw.h Changed Yes
c$mqcp.h Changed Yes
c$mqmg.h Changed Yes
c$mqs.h Changed Yes
APAR PJ27231
c$mqs.h Changed Yes

Library Interface Scripts

There are no changes.

Library Members (Object Files)

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

Table 982. Changes to Library Members (Object Files) for TPF MQSeries Enhancements

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
APAR PJ27230
CRFD CTBX Changed C Language Updated for MQSeries TCP/IP support.
CRFE CTBX Changed C Language Updated for MQSeries TCP/IP support.
CQCITA CMQI New Object Code Only Added for MQSeries TCP/IP support.
CQCLIB CMQI Changed C Language Updated for MQSeries TCP/IP support.
CQRREQ CMQI Changed C Language Updated for MQSeries TCP/IP support.
APAR PJ27351, PJ27431
CXQPRP CTAL Changed Assembler Updated for MQSeries slow queue sweeper and move support.

Link-Edited Modules

Table 983 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 983. Changes to Link-Edited Modules for TPF MQSeries Enhancements

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
APAR PJ27351, PJ27431
CMQS Changed Updated for MQSeries slow queue sweeper and move support.
APAR PJ27231
CMQS Changed Updated for MQSeries user exit support.
CUIM Changed Updated for MQSeries user exit support.
CMQU New Created for MQSeries user exit support.

Members (Object Files)

Table 984 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 984. Changes to Members (Object Files) for TPF MQSeries Enhancements

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
APAR PJ27230
CNMQD CMQ2 Changed C Language Updated for MQSeries TCP/IP support.
CNMQI CMQ2 Changed C Language Updated for MQSeries TCP/IP support.
CNMQJ CMQ2 Changed C Language Updated for MQSeries TCP/IP support.
APAR PJ27351, PJ27431
CMQAPI CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQBAT CMQS Changed Object Code Only Updated for MQSeries slow queue sweeper and move support.
CMQBLD CMQK Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQGRU CUIU Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQMGC CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQMGR CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQMVM CMQS New C++ Language Created for MQSeries slow queue sweeper and move support.
CMQQUE CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQRCV CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQSWP CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQUTL CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CMQXLR CMQX Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CRMTRA CMQS Changed Object Code Only Updated for MQSeries slow queue sweeper and move support.
CUIB CUIB Changed Object Code Only Updated for MQSeries slow queue sweeper and move support.
CUSC CUSC Changed Object Code Only Updated for MQSeries slow queue sweeper and move support.
CUSCCD CMQS Changed Object Code Only Updated for MQSeries slow queue sweeper and move support.
CUSCPF CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CUSCQL CMQS Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
CUSCRW CUSC Changed C++ Language Updated for MQSeries slow queue sweeper and move support.
APAR PJ27231
CMQQUE CMQS Changed C++ Language Created for MQSeries user exit support.
CMQMGR CMQS Changed C++ Language Created for MQSeries user exit support.
CUIA CMQU New C++ Language Created for MQSeries user exit support.
CUIM CUIM New C++ Language Updated for MQSeries user exit support.
CUIQ CMQU Changed C++ Language Updated for MQSeries user exit support.
CUIS CMQU Changed C++ Language Updated for MQSeries user exit support.
CUIT CMQU Changed C++ Language Updated for MQSeries user exit support.
CUIV CMQU Changed C++ Language Updated for MQSeries user exit support.
CUIW CMQU Changed C++ Language Updated for MQSeries user exit support.

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

There are no 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

There are no changes.

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)

Table 985 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 985. Changes to SIP Skeleton and Internal Macros for TPF MQSeries Enhancements

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

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 986 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 986. Changes to SIP Stage II Macros for TPF MQSeries Enhancements

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

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

There are no changes.

Segments

There are no changes.

System Equates

There are no changes.

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 987. Changes to ECB User Exits for TPF MQSeries Enhancements

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
APAR PJ27231
TPF MQSeries Assign LNIATA CMQS CUIW Changed Updated for MQSeries user exit support.
TPF MQSeries Convert to Object Handle CMQS CUIV Changed Updated for MQSeries user exit support.
TPF MQSeries Dead Letter Queue CMQS CUIQ Changed Updated for MQSeries user exit support.
TPF MQSeries Nonpersistent Message Handler CMQS CUIS Changed Updated for MQSeries user exit support.
TPF MQSeries Queue Manager MCA Security CMQS CUIT Changed Updated for MQSeries user exit support.
TPF MQSeries Start Queue Manager CMQS CUIA New Updated for MQSeries user exit support.

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 988 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 988. Changes to Commands for TPF MQSeries Enhancements

Command New, Changed, or No Longer Supported? Description of Change
APAR PJ27230
ZMQID ALTER Changed Updated for MQSeries TCP/IP support.
ZMQID DEFINE Changed Updated for MQSeries TCP/IP support.
ZMQID DISPLAY Changed Updated for MQSeries TCP/IP support.
APAR PJ27351, PJ27431
ZMQSC ALT MQP Changed Updated for MQSeries slow queue sweeper and move support.
ZMQSC ALT QL Changed Updated for MQSeries slow queue sweeper and move support.
ZMQSC DEF MQP Changed Updated for MQSeries slow queue sweeper and move support.
ZMQSC DEF QL Changed Updated for MQSeries slow queue sweeper and move support.
ZMQSC DISPLAY Changed Updated for MQSeries slow queue sweeper and move support.
ZMQSC MOVEMSGS New Created for MQSeries slow queue sweeper and move support.

Messages and System Errors

Table 989 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 989. Changes to Messages and System Errors for TPF MQSeries Enhancements

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
APAR PJ27230
MQID0095E Online No Longer Supported
MQID0098E Online No Longer Supported
MQID0106E Online New
MQID0107E Online New
MQID0108E Online New
MQID0109E Online New
MQID0110E Online New
APAR PJ27351, PJ27431
MQSC0141E Online No Longer Supported
MQSC0179E Online New
MQSC0217E Online New
MQSC0218E Online New
MQSC0220I Online New
MQSC0221E Online New
MQSC0222E Online New
MQSC0223E Online New
MQSC0224E 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 990 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 990. Changes to TPF Publications for TPF MQSeries Enhancements

Publication Title Softcopy File Name Description of Change
APAR PJ27230
TPF Application Programming GTPAPP0C Updated information for MQSeries TCP/IP support.
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 MQSeries TCP/IP support.
TPF Migration Guide: Program Update Tapes GTPMG203 Updated with migration considerations for MQSeries TCP/IP support.
TPF Operations GTPOPR0D Updated with information about the commands that were added and changed for MQSeries TCP/IP support.
APAR PJ27351, PJ27431
TPF Application Programming GTPAPP0C Updated information for MQSeries slow queue sweeper and move support.
TPF Library Guide GTPDOC0D Updated with definitions for new terminology in the master glossary for MQSeries slow queue sweeper and move support.
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 MQSeries slow queue sweeper and move support.
TPF Migration Guide: Program Update Tapes GTPMG203 Updated with migration considerations for MQSeries slow queue sweeper and move support.
TPF Operations GTPOPR0D Updated with information about the commands that were added and changed for MQSeries slow queue sweeper and move support.
APAR PJ27231
TPF Migration Guide: Program Update Tapes GTPMG203 Updated with information for the repackaged CMQS DLL and start queue manager user exit.
TPF System Installation Support Reference GTPINR0D Updated with information for the repackaged CMQS DLL and start queue manager user exit.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

There are no changes.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

Use the following procedure to install MQSeries TCP/IP support (APAR PJ27230) on your TPF 4.1 system.

  1. Install program update tape (PUT) 13.
  2. Compile segments CQCCCX, CQCCIC, CQCCMX, CQREXT, CQRFPT, CQRMSS, CRFD, CRFE and the segments listed for this APAR in Table 984.
  3. Assemble the CQEXIT segment.
  4. Run the CBLD program to create the link-edit decks for the CMQI LLM, CMQ2 DLM, and CTBX LLM. You do not need to compile the CQCITA library member (object file) contained in the CMQI LLM because it has been provided to you as an object code only (OCO) module.
  5. Link-edit the CMQI LLM, CMQ2 DLM, and CTBX LLM.
  6. Stop all TPF MQSeries client channels.
  7. Load CMQI LLM, CMQ2 DLM, and CTBX LLM to your TPF 4.1 system.
Note:
With TCP/IP support, it is possible to have APPC and TCP/IP channel definitions to the same remote TPF MQSeries server. It cannot be predicted which channel will be used when a TPF MQSeries client application connects to the remote server.

Use the following procedure to install MQSeries slow queue sweeper and move support (APARs PJ27351 and PJ27431) on your TPF 4.1 system.

  1. Install PUT 13.
  2. Compile segments CMQCKP, CMQCKQ,CMQMRM, and all segments except object code only segments listed for this APAR in Table 984.
  3. Run the CBLD program to create the link-edit decks for CMQK DLL, CMQM DLM, CMQS DLL, CMQX DLM, CTAL LLM, CUIB DLM, CUIU DLM, and CUSC DLM.
  4. Link-edit the CMQK DLL, CMQM DLM, CMQS DLL, CMQX DLM, CTAL LLM, CUIB DLM, CUIU DLM, and CUSC DLM.
  5. Stop the TPF MQSeries local queue manager.
  6. Load CMQK DLL, CMQS DLL, CUIB DLM, CUIU DLM, and CUSC DLM to your TPF 4.1 system.
  7. Start the TPF MQSeries local queue manager.
Note:
The SWEEP parameter has replaced the SWEEPTIME parameter for the ZMQSC ALT and ZMQSC DEF QL commands. Any TPF MQSeries local queues with a SWEEPTIME parameter value of zero, will have an initial SWEEP parameter value of OFF. Any TPF MQSeries local queues with a nonzero SWEEPTIME parameter value will have an initial SWEEP parameter value of ON.

Use the following procedure to install MQSeries user exit support (APAR PJ27231) on your TPF 4.1 system.

  1. Install PUT 13.
  2. Compile the segments listed for this APAR in Table 984.
  3. Run the CBLD program to create the link-edit decks for CMQS DLL, CMQU DLL, and CUIM DLM.
  4. Link-edit the CMQS DLL, CMQU DLL, and CUIM DLM.
  5. Stop the TPF MQSeries local queue manager.
  6. Generate a new SAL table, which contains segment CMQU.
  7. Load the new SAL table, CMQS DLL, CMQU DLL, and CUIM DLM to your TPF 4.1 system.
  8. Start the TPF MQSeries local queue manager.

Fallback and Coexistence

If you need to fall back to a TPF 4.1 system that does not have APARs PJ27351 and PJ27431 applied, the SWEEPTIME parameter value is restored to its previous value or is set to 30 if the queue was defined with APARs PJ27351 and PJ27431 installed.