Refresh Queue Manager

Use the Refresh Queue Manager (MQCMD_REFRESH_Q_MGR) command to perform special operations on queue managers.

HP Integrity NonStop Server	UNIX and Linux®	Windows
X	X	X

Required parameters

RefreshType (MQCFIN)

Type of information to be refreshed (parameter identifier: MQIACF_REFRESH_TYPE).

Use this parameter to specify the type of information to be refreshed. The value can be:

MQRT_CONFIGURATION

MQRT_CONFIGURATION causes the queue manager to generate configuration event messages for every object definition that matches the selection criteria specified by the ObjectType, ObjectName, and RefreshInterval parameters.

A Refresh Queue Manager command with a RefreshType value of MQRT_CONFIGURATION is generated automatically when the value of the queue manager's ConfigurationEvent parameter changes from MQEVR_DISABLED to MQEVR_ENABLED.

Use this command with a RefreshType of MQRT_CONFIGURATION to recover from problems such as errors on the event queue. In such cases, use appropriate selection criteria, to avoid excessive processing time and event message generation.

MQRT_EXPIRY

This requests that the queue manager performs a scan to discard expired messages for every queue that matches the selection criteria specified by the ObjectName parameter.

Note: Valid only on z/OS.

MQRT_PROXYSUB

Requests that the queue manager resynchronizes the proxy subscriptions that are held with and on behalf of queue managers that are connected in a hierarchy or a publish/subscribe cluster.

You must resynchronize the proxy subscriptions only in exceptional circumstances, for example, when the queue manager is receiving subscriptions that it must not be sent, or not receiving subscriptions that it must receive. The following list describes some of the exceptional reasons for resynchronizing proxy subscriptions:

Disaster recovery.
Problems that are identified in a queue manager error log where messages inform of the issuing of the REFRESH QMGR TYPE(REPOS) command.
Operator errors, for example, issuing a DELETE SUB command on a proxy subscription.

Missing proxy subscriptions can be caused if the closest matching topic definition is specified with Subscription scope set to Queue Manager or it has an empty or incorrect cluster name. Note that Publication scope does not prevent the sending of proxy subscriptions, but does prevent publications from being delivered to them.

Extraneous proxy subscriptions can be caused if the closest matching topic definition is specified with Proxy subscription behavior set to Force.

Missing or extraneous proxy subscriptions that are due to configuration errors are not changed by issuing a resynchronization. A resynchronization does resolve missing or extraneous publications as a result of the exceptional reasons listed.

Optional parameters (Refresh Queue Manager)

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE).

Specifies how the command is executed when the queue manager is a member of a queue-sharing group. You can specify one of the following:

blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, you must be using a queue-sharing group environment, and the command server must be enabled.
an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

ObjectName (MQCFST)

Name of object to be included in the processing of this command (parameter identifier: MQCACF_OBJECT_NAME).

Use this parameter to specify the name of the object to be included in the processing of this command.

Generic names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all objects having names that start with the selected character string. An asterisk on its own matches all possible names.

The maximum length is MQ_OBJECT_NAME_LENGTH.

ObjectType (MQCFIN)

Object type for which configuration data is to be refreshed (parameter identifier: MQIACF_OBJECT_TYPE).

Use this parameter to specify the object type for which configuration data is to be refreshed. This parameter is valid only if the value of RefreshType is MQRT_CONFIGURATION. The default value, in that case, is MQOT_ALL. The value can be one of:

MQOT_AUTH_INFO: Authentication information object.
MQOT_CF_STRUC: CF structure.
MQOT_CHANNEL: Channel.
MQOT_CHLAUTH: Channel authentication
MQOT_LISTENER: Listener.
MQOT_NAMELIST: Namelist.
MQOT_PROCESS: Process definition.
MQOT_Q: Queue.
MQOT_LOCAL_Q: Local queue.
MQOT_MODEL_Q: Model queue.
MQOT_ALIAS_Q: Alias queue.
MQOT_REMOTE_Q: Remote queue.
MQOT_Q_MGR: Queue manager.
MQOT_CFSTRUC: CF structure.
MQOT_SERVICE: Service.
Note: Not valid on z/OS.
MQOT_STORAGE_CLASS: Storage class.
MQOT_TOPIC: Topic name.

RefreshInterval (MQCFIN)

Refresh interval (parameter identifier: MQIACF_REFRESH_INTERVAL).

Use this parameter to specify a value, in minutes, defining a period immediately before the current time. This requests that only objects that have been created or altered within that period (as defined by their AlterationDate and AlterationTime attributes) are included.

Specify a value in the range zero through 999 999. A value of zero means there is no time limit (0 is the default).

This parameter is valid only if the value of RefreshType is MQRT_CONFIGURATION.