gtpm2m31Migration Guide: Program Update Tapes

Enhancements to TPF MQSeries Local Queue Manager Support (APAR PJ28136)

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

Prerequisite APARs

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

Functional Overview

Enhancements to TPF MQSeries local queue manager support include the following:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

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

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

Build Script Type New, Changed, or No Longer Supported? Description of Change
CMQS DLL Changed Updated for enhancements to TPF MQSeries local queue manager 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 1081 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 1081. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for Enhancements to TPF MQSeries Local Queue Manager Support

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
amquscrw.h Changed No Not Applicable
c$mqmg.h Changed No Not Applicable
c$mqpc.h New No Not Applicable
c$mqs.h Changed No Not Applicable
c$stck.h Changed No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

Table 1082 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 1082. Changes to Link-Edited Modules for Enhancements to TPF MQSeries Local Queue Manager Support

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CMQF Changed Updated for enhancements to TPF MQSeries local queue manager support.
CMQS Changed Updated for enhancements to TPF MQSeries local queue manager support.
CUIU Changed Updated for enhancements to TPF MQSeries local queue manager support.
CUSC Changed Updated for enhancements to TPF MQSeries local queue manager support.

Members

Table 1083 summarizes changes to members. This information is presented in alphabetic order by the name of the member.

Notes:

  1. You must recompile or reassemble a member if it has changed.

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

Table 1083. Changes to Members for Enhancements to TPF MQSeries Local Queue Manager Support

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
CMQAPI CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQFRM CMQF DLM Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQGRU CUIU DLM Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQMGC CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQMGR CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQQUE CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CMQTRM CMQS DLL New C++ Language Created by enhancements to TPF MQSeries local queue manager support.
CMQUTL CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CUSCCD CMQS DLL Changed Object Code Only Updated for enhancements to TPF MQSeries local queue manager support.
CUSCPF CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CUSCPR CMQS DLL New C++ Language Created by enhancements to TPF MQSeries local queue manager support.
CMQUTL CMQS DLL Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CUSCQL CUSC DLM Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager support.
CUSCRW CUSC DLM Changed C++ Language Updated for enhancements to TPF MQSeries local queue manager 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

Table 1084 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 1084. Changes to Copy Members for Enhancements to TPF MQSeries Local Queue Manager Support

Copy Member Type New, Changed, or No Longer Supported? Segment Where Copy Member is Included Name of Link-Edited Module DLM, DLL, LLM, or Control Program Description of Change
CMIS CP Changed CCNUCL Not Applicable Control Program Updated for enhancements to TPF MQSeries local queue manager support.
CT41 CP Changed CCCTIN Not Applicable Control Program Updated for enhancements to TPF MQSeries local queue manager support.

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

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

There are no changes.

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

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

Command New, Changed, or No Longer Supported? Description of Change
ZMQSC ALT PROCESS New Created for enhancements to TPF MQSeries local queue manager support.
ZMQSC ALT QL Changed Updated by enhancements to TPF MQSeries local queue manager support.
ZMQSC DEF PROCESS New Created for enhancements to TPF MQSeries local queue manager support.
ZMQSC DEF QL Changed Updated by enhancements to TPF MQSeries local queue manager support.
ZMQSC DEL Changed Updated by enhancements to TPF MQSeries local queue manager support.
ZMQSC DISPLAY Changed Updated by enhancements to TPF MQSeries local queue manager support.

Messages and System Errors

Table 1087 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 (Online) and Messages (System Error and Offline) 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 1087. Changes to Messages and System Errors for Enhancements to TPF MQSeries Local Queue Manager Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
MQSC0700I Online New
MQSC0704E Online New
MQSC0705E Online New
MQSC0721I Online New
MQSC0722I Online New
MQSC0723I Online New
MQSC0724E Online New
MQSC0725E 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 1088 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 1088. Changes to TPF Publications for Enhancements to TPF MQSeries Local Queue Manager Support

Publication Title Softcopy File Name Description of Change
TPF Application Programming GTPAPP0E Updated for enhancements to TPF MQSeries local queue manager support.
TPF Concepts and Structures GTPCON0C Updated for enhancements to TPF MQSeries local queue manager support.
TPF C/C++ Language Support User's Guide GTPCLU0F Updated for enhancements to TPF MQSeries local queue manager 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 enhancements to TPF MQSeries local queue manager support.
TPF Migration Guide: Program Update Tapes GTPMG205 Updated with migration considerations for enhancements to TPF MQSeries local queue manager support.
TPF Operations GTPOPR0F Updated with information about the commands that were added and changed for enhancements to TPF MQSeries local queue manager support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

Table 1089 summarizes API changes. This information is presented in alphabetic order by the name of the command. See TPF C/C++ Language Support User's Guide for a complete description of all APIs.

Table 1089. Changes to APIs for Enhancements to TPF MQSeries Local Queue Manager Support

Command New, Changed, or No Longer Supported? Description of Change
MQGET Changed Updated by enhancements to TPF MQSeries local queue manager support.
MQINQ Changed Updated by enhancements to TPF MQSeries local queue manager support.
MQSET Changed Updated by enhancements to TPF MQSeries local queue manager support.

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 enhancements to TPF MQSeries local queue manager support (APAR PJ28136) on your TPF 4.1 system.

  1. Install program update tape (PUT) 15.
  2. Compile segment CUSCQM, CMQMVM, and the segments listed for this APAR in Table 1083.
  3. Run the CBLD program to create the link-edit decks for the CMQF DLM, CMQS DLL, CUIU DLM, and CUSC DLM.
  4. Assemble the control program (CP).
  5. Link-edit the CP, CMQF DLM, CMQS DLL, CUIU DLM, and CUSC DLM.
  6. Load the CP, CMQF DLM, CMQS DLL, CUIU DLM, and CUSC DLM to your TPF 4.1 system.
  7. Stop the TPF MQSeries local queue manager on the processor to which you want to activate the new code.
  8. Activate the loadset that contains the new code.
  9. Start the TPF MQSeries local queue manager that you previously stopped.
  10. If you have to fall back from APAR PJ28136, ensure that APAR PJ28104 is still installed.