gtpm2m1q | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for TPF MQSeries local queue manager support.
See the APEDIT for APAR PJ25780 for information about prerequisite APARs.
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.
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:
The MQI is shipped as a new ISO-C dynamic link library (DLL) with the seven functions implemented as external functions in this DLL.
This can happen, for example, when TPF MQSeries local queue manager support receives persistent messages from remote MQSeries systems for which the destination queue is not defined or when TPF MQSeries cannot find a transmission queue when an application places a persistent message on a remote queue. The message is placed on the dead-letter queue with an MQDLH structure for the header as defined in the MQSeries Application Programming Reference. Your applications are responsible for monitoring the dead-letter queue and taking the appropriate action.
A remote queue can be defined as a local definition of a remote queue. When the remote queue is opened, TPF MQSeries local queue manager support will substitute the remote queue manager name and the remote queue name specified when the remote queue was defined (using the ZMQSC DEF QR command). Local definition of remote queues allows the system administrator to determine the destination queue manager and destination queue rather than having the application do it.
A remote queue can be defined with a queue manager alias. When the remote queue is opened, TPF MQSeries local queue manager support substitutes the remote queue manager name that was specified when the remote queue was defined (using the ZMQSC DEF QR command) for the queue manager name specified during the MQOPEN function call. Queue manager aliasing allows the system administrator to determine the destination queue manager rather than having the application do it.
The TPF 4.1 system can serve as a middle node in a network of TPF MQSeries local queue manager systems as long as the definitions adhere to the previous supported methods.
If a TPF MQSeries application places a nonpersistent message on a remote queue whose transmission queue is connected to a fast channel, the TPF MQSeries local queue manager will immediately send the message over the channel without filing a copy of the message. The message is not sent in a batch and is not guaranteed to be delivered.
If the transmission queue of the remote queue is connected to a normal channel, the TPF MQSeries local queue manager will include the message in a batch, guaranteeing delivery to the next node in the network.
Nonpersistent messages that arrive at TPF MQSeries fast receiver channels are passed immediately to applications through a unique TPF mechanism called the TPF MQSeries ROUTC bridge, whereas nonpersistent messages that arrive over normal channels are handled as persistent messages. This unique TPF MQSeries ROUTC bridge function allows nonpersistent messages to arrive through the MQSeries interface, but routes the message to a TPF application. Inbound nonpersistent messages over fast channels are converted into an application message format (AM0SG) and passed immediately to the COA4 segment. You must code a user exit to determine which application will receive the message and what LNIATA is associated with the TPF message. The application must set up the message queuing message descriptor (MQMD) with ReplyToQmgr and ReplyToQ. Information about where to send the reply is saved in the entry control block (ECB) and in the terminal address table (WGTA). When the application has completed processing the message, it can issue the ROUTC macro to send a reply. The ROUTC macro is intercepted and converted into an MQSeries nonpersistent outbound message.
Nonpersistent messages that originally came to the TPF MQSeries local queue manager over fast channels are returned to their originating TPF MQSeries system over the TPF MQSeries ROUTC bridge interface.
The TPF MQSeries local queue manager supports sender and receiver channels, which can be fast or normal.
Normal sender channels process messages in batches that are guaranteed to be delivered. The sender channel takes messages from its associated transmission queue and sends them in batches whose size is negotiated with the remote receiver channel. If a nonpersistent message is added to a transmission queue that is associated with a normal channel, the message is sent in a batch and guaranteed to be delivered to the next node in the network.
Fast sender channels process nonpersistent messages only. Messages are sent immediately to the remote MQSeries receiver channel. They are not included in a batch and, therefore, are not guaranteed to be delivered. Persistent messages that are placed on a transmission queue that is associated only with a fast channel remain on that queue until a normal channel is activated to service that transmission queue.
You can have both a fast channel and a normal channel associated with a single transmission queue. This combination allows persistent messages placed on a transmission queue to be processed by a normal channel, and nonpersistent messages placed on the same transmission queue to be processed by a fast channel.
Normal receiver channels receive persistent and nonpersistent messages that are contained in batches. TPF MQSeries local queue manager support guarantees that the messages received over normal receiver channels are delivered to the destination queue or are put on the TPF MQSeries dead-letter queue.
Fast receiver channels receive both persistent and nonpersistent messages. Nonpersistent messages that are received over a fast channel are passed immediately to the application through the TPF MQSeries ROUTC bridge. Persistent messages that are received over a fast channel are treated as if they were received over a normal channel. The messages are included in a batch and TPF MQSeries local queue manager support guarantees the message is delivered to the destination queue or the dead-letter queue.
The following unique TPF functions are provided with TPF MQSeries local queue manager support:
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.
There are no hardware requirements.
The following section contains information about software requirements.
The following section summarizes the communication changes.
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.
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.
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 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. |
There are no changes.
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.
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 |
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.
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 |
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. |
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. |
There are no changes.
Table 472 summarizes changes to members (object files). This information is presented in alphabetic order by the name of the member (object file).
Notes:
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. |
There are no changes.
There are no changes.
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 |
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. |
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.
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 |
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 |
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 |
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
There are no changes.
There are no changes.
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. |
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 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. |
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 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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no 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.
There are no changes.
There are no changes.
There are no changes.
Use the following procedure to install TPF MQSeries local queue manager support on your TPF 4.1 system.
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.
ZINET ADD S-MQS PGM-CMQL MODEL-AOR PORT-1414 AORL-8 P-TCP