DynamicQName (MQCHAR48)

This is the name of a dynamic queue that is to be created by the MQOPEN call. This is of relevance only when ObjectName specifies the name of a model queue; in all other cases DynamicQName is ignored.

The characters that are valid in the name are the same as those for ObjectName, except that an asterisk is also valid. A name that is blank (or one in which only blanks occur before the first null character) is not valid if ObjectName is the name of a model queue.

If the last nonblank character in the name is an asterisk ( *), the queue manager replaces the asterisk with a string of characters that guarantees that the name generated for the queue is unique at the local queue manager. To allow a sufficient number of characters for this, the asterisk is valid only in positions 1 through 33. There must be no characters other than blanks or a null character following the asterisk.

It is valid for the asterisk to occur in the first character position, in which case the name consists solely of the characters generated by the queue manager.

On z/OS®, do not use a name with the asterisk in the first character position, as there can be no security checks made on a queue with a full name that is generated automatically.

This is an input field. The length of this field is given by MQ_Q_NAME_LENGTH. The initial value of this field is determined by the environment:

On z/OS, the value is 'CSQ.*'.
On other platforms, the value is 'AMQ.*'.

The value is a null-terminated string in C, and a blank-padded string in other programming languages.