EVENTS | NOEVENTS

Pragma equivalent

None.

Purpose

Produces an event file that contains error information and source file statistics.

Syntax

Defaults

NOEVENTS

Parameters

Sequential filename: Specifies the sequential data set file name for the event file.
Partitioned data set: Specifies the partitioned data set for the event file.
Partitioned data set (member): Specifies the partitioned data set (member) for the event file.
z/OS UNIX System Services filename: Specifies the z/OS® UNIX file name for the event file.
z/OS UNIX System Services directory: Specifies the z/OS UNIX System Services directory for the event file.

Usage

The compiler writes the events data to the DD:SYSEVENT ddname, if you allocated one before you called the compiler. If this ddname is not allocated, the compiler will allocate one dynamically using default characteristics (LRECL=4095,RECFM=V,BLKSIZE=4099), and the name is the source file name with SYSEVENT as the lowest-level qualifier. You can control the name by specifying the file name as the suboption of the EVENTS option.

If you specified a suboption, the compiler uses the data set that you specified, and ignores the DD:SYSEVENT.

There is no set requirement on the file characteristics for the event file. If you want to allocate an event file, you should specify a record length that is large enough to contain the longest message that the compiler can emit plus approximately 40 bytes for the control information.

If the source file is a z/OS UNIX file, and you do not specify the event file name as a suboption, the compiler writes the event file in the current working directory. The event file name is the name of the source file with the extension .err.

The compiler ignores #line directives when the EVENTS option is active, and issues a warning message.

For a description of the layout of the event file, see Layout of the Events file.

Predefined macros