Classic Format

By default, log entry types supported prior to level 2.0 of the interface software are sent in the same “classic” format as they were sent in prior levels. These formats are shown in this section.

If you specify the option LOG_COMPATIBILITY 2 following the major,minor type of a previously supported log entry in the filter file or a FILTER ADD command, the interface software sends the log information to Operations Sentinel in the Job Formatter format, rather than the classic format. Refer to 3.3 and 5.2.2. For some log types, Job Formatter format includes additional fields not supplied in the classic format.

Major Type 1, Minor Types 1–4

These messages are generated when jobs and tasks start and stop on an MCP host system, as summarized in this table:

Code	Major, Minor Type	Description
BOJ	1,1	Beginning of a job
EOJ	1,2	End of a job
BOT	1,3	Beginning of a task
EOT	1,4	End of a task

Format

jobnum/tasknumjobname {BOJ|BOT} [usercode]
jobnum/tasknumjobname {EOJ|EOT} termination-status [usercode]

where:

jobnum

is the job number of the MCP process associated with the log entry.

tasknum

is the task number of the MCP process associated with the log entry.

jobname

is the job name of the MCP process associated with the log entry.

termination-status

is a string included in the EOJ and EOT messages explaining the reason for termination of the job or task. The following list shows the job and task termination status strings:

NORMAL Normal job or task termination
?-DS Discontinued reason is not known because the history was not set.
	A-DS Discontinued because of invalid job attributes.
D-DS Data comm was discontinued.
E-DS Discontinued because of data error.
F-DS Discontinued because of a fault error (for example, a divide by
			zero or segmented array error).
I-DS Discontinued because of an I/O error.
N-DS Discontinued because of a network error.
O-DS Discontinued by the operator.
P-DS Programmatically discontinued.
Q-DS Discontinued because the job failed queue insertion.
R-DS Discontinued because of a resource limitation (for example, a
			print limit exceeded or stack overflow).
S-DS Discontinued by the system.

is the usercode associated with the log entry. This information can be useful for automating alarms and for other actions.

For compatibility with previous levels of the interface software, the usercode is included only if the statements LOG_COMPATIBILIY 1 and LOG_JOB_USERCODE YES are included in the configuration file. See Section 3. By default, LOG_JOB_USERCODE is NO. Note that the usercode is also available when you specify LOG_COMPATIBILIY 2 in the configuration file, but doing so causes the interface software to produce all messages in Job Formatter format (see 6.3.1), which might require extensive pattern changes in your existing SP-AMS databases.

Major Type 2, Minor Type 12

These messages indicate where in the mainframe hardware an error occurred and the type of error.

Format

MAINFRAME ERROR hhmmss Box type: box-type
BOX NUMBER: number-of-box ERROR TYPE: error-type

where:

hhmmss

is the time of the error.

box-type

is the name of the hardware subsystem where the error occurred. These are the possible box types:

CPM
IOP
MCM
MEMORY
MDP
MSM
AUX
HDU
AUX IOP
RMM
UNKNOWN

number-of-box

is the number assigned to the hardware where the error occurred.

error-type

is the description of the type of error. These are the possible error types:

CPM INTERRUPT
IOP INTERRUPT
MEM INTERRUPT
SYSTEM ERROR
MF EVENT
SYSTEM RECONFIGURATION
BOX ERROR
FSM
TCP ERROR
RMM ERROR

Major Type 2, Minor Type 20

These messages specify the processor where an error occurred, the type of error, and the job number and task number associated with the error.

Format

jobnum/tasknum PROCESSOR ERROR       error-type  processor-number

where:

jobnum

is the job number of the MCP process associated with the log entry.

tasknum

is the task number of the MCP process associated with the log entry.

error-type

is the type of error. The two possible values are ERROR THRESHOLD and HARD CORRECTABLE.

processor-number

is the number of the processor where the error occurred.

Major Type 2, Minor Type 21

These messages indicate the input/output (I/O) unit where an I/O exception error occurred, the type of error, and the job number and task number associated with the error.

Format

jobnum/tasknum UNIT NUMBER:       unitnum

where:

jobnum

is the job number of the MCP process associated with the log entry.

tasknum

