2.1.1 Installation folder (Windows only)

(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          : 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

To Page Top

(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

To Page Top

(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

To Page Top

(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.

Table 2‒1: Main programs used in JP1/Advanced Shell (Windows only)

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).

To Page Top