ObjectName (MQCHAR48)

This is the name of the topic object as defined on the local queue manager.

• 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 can contain trailing blanks. Use a null character 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 z/OS :
  • Avoid names that begin or end with an underscore; they cannot be processed by the operations and control panels.
  • The percent character has a special meaning to RACF . If RACF is used as the external security manager, names must not contain the percent. If they do, those names are not included in any security checks when RACF generic profiles are used.

• On IBM i, 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 ObjectName is used to form the full topic name.

The full topic name can be built from two different fields: ObjectName and ObjectString. For details of how these two fields are used, see Use topic strings.

If the object identified by the ObjectName field cannot be found, the call fails with reason code MQRC_UNKNOWN_OBJECT_NAME even if there is a string specified in ObjectString.

On return from an MQSUB call using the MQSO_RESUME option this field is unchanged.

The length of this field is given by MQ_TOPIC_NAME_LENGTH. The initial value of this field is the null string in C, and 48 blank characters in other programming languages.

If altering an existing subscription using the MQSO_ALTER option, the name of the topic object subscribed to cannot be changed. This field and the ObjectString field can be omitted. If they are provided, they must resolve to the same full topic name. If they do not, the call fails with MQRC_TOPIC_NOT_ALTERABLE.