Parameters for Basic Interfaces › TSO-related Parameters › TSODEST Parameter

TSODEST Parameter

This parameter specifies the default destination of messages generated by commands sent to servers through ADDRESS TSO clauses in AOF rules. TSODEST is valid only when the CA OPS/MVS message has one of these severity levels: I (informational), W (warning), E (error), or S (severe error).

Default value:

X'0000000000000000'

Other possible values:

Any valid destination, expressed as hexadecimals

To specify a value for TSODEST, it may be helpful for you to think of the value as 8 bytes of information.

These 8 bytes break down as follows:

• The first byte can be either C3, which is the hexadecimal representation of the character C; or C2, which is the hexadecimal representation of the character B.
  • If you specify C3, the messages are sent to the specified console (that is, the console specified by the fourth byte of the TSODEST value) and also to OPSLOG Browse.
  • If you specify C2, the messages are sent to OPSLOG Browse only, and the second through eighth bytes of the TSODEST value are ignored.
• The second byte of the TSODEST value is reserved; this value should always be 00.
• The third byte of the TSODEST value indicates the MCS flags code. There are two values you can specify for this byte: 00 (for X'00') indicating that the messages should be queued for the console and hard copy; and 02 (for X'02') indicating the messages should be queued for hard copy only.

  Note: The integer value of X'02' is 7; the OPSBITS() character string that corresponds to this value is HRDCPY.

• The fourth byte indicates the default console ID. You can specify a console ID from 00 to 99, but you must represent it as hexadecimals (the decimal values 00 through 99 are equivalent to the hexadecimal values X'00' through X'63').
• The fifth and sixth bytes indicate the default routing codes for the messages. The routing codes that you specify here are the same as the routing codes that you may specify for the TSOROUTE parameter. For more information, see TSOROUTE Parameter in this chapter. In other words, if you use the TSOROUTE parameter to set default routing codes for TSO messages and then later use bytes 5 and 6 of the TSODEST value to set different routing codes, the values you set last override the earlier settings. The opposite is also true. For a list of routing codes and their descriptions, see TSOROUTE Parameter in this chapter.
• The seventh and eighth bytes indicate the default descriptor codes for the messages. The descriptor codes that you specify here are the same as those that you may specify for the TSODESC parameter. For more information, see TSODESC Parameter in this chapter. In other words, if you use the TSODESC parameter to set default descriptor codes for TSO messages and then later use bytes 7 and 8 of the TSODEST value to set different descriptor codes, the values you set last override the earlier settings. The opposite is also true. For a list of descriptor codes and their descriptions, see TSODESC Parameter in this chapter.

Set or modify this parameter: Anytime

Example: TSODEST

This function sends messages resulting from commands sent to TSO to console 5:

OPSPRM('SET','TSODEST','C300000500000000')