z/OS batch considerations

z/OS batch programs that call the MQI can be in either supervisor or problem state.

• They must be in task mode, not service request block (SRB) mode.
• They must be in Primary address space control (ASC) mode (not Access Register ASC mode).
• They must not be in cross-memory mode. The primary address space number (ASN) must be equal to the secondary ASN and the home ASN.
• They must not be used as MPF exit programs.
• No z/OS locks can be held.
• There can be no function recovery routines (FRRs) on the FRR stack.
• Any program status word (PSW) key can be in force for the MQCONN or MQCONNX call (provided the key is compatible with using storage that is in the TCB key), but subsequent calls that use the connection handle returned by MQCONN or MQCONNX:
  • Must have the same PSW key that was used on the MQCONN or MQCONNX call
  • Must have parameters accessible (for write, where appropriate) under the same PSW key
  • Must be issued under the same task (TCB), but not in any subtask of the task

• They can be in either 24-bit or 31-bit addressing mode. However, if 24-bit addressing mode is in force, parameter addresses must be interpreted as valid 31-bit addresses.

If any of these conditions is not met, a program check might occur. In some cases the call will fail and a reason code will be returned. Parent topic: The Message Queue Interface overview