gtpm2m1qMigration Guide: Program Update Tapes

TPF MQSeries Local Queue Manager Support (APAR PJ25780)

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

Prerequisite APARs

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

Functional Overview

TPF MQSeries local queue manager support implements a local queue manager on the TPF 4.1 system. A TPF MQSeries client was implemented previously to allow applications to interact with queue managers that are remote to the TPF 4.1 system. See Message Queue Interface (MQI) Client (APAR PJ22434) for more information about the TPF MQSeries client. With TPF MQSeries local queue manager support, TPF applications can now interact with the local queue manager or with the remote queue manager server.

Applications can choose to access TPF MQSeries local queue manager support by referencing the local TPF queue manager name in the MQCONN application programming interface (API). If the local queue manager name is not specified in MQCONN, this call and all subsequent MQSeries API calls will go to the TPF MQSeries client.

TPF MQSeries local queue manager support provides a subset of the functions defined in the MQSeries architecture. Applications that need to use functions that are not included in TPF MQSeries local queue manager support must use the MQSeries client.

The IPRSE parser utility has been enhanced in several ways:

See the TPF C/C++ Language Support User's Guide for more information about the IPRSE parser utility.

Architecture

The TPF MQSeries local queue manager support implementation is based on a subset of the standard TPF MQSeries local queue manager support interface used by other MQSeries product offerings. The following is a list of the standard MQSeries functions that are supported by TPF MQSeries local queue manager support:

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with TPF MQSeries local queue manager support, you must establish the required operating environment. The following section describes hardware and software requirements specific 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.

General Communication

TPF MQSeries local queue manager support requires TCP/IP connections for channels to communicate with remote MQSeries systems. See TPF Transmission Control Protocol/Internet Protocol for more information about how to define and start TCP/IP sessions.

TPF MQSeries local queue manager support uses TPF collection support (TPFCS) for its database manager. A TPFCS database must be installed and initialized before defining a TPF MQSeries local queue manager. See TPF Collection Support Enhancements (APAR PJ25332) for more information about TPFCS.

The TPF MQSeries local queue manager support receiver channel uses the TPF Internet daemon function to provide the TCP listener function, which is needed to activate new receiver channel connections.

Compilers

You must use the IBM OS/390 C/C++ Version 2 Release 4 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 467 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 467. Changes to Build Scripts for TPF MQSeries Local Queue Manager Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CMQLBS DLM New TPF MQSeries local queue manager support.
CMQRBS DLM New TPF MQSeries local queue manager support.
CMQSBS DLL New TPF MQSeries local queue manager support.
COMXBS DLM Changed TPF MQSeries local queue manager support.
CTALBS DLM Changed Support for the parser and TPF MQSeries local queue manager support.
CTBXBS DLM Changed Support for the parser.
CUIEBS DLM New TPF MQSeries local queue manager support.
CUIFBS DLM New TPF MQSeries local queue manager support.
CUIKBS DLM New TPF MQSeries local queue manager support.
CUIMBS DLM New TPF MQSeries local queue manager support.
CUIRBS DLM New TPF MQSeries local queue manager support.
CUIUBS DLM New TPF MQSeries local queue manager support.
CUIXBS DLM New TPF MQSeries local queue manager support.
CUSCBS DLM New TPF MQSeries local queue manager support.

Dynamic Load Module (DLM) Stubs

There are no changes.

General Use C/C++ Language Header Files

Table 468 summarizes the general use C language header file changes. This information is presented in alphabetic order by the name of the general use C language header file.

General use means these header files are available for your use.

Table 468. Changes to General Use C/C++ Language Header Files for TPF MQSeries Local Queue Manager Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments?
c$an0nt.h Changed Yes
c$cinfc.h Changed Yes
c$cmqcfc.h New Yes
c$cmqxc.h New Yes
c$eb0eb.h Changed Yes
c$mqdc.h New Yes
c$trmeq.h Changed Yes
cmqc.h Changed Yes
i$prse.h New Yes
iconv.h Changed Yes
socket.h Changed Yes
tpfapi.h Changed Yes
tpfparse.h Changed No

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

