Previous Topic: LOCATENext Topic: MCOUSR

CA JCLCheck Runtime Options › Description of Runtime Options › MCOSYS

MCOSYS

The MCOSYS option enables you to specify the data set name of a system message control option file; you can also specify a member name. The system message control option file is a text file that specifies message numbers and severities to be used instead of severities specified in the JCLMSG file. This file is dynamically allocated by CA JCLCheck.

This option has the following format:

MCOSys(datasetname[,membername]) | NOMCOSys
datasetname

Specifies the data set name of the message control file to be processed. This file must point to an existing sequential file that contains a logical record length of 80.

membername

Specifies the optional member name of the message control file to be processed. This file must point to an existing sequential file that contains a logical record length of 80.

The format of every line in the system message control option file is:

messagenumber,messageseverity
messagenumber

Indicates the error message number. The messagenumber must be present in columns 1-3. The messagenumber must be numeric and a valid CA JCLCheck message number in the range of 001-999.

Column 4 must contain a comma.

messageseverity

Indicates the message severity used when the message is issued in CA JCLCheck. The messageseverity must be present in columns 5-6. A messageseverity of -1 indicates the message is to be suppressed.

The messageseverity must be numeric and within a range of -1 through 15 as shown below:

-1        Suppress the message
00 - 03   Informational severity
04 - 07   Warning severity
08 - 11   Error severity
12 - 15   Serious error severity

The messagenumber and messageseverity must be separated by a comma. If the line starts with an asterisk (*) in column 1, it is considered to be a comment. Entries can be input in any sequence; duplicate entries are overwritten. Invalid entries result in an error. Any matching entries will be modified and unmatched entries will be added in this sequence.

While processing a message, the following order of precedence is used to establish the message severity:

  1. JCLMSG (out of the box or as modified by USERMOD MZ2C023)
  2. JCLCheck program that issues the message
  3. MCOSYS (if option specified)
  4. MCOUSR (if option specified)
  5. CAZ1REXX or REXX EXEC specified in the STDREXX option (if REXXMSG option is specified)
  6. CAZ1XERR (if option specified; out of the box retains all messages or as modified by USERMOD MZ1C030)

Additionally, you can elect to use the current Option Exclusion List feature (CAZ2JOEL) to disable this option, or the MCOUSR option.

Note: For more information on the Option Exclusion List feature (CAZ2JOEL), see Installation Options in the Programming Guide. For more information on the user exit CAZ1XERR, see User Exits in the Programming Guide.