DELETE SUB

Use the MQSC command DELETE SUB to remove a durable subscription from the system. For a managed destination, any unprocessed messages left on the destination are removed.

UNIX and Linux®	Windows

Syntax diagram
Usage Notes
Parameter descriptions for DELETE SUB

Synonym: DEL SUB

DELETE SUB

Notes:

¹ Valid only on z/OS®.
² Valid only on z/OS when the queue manager is a member of a queue-sharing group.

Usage notes for DELETE SUB

You can specify either the name, the identifier, or both, of the subscription you want to delete.

Examples of valid forms:

  DELETE SUB(xyz)
  DELETE SUB SUBID(123)
  DELETE SUB(xyz) SUBID(123)

Parameter descriptions for DELETE SUB

subscription-name

The local name of the subscription definition to be deleted.

CMDSCOPE

This parameter applies to z/OS only and specifies how the command is executed when the queue manager is a member of a queue-sharing group.

CMDSCOPE must be blank, or the local queue manager, if QSGDISP is set to GROUP.

' ': The command is processed on the queue manager on which it was entered. This is the default value.
qmgr-name: The command is processed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.
You can specify a queue manager name other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.
*: The command is processed on the local queue manager and is also passed to every active queue manager in the queue-sharing group. The effect of this is the same as entering the command on every queue manager in the queue-sharing group.

You cannot use CMDSCOPE as a filter keyword.

SUBID(string)

The internal, unique key identifying a subscription.