Table 469 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 469. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for 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?
amquscrw.h New Yes
c$mqs.h New Yes
c$mqtr.h New Yes
i$netd.h Changed Yes

Library Interface Scripts

Table 470 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 470. Changes to Library Interface Scripts for TPF MQSeries Local Queue Manager Support

Library Interface Script New, Changed, or No Longer Supported? Description of Change
COMXXV Changed Added support for the activate_on_receipt_with_length function.
CTALXV Changed Parser changes; added support for the wgtac_ext function.

Library Members (Object Files)

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

Table 471. Changes to Library Members (Object Files) for TPF MQSeries Local Queue Manager Support

Library Member (Object File) Library Module Name New, Changed, or No Longer Supported? Type Description of Change
CRFA CTBX Changed C Language Support for the parser.
CRFB CTBX Changed C Language Support for the parser.
CRFC CTBX Changed C Language Support for the parser.
CRFD CTBX Changed C Language Support for the parser.
CRFE CTBX Changed C Language Support for the parser.
CRFG CTBX Changed C Language Support for the parser.
CRFH CTBX No Longer Supported C Language Support for the parser.
CRFI CTBX No Longer Supported C Language Support for the parser.
CRFJ CTBX No Longer Supported C Language Support for the parser.
CRFK CTBX No Longer Supported C Language Support for the parser.
CWGTAE CTAL New Real-Time Assembler Support for the wgtac_ext function.
C512 COMX Changed C Language TPF MQSeries local queue manager support.

Link-Edited Modules

There are no changes.

Members (Object Files)

Table 472 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 link module (DLM) if it has changed.

Table 472. Changes to Members (Object Files) for TPF MQSeries Local Queue Manager Support

Member (Object File) DLM/DLL New, Changed, or No Longer Supported? Type Description of Change
CCCCXA CMQS New Object-Only TPF MQSeries local queue manager support.
CCCITA CMQS New Object-Only TPF MQSeries local queue manager support.
CCCMXA CMQS New Object-Only TPF MQSeries local queue manager support.
CCERRA CMQS New Object-Only TPF MQSeries local queue manager support.
CCLIBA CMQS New Object-Only TPF MQSeries local queue manager support.
CINET1 CLTV Changed C Language TPF MQSeries local queue manager support.
CINET4 CLTX Changed C Language TPF MQSeries local queue manager support.
CMQAPI CMQS New C++ Language TPF MQSeries local queue manager support.
CMQCOL CMQS New C++ Language TPF MQSeries local queue manager support.
CMQERR CMQS New Object-Only TPF MQSeries local queue manager support.
CMQGBL CMQS New C++ Language TPF MQSeries local queue manager support.
CMQGRU CMQS New C++ Language TPF MQSeries local queue manager support.
CMQHSH CMQS New C++ Language TPF MQSeries local queue manager support.
CMQI03 CMQ3 Changed C Language Support for the parser.
CMQL CMQS New Object-Only TPF MQSeries local queue manager support.
CMQMCA CMQS New Object-Only TPF MQSeries local queue manager support.
CMQMGC CMQS New C++ Language TPF MQSeries local queue manager support.
CMQMGR CMQS New C++ Language TPF MQSeries local queue manager support.
CMQMTR CMQS New Object-Only TPF MQSeries local queue manager support.
CMQNPM CMQS New C++ Language TPF MQSeries local queue manager support.
CMQNPS CMQS New Object-Only TPF MQSeries local queue manager support.
CMQQUE CMQS New C++ Language TPF MQSeries local queue manager support.
CMQR CMQS New Object-Only TPF MQSeries local queue manager support.
CMQUTL CMQS New C++ Language TPF MQSeries local queue manager support.
CNMQI CMQ2 Changed C Language Support for the parser.
CRCCCA CMQS New Object-Only TPF MQSeries local queue manager support.
CRCMNA CMQS New Object-Only TPF MQSeries local queue manager support.
CRCMSA CMQS New Object-Only TPF MQSeries local queue manager support.
CRCRSA CMQS New Object-Only TPF MQSeries local queue manager support.
CRCSIA CMQS New Object-Only TPF MQSeries local queue manager support.
CRERRA CMQS New Object-Only TPF MQSeries local queue manager support.
CREXTA CMQS New Object-Only TPF MQSeries local queue manager support.
CRFPTA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMCLA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMCVA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMMQA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMRCA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMRSA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMSAA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMSSA CMQS New Object-Only TPF MQSeries local queue manager support.
CRMTRA CMQS New Object-Only TPF MQSeries local queue manager support.
CUIE CUIE New Object-Only TPF MQSeries local queue manager support.
CUIF CUIF New Object-Only TPF MQSeries local queue manager support.
CUIK CUIK New C++ Language TPF MQSeries local queue manager support.
CUIM CUIM New C++ Language TPF MQSeries local queue manager support.
CUIQ CMQS New C++ Language TPF MQSeries local queue manager support.
CUIR CUIR New C++ Language TPF MQSeries local queue manager support.
CUIS CMQS New C++ Language TPF MQSeries local queue manager support.
CUIT CMQS New C++ Language TPF MQSeries local queue manager support.
CUIV CMQS New C++ Language TPF MQSeries local queue manager support.
CUIW CMQS New C++ Language TPF MQSeries local queue manager support.
CUIX CUIX New Object-Only TPF MQSeries local queue manager support.
CUSCCA CMQS New Object-Only TPF MQSeries local queue manager support.
CUSCCD CMQS New Object-Only TPF MQSeries local queue manager support.
CMQS New C++ Language TPF MQSeries local queue manager support.
CUSCQL CMQS New C++ Language TPF MQSeries local queue manager support.
CUSCQM CMQS New C++ Language TPF MQSeries local queue manager support.
CUSCQR CMQS New C++ Language TPF MQSeries local queue manager support.
CUSCRW CUSC New C++ Language TPF MQSeries local queue manager support.
CUSCUL CMQS New C++ Language TPF MQSeries local queue manager support.
CXCSMW CMQS New Object-Only TPF MQSeries local queue manager support.
CXCSSW CMQS New Object-Only 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

