Previous Topic: MAXQTIME(nn)Next Topic: NODB


MSGEVENT(options)

The MSGEVENT control option is used to define the messages that CAIENF is to intercept and generate JOBFAIL events for.

If (action,prefix,type,desc,namecol,nbrcol) is not entered, the command presents a summary of all installation defined messages that CAIENF is to intercept and generate JOBFAIL events for.

The control option syntax and description are as follows:

MSGEVENT(action,prefix,type,desc,namecol,nbrcol)

Defines a message that CAIENF is to intercept and generate JOBFAIL events for. A MSGEVENT statement lets you create JOBFAIL events for messages that are issued by your installation exits. For example, a JES2 JCL converter internal text scan exit.

The MSGEVENT statement can be repeated once for each message (up to a maximum of 16 messages) that CAIENF is to intercept and generate JOBFAIL events for.

Options are:

action

DEFINE to define a JOBFAIL message or DELETE to delete a previously defined JOBFAIL message.

prefix

The message prefix. Must be at least 5 characters long and can be up to 16 characters long.

The first character must be alphabetic or numeric. The remaining characters must be alphabetic, numeric, or one of the special characters ($, #, @).

Must not be one of the default message prefixes that CAIENF always generates JOBFAIL events for (for example, IEF251I).

This option is required for all actions.

type

The JOBFAIL event type. Can be up to eight characters long. A user-defined type; there are no predefined values.

The first character must be alphabetic or numeric. The remaining characters must be alphabetic, numeric, or one of the special characters ($, #, @).

This option is required for the DEFINE action and is not allowed for the DELETE action.

desc

The JOBFAIL event description. Can be up to 40 characters long. If the description contains spaces or any special characters, the entire string must be enclosed in single quotes.

This option is required for the DEFINE action and is not allowed for the DELETE action.

namecol

The starting column number of the job name in the intercepted message. The value that is specified must be a decimal value from 0 to 128.

If the value specified is zero, the originating job name is used. Otherwise, the job name is set to the 8 bytes of message text beginning at the column specified.

Note: The originating job name can be spaces if the WTO is issued in SRB dispatching mode.

This option is required for the DEFINE action and is not allowed for the DELETE action.

nbrcol

The starting column number of the job number in the intercepted message. The value that is specified must be a decimal value from 0 to 128.

If the value specified is zero, the originating job number is used. Otherwise, the job number is set to the 8 bytes of message text beginning at the column specified.

Note: The originating job number can be spaces if the WTO is issued in SRB dispatching mode.

This option is required for the DEFINE action and is not allowed for the DELETE action.

JOBFAIL Messages

HASP105

HASP107

HASP119

HASP310

HASP396

HASP543

HASP608

HASP890

HASP913

IAT2628

IAT4801

IAT6815

ICH408I

IEF251I

IEF450I

IEF452I

IEF453I

IEF722I

IEFC452I

TSS7100E

TSS7145E