gtpm2m3e | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF MQSeries server support.
See the APEDIT for APAR PJ28435 for information about prerequisite APARs.
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.
There are no changes.
There are no changes.
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 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. |
There are no changes.
There are no changes.
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.
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 |
There are no changes.
There are no changes.
Table 1237 summarizes changes to members. This information is presented in alphabetic order by the name of the member.
Notes:
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. |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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 |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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. |
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 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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no 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. |
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TPF MQSeries server support (APAR PJ28435) on your TPF 4.1 system.