Table 473 summarizes the control program interface (CINFC) tag changes. The information in this table is ordered numerically by the equate value.

Table 473. Changes to CINFC Tags for TPF MQSeries Local Queue Manager Support

CINFC Tag Equate Value New, Changed, or No Longer Supported?
CMMMQT 374 New

Copy Members

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

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

Copy Member Type CSECT Where Copy Member Is Located New, Changed, or No Longer Supported? Description of Change
CDC1 Control Program CCDCOL Changed Support for TPF MQSeries data collection.
CICR Control Program CCNUCL Changed Support for TPF MQSeries.
CLXA Control Program CCCCP1 Changed Support for TPF MQSeries ROUTC bridge.

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

Table 475 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 475. Changes to Data Macros for TPF MQSeries Local Queue Manager Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs That Use This Data Macro?
DC0DC Changed Yes

General Macros

Table 476 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 476. Changes to General Macros for TPF MQSeries Local Queue Manager Support

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

Selected Equate Macros

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

Table 477. Changes to Selected Equate Macros for TPF MQSeries Local Queue Manager Support

Selected Equate Macro New, Changed, or No Longer Supported? Do You Need to Reassemble?
CZISE Changed No
TRMEQ Changed Yes

Structured Programming Macros (SPMs)

There are no changes.

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

Table 478 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) steps from the SIP Stage II deck.

Table 478. Changes to SIP Skeleton and Internal Macros for 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

