This action sets up IBM MQ redistributable client (Client) and IBM MQ MacOS Toolkit (Toolkit) to Linux, Windows and MacOS GitHub-hosted runners.

Clients downloaded from https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/messaging/mqdev/redist

Toolkit downloaded from https://public.dhe.ibm.com/ibmdl/export/pub/software/websphere/messaging/mqdev/mactoolkit

Default installation paths are used for Clients and Toolkit installations:

• Windows: %HOMEDRIVE%%HOMEPATH%\IBM\MQ\data
• Linux: $HOME/IBM/MQ/data
• MacOS: /opt/mqm

Installation path can be changed with mq-file-path input parameter (can't be changed for MacOS).

Action will fail if mq-file-path already exists. To recreate mq-file-path use true for clean-mq-file-path parameter. Default is false.

By default Client and Toolkit downloaded to setup-mqclient directory in the Home directory. You can use it for caching.

Caching directory can be changed by using download-path input parameter.

Default directory of the data path can be changed with mq-data-path input parameter.

Action has output parameter mq-file-path, that contains installation path.

See action.yml

Basic:

steps:
  - name: Install MQ Client
    uses: SeyfSV/setup-mqclient@v0.3.0
    with:
      mq-client-version: 9.3.0.0 # Exact version of a client or toolkit

    - run: dspmqver

Caching and matrix:

strategy:
  matrix:
    environment: ['macos-latest', 'windows-latest', 'ubuntu-latest']
    mq-client-version: [9.3.0.0, latest]
runs-on: ${{ matrix.environment}}
steps:
  - name: Cache MQ Client
    uses: actions/cache@v2
    with:
      path: ${{ github.workspace }}/setup-mqclient
      key: mqclient-${{ runner.os }}-${{ matrix.mq-client-version }}

  - name: Install MQ Client
    uses: SeyfSV/setup-mqclient@v0.3.0
    with:
      mq-client-version: ${{ matrix.mq-client-version }}

    - run: dspmqver

The scripts and documentation in this project are released under the MIT License