Home

 

Extended responses

 

Commands issued on z/OS generate extended responses only. There are three types of extended response:

• Message response, with type MQCFT_XR_MSG

• Item response, with type MQCFT_XR_ITEM

• Summary response, with type MQCFT_XR_SUMMARY

Each command may generate one, or more, sets of responses. Each set of responses comprises one or more messages, numbered sequentially from 1 in the MsgSeqNumber field of the PCF header. The Control field of the last (or only) response in each set has the value MQCFC_LAST. For all other responses in the set, this value is MQCFC_NOT_LAST.

Any response may include one, or more, optional MQCFBS structures in which the Parameter field is set to MQBACF_RESPONSE_SET, the value being a response set identifier. Identifiers are unique and identify the set of responses which contain the response. For every set of responses, there is an MQCFBS structure that identifies it.

Extended responses have at least two parameter structures:

• An MQCFBS structure with the Parameter field set to MQBACF_RESPONSE_ID. The value in this field is the identifier of the set of responses to which the response belongs. The identifier in the first set is arbitrary. In subsequent sets, the identifier is one previously notified in an MQBACF_RESPONSE_SET structure.

• An MQCFST structure with the Parameter field set to MQCACF_RESPONSE_Q_MGR_NAME, the value being the name of the queue manager from which the set of responses come.

Many responses have additional parameter structures, and these are described in Extended responses to Inquire commands, Extended responses to commands other than Inquire, and Extended responses to commands using CommandScope.

We cannot determine in advance how many responses there will be in a set other than by getting responses until one with MQCFC_LAST is found. Neither can you determine in advance how many sets of responses there will be as any set may include MQBACF_RESPONSE_SET structures to indicate that additional sets will be generated.

• Extended responses to Inquire commands
  

• Extended responses to commands other than Inquire
  

• Extended responses to commands using CommandScope
  

 

Parent topic:

Using Programmable Command Formats

pc10470_

 

Home