2.1.1 Installation folder (Windows only)
- Organization of this subsection
(1) Installation folder
In Windows, you can install JP1/Advanced Shell in any folder. The following folders for the environments are created under the specified installation folder.
Environment to be installed |
Installation target |
Remarks |
---|---|---|
Execution environment |
installation-folder\JP1ASE |
We recommend that you install this environment on a server. |
Development environment |
installation-folder\JP1ASD |
We recommend that you install this environment on a client PC. |
Custom job definition programs included in the execution environment (JP1/Advanced Shell - Custom Job) |
installation-folder\JP1ASV |
Install these programs at the operation management console on which JP1/AJS - View is installed. |
The organization of the installation folder is shown below. Only folders for the selected environments are created.
Installation folder#1 |---JP1ASD : Development environment folder | |---bin : Program folder | |---cmd : UNIX-compatible command folder | |---doc : Help folder | | |---en : Help (English edition) folder | | |---ja : Help (Japanese edition) folder | |---maintenance : Folder used that is used when failure occurs | |---parts : Script development parts folder | | |---en : Script development parts (English version) folder | | |---ja : Script development parts (Japanese version) folder | |---sample : Sample data folder |---JP1ASE : Execution environment folder | |---bin : Program folder | |---cmd : UNIX-compatible command folder | |---doc : Help folder | | |---en : Help (English edition) folder | | |---ja : Help (Japanese edition) folder | |---maintenance : Folder used that is used when failure occurs | |---parts : Script development parts folder | | |---en : Script development parts (English edition) folder | | |---ja : Script development parts (Japanese edition) folder | |---sample : Sample data folder | |---util--setup.exe : Installer of custom job defining program |---JP1ASV : Custom job defining program folder |---bin : Program folder |---doc--ja--help--INDEX.HTM : Help (manual) |---image--custom : Custom job icon folder | |---CUSTOM_PC_ADSHPC.gif : Custom job icon for PC job | |---CUSTOM_PC_ADSHUX.gif : Custom job icon for UNIX job | |---CUSTOM_PC_ADSHAPPEXEC.gif : Custom job icon for GUI application execution job#2 |---maintenance : Folder that is used when failure occurs
- #1:
Do not use any of the following characters in the installation folder name: & [ ] { } ^ = ; ! ' + , ` ~ # %. The product will not function normally if it is installed in a folder whose name contains any of these characters.
- #2:
-
If a version of JP1/AJS3 - View that is earlier than 11-00 is installed and the custom job definition program is to be installed, the custom job icons must be copied to the following folder:
Installation folder of JP1/AJS - View\image\custom
(2) Trace output folder and folder for creating a system environment file
The trace output folder and the folder for creating the system environment files are created under the Common application data folder.
Common-application-data-folder |---Hitachi--JP1AS--JP1ASD : Development environment folder | |---conf : System environment file storage folder | |---trace : Trace output folder | |---uxpl : Log folder |-----JP1ASE : Execution environment folder | |---conf : System environment file storage folder | |---trace : Trace output folder | |---uxpl : Log folder |-----JP1ASV : Custom job definition program folder | |---trace : Trace output folder |-----misc : Folder for libraries common to all products |---trace : Trace output folder |---uxpl : Log folder
(3) System execution logs, spool, and temporary files
The folders for system execution logs, spool, and temporary files are created in the shared documents folder.
shared-documents-folder |---Hitachi--JP1AS--JP1ASD : Development environment folder | |---log : Folder for system execution logs | |---spool : Spool folder | |---temp : Folder for temporary files |-----JP1ASE : Execution environment folder | |---log : Folder for system execution logs | |---appexec: Folder for application-execution | | agent function log | |---spool : Spool folder | |---temp : Folder for temporary files |-----misc : Folder for libraries common to all products |---log : Log folder
(4) List of programs
The following table lists and describes the storage locations and file names of the main programs used in JP1/Advanced Shell.
Storage folder |
File name |
Overview of program (icon) |
Description |
---|---|---|---|
installation-folder\each-environment's-folder#1\bin |
adshappagent.exe |
Application-execution agent program |
This is the program that executes the executable application in the execution environment. This command registers this program to startup and cancels said registration. |
adshappexec.exe |
GUI application execution program ( |
This is the program that reports to the application-execution agent program when using the executable application in the execution environment. |
|
adshchmsg.exe |
Manual response to reply-request messages when an error occurs |
Command that is used to respond manually to reply-request messages when an error occurs. This command must be used by a user with Administrators permissions. |
|
adshctmj.exe |
JP1/Advanced Shell execution definition program ( |
Program that defines the JP1/Advanced Shell execution environment in a custom job definition program. |
|
adshctmjapp.exe |
GUI application execution definition program ( |
This is the program that defines the execution environment of the GUI application with the custom job definition program. |
|
adshctmjapp.bat |
GUI application execution definition program |
This is the program that defines the execution environment of the GUI application with the custom job definition program. |
|
adshctmjpc.bat |
JP1/Advanced Shell execution definition program for PC jobs |
Program that defines the JP1/Advanced Shell execution environment for PC jobs in a custom job definition program. |
|
adshctmjunix.bat |
JP1/Advanced Shell execution definition program for UNIX jobs |
Program that defines the JP1/Advanced Shell execution environment for UNIX jobs in a custom job definition program. |
|
adshcvmerg.exe |
Merging coverage information |
Command that merges coverage information. This program can be used in both environments (execution and development). |
|
adshcvshow.exe |
Displaying coverage information from commands |
Command that displays coverage information. This program can be used in both environments (execution and development). |
|
adshcvview.exe |
Displaying coverage information from the editor |
Program that displays coverage information. This program enables coverage information to be displayed from the editor in the development environment. |
|
adshedit.exe |
JP1/Advanced Shell Editor ( |
Editor used to edit job definition scripts in the development environment. Double-clicking the icon opens the JP1/Advanced Shell Editor. |
|
adshesub.exe |
Debugging in the editor |
Program that debugs job definition scripts in the development environment. This program is started automatically from adshedit.exe. |
|
adshevtout.exe |
Outputting job definition script operation information |
In an execution environment, the command that outputs job definition script operation information to a CSV file. |
|
adshexec.exe |
Executing batch jobs |
Command that starts the job controller that analyzes and controls execution of job definition scripts. |
|
adshexecsub.exe |
Command that executes batch jobs in the execution environment. This command is started automatically from adshexec.exe. |
||
adshfile.exe |
Registration of file postprocessing |
Command that defines how a specified file is to be processed when a job step or job is terminated. This program can be used in both environments (execution and development). |
|
adshhk.exe |
Deleting spool jobs |
Command that deletes spool jobs. This command can be used in both environments (execution and development). |
|
adshlsmsg.exe |
Displaying a list of reply-request messages when an error has occurred |
Command that outputs job definition script operation information to a CSV file in the execution environment. |
|
adshmsvcd.exe |
User-reply functionality's management service |
Command that registers the service that manages shared memory for the user-reply functionality. This command is used in the development environment. It must be used by a user with Administrators permissions. |
|
adshmsvce.exe |
User-reply functionality's management service |
Command that registers the service that manages shared memory for the user-reply functionality. This command is used in the execution environment. It must be used by a user with Administrators permissions. |
|
installation-folder\each-environment's-folder#1\cmd |
awk.exe, basename.exe, cat.exe, cmp.exe, cp.exe, cut.exe, date.exe, diff.exe, dirname.exe, egrep.exe, expand.exe, expr.exe, find.exe, getopt.exe, grep.exe, gunzip.exe, gzip.exe, head.exe, hostname.exe, ln.exe, ls.exe, mkdir.exe, mv.exe, paste.exe, printf.exe, rm.exe, rmdir.exe, sed.exe, sleep.exe, sort.exe, split.exe, stat.exe, tail.exe, tar.exe, touch.exe, tr.exe, uname.exe, uniq.exe, wc.exe, which.exe, xargs.exe |
UNIX-compatible commands#2 |
Commands that are used mainly in UNIX batch applications but can also be used in a Windows environment. These commands can be used in both environments (execution and development). |
installation-folder\each-environment's-folder#1\maintenance |
adshcollect.bat |
Collecting data |
Command that collects troubleshooting data. This program can be used in both environments (execution and development). |
- #1
each-environment's-folder is JP1ASD for the development environment and JP1ASE for the execution environment and JP1ASV for the custom job definition program.
- #2
The UNIX-compatible commands also include chmod, su, and who. If you will be using any of these three commands, edit beforehand each of the applicable sample script files provided by JP1/Advanced Shell using the procedure described in (2) Preparations for using the script-format UNIX-compatible commands (Windows only).