MQOO_RESOLVE_NAMES" /> Object attributes

 

Object attributes

alteration date

The alteration date. This attribute is read-only.

alteration time

The alteration time. This attribute is read-only.

alternate user id

The alternate user id, up to MQ_USER_ID_LENGTH characters. The initial value is a null string.

alternate security id

The alternate security id. A binary value (MQBYTE40) of length MQ_SECURITY_ID_LENGTH. The initial value is MQSID_NONE.

close options

Options that apply when an object is closed. The initial value is MQCO_NONE. This attribute is ignored during implicit reopen operations, where a value of MQCO_NONE is always used.

connection reference

A reference to an Manager object that provides the required connection to a (local) queue manager. For an Manager object, it is the object itself. The initial value is zero.
Note:
Do not confuse this with the queue manager name that identifies a queue manager (possibly remote) for a named queue.

description

The descriptive name (up to 64 characters) of the queue manager, queue, namelist, or process. This attribute is read-only.

name

The name (up to 48 characters) of the queue manager, queue, namelist, or process. The initial value is a null string. The name of a model queue changes after an open to the name of the resulting dynamic queue.
Note:
An Manager can have a null name, representing the default queue manager. The name changes to the actual queue manager after a successful open. An ImqDistributionList is dynamic and must have a null name.

next managed object

This is the next object of this class, in no particular order, having the same connection reference as this object. The initial value is zero.

open options

Options that apply when an object is opened. The initial value is MQOO_INQUIRE. There are two ways to set appropriate values:

  1. Do not set the open options and do not use the open method. WebSphere MQ automatically adjusts the open options and automatically opens, reopens, and closes objects as required. This can result in unnecessary reopen operations, because WebSphere MQ uses the openFor method, and this adds open options incrementally only.

  2. Set the open options before using any methods that result in an MQI call (see Appendix B. MQI cross reference). This ensures that unnecessary reopen operations do not occur. Set open options explicitly if any of the potential reopen problems are likely to occur (see Reopen).

    If you use the open method, ensure that the open options are appropriate first. However, using the open method is not mandatory; WebSphere MQ still exhibits the same behavior as in case 1, but in this circumstance, the behavior is efficient.

Zero is not a valid value; set the appropriate value before attempting to open the object. This can be done using eithersetOpenOptions( lOpenOptions ) followed by open( ), or openFor( lRequiredOpenOption ).

Notes:

  1. MQOO_OUTPUT is substituted for MQOO_INQUIRE during the open method for a distribution list, as MQOO_OUTPUT is the only valid open option at this time. However, it is good practice always to set MQOO_OUTPUT explicitly in application programs that use the open method.

  2. Specify MQOO_RESOLVE_NAMES if you want to use the resolved queue manager name and resolved queue name attributes of the class.

open status

Whether the object is open (TRUE) or closed (FALSE). The initial value is FALSE. This attribute is read-only.

previous managed object

The previous object of this class, in no particular order, having the same connection reference as this object. The initial value is zero.

queue manager identifier

The queue manager identifier. This attribute is read-only.