gtpm2m3eMigration Guide: Program Update Tapes

TPF MQSeries Server Support (APAR PJ28435)

The following section discusses the migration considerations for TPF MQSeries server support.

Prerequisite APARs

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

Functional Overview

TPF MQSeries server support provides the following:

TPF MQSeries local queue manager server support allows an MQSeries client to connect to a TPF 4.1 system by using a server connection channel. MQSeries clients can now pass MQSeries application programming interfaces (APIs) to the TPF 4.1 system, which can act as the server, run the API, and return code to the client. TPF MQSeries user exits and APIs have been added and existing APIs have been enhanced as part of this support.

TPF MQSeries database rebuild support provides the ZMQSC DBREBUILD command, which allows you to rebuild TPF MQSeries definitions in the current file address reference format (FARF) on the TPF system without losing those definitions and without losing any messages that are currently on queue.

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

Table 1235 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 1235. Changes to Build Scripts for TPF MQSeries Server Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CMQSBS DLM Changed Updated for TPF MQSeries server support.
CPGCBS DLL New Created for TPF MQSeries server 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 1236 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 1236. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for TPF MQSeries Server 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
cmqc.h Changed No Not Applicable
c$mqdc.h Changed No Not Applicable
c$mqs.h Changed No Not Applicable
c$mqtr.h Changed No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

There are no changes.

Members

Table 1237 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 1237. Changes to Members for TPF MQSeries Server Support

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
CCCCXA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CCCITA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CMQAPI CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQCOL CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQERR CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CMQFTR CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQHSH CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQMCA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CMQMGC CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQMGR CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQMTR CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CMQQUE CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CMQSVR CMQS DLL New Object Code Only Created for TPF MQSeries server support.
CMQUTL CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CPGS CPGS DLM Changed C Language Changed for TPF MQSeries server support.
CRCMSA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRCSIA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CREXTA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRFPTA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMCLA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMCVA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMRSA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMSAA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMSSA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRMTRA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CRSRVA CMQS DLL New Object Code Only Created for TPF MQSeries server support.
CUIF CUIF DLM Changed Object Code Only Updated for TPF MQSeries server support.
CUIT CMQU DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCCA CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CUSCCD CMQS DLL Changed Object Code Only Updated for TPF MQSeries server support.
CUSCPF CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCPR CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCQL CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCQM CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCQR CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CUSCRW CUSC DLM Changed C++ Language Updated for TPF MQSeries server support.
CUSCUL CMQS DLL Changed C++ Language Updated for TPF MQSeries server support.
CXCSSW CMQS DLL Changed Object Code Only Updated for TPF MQSeries server 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 1238 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 1238. Changes to Copy Members for TPF MQSeries Server 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
CL10 CP Changed CCTLOG CPS0 Control Program Updated for TPF MQSeries server 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 1239 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 1239. Changes to SIP Skeleton and Internal Macros for TPF MQSeries Server 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

Table 1240 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 1240. Changes to SIP Stage II Macros for TPF MQSeries Server Support

SIP Stage II Macro New, Changed, or No Longer Supported?
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

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

Table 1241. Changes to Segments for TPF MQSeries Server Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CMQMPP Offline CMQMPP Changed Updated for TPF MQSeries server support.
JCD4 Real-Time Assembler Not Applicable Changed Updated for TPF MQSeries server support.
JRA1 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.
JRA2 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.
JRA3 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.
JRM1 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.
JRM5 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.
JRS3 Offline PL/I DATAREAD Changed Updated for TPF MQSeries server support.

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 1242. Changes to ECB User Exits for TPF MQSeries Server Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
TPF MQSeries Channel Message Exit CMQU CUIT New Created for TPF MQSeries server support.
TPF MQSeries Channel Message Retry Exit CMQU CUIT New Created for TPF MQSeries server support.
TPF MQSeries Channel Security Exit CMQU CUIT Changed Updated for TPF MQSeries server 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 1243 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 1243. Changes to Commands for TPF MQSeries Server Support

Command New, Changed, or No Longer Supported? Description of Change
ZMQSC ALT CHL Changed Updated for TPF MQSeries server support.
ZMQSC DBREBUILD New Created for TPF MQSeries server support.
ZMQSC DEF CHL Changed Updated for TPF MQSeries server support.
ZMQSC DISPLAY Changed Updated for TPF MQSeries server support.

Messages and System Errors

Table 1244 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 1244. Changes to Messages and System Errors for TPF MQSeries Server Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
MQSC0101E Online New
MQSC0167E Online Changed
MQSC0226E Online New
MQSC0227E Online New
MQSC0232E Online New
MQSC0233E Online New
MQSC0234E Online New
MQSC0235I Online New
MQSC0236E Online New
MQSC0237E Online New
MQSC0350E Online New
MQSC0351I Online New
MQSC0352E Online New
MQSC0353I Online New
MQSC0354E Online New
MQSC0355E Online New
MQSC0900I Online New
MQSC0901E Online New
MQSC0950E Online New
MQSC0951E 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 1245 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 1245. Changes to TPF Publications for TPF MQSeries Server Support

Publication Title Softcopy File Name Description of Change
TPF Concepts and Structures GTPCON0D Updated for TPF MQSeries server support.
TPF C/C++ Language Support User's Guide GTPCLU0G Updated for TPF MQSeries server 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 TPF MQSeries server support.
TPF Migration Guide: Program Update Tapes GTPMG206 Updated with migration considerations for TPF MQSeries server support.
TPF Operations GTPOPR0G Updated with information about the commands that were added and changed for TPF MQSeries server support.
TPF System Installation Support Reference GTPINR0G Created and updated user exits for TPF MQSeries server support.
TPF System Performance and Measurement Reference GTPSPR0F Updated with information for TPF MQSeries server support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

Table 1246 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 1246. Changes to APIs for TPF MQSeries Server Support

Command New, Changed, or No Longer Supported? Description of Change
MQBACK New Created for TPF MQSeries server support.
MQCMIT New Created for TPF MQSeries server support.
MQGET Changed Updated by TPF MQSeries server support.
MQPUT Changed Updated by TPF MQSeries server support.
MQPUT1 Changed Updated by TPF MQSeries server support.
MQSET Changed Updated by TPF MQSeries server 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 TPF MQSeries server support (APAR PJ28435) on your TPF 4.1 system.

  1. Install program update tape (PUT) 16.
  2. Assemble segment CCTLOG.
  3. Compile the segments listed for this APAR in Table 1241.
  4. Compile the members listed for this APAR in Table 1237.
  5. Run the CBLD program to create the link-edit decks for the CMQS DLL and CPGC DLM.
  6. Link-edit the control program (CPS0).
  7. Link-edit the CMQS DLL, CMQU DLL, CPGC DLM, CUIF DLM, and CUSC DLM. CMQS must be linked before CUSC because CUSC needs a function that is in the definition side-deck from CMQS.
  8. Link-edit the CMQMPP offline trace program by using the system initialization program (SIP) generated job control language (JCL). The CMQMPP program does not require prelinking because the program is compiled with the NORENT and NOLONGNAME options.
  9. Stop all TPF MQSeries queue managers.
  10. Load the new control program (CP), CMQS DLL, CMQU DLL, CPGC DLM, CUIF DLM, and CUSC DLM to a new image using the auxiliary loader (TLDR).
  11. IPL the new image and cycle the TPF 4.1 system to NORM state.