DEBUGUL parameter

From m204wiki
Jump to navigation Jump to search

User language debug options

Summary

Default value
X'00'
Parameter type
User
Where set
By any user
Related products
All
Introduced
Model 204 V6.1 or earlier

Description

Included procedures can accompany evaluation time Model 204 error messages

You can display the names of the procedures that were included up to the point of the evaluation time error on the audit trail or at your terminal.

The DEBUGUL settings and their effects are:

SettingDisplays procedure list...
X'20' After warning messages about truncation for User Language WITH operator string concatenations greater than 255 bytes
X'10' Debug messages on user's terminal in addition to audit trail.
X'08' After errors (other than counting errors) that terminate execution of the request
X'04' After counting errors that terminate execution of the request
X'02' After counting errors that do not terminate execution of the request
X'01' After informational messages
Any nonzero After a snap or a dump
X'00' Does not display procedure list

Usage

DEBUGUL and error messages display

When DEBUGUL is set to X'10', Model 204 forces the error message along with the DEBUGUL messages to the user's terminal regardless of the setting of MSGCTL. However, if an error message is normally suppressed from going to the user's terminal through the use of NOTERM (or by default it is not displayed), the DEBUGUL messages are suppressed regardless of the setting of DEBUGUL.

How the DEBUGUL parameter can override the MSGCTL parameter

If you have set the MSGCTL parameter to a value that suppresses the message, and set the DEBUGUL parameter to a value where the X'10' bit is on, the DEBUGUL parameter setting forces the message to the terminal, even though the MSGCTL parameter setting says not to.

How the MSGCTL command can override both the MSGCTL and DEBUGUL parameters

If you use the MSGCTL command, and suppress the display of a message by using the NOTERM keyword, then no matter how the MSGCTL or DEBUGUL parameters are set, the message does not go to the terminal. Conversely, if you want messages displayed at the terminal, enter a MSGCTL command using the following syntax:

MSGCTL {M204 | USER}.msg-number TERM

Where:

  • M204 or USER specifies a Model 204 or User defined message, respectively
  • msg-number is the 4-digit number of the message
  • TERM displays the specified error message on the user’s terminal, when appropriate

DEBUGUL parameter and QTBL size

Setting the DEBUGUL parameter to anything other than 0 significantly increases QTBL. Increases in STBL and VTBL are dependent on how many INCLUDEs the procedure does because of the storage described here:

Table nameStores
QTBL An extra word for every QUAD in the request
STBL Procedure names
VTBL Chain storage for file and procedure pointers

Usage in production

A UTABLE command can handle the additional space requirements before the request is compiled. Although there is a storage penalty for using the DEBUGUL parameter, there is no evaluation time penalty in CPU unless an error that you are debugging is reported on.

Rocket Software recommends

Set this parameter in User 0’s CCAIN only if the job is not set up to use subsystems (SYSOPT does not include the 1-bit setting). Procedures that are run for APSY subsystem initialization do not allow for the extra compiler table requirements needed when DEBUGUL is set.

  • If you are not using APSY, you can set DEBUGUL in the CCAIN.
  • If you are using APSY, you can set DEBUGUL:
    • On IODEV lines
    • In APSY subsystem login procedures
    • In user procedures