is the task number of the MCP process associated with the log entry.

unitnum

is the number of the I/O unit where the error occurred.

Major Type 3, Minor Type All

These are RSVP and information messages. Minor types 1 and 9 are RSVP messages. An RSVP message is a message generated on the host system when it requires information about an operation. The host process waits for a reply before proceeding.

Format

          jobnum/tasknum jobname       message

where:

jobnum

is the job number of the MCP process associated with the log entry.

tasknum

is the task number of the MCP process associated with the log entry.

jobname

is the job name of the MCP process associated with the log entry. In the case of a non-RSVP message, the jobname appears as UNKNOWN.

message

is an alphanumeric message with a variable format. Its content and format are defined by the master control program (MCP) or other host system application processes. See the MCP System Messages Support Reference Manual for a selection of MCP host system messages.

The default filter file includes type 14,ALL . If you add type 3,ALL to the filter file without removing type 14,ALL, the interface software will report some messages twice, with slightly different formats.

Major Type 6, Minor Type 3

These messages result from an MCP operator redirecting an I/O waiting entry using the Ignore Label (IL), Output Unit (OU), Unlabeled (UL), or Form Message (FM) command.

Format

MESSAGE:7MIX=mixnum I/O REDIRECTED TO {MT I PK I LP}=unitnum

where:

mixnum

is the MCP program mix number.

MT, PK, or LP

is the type of the I/O unit, where MT is Magnetic Tape, PK is Disk Pack, and LP is Line Printer.

unitnum

is the I/O unit number.

Major Type 14, Minor Type All

These are RSVP and information messages that result from a Multilingual System (MLS) entry in the host system log. Minor types 1, 9, and 10 are RSVP messages.

An RSVP message is a message generated on the host system when it requires information about an operation. The host process waits for a reply before proceeding.

Format

jobnum/tasknum jobname      message

where:

jobnum

is the job number of the MCP process associated with the log entry.

tasknum

is the task number of the MCP process associated with the log entry.

jobname

is the job name of the MCP process associated with the log entry. In the case of a non-RSVP message, the jobname appears as UNKNOWN.

message

is alphanumeric text with a variable format. Its content and format is defined by the master control program (MCP) or other host application processes. See the MCP System Messages Support Reference Manual for a selection of MCP host system messages.

The default filter file includes type 14,ALL. If you add type 3,ALL to the filter file without removing type 14,ALL, the interface software will report some messages twice, with slightly different formats.

Major Type 15, Minor Types 1, 2, 3, and 5

These messages contain status information for tape units, disk units, and printers.

Major Type 15 messages are generated by the host system when the following events happen:

Disk families or tape units are brought online.
Disk families or tape units are dropped offline.
Tape volumes are purged.
New tape labels (volumes) are created.
New disk labels (volumes) are created.

The following formats are for the messages derived from type15 log entries. The information in the message varies depending on the event.

STATUS TAPE: MT=numeric
							WRITE-ENABLED={Y | N | blank}
							SERIAL-NUMBER={ alphanumeric | blank}
							STATUS={OFFLINE  ONLINE  SAVED  READY  RESERVED  FREED 
								INUSE}
							TAPE-NAME={ alphanumeric | blank}
							VOLUME-SCRATCH={Y | N | blank}
							TAPE-DENSITY={ numeric | blank}

STATUS PACK: PK=numeric
							PACK-TYPE={B | I | C | U}
							FAMILY-SERIAL-NUMBER={ numeric [:numeric] | blank}
							FAMILY-INDEX={ numeric | blank}
							STATUS={FREED  RESERVED  SAVED  CLOSED  NOTREADY  ONLINE |
								SCRATCH  UNLABELED  UNINITIALIZED  DUPSERIALNO  BLASTED |
								LABELERROR}
							FAMILY-NAME={ alphanumeric | blank}
							MIRRORED={Y | N | blank}

STATUS PRINTER: LP=numeric,
							STATUS={OFFLINE | ONLINE | SAVED | RESERVED | READY | INUSE}

Notes:

In the STATUS TAPE message, the SERIAL-NUMBER can be one to six characters in length.
In the STATUS PACK message, each numeric value in the FAMILY-SERIALNUMBER can be one to six characters in length.