WRKMQMTOP (Work with MQ Topics)

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

The Work with MQ Topics (WRKMQMTOP) command allows you to work with multiple topic objects that are defined on the local queue manager. This enables you to copy, change, display, delete, display authority, edit authority, record and recover an MQ topic object.

Parameters

Table 1. Command parameters
Keyword	Description	Choices	Notes
TOPNAME	Topic name	`Character value`, *ALL	Optional, Positional 1
MQMNAME	Message Queue Manager name	`Character value`, *DFT	Optional, Positional 2
WHERE	Filter command	Single values: *NONE Other values: `Element list`	Optional, Positional 3
	Element 1: Filter keyword	ALTDATE, ALTTIME, DFTMSGPST, DFTPTY, DFTPUTRESP, DURSUB, MGDDURMDL, MGDNDURMDL, NPMSGDLV, PMSGDLV, PUBENBL, SUBENBL, TEXT, TOPNAME, TOPICSTR, WILDCARD
	Element 2: Filter operator	GT, LT, EQ, NE, GE, LE, LK, NL, CT, EX, CTG, EXG
	Element 3: Filter value	Character value

Topic name (TOPNAME)

Specifies the name or names of the topic objects.

The possible values are:

*ALL

All topic objects are selected.

generic-topic-name

Specify the generic name of the MQ topic objects. A generic name is a character string followed by an asterisk (*). For example ABC*, it selects all topic objects having names that start with the character string.

You are recommended to specify the name required within quotation marks. Using this format ensures that your selection is precisely what you entered.

You cannot select all the uppercase and lowercase versions of a generic name on a single panel, without requesting all the names.

topic-name

Specify the name of the MQ topic object.

Message Queue Manager name (MQMNAME)

Specifies the name of the Queue Manager.

The possible values are:

*DFT: Use the default Queue Manager.
queue-manager-name: The name of a Queue Manager.

Filter command (WHERE)

This parameter can be used to selectively display only those topices with particular topic attributes.

The parameter takes three arguments, a keyword, an operator and a value.

Generic strings are allowed for values which are names.

The operator can take one of the following values:

*GT: Greater than.
Applicable to integer and non-generic string values.
*LT: Less than.
Applicable to integer and non-generic string values
*EQ: Equal to.
Applicable to integer and non-generic string values.
*NE: Not equal to.
Applicable to integer and non-generic string values.
*GE: Greater than or equal to.
Applicable to integer and non-generic string values.
*LE: Less than or equal to.
Applicable to integer and non-generic string values.
*LK: Like.
Applicable to generic string values.
*NL: Not like.
Applicable to generic string values.
*CT: Contains.
Applicable to non-generic list values.
*EX: Excludes.
Applicable to non-generic list values.
*CTG: Contains generic.
Applicable to generic list values.
*EXG: Excludes generic.
Applicable to generic list values.

The keyword can take one of the following values:

*ALTDATE

The date on which the object or information was last altered.

The filter value is the date in the form yyyy-mm-dd.

*ALTTIME

The time at which the object or information was last altered.

The filter value is the time in the form hh:mm:ss.

*DFTMSGPST

The default persistence for messages associated with this topic.

The filter value is one of the following:

*ASPARENT: Default persistence for messages is inherited from the parent topic.
*NO: Messages associated with this topic are lost across a restart of the queue manager.
*YES: Messages associated with this topic survive a restart of the queue manager.

*DFTPUTRESP

Default Put Response.

The filter value is one of the following:

*ASPARENT: The default response type is based on the setting of the first parent administrative node found in the topic tree relating to this topic.
*SYNC: Put operations to the queue that specify MQPMO_RESPONSE_AS_Q_DEF are issued as if MQPMO_SYNC_RESPONSE had been specified instead.
*ASYNC: Put operations to the queue that specify MQPMO_RESPONSE_AS_Q_DEF are always issued as if MQPMO_ASYNC_RESPONSE had been specified instead.

*DFTPTY

Default priority for messages associated with this topic.

The filter value is the integer priority value.

*DURSUB

Specifies whether the topic permits durable subscriptions.

The filter value is one of the following:

*ASPARENT: This topic behaves in the same way as the parent topic.
*NO: This topic does not permit durable subscriptions.
*YES: This topic does permit durable subscriptions.

*MGDDURMDL

The name of the model queue for managed durable subscriptions.

The filter value is the name of the queue.

*MGDNDURMDL

The name of the model queue for managed non-durable subscriptions.

The filter value is the name of the queue.

*NPMSGDLV

Specifies the delivery mechanism for non-persistent messages published to this topic.

The filter value is one of the following:

*ALL: All non-persistent messages are published to this topic.
*ALLDUR: All durable non-persistent messages are published to this topic.
*ALLAVAIL: All available non-persistent messages are published to this topic.
*ASPARENT: This topic behaves in the same way as the parent topic.

*PMSGDLV

Specifies the delivery mechanism for persistent messages published to this topic.

The filter value is one of the following:

*ALL: All persistent messages are published to this topic.
*ALLDUR: All durable persistent messages are published to this topic.
*ALLAVAIL: All available persistent messages are published to this topic.
*ASPARENT: This topic behaves in the same way as the parent topic.

*PUBENBL

Specifies whether the topic allows publications.

The filter value is one of the following:

*ASPARENT: This topic behaves in the same way as the parent topic.
*NO: This topic does not have publication enabled.
*YES: This topic does have publication enabled.

*SUBENBL

Specifies whether the topic allows subscriptions.

The filter value is one of the following:

*ASPARENT: This topic behaves in the same way as the parent topic.
*NO: This topic does not allow subscriptions.
*YES: This topic allows subscriptions.

*TEXT

Descriptive comment.

The filter value is the text description of the topic.

*TOPNAME

The name of the topic.

The filter value is the name of the topic.

*TOPICSTR

The topic string, used to identify the topic node.

The filter value is a character string.

*WILDCARD

Specifies the behavior of wildcard subscriptions with respect to this topic.

The filter value is one of the following:

*PASSTHRU: Subscriptions made to a wildcarded topic less specific than the topic string at this topic object will receive publications made to this topic and to topic strings more specific than this topic.
*BLOCK: Subscriptions made to a wildcarded topic less specific than the topic string at this topic object will not receive publications made to this topic or to topic strings more specific than this topic.