[IBM i]

RFRMQM (Refresh Message Queue Manager)

The Refresh Message Queue manager (RFRMQM) performs special operations on queue managers.

Where allowed to run
All environments (*ALL)
Threadsafe
Yes

Parameters

Table 1. Command parameters
Keyword Description Choices Notes
MQMNAME Message Queue Manager name Character value, *DFT Required, Positional 1
TYPE Refresh Type *CONFIGEV, *PROXYSUB Required, Positional 2
OBJECT Object Type *ALL, Specified objects Optional, Positional 3
NAME Object Name *ALL, generic- object-name, object-name Optional, Positional 4
INCLINT Include Interval *NONE, include- interval Optional, Positional 5

Message Queue Manager name (MQMNAME)

Specifies the name of the queue manager.

*DFT
Use the default queue manager.
queue_manager_name
Specify the name of the queue manager.

Refresh Type (TYPE)

The type of queue manager refresh to be performed.

The possible values are:

*CONFIGEV
Requests that the queue manager generates a configuration event message for every object that matches the selection criteria specified by the OBJECT, NAME, and INCLINT parameters.
*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 publish/subscribe cluster.

Object Type (OBJECT)

Requests that only objects of the specified type are included in the refresh.

This parameter is only valid for TYPE(*CONFIGEV)

The possible values are:

*ALL
All specified objects.
Specific objects
Select from:
  • *QUEUE
  • *QLOCAL
  • *QMODEL
  • *QALIAS
  • *QREMOTE
  • *CHANNEL
  • *NAMELIST
  • *POLICY
  • *PROCESS
  • *QMGR
  • *AUTHINFO
  • *AUTHREC

Object Name (NAME)

Requests that only objects whose names match the name specified are included in the refresh.

This parameter is only valid for TYPE(*CONFIGEV)

The possible values are:

*ALL
All object names are included.
generic-object-name
Specify the generic name of the objects to be included. A generic name is a character string, followed by an asterisk (*), for example ABC*, and it selects all queues having names that start with the character string.
object-name
Specify the object name to be included.

Include Interval (INCLINT)

Specifies a value in minutes, defining a period immediately before the current time, and requests that only objects that have been created or changed within that period are included in the refresh.

This parameter is only valid for TYPE(*CONFIGEV)

The possible values are:

*NONE
No time limit is used.
include-interval
Specify the include interval in minutes (0-999999).