10.2.3 Setup for displaying a hyperlink to Web GUI in the Event Details window of JP1/IM - View

A hyperlink to the Monitor screen of Web GUI can be displayed in the Event Details window of JP1/IM - View. By opening the Monitor screen of Web GUI from the Event Details window, the user can quickly check the status of the unit related to an issued JP1 event.

For details about the event guide function, see the JP1/Integrated Management 2 - Manager Overview and System Design Guide.

Before you can change the display of the Event Details window, you must set up the event guide function. To set up the event guide function, edit the following two files:

Event-guide message file

File in which to write a message to be displayed in the Event Details window.

In an event guide message file, you can specify the message to be output for a JP1 event that occurs, and the URL for opening the Monitor screen of Web GUI.
Event guide information file

A file managed by JP1/IM - Manager. This file contains the information about the mapping between JP1 events occurring in JP1/AJS3 and event guide message files.

The following is the procedure for setting up the event guide function by editing the above two files.

On all client hosts, terminate JP1/IM - View.
Create an event-guide message file.

Create (in HTML) a message to be displayed in the Event Details window. An example of an event-guide message file is as follows:
```
<HTML>
 <HEAD>
 </HEAD>
 <BODY>
   A job terminated abnormally.<BR>
   <A HREF="URL-for-opening-the-Monitor-screen">Open the Monitor screen of Web GUI.</A>
 </BODY>
</HTML>
```
You can specify one of the following two types of URLs as the URL for opening the Monitor screen:

URL supporting single sign-on (JP1/IM - Manager 11-10 or later):

If this type of URL is specified, the user can directly open the Monitor screen of Web GUI from the Event Details window. The user logs in to JP1/AJS3 with a login account of JP1/IM.

This type of URL has the following format:

communication-protocol://host-name-or-IP-address-of-Web-Console-server:port-number/ajs/login.html?sign=jt

URL not supporting single sign-on (JP1/IM - Manager 09-50 or later):

If this type of URL is specified, the Web GUI login screen opens first. To open the Monitor screen of Web GUI, the user must log in to JP1/AJS3.

This type of URL is formatted as follows (Δ indicates a one-byte space.):

communication-protocol://host-name-or-IP-address-of-Web-Console-server:port-number/ajs/login.html?manager=$B.SOURCESERVER$URLENCΔ&type=monitor&unitName=$E.OBJECT_NAME$URLENCΔ&execID=$E.A3$URLENCΔ&eou=1

In the following part, specify values appropriate for your environment:

communication-protocol://host-name-or-IP-address-of-Web-Console-server:port-number

communication-protocol

Specify http or https as the communication protocol.

host-name-or-IP-address-of-Web-Console-server

Specify the host name or IP address of the Web Console server.

port-number

Specify the port number to be used for communication with the Web Console server. If SSL communication is disabled, the default port number is 22252. If SSL communication is enabled, the default port number is 22253.

The following shows an example of the URL that can be specified:
```
https://hostA:22253/ajs/login.html?sign=jt
```
Place the created event-guide message file in any path on the JP1/IM - Manager host.
Create the event guide information file.

You can omit this step if you have already created the event guide information file.

For details about the event guide information file, see the manual JP1/Integrated Management 2 - Manager Command and Definition File Reference.

The following shows the storage folders for the event guide information file.
- In Windows
  
  system-drive:\Program Files^#\HITACHI\JP1Cons\conf\guide\jco_guide.txt
  
  or
  
  shared-folder\jp1cons\conf\guide\jco_guide.txt
- In UNIX
  
  /etc/opt/jp1cons/conf/guide/jco_guide.txt
  
  or
  
  shared-directory/jp1cons/conf/guide/jco_guide.txt
#

For 64-bit versions of Windows, replace Program Files with Program Files (x86).
Edit the event guide information file to map JP1 events that can occur in JP1/AJS3 to event-guide message files.

Add the following entry (or substitute it for the existing description) in the event guide information file. You can add multiple entries of the event guide information.

For details and cautionary notes about the event guide information file, see the manual JP1/Integrated Management 2 - Manager Command and Definition File Reference.
```
DESC_VERSION=file-version
 
[EV_GUIDE_event-guide-number]
EV_COMP=B.IDBASE:event-ID
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=location-of-the-event-guide-message-file
[END]
```
The following describes the value to be specified for each entry. Specify a value appropriate for your environment.

file-version

Specify 2.

event-guide-number

Specify a unique number.

event-ID

Specify the ID of a JP1 event to be mapped to an event-guide message file. For the JP1 events that can be specified, see 10.2.5 JP1 events supported by JP1/IM linkage.

location-of-the-event-guide-message-file

Specify the path that you specified in step 3.

The following shows an example of entries to be added to the event guide information file:
```
DESC_VERSION=2
 
[EV_GUIDE_1]
EV_COMP=B.IDBASE:00004102
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=C:\\Program Files\\HITACHI\\JP1Cons\\conf\\guide\\guidemes01_Webcon.htm
[END]
[EV_GUIDE_2]
EV_COMP=B.IDBASE:00004103
EV_COMP=E.PRODUCT_NAME:/HITACHI/JP1/AJS2
EV_FILE=C:\\Program Files\\HITACHI\\JP1Cons\\conf\\guide\\guidemes02_Webcon.htm
[END]
```
Restart the JP1/IM - Manager service, or execute the jco_spmd_reload command.

Cautionary note: The maximum length of a URL that can be used as a hyperlink for an event guide in HTML format is 2,046 characters. For details on how to change the maximum length of a URL, see the Release Notes for JP1/IM.

To Page Top