How To
Summary
The MQ Client Channel Definition Table (CCDT) is a binary file that is created and maintained by the MQ queue manager. Because of changes in the CCDT format between certain MQ versions, it is not possible to edit an MQ 8.0 CCDT on an MQ 7.1 queue manager. Thus, it is necessary to identify the version of the CCDT in order to select a queue manager with the proper version to edit the file.
a) Identify the character in position hex 0x2C (44th character in the file) and see the hexadecimal value: If it is 0x09 or 0x0A, then the version is 7.1 or 7.5. If it is 0x0B then the version is 8.0 or 9.0.
b) Another solution is to use the SupportPac MO72 which has been discontinued. But because many customers have a copy, they may find this article useful.
Objective
The MQ Client Channel Definition Table (CCDT) is a binary file that is created and maintained by the MQ queue manager. This file can be copied to another directory or host.
Customers who have a variety of MQ versions, such as MQ 7.1, 7.5, 8.0 and 9.0 may be using several CCDT files that were created at different versions.
Because of changes in the CCDT format between certain MQ versions, it is not possible to edit an MQ 8.0 CCDT on an MQ 7.1 queue manager. Thus, it is necessary to identify the version of the CCDT in order to select a queue manager with the proper version to edit the file.
This article provides 2 methods to identify the version in Windows and Linux.
.
The following article discusses the compatibility of CCDT files.
http://www.ibm.com/support/docview.wss?uid=swg21312967
MQ 7.x, MQ 8.0 and MQ 9.0 compatibility with previous versions - including usage of CCDT files, JMS .bindings, SSL/TLS
Steps
.
++ Section A: Looking at the Hex dump of the CCDT file (character in position 0x2C)
The character in position hex 2C (44th character) shows the version.
0x09 => MQ 7.1 or MQ 7.5
0x0b => MQ 8.0 or MQ 9.0
+ Linux: hexdump -C filename
MQ 7.5:
mqm@mosquito: /var/mqm/qmgrs/QM75/@ipcc
$ hexdump -C AMQCLCHL.TAB
00000000 41 4d 51 52 f2 07 00 00 de 07 00 00 00 00 00 00 |AMQR............|
00000010 00 00 00 00 00 00 00 00 53 59 53 54 45 4d 2e 44 |........SYSTEM.D|
00000020 45 46 2e 43 4c 4e 54 43 4f 4e 4e 20 09 00 00 00 |EF.CLNTCONN ....|
**
MQ 8.0:
mqm@mosquito: /var/mqm/qmgrs/QM80/@ipcc
$ hexdump -C AMQCLCHL.TAB
00000000 41 4d 51 52 32 08 00 00 1e 08 00 00 00 00 00 00 |AMQR2...........|
00000010 00 00 00 00 00 00 00 00 53 59 53 54 45 4d 2e 44 |........SYSTEM.D|
00000020 45 46 2e 43 4c 4e 54 43 4f 4e 4e 20 0b 00 00 00 |EF.CLNTCONN ....|
**
+ Windows:
There is no native utility provided with Windows 7 and later that can be run in a normal command prompt.
However, if Windows PowerShell has been installed then you can use Format-Hex as explained below.
If you do not have PowerShell, then search the web for free utilities to view "Hex dump of Windows Files"
Started a PowerShell command session.
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
PS C:\Users\AngelRivera> cd C:\angel\coding\MQ\CCDT
PS C:\angel\coding\MQ\CCDT> dir
-a---- 7/9/2018 11:08 AM 4076 AMQCLCHL-WIN-71.TAB
-a---- 7/9/2018 11:11 AM 10178 AMQCLCHL-WIN-75.TAB
-a---- 7/9/2018 11:14 AM 4204 AMQCLCHL-WIN-80.TAB
-a---- 7/9/2018 11:16 AM 4204 AMQCLCHL-WIN-90.TAB
Note: MQ 7.1
PS C:\angel\coding\MQ\CCDT> Format-Hex AMQCLCHL-WIN-71.TAB
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
00000000 41 4D 51 52 F2 07 00 00 DE 07 00 00 00 00 00 00 AMQRò...Þ.......
00000010 F6 07 00 00 00 00 00 00 53 59 53 54 45 4D 2E 44 ö.......SYSTEM.D
00000020 45 46 2E 43 4C 4E 54 43 4F 4E 4E 20 09 00 00 00 EF.CLNTCONN ....
**
Note: 20 from First column + 0C from the title column = 2C
Note: MQ 8.0
PS C:\angel\coding\MQ\CCDT> Format-Hex AMQCLCHL-WIN-80.TAB
Path: C:\angel\coding\MQ\CCDT\AMQCLCHL-WIN-80.TAB
00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
00000000 41 4D 51 52 32 08 00 00 1E 08 00 00 00 00 00 00 AMQR2...........
00000010 36 08 00 00 00 00 00 00 53 59 53 54 45 4D 2E 44 6.......SYSTEM.D
00000020 45 46 2E 43 4C 4E 54 43 4F 4E 4E 20 0B 00 00 00 EF.CLNTCONN ....
**
+ Section B: Using SupportPac MO72
.
Use the SupportPac MO72 for Windows to find out the version of a CCDT file when the file was created with MQ 7.x.
# Open Windows command prompt and run as Administrator
# Change to the directory where the Windows version of the tool is
located, such as
cd "C:\MQ-SupportPac\MO72 7.5 MQSC Client, reads CCDT\Windows"
# Need to specify the location of the CCDT file:
set MQCHLLIB=C:\var\mqm\Qmgrs\QM75\@ipcc
# If not using default name for the CCDT (which is AMQCLCHL.TAB), then specify the following (MyCCDT is just a placeholder)
set MQCHLTAB=MyCCDT
# Invoke the tool with -n
mqsc -n
>display channel(*) version
AMQ8414: Display Channel details.
CHANNEL(MI.SVRCONN) CHLTYPE(CLNTCONN) VERSION(7.5)
.
Notice that this SupportPac does not support CCDTs created with MQ 8.0, MQ 9.0 and later, and the following warning is issued:
>display channel(*) version
Sorry, this program does not support reading version 11 channel records
.
With CCDTs for MQ 8.0, the command "runmqsc -n" does NOT have the option to display the version:
C:\> runmqsc -n
5724-H72 (C) Copyright IBM Corp. 1994, 2018.
Starting local MQSC for 'AMQCLCHL.TAB'.
display channel(*) version
1 : display channel(*) version
AMQ8405I: Syntax error detected at or near end of command segment below:-
display channel(*) version
.
Notice that the output of "display channel(*)" does not have an attribute that shows the version.
.
+++ end +++
Related Information
Was this topic helpful?
Document Information
Modified date:
10 July 2018
UID
ibm10716735