F,MSG,E or D — Enable or Disable the TQI Message Handler

Purpose

Use this command to disable or enable the TQI message handler for routing messages.

Format


>>-prefix--+-MODIFY-+--,MSG--+-,DISABLE-+----------------------><
           '-F------'        +-,D-------+   
                             +-,ENABLE--+   
                             '-,E-------'

prefix

is the prefix. With this command you must use one of the following prefixes rather than the prefix you use with most other commands:

bdt-char
BDT,node-name

bdt-char is a character defined during installation of BDT that routes commands directly to the BDT subsystem or, in a poly-BDT complex, to a specific BDT node. It is a 1-character special symbol (such as + or -).

When using BDT,node-name, substitute a node name for node-name.

Do not use a prefix when submitting commands in a batch job.

MSG

specifies the TQI message handler.

DISABLE or D

disables the message handler for routing messages.

ENABLE or E

enables the message handler for routing messages.

Usage Notes

You can use this command at two types of consoles only:
- The MCS console for the processor on which the TQI address space exists.
- A JES3 console. From a JES3 console, use the JES3 *SEND command to route this command to the processor on which the TQI address space exists.
For information on defining bdt-char, see z/OS BDT Installation
In most cases, BDT will disable the message handler automatically when it encounters errors. However, in some cases you will need to disable the message handler with this command. Your system programmer will tell you when to disable the message handler.
Use this command to enable the message handler again after an error disabling it has been fixed. Again, your system programmer will tell you when to enable the message handler.

Results

For DISABLE:

Messages will not be recorded on the message data set.
All messages will go to the BDT system log.
WTO messages will go to operators’ consoles.
BDT will attempt to route other messages to their destinations, but may not be successful.

BDT issues this message for DISABLE:

BDT2120 node-name MSG DISABLE COMMAND PROCESSED

For ENABLE, messages will be recorded on the message data set and will be routed to their usual destinations as well as to the BDT system log.

BDT issues this message for ENABLE:

BDT2120 node-name MSG ENABLE COMMAND PROCESSED

Examples of enabling/disabling the TQI message handler

From the MCS console, disable the message handler for routing messages. The bdt-char prefix is +.
```
+MODIFY,MSG,D
```
Result:
```
BDT2120 SPK01 MSG DISABLE COMMAND PROCESSED
```
From a JES3 console, enable the message handler for routing messages on processor SY1. The bdt-char prefix is +.
```
*SEND SY1 +MODIFY,MSG,E
```
Result:
```
BDT2120 SPK01 MSG ENABLE COMMAND PROCESSED
```