Table 479 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 479. Changes to SIP Stage II Macros for TPF MQSeries Local Queue Manager 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 480 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 480. Changes to Segments for TPF MQSeries Local Queue Manager Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CMQMPP Offline C Language CMQMPP New Support for TPF MQSeries local queue manager support channel trace.
CTKR Real-Time Assembler Not Applicable Changed Support for the wgtac_ext function.
CTKT Real-Time Assembler Not Applicable Changed Support for the wgtac_ext function.
CVAB Real-Time Assembler Not Applicable Changed Support for the wgtac_ext function.
JCD1 Real-Time Assembler Not Applicable Changed Support for TPF MQSeries data collection.
JCD2 Real-Time Assembler Not Applicable Changed Support for TPF MQSeries data collection.
JCD6 Real-Time Assembler Not Applicable Changed Support for TPF MQSeries data collection.
JCM0 Real-Time Assembler Not Applicable Changed Support for TPF MQSeries data collection.
JRA2 Offline PL/I DATAREAD Changed Support for TPF MQSeries data reduction reports.
JRF1 Offline PL/I DATAREAD Changed Support for TPF MQSeries data reduction reports.
JRM1 Offline PL/I DATAREAD Changed Support for TPF MQSeries data reduction reports.
JRM5 Offline PL/I DATAREAD Changed Support for TPF MQSeries data reduction reports.
JRS1 Offline PL/I DATAREAD Changed Support for TPF MQSeries data reduction reports.

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 481. Changes to ECB User Exits for TPF MQSeries Local Queue Manager Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
TPF MQSeries Assign LNIATA Initiating program (TPF MQSeries local queue manager) CUIW New Converts the remote queue name and the remote queue manager name that is associated with the nonpersistent message into a line number, interchange address, and terminal address (LNIATA).
TPF MQSeries Convert to Object Handle Initiating program (TPF MQSeries local queue manager) CUIV New Converts a line number, interchange address, and terminal address (LNIATA) into an MQSeries object handle that is associated with a remote queue manager and a remote queue.
TPF MQSeries Empty-Queue Trigger CREEC CUIR New Activates the application to process the local queue specified in the trigger message.
TPF MQSeries Queue Manager MCA Security Initiating program (TPF MQSeries message channel agent (MCA)) CUIT New Provides security protection for data that TPF MQSeries transfers.

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

Command New, Changed, or No Longer Supported? Description of Change
ZINET ADD Changed Added the AORLength parameter.
ZINET ALTER Changed Added the AORLength parameter.
ZINET DISPLAY Changed Added the AORLength parameter.
ZMQID ALTER Changed Added new parser options, grammar options, and character types.
ZMQID DEFINE Changed Added new parser options, grammar options, and character types.
ZMQID DELETE Changed Added new parser options, grammar options, and character types.
ZMQID DISPLAY Changed Added new parser options, grammar options, and character types.
ZMQIT Changed Added new parser options, grammar options, and character types.
ZMQSC ALT CHL New TPF MQSeries change channel definition.
ZMQSC ALT MQP New TPF MQSeries change profile definition.
ZMQSC ALT QL New Change a TPF MQSeries local queue definition.
ZMQSC ALT QR New Change a transmission queue definition for the MQSeries remote queue.
ZMQSC DEF CHL New Define a TPF MQSeries message channel.
ZMQSC DEF MQP New Define a TPF MQSeries profile.
ZMQSC DEF QL New Define a local queue.
ZMQSC DEF QR New Define a remote queue.
ZMQSC DEL New Delete a TPF MQSeries resource.
ZMQSC DISPLAY New Display a channel definition and status, a TPF MQSeries profile, or a queue definition.
ZMQSC RESET New Reset a sender or receiver channel with a sequence number.
ZMQSC RESOLVE New Resolve a sender channel.
ZMQSC START New Start a TPF MQSeries sender channel or the TPF MQSeries local queue manager.
ZMQSC STOP New Stop a TPF MQSeries sender or receiver channel or the TPF MQSeries local queue manager.
ZMQSC SWQ New Move messages from one transmission queue to another transmission queue.
ZMQSC TRACE New Turn on or turn off the TPF MQSeries message channel agent (MCA) trace switch for a message channel.

