2.1.1 Installation folder (Windows only)

Organization of this subsection

(1) Installation folder
(2) Trace output folder and folder for creating a system environment file
(3) System execution logs, spool, and temporary files
(4) List of programs

(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

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

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`	`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`	Executing batch jobs	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).

To Page Top