Directory structure on IBM i

A description of the IFS is given, and the IBM MQ IFS directory structure is described for server, client, and Java.

The integrated file system (IFS) is a part of IBM i that supports stream input/output and storage management similar to personal computer, UNIX and Linux operating systems, while providing an integrating structure over all information stored in the server.

On IBM i directory names begin with the character & (ampersand) instead of the character @ (at). For example, @system on IBM i is &system.


IFS root file system for IBM MQ server

When you install IBM MQ Server for IBM i, the following directories are created in the IFS root file system.

ProdData:

    Overview

      QIBM
      '-- ProdData

      • '-- mqm
      • '-- doc
      • '-- inc
      • '-- lib
      • '-- samp
      • '-- licenses
      • '-- LicenseDoc
      • '-- 5724H72_V8R0M0

    /QIBM/ProdData/mqm
    Subdirectories below this contain all the product data, for example, C++ classes, trace format files, and license files. Data in this directory is deleted and replaced each time the product is installed.

    /QIBM/ProdData/mqm/doc
    A Command Reference for the CL commands is provided in HTML format and installed here.

    /QIBM/ProdData/mqm/inc
    The header files for compiling your C or C++ programs.

    /QIBM/ProdData/mqm/lib
    Auxiliary files used by MQ.

    /QIBM/ProdData/mqm/samp
    Further samples.

    /QIBM/ProdData/mqm/licenses
    License files. The two files for each language are named like LA_ xx and LI_ xx where xx is the 2 character language identifier for each language supplied.

Also the following directory stores license agreements files:

    /QIBM/ProdData/LicenseDoc/5724H72_V8R0M0
    License files. The files are named like 5724H72_V8R0M0_ xx where xx is the 2 or 5 character language identifier for each language supplied.

UserData:

    Overview

      QIBM
      '-- UserData

      • '-- mqm
      • '-- errors
      • '-- trace
      • '-- qmgrs
      • '-- &system
      • '-- qmgrname1
      • '-- qmgrname2
      • '-- and so on

    /QIBM/UserData/mqm
    Subdirectories below this contain all user data relating to queue managers.

    When you install the product, an mqs.ini file is created in directory /QIBM/UserData/mqm/ (unless it is already there from a previous installation).

    When creating a queue manager, a qm.ini file is created in the directory /QIBM/UserData/mqm/qmgrs/ QMGRNAME / (where QMGRNAME is the name of the queue manager).

    Data in the directories is retained when the product is deleted.


IFS root file system for IBM MQ MQI client

When you install IBM MQ MQI client for IBM i, the following directories created in the IFS root file system:

ProdData:

    Overview

      QIBM
      '-- ProdData

      • '-- mqm
      • '-- lib

    /QIBM/ProdData/mqm
    Subdirectories below this directory contain all the product data. Data in this directory is deleted and replaced each time the product is replaced.

UserData:

    Overview

      QIBM
      '-- UserData

      • '-- mqm
      • '-- errors
      • '-- trace

    /QIBM/UserData/mqm
    Subdirectories below this directory contain all user data.


IFS root file system for IBM MQ Java

When you install IBM MQ Java on IBM i, the following directories are created in the IFS root file system:

ProdData:

    Overview

      QIBM
      '-- ProdData

      • '-- mqm
      • '-- java
      • '--samples
      • '-- bin
      • '-- lib

    /QIBM/ProdData/mqm/java
    Subdirectories below this contain all the product data, including Java classes. Data in this directory is deleted and replaced each time the product is replaced.

    /QIBM/ProdData/mqm/java/samples
    Subdirectories below this contain all the sample Java classes and data.


Libraries created by server and client installations

Installation of the IBM MQ server or client creates the following libraries:

  • QMQM

    The product library.

  • QMQMSAMP

    The samples library (if you choose to install the samples).

  • QMxxxx

    Server only.

    Each time that you create a queue manager, IBM MQ automatically creates an associated library, with a name like QMxxxx where xxxx is derived from the queue manager name. This library contains objects specific to the queue manager, including journals and associated receivers. By default the name of this library is derived from the name of the queue manager prefixed with the characters QM. For example, for a queue manager called TEST, the library would be called QMTEST.

    Note: When creating a queue manager, we can specify the name of its library if we want to. For example: 
    CRTMQM MQMNAME(TEST) MQMLIB(TESTLIB)
    We can use the WRKLIB command to list all the libraries that IBM MQ for IBM i has created. Against the queue manager libraries, we will see the text QMGR: QMGRNAME. The format of the command is: 
    WRKLIB LIB(QM*)
    These queue manager-associated libraries are retained when the product is deleted.

Parent topic: Plan file system support on Multiplatforms