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.
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 : Folder for UNIX-compatible commands | |---doc--en--help--INDEX.HTM : Help (manual) | |---maintenance : Folder used for handling errors | |---readme.txt : readme file | |---sample : Folder for sample data | |-Adapter_HITACHI_JP1_AS_ASD_USERREPLY.conf | | : Adapter command configuration file used for the user-reply functionality | |-hitachi_jp1_as_C_attr_cn.conf | | : definition file for the extended event attributes (English) | |-hitachi_jp1_as_C_attr_en.conf | | : definition file for the extended event attributes (English) | |-hitachi_jp1_as_EUC_attr_ja.conf | | : definition file for the extended event attributes (Japanese EUC) | |-hitachi_jp1_as_SJIS_attr_ja.conf | | : definition file for the extended event attributes (Japanese Shift JIS) | |-hitachi_jp1_as_UTF8_attr_ja.conf | | : definition file for the extended event attributes (Japanese UTF-8) | |-sample.ase : Templates for environment files | |-sample.ash : Sample job definition script file | |-script_0 : Common sample script that does nothing | |-script_chmod1 : Sample script file for chmod | |-script_chmod2 : Sample script file for chmod | |-script_chmod3 : Sample script file for chmod | |-script_su1 : Sample script file for su | |-script_who1 : Sample script file for who |---JP1ASE : Execution environment folder | |---bin : Program folder | |---cmd : Folder for UNIX-compatible commands | |---doc--en--help--INDEX.HTM : Help (manual) | |---maintenance : Folder used for handling errors | |---readme.txt : readme file | |---sample : Folder for sample data | | |-Adapter_HITACHI_JP1_AS_ASE_USERREPLY.conf | | | : Adapter command configuration file used for the user-reply functionality | | |-hitachi_jp1_as_C_attr_cn.conf | | | : definition file for the extended event attributes (English) | | |-hitachi_jp1_as_C_attr_en.conf | | | : definition file for the extended event attributes (English) | | |-hitachi_jp1_as_EUC_attr_ja.conf | | | : definition file for the extended event attributes (Japanese EUC) | | |-hitachi_jp1_as_SJIS_attr_ja.conf | | | : definition file for the extended event attributes (Japanese Shift JIS) | | |-hitachi_jp1_as_UTF8_attr_ja.conf | | | : definition file for the extended event attributes (Japanese UTF-8) | | |-sample.ase : Templates for environment files | | |-sample.ash : Sample job definition script | | |-script_0 : Common sample script that does nothing | | |-script_chmod1 : Sample script file for chmod | | |-script_chmod2 : Sample script file for chmod | | |-script_chmod3 : Sample script file for chmod | | |-script_su1 : Sample script file for su | | |-script_who1 : Sample script file for who | |---util--setup.exe : Installer for the custom job definition program | |---JP1ASV : Custom job definition program folder |---bin : Program folder |---doc--en--help--INDEX.HTM : Help (manual) |---image--custom : Folder for custom job icons | |-CUSTOM_PC_ADSHPC.gif : Custom job icons for PC jobs#2 | |-CUSTOM_PC_ADSHUX.gif : Custom job icons for UNIX jobs#2 |---maintenance : Folder used for handling errors
- #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 09-50 is installed and the custom job definition program is to be installed, the custom job icons must be copied to the following folder:
JP1/AJS-View-installation-folder\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 | |---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 |
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. |
|
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, head.exe, hostname.exe, ls.exe, mkdir.exe, mv.exe, paste.exe, rm.exe, rmdir.exe, sed.exe, sleep.exe, sort.exe, split.exe, stat.exe, tail.exe, touch.exe, uname.exe, uniq.exe, wc.exe, which.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). |