4.15.3 Copying JP1 event information and action execution results to the clipboard
In JP1/IM, you can copy selected JP1 event information and action execution results to the clipboard in CSV format. You can then make temporary use of the information. For example, you can copy information about a JP1 event triggered by a major error into a text editor or the body of an email.
The clipboard feature is enabled by default. For the procedure to enable or disable copying to the clipboard, see 1.19.2 Customizing operation of JP1/IM - View (Central Console viewer and Central Scope viewer) (for Windows) in the JP1/Integrated Management 2 - Manager Configuration Guide.
The following describes the windows and types of information that you can copy to the clipboard, and the output format and output items.
- Organization of this subsection
(1) Target windows and types of information
You can copy the following types of information to the clipboard:
-
JP1 event information
-
Action log
-
Command log
The clipboard feature can be used in all windows in which these types of information are displayed. The following table lists the applicable windows and display items.
Window name |
Display item |
Information |
---|---|---|
Event Console window
|
List of events |
JP1 event information |
Event Details window |
Event attributes |
JP1 event information (detailed information) |
Related Events (Summary) window |
|
JP1 event information |
Related Events (Correlation) window |
|
JP1 event information |
Action Log window |
Log |
Action log |
Action Log Details window |
Log |
Action log (detailed information) |
List of Action Results window |
Log |
Action log |
Execute Command window |
Log |
Command log |
In the Event Console window, you can copy information to the clipboard by choosing Edit and then Copy, or by pressing the Ctrl+C keys. In all other windows, press the Ctrl+C keys to copy selected information to the clipboard.
(2) CSV image and format
Information copied to the clipboard can be output in CSV format, in the same order as displayed in JP1/IM - View. The display item names are added as header information to identify the items.
The following figure shows the CSV output.
Line 1 is the display item names corresponding to the information selected in JP1/IM - View, separated by commas.
Line 2 and subsequent lines are the selected information, separated by commas and following the order of the display item names in line 1.
The CSV output format is as follows:
-
Items are separated by commas (,).
item1,item2,item3,item4,item5,...
-
Lines are separated by linefeed codes (CRLF).
item1,item2,item3,item4,item5,...(CRLF)
item1,item2,item3,item4,item5,...(CRLF)
-
Any item containing a comma (,) is enclosed with double quotation marks (").
item1,"item,2",item3,item4,item5,...
-
Any item containing a control character (0x00 to 0x1F, and 0x7F to 0x9F) is enclosed with double quotation marks (").
item1,"item(0x00)2",item3,item4,item5,...
-
When an item contains a double quotation mark ("), another double quotation mark is inserted before it, and the whole is enclosed with double quotation marks (").
item1,"item""2",item3,item4,item5,...
-
Empty items are shown as blank (nothing is entered).
item1,,item3,item4,item5,...
(3) CSV output items
The following describes the items and contents that are copied to the clipboard.
- JP1 event information
-
The contents output when copying JP1 event information to the clipboard are the same as the contents output to line 2 and subsequent lines when saving an event listing as a CSV snapshot. For details, see Table 4-21 Contents output to the body of a snapshot. As there is no header information, the display item names are output to line 1, and the event information is output to line 2 onward.
- Action log
-
The following table describes the contents output as an action log.
Table 4‒24: Contents output as an action log Display item name
Output contents
Type#
The icons in the window are converted into character strings and output as follows:
-> Command
-> Rule
Action serial number
The character string displayed in the window is output.
Action
The character string displayed in the window is output.
Host
The character string displayed in the window is output.
Status
The character string displayed in the window is output.
Delay
The character string displayed in the window is output.
Registered time
Output in the following format:
-
When the attribute value is the cumulative number of seconds from 1970/01/01 00:00:00 (GMT):
The attribute value is converted for the time zone set for JP1/IM - View in the YYYY/MM/DD hh:mm:ss format, and then output.
-
When the attribute value is other than the above:
The character string set as the attribute value is output.
Event arrival time
End time
Return code
The character string displayed in the window is output.
-
- Command log
-
The following table describes the contents output as a command log.
Table 4‒25: Contents output as a command log Display item name
Output contents
Time
Output in the following format:.
-
When the attribute value is the cumulative seconds from 1970/01/01 00:00:00 (GMT):
The attribute value is converted for the time zone set for JP1/IM - View in the YYYY/MM/DD hh:mm:ss format, and then output.
-
When the attribute value is other than the above:
The character string set as the attribute value is output.
Host
The character string displayed in the window is output.
Message
The character strings displayed in the window are output.
-
- JP1 event information (details) or action log (details)
-
The following table describes the contents output as detailed information about a JP1 event or an action log entry.
Table 4‒26: Contents output as detailed information Display item name
Output contents
Attribute name
The character string displayed in the window is output.
Attribute value
The character string displayed in the window is output.
However, when time is displayed as the attribute value, the attribute value is output in the following format:
-
When the attribute value is the cumulative number of seconds from 1970/01/01 00:00:00 (GMT):
The attribute value is converted for the time zone set for JP1/IM - View in the YYYY/MM/DD hh:mm:ss format, and then output.
-
When the attribute value is other than the above:
The character string set as the attribute value is output.
-
(4) Notes
Note the following when copying displayed information to the clipboard:
-
If you want to copy information to the clipboard by pressing the Ctrl+C keys, make sure that the functionality is enabled. It is enabled by default.
-
The information copied to the clipboard is the item selected in the window that has the focus when you perform a copy operation by choosing a command or by pressing the shortcut keys. The selected information is not copied if it was changed to an unselected state as the result of an auto-refresh action that scrolled the item out of view before it was copied.
-
When the amount of information to be copied to the clipboard exceeds the maximum memory usage, the copy processing is canceled and the information is not copied.