Job Management Partner 1/Software Distribution Client Description and User's Guide

8.2.3 JP1 events issued by the distributor tools

Table 8-11 shows JP1 events issued by the distributor tools.

Table 8-11 JP1 event list (distributor tools)

Event ID	Event name	When the event is issued
00010302	Job completion event	If the job execution result is COMPLETE when the result-reporting file or the status information file is received.
00010303		If the job execution result is ERROR when the result-reporting file or the status information file is received.
00010304		If the job execution result is INS-WAIT when the result-reporting file or the status information file is received.
00010301	Server malfunction event	When the processing server for the distributor tools terminated abnormally. This event reports a severe error, since abnormal termination of the processing server disables package distribution.
00000000	Messages	All messages output by the distributor tools are reported as JP1 events. Messages output to the log file are also reported as JP1 events.

The following explains the contents of each type of JP1 event issued by distributor tools. In addition, at JP1 events issued for JP1/Base, Severity is set as both an extended attribute and a main attribute. The severity of each event is displayed in the viewer of the integrated console.

Organization of this subsection

(1) Job completion event

(2) Server malfunction events

(1) Job completion event

Table 8-12 shows the attributes of the event issued by the distributor tools to reports job completion. Table 8-13 shows detailed information. The event that reports job completion only applies to jobs that have been installed normally (job type: D).

Table 8-12 Attributes of the job completion event

Attribute type		Item	Attribute name	Details
Main attribute		Event ID	--	00010302 (COMPLETE) 00010303 (ERROR) 00010304 (INS-WAIT)
		Message	--	--
		Detailed information	--	Provided Detailed information format Text Maximum length of detailed information 218 Bytes Characters used to delimit items of detailed information Blank
Extended attribute	Common information	Severity	SEVERITY	COMPLETE or INS-WAIT:Notice ERROR:Error

Legend:

--: Not applicable.

Table 8-13 Detailed information on job completion events

Item	Contents	Maximum length (Bytes)	Format
Distributor tools maintenance information	Maintenance information for distributor tools	7	Character string
Local UNIX machine name	Host name of the local UNIX machine	33
Job completion date	Shown in YY:MM:DD format	8
Job completion time	Shown in hh:mm:ss format	8
Job number	Serial job number in managing server	16
Distribution destination	Destination of the job	64
Full package ID	Full package ID	63
Job type	Job type	1
Status	Shows job status. 1st, 2nd characters: Host status 3rd, 4th characters: Cancel status 5th, 6th characters: End status 7th, 8th characters: User status 9th, 10th characters: End status 2 11th, 12th characters: External program processing for installation completion code 13th, 14th characters: Recovery status	14

Note

As shown below, each item is delimited with either a blank space () or a slant.

 
distributor-tools-maintenance-informationlocal-UNIX-machine namejob-completion-date
job-completion-time/job-number/distribution-destination/full-package-ID/job-type/status

(2) Server malfunction events

Table 8-14 shows the attributes of server malfunction event, which is issued by the distributor tools. Table 8-15 shows detailed information.

Table 8-14 Attributes of the server malfunction events

Attribute type		Item	Attribute name	Contents
Main attribute		Event ID	--	00010301
		Message	--	--
		Detailed information	--	Provided Detailed information format Text Maximum length of detailed information 89 byte Characters used to delimit items of detailed information Blank space
Extended attribute	Common information	Severity	SEVERITY	CRITICAL

Legend:

--: Not applicable.

Table 8-15 Detailed server malfunction event information

Item	Description	Maximum length (Bytes)	Format
Distributor tools maintenance information	Maintenance information for the distributor tools	7	Character string
Local UNIX machine name	Host name of the local UNIX machine	33
Date of error occurrence	Shown in YY:MM:DD format	8
Time of error occurrence	Shown in hh:mm:ss format	8
Process ID	Process ID	4
Location of communication error occurrence	Location where a communication error occurred	9
Cause of server malfunction	EXIT (EXIT Shutdown)	4
	TERM (SIGTERM Shutdown)
	STOP (Forced shutdown)
EXIT Status	Shows EXIT status	8

Notes

As shown below, each item is delimited with either a blank space () or a slant.

 
distributor-tools-maintenance-informationlocal-UNIX-machine-name
error-occurrence-dateerror-occurrence-time
/process-ID/communication-error-occurrence-location/cause-of-server-malfunction/EXIT-status

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.