AllQueueManagers stanza of the mqs.ini file

Use the AllQueueManagers stanza in the mqs.ini file to specify the information about all queue managers.

Alternatively, on Linux® (x86 and x86-64) and Windows, use the IBM® MQ Explorer General and Extended IBM MQ properties page.

DefaultPrefix= directory_name

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

If you change the default prefix for the queue manager, replicate the directory structure that was created at installation time. In particular, you must 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 AIX® and Linux systems, or the \errors directory on Windows systems.

As an alternative to changing the default prefix, you 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, you must create the directory yourself if you change the default value. You 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, you 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 AIX 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 your 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.

Table 1. List of possible ISO CCSIDs

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 9.1.0 Fix Pack 2 and IBM MQ 9.1.2, you 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.