Home

 

Optional parameters

QMgrName

name:

"MQPSQMgrName"   (string constant: MQPS_Q_MGR_NAME)

value:

The subscriber's queue manager name.

The default is the ReplyToQMgr name in the message descriptor (MQMD). If the resulting name is blank, it matches a publisher with a blank queue manager name (that is, local to the broker).

QName

name:

"MQPSQName"   (string constant: MQPS_Q_NAME)

value:

The subscriber's queue name.

The default is the ReplyToQ name in the message descriptor (MQMD), which must not be blank in this case.

RegistrationOptions

name:

"MQPSRegOpts"   (string constant: MQPS_REGISTRATION_OPTIONS)

value:

The following registration options can be specified:

"CorrelAsId"  

(string constant: MQPS_CORREL_ID_AS_IDENTITY, integer constant: MQREGO_CORREL_ID_AS_IDENTITY)

The CorrelId in the message descriptor (MQMD), which must not be zero, is part of the subscriber's identity.

"VariableUserId"  

(string constant: MQPS_VARIABLE_USER_ID, integer constant: MQREGO_VARIABLE_USER_ID)

If the subscription of the request update command has VariableUserId set, this must be set when the Request Update is sent to indicate which subscription is referred to. Otherwise, the userid of the Request Update command is used to identify the subscription. This is overridden (along with the other subscriber identifiers) if a subscription name is supplied.

If VariableUserId is set and the userid differs from that of the subscription, the command succeeds only if the userid of the new command message has authority to browse the stream queue, and put authority to the subscriber queue of the subscription (that is, existing Publish/Subscribe authority check for a subscriber), otherwise it fails.

StreamName

name:

"MQPSStreamName"   (string constant: MQPS_STREAM_NAME)

value:

The name of the publication stream for the specified Topic(s).

The default value is SYSTEM.BROKER.DEFAULT.STREAM.

SubName

name:

"MQPSSubName"   (string constant: MQPS_SUBSCRIPTION_NAME)

value:

The subscription name.

The SubName value takes precedence over all other identifier fields except the userid unless VariableUserId is set on the subscription itself.

If a subscription exists that matches the traditional identity of this command, but has no SubName, the Request Update command fails.

If an attempt is made to request an update for a subscription that has a SubName using a command message that matches the traditional identity, but with no SubName specified, the command succeeds.

 

Home