gtpm2m3dMigration Guide: Program Update Tapes

TPF MQSeries Clear Queue Support and Display Enhancements (APAR PJ28339)

The following section discusses the migration considerations for TPF MQSeries clear queue support and display enhancements.

Prerequisite APARs

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

Functional Overview

TPF MQSeries clear queue support and display enhancements includes the following:

Architecture

There are no changes.

Operating Environment Requirements and Planning Information

There are no changes.

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/C++ Language Header Files

There are no changes.

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

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

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$mqs.h Changed No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

There are no changes.

Members

Table 1231 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 1231. Changes to Members for TPF MQSeries Clear Queue Support and Display Enhancements

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
CMQMGC CMQS DLL Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.
CMQQUE CMQS DLL Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.
CMQRCV CMQS DLL Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.
CMQSWP CMQS DLL Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.
CUSCCA CMQS DLL Changed Object Code Only Updated for TPF MQSeries clear queue support and display enhancements.
CUSCCD CMQS DLL Changed Object Code Only Updated for TPF MQSeries clear queue support and display enhancements.
CUSCQL CUSC DLL Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.
CUSCRW CUSC DLM Changed C++ Language Updated for TPF MQSeries clear queue support and display enhancements.

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

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 1232 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 1232. Changes to Commands for TPF MQSeries Clear Queue Support and Display Enhancements

Command New, Changed, or No Longer Supported? Description of Change
ZMQSC CLEAR QL New Created for TPF MQSeries clear queue support and display enhancements.
ZMQSC DISPLAY Changed Updated for TPF MQSeries clear queue support and display enhancements.

Messages and System Errors

Table 1233 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 TPF Messages 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 1233. Changes to Messages and System Errors for TPF MQSeries Clear Queue Support and Display Enhancements

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
MQSC0140I Online No Longer Supported
MQSC0150I Online No Longer Supported
MQSC0151I Online No Longer Supported
MQSC0152I Online No Longer Supported
MQSC0156W Online New
MQSC0219I Online New
MQSC0225I 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 1234 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 1234. Changes to TPF Publications for TPF MQSeries Clear Queue Support and Display Enhancements

Publication Title Softcopy File Name Description of Change
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 TPF MQSeries clear queue support and display enhancements.
TPF Migration Guide: Program Update Tapes GTPMG206 Updated with migration considerations for TPF MQSeries clear queue support and display enhancements.
TPF Operations GTPOPR0G Updated with information about the commands that were added and changed for TPF MQSeries clear queue support and display enhancements.

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 TPF MQSeries clear queue support and display enhancements (APAR PJ28339) on your TPF 4.1 system.

  1. Install program update tape (PUT) 16.
  2. Compile the segments listed for this APAR in Table 1231.
  3. Link-edit the CMQS DLL and CUSC DLM. CMQS must be linked before CUSC because CUSC needs a function that is in the definition side-deck from CMQS.
  4. Stop the TPF MQSeries local queue manager on the processor to which you want to activate the new code.
  5. Load the CMQS DLL and CUSC DLM to your TPF 4.1 system.
  6. Activate the loadset that contains the new code.
  7. Start the TPF MQSeries local queue manager that you previously stopped.