Job Management Partner 1/Integrated Management - Manager Configuration Guide

4.8 How to display user-specific event attributes

This section describes the procedures for displaying user-specific event attributes (user-specific information for extended attributes).

Before you start using JP1/IM, you can set JP1/Base to issue user-specific events. For details about how to set JP1/Base to issue user-specific events, see the manual Job Management Partner 1/Base Function Reference.

You can also use the jevsend and jevsendd commands in JP1/Base to issue user-specific events. In such cases, you might also need to specify information such as definition files for the extended event attributes. For details about how to set user-specific events to be issued by using the jevsend and jevsendd commands in JP1/Base, see the Job Management Partner 1/Base User's Guide.

To display user-specific event attributes in JP1/IM:

1. Create definition files.
   Create the following definition files on the machine where JP1/IM - Manager is installed:
   
   • Definition file for the extended event attributes
     Defines the user-specific event attributes that you want to display.
     
   • Definition file for objects types
     Defines the display items on the JP1/IM - View window that are used to display user-specific event attributes.
     
2. Apply the definition files.

The details of each step are provided in the subsections below. The following explains how to create the definition files for displaying the attributes of sample JP1 events.

Sample JP1 events

This example uses the startup and abnormal termination events that are issued when a Windows application named SAMPLE starts and terminates.

The following are the details of each event:

Types of JP1 events to be displayed

• JP1 event that is issued when the SAMPLE application starts (startup event)
  Event ID: 0x00000001
  Message: The SAMPLE application now starts.
  
• JP1 event that is issued when the SAMPLE application terminates abnormally (abnormal termination event)
  Event ID: 0x00000002
  Message: The SAMPLE application terminated abnormally.
  

Attribute definition for the startup event (extended attributes (extattrs))

The following attributes have been defined for the startup event of the SAMPLE application:

Table 4-8 Attributes of the startup event

Attribute type	Item	Attribute name	Description
Basic attribute	Event ID	--	0x00000001
	Message	--	The SAMPLE application now starts.
Extended attribute (common information)	Event level	SEVERITY	Notice
	User name	USER_NAME	SAMPLE_USER
	Product name	PRODUCT_NAME	/COMPANY/APP1/SAMPLE_PRODUCT (product name)
	Object type	OBJECT_TYPE	SAMPLE
	Object name	OBJECT_NAME	SAMPLE_NAME
	Root object type	ROOT_OBJECT_TYPE	ROOT_SAMPLE
	Root object name	ROOT_OBJECT_NAME	ROOT_SAMPLE_NAME
	Object ID	OBJECT_ID	SAMPLE_ID
	Occurrence	OCCURRENCE	START
	Start time	START_TIME	SAMPLE application start time. This is the number of seconds from UTC 01/01/1970 00:00:00.
	Platform type	PLATFORM	NT
	Version information	ACTION_VERSION	0600
Extended attribute (user-specific information)	SAMPLE common attribute 1	COMMON_ATTR1	NATIVE
	SAMPLE common attribute 2	COMMON_ATTR2	TRUE
	SAMPLE start attribute 1	START_ATTR1	SAMPLE1
	SAMPLE start attribute 2	START_ATTR2	SAMPLE2

Attribute definition for the abnormal termination event (extended attributes (extattrs))

The following attributes have been defined for the abnormal termination event of the SAMPLE application:

Table 4-9 Attributes of the abnormal termination event

Attribute type	Item	Attribute name	Description
Basic attribute	Event ID	--	0x00000002
	Message	--	The SAMPLE application terminated abnormally.
Extended attribute (common information)	Event level	SEVERITY	Error
	User name	USER_NAME	SAMPLE_USER
	Product name	PRODUCT_NAME	/COMPANY/APP1/SAMPLE_PRODUCT (product name)
	Object type	OBJECT_TYPE	SAMPLE
	Object name	OBJECT_NAME	SAMPLE_NAME
	Root object type	ROOT_OBJECT_TYPE	ROOT_SAMPLE
	Root object name	ROOT_OBJECT_NAME	ROOT_SAMPLE_NAME
	Object ID	OBJECT_ID	SAMPLE_ID
	Occurrence	OCCURRENCE	END
	End time	END_TIME	SAMPLE application end time. This is the number of seconds from UTC 01/01/1970 00:00:00.
	Termination code	RESULT_CODE	Termination code of the SAMPLE application
	Platform type	PLATFORM	NT
	Version information	ACTION_VERSION	0600
Extended attribute (user-specific information)	SAMPLE common attribute 1	COMMON_ATTR1	NATIVE
	SAMPLE common attribute 2	COMMON_ATTR2	TRUE
	SAMPLE end attribute 1	END_ATTR1	SAMPLE1
	SAMPLE end attribute 2	END_ATTR2	SAMPLE2

Organization of this section

4.8.1 Creating the definition files

4.8.2 Enabling the definition files

[Contents][Back][Next]

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