gtpm2m2q | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF MQSeries enhancements.
See the APEDIT for APARs PJ27230, PJ27231, PJ27351, and PJ27431 for information about prerequisite APARs.
TPF MQSeries enhancements include the following:
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.
There are no hardware requirements.
The following section contains information about software requirements.
The following section summarizes the communication changes.
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.
The following section summarizes interface changes.
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.
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. |
There are no changes.
There are no changes.
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.
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) |
| ||
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 |
There are no changes.
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. |
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. |
Table 984 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
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.
There are no changes.
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. |
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.
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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install MQSeries TCP/IP support (APAR PJ27230) on your TPF 4.1 system.
Use the following procedure to install MQSeries slow queue sweeper and move support (APARs PJ27351 and PJ27431) on your TPF 4.1 system.
Use the following procedure to install MQSeries user exit support (APAR PJ27231) on your TPF 4.1 system.
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.