mqccdt type

Use the mqccdt type to create configurations that contain a client channel definition table (CCDT), which provides channel definitions and authentication information for connecting to one or more IBM® MQ queue managers.

Tip: The mqccdt type works with the mqccred.ini type, which is used to store user ID and password credentials for connecting to the queue managers.

To connect to IBM MQ, you might also need other configuration types such as Policy project, Keystore, server.conf.yaml, and setdbparms.txt.


Summary of key details for the configuration type

File name or type Contains secrets Path extracted/imported to Maximum allowed per integration runtime
JSON No /home/aceuser/ace-server/mqccdt/ Multiple

About the mqccdt file

The mqccdt type requires a JSON file that contains client-connection channel definitions in the form of a CCDT that the integration runtime can use to determine which queue managers to connect to. A JSON format CCDT is a flat text file (with a .json extension) that you create on the IBM MQ server. The file typically contains the name of one or more channels and queue managers, and the host, port, and TLS information.

To create a JSON CCDT file (for example, mqccdt.json), see Configuring a JSON format CCDT in the IBM MQ documentation. Examples of JSON CCDT that you can use as a basis for your requirements are provided in JSON CCDT examples.

Copy the JSON CCDT file from the server to a location on your computer.

You can specify multiple JSON CCDT files for an integration runtime. The file is placed in the mqccdt directory in the integration runtime work path for use by the integration runtime when it starts.

Creating a configuration for the mqccdt type by using the configuration panel

You can create an mqccdt-type configuration while creating an integration runtime, or independently, as follows:

  1. Open the Configuration page by clicking the Configuration icon Configuration icon in the navigation pane. Then, click Create configuration. For more information, see Creating configurations on the Configurations page.
  2. From the Create configuration panel, select mqccdt from the Type list.
  3. In the Name field, specify a name for this configuration.
  4. In the Description field, specify text that will help you identify the CCDT details, or the integration runtime that will use these details to connect to a queue manager.
    Create configuration panel
  5. Complete the mqccdt section by completing either of the following steps:
    • Copy the contents of an existing mqccdt file and then paste it into the mqccdt text editor.
      mqccdt text editor with pasted contents
    • Import a valid mqccdt file from your file system:
      1. Click the Import mqccdt file icon Import icon.
      2. Click within the boxed area to select the file from a file browser, or drag-and-drop the file.
        Import mqccdt view

        The content of the mqccdt file is displayed.

        mqccdt text editor with imported contents
  6. Click Create. The configuration is added to the configurations table and can be selected for use with an integration runtime.

Updating or deleting a configuration

If you need to update the content or settings in a configuration, or delete a configuration that's no longer needed, see Creating configurations on the Configurations page.