Work with MQ Topics (WRKMQMTOP)

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

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.

We 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.

Examples

None

Error messages

Unknown