AllQueueManagers stanza of the mqs.ini file

Use the General and Extended IBM MQ properties page from the IBM MQ Explorer, or the AllQueueManagers stanza in the mqs.ini file to specify the following information about all queue managers.

    DefaultPrefix= directory_name
    This attribute specifies the path to the qmgrs directory, within which the queue manager data is kept.

    If we change the default prefix for the queue manager, replicate the directory structure that was created at installation time.

    In particular, create the qmgrs structure. Stop IBM MQ before changing the default prefix, and restart IBM MQ only after you have moved the structures to the new location and changed the default prefix. Note: Do not delete the /var/mqm/errors directory on UNIX and Linux systems, or the \errors directory on Windows systems.

    As an alternative to changing the default prefix, we can use the environment variable MQSPREFIX to override the DefaultPrefix for the crtmqm command.

    Because of operating system restrictions, keep the supplied path sufficiently short so that the sum of the path length and any queue manager name is a maximum of 70 characters long.

    DefaultEphemeralPrefix= directory_name
    This attribute specifies the path to the directory, within which the queue manager ephemeral data is kept, such as IPC sockets, and is used only to set the EphemeralPrefix of a queue manager when a queue manager is created. In addition, create the directory yourself if we change the default value. We must create the ephemeral data directory with permissions that allow the IBM MQ group access to write to that directory.
    As an alternative to changing the mqs.ini file, we can use the environment variable MQ_EPHEMERAL_PREFIX to override the DefaultEphemeralPrefix for the crtmqm command.
    Because of operating system restrictions, the default ephemeral prefix is restricted to:

    • 12 characters on UNIX and Linux platforms.
    • 24 characters on IBM i.

    DefaultEphemeralPrefix is not supported on the IBM MQ Appliance.

    ConvEBCDICNewline=NL_TO_LF|TABLE|ISO
    EBCDIC code pages contain a newline (NL) character that is not supported by ASCII code pages (although some ISO variants of ASCII contain an equivalent). Use the ConvEBCDICNewline attribute to specify how IBM MQ is to convert the EBCDIC NL character into ASCII format.

    On IBM MQ for IBM i, CCSID 1253 is considered to be an ISO CCSID, and NL_TO_LF affects both ISO and ASCII conversions.

    The ConvEBCDICNewline attribute is not available on z/OS . The behavior on z/OS is equivalent to ConvEBCDICNewline=TABLE. Note that the default on other platforms might be different.

      NL_TO_LF
      Convert the EBCDIC NL character (X'15') to the ASCII line feed character, LF (X'0A'), for all EBCDIC to ASCII conversions.

      NL_TO_LF is the default.

      TABLE
      Convert the EBCDIC NL character according to the conversion tables used on the platform for all EBCDIC to ASCII conversions.

      The effect of this type of conversion might vary from platform to platform and from language to language; even on the same platform, the behavior might vary if you use different CCSIDs.

      ISO
      Convert:

      • ISO CCSIDs using the TABLE method
      • All other CCSIDs using the NL_TO_CF method

      Possible ISO CCSIDs are shown in Table 1.

      CCSID Code Set
      819 ISO8859-1
      912 ISO8859-2
      915 ISO8859-5
      1089 ISO8859-6
      813 ISO8859-7
      916 ISO8859-8
      920 ISO8859-9
      1051 roman8

      If the ASCII CCSID is not an ISO subset, ConvEBCDICNewline defaults to NL_TO_LF.

    From IBM MQ Version 9.1.0, Fix Pack 2 and IBM MQ Version 9.1.2, we can use the AMQ_CONVEBCDICNEWLINE environment variable instead of the ConvEBCDICNewline stanza attribute, for example to provide ConvEBCDICNewline functionality on the client side in situations where the mqs.ini file cannot be used. The environment variable takes the same values (NL_TO_LF, TABLE, or ISO) as the ConvEBCDICNewline attribute. The stanza attribute takes precedence if both the attribute and the environment variable are set.

Parent topic: Attributes for changing IBM MQ configuration information