MESSAGE_LEVEL - UAG configuration option
Description
The MESSAGE_LEVEL option specifies the level of messages to write.
Usage
Method | Syntax | IBM i | HP NonStop | UNIX | Windows | z/OS |
---|---|---|---|---|---|---|
Configuration File Keyword | message_level level |
Values
level is the level of messages to write.
Valid values for level are:
- trace
Writes trace messages used for diagnostic purposes (see #Trace Files).
Note
Use trace only as directed by Stonebranch, Inc. Customer Support.
- audit
Writes audit, informational, warning, and error messages. - info
Writes informational, warning, and error messages. - warn
Writes warning and error messages. - error
Writes error messages only.
Default is info.
Trace Files
UNIX
The trace file is created in the directory /var/opt/universal/trace.
Windows
The trace file is created in the installation directory of Universal Automation Center Agent, which defaults to:
C:\Program Files\Universal\uag
z/OS
There are two possible destinations of the trace data:
- If ddname UNVTRMDL is defined in the UBROKER started task procedure, a sequential data set is created using the data set allocated to UNVTRMDL as a model.
The dynamically allocated trace data set name is #HLQ.UBR.Dyymmdd.Thhmmss, where:- #HLQ is the data set name allocated on the UNVTRMDL ddname.
- yymmdd is the year, month, and day.
- hhmmss is the hour, minute, second the data set was allocated.
The amount of space allocated for trace data sets modeled after UNVTRMDL is based upon the TRACE_FILE_LINES configuration option and the record format of the model data set. If the model data set is fixed record format, the total amount of space measured in bytes is TRACE_FILE_LINES *LRECL. If the model data set is variable record format, the total amount of space measured in bytes is TRACE_FILE_LINES * 50 (50 is considered the average length of a trace file record).
The number of cylinders is calculated from the total amount of space in bytes. The total number of cylinders is calculated base on a total of 16 extents being allocated.
The formula is cylCount = (totalSize / 16) / 760000.
The allocation unit is set to cylinders and the primary and secondary space allocation is set to cylCount (that is, SPACE=(CYL,(cylCount,cylCount),RLSE)).
- If ddname UNVTRMDL is not defined in the UBROKER started task procedure, member name UBROKER is created in the PDS or PDS/E allocated to the UNVTRACE ddname.
Depending on the error condition being diagnosed, it is possible that the member name of the UNVTRACE PDS or PDS/E is not created. If this occurs, the UNVTRMDL ddname must be used to create a sequential data set name.
The records written to PDS and PDS/E members cannot be wrapped, so the TRACE_FILE_LINES limit has no effect on the maximum number of trace records written to the member.