Change MQ Subscription (CHGMQMSUB)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Change MQ Subscription (CHGMQMSUB) command changes the specified attributes of an existing MQ subscription.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SUBID | Subscription identifier | Character value, *SAME | Optional, Key, Positional 2 |
| SUBNAME | Subscription name | Character value, *SAME | Optional, Key, Positional 1 |
| MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Key, Positional 3 |
| TOPICSTR | Topic string | Character value, *NONE, *SAME | Optional, Positional 4 |
| TOPICOBJ | Topic object | Character value, *NONE, *SAME | Optional, Positional 5 |
| DEST | Destination | Character value, *SAME | Optional, Positional 6 |
| DESTMQM | Destination Queue Manager | Character value, *NONE, *SAME | Optional, Positional 7 |
| DESTCRRLID | Destination Correlation Id | Character value, *NONE, *SAME | Optional, Positional 8 |
| PUBACCT | Publish Accounting Token | Character value, *NONE, *SAME | Optional, Positional 9 |
| PUBAPPID | Publish Application Id | Character value, *NONE, *SAME | Optional, Positional 10 |
| SUBUSER | Subscription User Id | Character value, *SAME | Optional, Positional 11 |
| USERDATA | Subscription User Data | Character value, *NONE, *SAME | Optional, Positional 12 |
| SELECTOR | Selector String | Character value, *NONE, *SAME | Optional, Positional 13 |
| PSPROP | PubSub Property | *SAME, *NONE, *COMPAT, *RFH2, *MSGPROP | Optional, Positional 14 |
| DESTCLASS | Destination Class | *SAME, *MANAGED, *PROVIDED | Optional, Positional 15 |
| VARUSER | Variable User | *SAME, *ANY, *FIXED | Optional, Positional 16 |
| REQONLY | Request Publications | *SAME, *YES, *NO | Optional, Positional 17 |
| PUBPTY | Publish Priority | 0-9, *SAME, *ASPUB, *ASQDEF | Optional, Positional 18 |
| WSCHEMA | Wildcard Schema | *SAME, *CHAR, *TOPIC | Optional, Positional 19 |
| EXPIRY | Expiry Time | 0-999999999, *SAME, *UNLIMITED | Optional, Positional 20 |
Subscription identifier (SUBID)
The subscription identifier of the subscription to be changed.
The possible values are:
- subscription-identifier
- Specify the 48 character hexadecimal string representing the 24 byte subscription identifier.
Subscription name (SUBNAME)
The name of the subscription to be changed.
The possible values are:
- subscription-name
- Specify a maximum of 256 bytes for the subscription name.
Note: Subscription names of greater than 256 bytes can be specified using MQSC.
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.
Topic string (TOPICSTR)
Specifies the topic string associated with this subscription.
The possible values are:
- topic-string
- Specify a maximum of 256 bytes for the topic string.
Note: Topic strings of greater than 256 bytes can be specified using MQSC.
Topic object (TOPICOBJ)
Specifies the topic object associated with this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- topic-object
- Specify the name of the topic object.
Destination (DEST)
Specifies the destination queue for messages published to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- destination-queue
- Specify the name of the destination queue.
Destination Queue Manager (DESTMQM)
Specifies the destination queue manager for messages published to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- No destination queue manager is specified.
- destination-queue
- Specify the name of the destination queue manager.
Destination Correlation Id (DESTCRRLID)
Specifies the correlation identifier for messages published to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- Messages are placed on the destination with a correlation identifier of MQCI_NONE.
- correlation-identifier
- Specify the 48 character hexadecimal string representing the 24 byte correlation identifier.
Publish Accounting Token (PUBACCT)
Specifies the accounting token for messages published to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- Messages are placed on the destination with an accounting token of MQACT_NONE.
- publish-accounting-token
- Specify the 64 character hexadecimal string representing the 32 byte publish accounting token.
Publish Application Id (PUBAPPID)
Specifies the publish application identity for messages published to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- No publish application identifier is specified.
- publish-application-identifier
- Specify the publish application identifier.
Subscription User Id (SUBUSER)
Specifies the user profile that owns this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- user-profile
- Specify the user profile.
Subscription User Data (USERDATA)
Specifies the user data associated with the subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- No user data is specified.
- user-data
- Specify a maximum of 256 bytes for user data.
Note: User data of greater than 256 bytes can be specified using MQSC.
Selector String (SELECTOR)
Specifies the SQL 92 selector string to be applied to messages published on the named topic to select whether they are eligible for this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- No selection string is specified.
- selection-string
- Specify a maximum of 256 bytes for selection string.
Note: Selection strings of greater than 256 bytes can be specified using MQSC.
PubSub Property (PSPROP)
Specifies the manner in which publish / subscribe related message properties are added to messages sent to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *NONE
- Publish / subscribe properties are not added to the message.
- *COMPAT
- Publish / subscribe properties are added to the message to maintain compatibility with IBM® MQ V6.0 Publish / Subscribe.
- *RFH2
- Publish / subscribe properties are added to the message within an RFH Version 2 header.
- *MSGPROP
- Publish / subscribe properties are added as message properties.
Destination Class (DESTCLASS)
Specifies whether this is a managed subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *MANAGED
- The destination is managed.
- *PROVIDED
- The destination is a queue.
Variable User (VARUSER)
Specifies whether user profiles other than the creator of the subscription can connect to it (subject to topic and destination authority checks).
The possible values are:
- *SAME
- The attribute is unchanged.
- *ANY
- Any user profiles can connect to the subscription.
- *FIXED
- Only the user profile that created the subscription can connect to it.
Request Publications (REQONLY)
Specifies whether the subscriber will poll for updates via MQSUBRQ API, or whether all publications are delivered to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *YES
- Publications are only delivered to this subscription in response to an MQSUBRQ API.
- *NO
- All publications on the topic are delivered to this subscription.
Publish Priority (PUBPTY)
Specifies the priority of the message sent to this subscription.
The possible values are:
- *SAME
- The attribute is unchanged.
- *ASPUB
- The priority of the message sent to this subscription is taken from that supplied in the published message.
- *ASQDEF
- The priority of the message sent to this subscription is taken from the default priority of the queue defined as the destination.
- priority-value
- Specify a priority ranging from 0 through 9.
Wildcard Schema (WSCHEMA)
Specifies the schema to be used when interpreting wildcard characters in the topic string.
The possible values are:
- *SAME
- The attribute is unchanged.
- *TOPIC
- Wildcard characters represent portions of the topic hierarchy.
- *CHAR
- Wildcard characters represent portions of strings.
Expiry Time (EXPIRY)
Specifies the expiry time of the subscription. After a subscription's expiry time has elapsed, it becomes eligible to be discarded by the queue manager and will receive no further publications.
The possible values are:
- *SAME
- The attribute is unchanged.
- *UNLIMITED
- The subscription does not expire.
- expiry-time
- Specify an expiry time in tenths of a second ranging from 0 through 999999999.
Examples
None
Error messages
Unknown