All queue managers

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 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 we 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.

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 Version 9.0.0, Fix Pack 6, 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.