2.8.2 Setting up the user-reply functionality after JP1/Advanced Shell has been installed (Windows only)
This subsection explains the settings to be specified after JP1/Advanced Shell has been installed to use the user-reply functionality. These settings must be specified by a user with an administrator role.
- Organization of this subsection
(1) Setting up the service
(a) Specifying how to start the JP1/Advanced Shell service
To have the JP1/Advanced Shell service start automatically:
-
From the Windows Control Panel, select Administrative Tools, and then Services.
-
From the displayed list of service names, display the properties of the following service:
-
To use the user-reply functionality from the execution environment, service name beginning with AdshmSvcE
-
To use the user-reply functionality from the development environment, service name beginning with AdshmSvcD
-
-
On the General page, change Startup Type as follows:
Immediately after JP1/Advanced Shell has been installed, the initial setting is Manual. If you want to have the service start automatically whenever Windows starts, change this setting to Automatic.
(b) Starting the JP1/Advanced Shell service
This subsection explains how to start the JP1/Advanced Shell service manually. You can skip this procedure if you set Startup Type to Automatic in (a) Specifying how to start the JP1/Advanced Shell service, and then started Windows.
To start the JP1/Advanced Shell service
-
From the Windows Control Panel, select Administrative Tools, and then Services.
-
From the displayed list of service names, display the properties of the following service:
-
To use the user-reply functionality from the execution environment, service name beginning with AdshmSvcE
-
To use the user-reply functionality from the development environment, service name beginning with AdshmSvc
-
-
On the General page, click the Start button.
If the service does not start, check the error information output to the event logs.
If the KNAX7552-E message is issued as error information, check and, if necessary, revise the system environment file, and then restart the service.
(c) Registering a service
If a service (AdshmSvcD or AdshmSvcE) to be registered automatically during installation is deleted, you must re-register the service to use the user-reply functionality. You can use the adshmsvcd and adshmsvce commands to register services.
The following explains how to register a service.
-
How to re-register a service
If AdshmSvcD or AdshmSvcE are not displayed in Services in Administrative Tools, registration of the service might have been deleted. You can re-register the service by executing the following command:
-
To register the AdshmSvcD service
adshmsvcd -install
-
To register the AdshmSvcE service
adshmsvce -install
If the command terminates normally, the registered service is displayed in Services in Administrative Tools.
-
For details about how to start a registered services, see (b) Starting the JP1/Advanced Shell service.
(2) Setting up the adapter command (for the execution environment)
To use the user-reply functionality in the execution environment, you must specify the adapter command shown below in JP1/Base. Specify this setting only once after you have installed JP1/Advanced Shell. However, if you have re-installed JP1/Base, you must perform this setup again.
To set up the adapter command:
-
Check the path specified in cmdpath in the adapter command configuration file used for the user-reply functionality. If it differs from the JP1/Advanced Shell installation folder, correct it to the installation folder.
The adapter command configuration file used for the user-reply functionality is stored at the following location:
Installation-folder\JP1ASE\sample\Adapter_HITACHI_JP1_AS_ASE_USERREPLY.conf
When JP1/Advanced Shell is installed, the adapter command configuration file used for the user-reply functionality contains the following information:
-
In a 64-bit edition of Windows
fileversion 07000000
upperpp /HITACHI/JP1/IM/CC
componenttype JP1_AS_ASE_USERREPLY
cmdpath C:\Program Files (x86)\Hitachi\JP1AS\JP1ASE\bin\adshuserreply.exe
-
In non-64-bit editions of Windows
fileversion 07000000
upperpp /HITACHI/JP1/IM/CC
componenttype JP1_AS_ASE_USERREPLY
cmdpath C:\Program Files\Hitachi\JP1AS\JP1ASE\bin\adshuserreply.exe
-
-
Copy the adapter command configuration file used for the user-reply functionality shown in step 1 to the JP1/Base installation target.
The target folder is as follows:
JP1/Base-installation-folder\plugin\conf
Responses can now be entered for reply-waiting events that are displayed in JP1/IM - View.
(3) Setting up the adapter command (for the development environment)
To use the user-reply functionality in the development environment of JP1/Advanced Shell, you must specify the settings described here. However, if you specify the standard output as the output destination of the user-reply functionality, there is no need to perform this setup.
Specify this setting only once after you have installed JP1/Advanced Shell. However, if you have re-installed JP1/Base, you must perform this setup again.
To set up the adapter command:
-
Check the path specified in cmdpath in the adapter command configuration file used for the user-reply functionality. If it differs from the JP1/Advanced Shell installation folder, correct it to the installation folder.
The adapter command configuration file used for the user-reply functionality is stored at the following location:
JP1/Advanced-Shell-installation-folder\JP1ASD\sample\Adapter_HITACHI_JP1_AS_ASD_USERREPLY.conf
When JP1/Advanced Shell is installed, the adapter command configuration file used for the user-reply functionality contains the following information:
-
In a 64-bit edition of Windows
fileversion 07000000
upperpp /HITACHI/JP1/IM/CC
componenttype JP1_AS_ASD_USERREPLY
cmdpath C:\Program Files (x86)\Hitachi\JP1AS\JP1ASD\bin\adshuserreply.exe
-
In non-64-bit editions of Windows
fileversion 07000000
upperpp /HITACHI/JP1/IM/CC
componenttype JP1_AS_ASD_USERREPLY
cmdpath C:\Program Files\Hitachi\JP1AS\JP1ASD\bin\adshuserreply.exe
-
-
Copy the file shown in step 1 to the JP1/Base installation target.
The target folder in JP1/Base is as follows:
JP1/Base-installation-folder\plugin\conf
Responses can now be entered for reply-waiting events that are displayed in JP1/IM - View.