ODON (48-byte character string)
Object name.
This is the local name of the object as defined on the queue manager identified by ODMN. The name can contain the following characters:
- Uppercase alphabetic characters (A through Z)
- Lowercase alphabetic characters (a through z)
- Numeric digits (0 through 9)
- Period (.), forward slash (/), underscore (_), percent (%)
The name must not contain leading or embedded blanks, but may contain trailing blanks. A null character can be used to indicate the end of significant data in the name; the null and any characters following it are treated as blanks. The following restrictions apply in the environments indicated:
- On systems that use EBCDIC Katakana, lowercase characters cannot be used.
- On i5/OS, names containing lowercase characters, forward slash, or percent, must be enclosed in quotation marks when specified on commands. These quotation marks must not be specified for names that occur as fields in structures or as parameters on calls.
The following points apply to the types of object indicated:
- If ODON is the name of a model queue, the queue manager creates a dynamic queue with the attributes of the model queue, and returns in the ODON field the name of the queue created. A model queue can be specified only on the MQOPEN call; a model queue is not valid on the MQPUT1 call.
- If the object being opened is a distribution list (that is, ODREC is present and greater than zero), ODON must be blank or the null string. If this condition is not satisfied, the call fails with reason code RC2152.
- If ODOT is OTQM, special rules apply; in this case the name must be entirely blank up to the first null character or the end of the field.
This is an input/output field for the MQOPEN call when ODON is the name of a model queue, and an input-only field in all other cases. The length of this field is given by LNQN. The initial value of this field is 48 blank characters.