Messages and System Errors

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

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
009300 System Error New
009301 System Error New
009304 System Error New
009305 System Error New
INET0112E Online New
MQSC0001I Online New
MQSC0002I Online New
MQSC0003E Online New
MQSC0004I Online New
MQSC0005E Online New
MQSC0006I Online New
MQSC0007E Online New
MQSC0009E Online New
MQSC0010I Online New
MQSC0011I Online New
MQSC0015I Online New
MQSC0016I Online New
MQSC0017I Online New
MQSC0018I Online New
MQSC0019I Online New
MQSC0020I Online New
MQSC0021E Online New
MQSC0022E Online New
MQSC0023W Online New
MQSC0024W Online New
MQSC0025E Online New
MQSC0026W Online New
MQSC0027E Online New
MQSC0040E Online New
MQSC0041E Online New
MQSC0042E Online New
MQSC0043E Online New
MQSC0044I Online New
MQSC0045E Online New
MQSC0052I Online New
MQSC0054E Online New
MQSC0055I Online New
MQSC0059W Online New
MQSC0061E Online New
MQSC0062E Online New
MQSC0063E Online New
MQSC0066E Online New
MQSC0071E Online New
MQSC0072E Online New
MQSC0074E Online New
MQSC0075E Online New
MQSC0076E Online New
MQSC0077E Online New
MQSC0078E Online New
MQSC0079E Online New
MQSC0080I Online New
MQSC0081E Online New
MQSC0082E Online New
MQSC0083E Online New
MQSC0084E Online New
MQSC0089E Online New
MQSC0090E Online New
MQSC0091E Online New
MQSC0102E Online New
MQSC0103E Online New
MQSC0104E Online New
MQSC0105E Online New
MQSC0106E Online New
MQSC0107E Online New
MQSC0108E Online New
MQSC0109E Online New
MQSC0110E Online New
MQSC0111E Online New
MQSC0112E Online New
MQSC0113E Online New
MQSC0114E Online New
MQSC0115E Online New
MQSC0116E Online New
MQSC0117E Online New
MQSC0118E Online New
MQSC0119E Online New
MQSC0122E Online New
MQSC0123E Online New
MQSC0125E Online New
MQSC0126E Online New
MQSC0127E Online New
MQSC0128E Online New
MQSC0129E Online New
MQSC0130E Online New
MQSC0131E Online New
MQSC0132E Online New
MQSC0136E Online New
MQSC0138E Online New
MQSC0139E Online New
MQSC0140I Online New
MQSC0144E Online New
MQSC0151I Online New
MQSC0152I Online New
MQSC0153E Online New
MQSC0154E Online New
MQSC0155E Online New
MQSC0157E Online New
MQSC0158I Online New
MQSC0159I Online New
MQSC0160I Online New
MQSC0161I Online New
MQSC0162E Online New
MQSC0163E Online New
MQSC0164E Online New
MQSC0200I Online New
MQSC0201I Online New
MQSC0202I Online New
MQSC0203I Online New
MQSC0301E Online New
MQSC0302E Online New
MQSC0303E Online New
MQSC0304E Online New
MQSC0305E Online New
MQSC0306E Online New
MQSC0307E Online New
MQSC0308E Online New
MQSC0309E Online New
MQSC0310E Online New
MQSC0311I Online New
MQSC0312I Online New
MQSC0313E Online New
MQSC0314E Online New
MQSC0315I Online New
MQSC0316I Online New
MQSC0317E Online New
MQSC0318E Online New
MQSC0319E Online New
MQSC0320I Online New
MQSC0321E Online New
MQSC0322E Online New
MQSC0323E Online New
MQSC0324E Online New
MQSC0325E Online New
MQSC0326E Online New
MQSC0327E Online New
MQSC0328E Online New
MQSC0329E Online New
MQSC0330E Online New
MQSC0332E Online New
MQSC0401E Online New
MQSC0402E Online New
MQSC0403E Online New
MQSC0404E Online New
MQSC0405E Online New
MQSC0406E Online New
MQSC0407I Online New
MQSC0408E Online New
MQSC0409E Online New
MQSC0410E Online New
MQSC0411E Online New
MQSC0412E Online New
MQSC0413E Online New
MQSC0414E Online New
MQSC0415E Online New
MQSC0416E Online New
MQSC0417E Online New
MQSC0418E Online New
MQSC0419E Online New
MQSC0420E Online New
MQSC0421E Online New
MQSC0422E Online New
MQSC0502E Online New
MQSC0504E Online New
MQSC0507E Online New
MQSC0511W Online New
MQSC9998E Online New
MQSC9999E 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 484 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 484. Changes to TPF Publications for TPF MQSeries Local Queue Manager Support

