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.