4.12 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 JP1/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 JP1/Base User's Guide.
To display user-specific event attributes in JP1/IM:
-
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.
-
-
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‒10: 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‒11: 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.
Result code
RESULT_CODE
Result 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