Publication Title Softcopy File Name Description of Change
TPF C/C++ Language Support User's Guide GTPCLU08 Updated with APIs added for TPF MQSeries local queue manager support.
TPF Library Guide GTPDOC08 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 TPF MQSeries local queue manager support.
TPF Migration Guide: Program Update Tapes GTPMIG08 Updated with migration considerations for TPF MQSeries local queue manager support.
TPF Operations GTPOPR08 Updated with information about the commands that were added and changed for TPF MQSeries local queue manager support.
TPF Program Development Support Reference GTPPDR08 Updated with information about the channel trace function that was added for TPF MQSeries local queue manager support.
TPF System Generation GTPSYG08 Updated with information about SIPG6I that was added for TPF MQSeries local queue manager support.
TPF System Installation Support Reference GTPINR08 Updated with information about the user exits that were added for TPF MQSeries local queue manager support.
TPF System Performance and Measurement Reference GTPSPR07 Updated with information about the two MQSeries reports that were added for TPF MQSeries local queue manager support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW04 Updated with information about the activate_on_receipt_with_length function that was added for TPF MQSeries local queue manager support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

A subset of the Message Queue Interface (MQI) is available through an ISO-C interface which gives the TPF application access to TPF MQSeries local queue manager support. There is no change to MQI for access to the TPF MQSeries client.

In addition, a new function, activate_on_receipt_with_length, has been provided to give TCP/IP applications the ability to specify a length rather than the default, 32 KB, when issuing activate_on_receipt function calls.

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 local queue manager support on your TPF 4.1 system.

  1. Install program update tape (PUT) 9.
  2. Compile the TPF MQSeries programs by using the IBM OS/390 C/C++ Version 2 Release 4 compiler or later version or release. See the OS/390 C/C++ User's Guide for more information about C and C++ compilers.
  3. Run the CBLD program to create the link-edit decks for the DLLs and DLMs.

    You do not need to compile some of the modules contained in the MQSeries DLL (CMQS) because they are provided to you as object-code-only (OCO) modules.

  4. Recompile the C512 module and link-edit the COMX library again to pick up the new activate_on_receipt_with_length function.
  5. Compile the CINET1 and CINET4 members, and link-edit the CLTV and CLTX modules to pick up the changes to the Internet daemon to support the AORLENGTH parameter on the ZINET commnd.
  6. Compile the following Message Queue Interface (MQI) client modules to pick up changes to the cmqc.h header file: CMQI01, CMQI03, CQRREQ, CQRMSS, CQCLIB, CQRFPT, CQCCCX, CQREXT, CQCCMX, CQCCIC, CNMQI, CNMQJ, and CNMQD. See Message Queue Interface (MQI) Client (APAR PJ22434) for more information.
  7. Link-edit the following MQI client modules to pick up changes to the cmqc.h header file: CMQI, CMQ2, CMQ1, and CMQ3. See Message Queue Interface (MQI) Client (APAR PJ22434) for more information.
  8. Do the following for any application programs that currently call the MQI client API functions:
    1. Use the DLL option to recompile the application programs.
    2. Modify the prelink step to import the CMQS definition side-deck for the application programs.
    3. Link-edit the application programs.
  9. Assemble the CWGTAE module and link-edit the CTAL library to pick up the wgtac_ext function.
  10. Load COMX, CLTV, CLTX, DLMs, and DLLs to your TPF 4.1 system. See Table 472.
  11. Enter the ZMQSC DEF MQP command to define an MQSeries message profile.
  12. Enter the ZMQSC DEF CHL command to define all MQSeries message channels that are needed by your applications.
  13. Enter the ZMQSC DEF QL command to define all local queues that are needed by your applications.
  14. Enter the ZMQSC DEF QR command to define all remote queues that are needed by your applications.
  15. To establish connections between a TPF MQSeries receiver channel and a remote MQSeries sender channel, define an Internet daemon that will provide the TCP/IP listener function. To do this, enter:
    ZINET ADD S-MQS PGM-CMQL MODEL-AOR PORT-1414 AORL-8 P-TCP
    
  16. Enter the ZMQSC START command with the QMGR parameter specified to start the queue manager.
  17. Enter the ZMQSC START command with the CHL parameter specified to start the channel.