2.6.19 Creating the directories required for JP1/Advanced Shell

If you want to change the default settings for the directories required for execution after you have installed JP1/Advanced Shell, you must create new directories, and then specify them in the environment files.

The directories required for JP1/Advanced Shell and the information to be specified are described below. The user who will be running JP1/Advanced Shell must grant the required permissions to these directories.

Directory for temporary files

Specify the directory in which the files to be used only within batch jobs are to be created temporarily.
Directory for the spool

Specify the directory used to store job execution logs and program output data files.
Directory for system execution logs

Specify the directory used to store batch job logs as system execution logs that are used by the system administrator for monitoring execution of batch jobs.
Directory for traces

Specify the directory used to store the statuses for troubleshooting purposes in the event of system failure.

The table below lists the directories required in JP1/Advanced Shell. For details about how to specify the environment setting parameters, see 7. Parameters Specified in the Environment Files.

Table 2‒18: Directories required in JP1/Advanced Shell
Directory	Environment setting parameter	Default directory or path	Default permissions
Directory for temporary files	`TEMP_FILE_DIR`	Execution environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASE\temp` Development environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASD\temp` Execution environment (UNIX only) `/var/opt/jp1as/temp`	`CRWD` (Windows) `1777` (UNIX)
Directory for the spool	`SPOOL_DIR`	Execution environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASE\spool` Development environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASD\spool` Execution environment (UNIX only) `/var/opt/jp1as/spool`	`CRWD` (Windows) `1777` (UNIX)
Directory for system execution logs	`LOG_DIR` `LOG_FILE_CNT` `LOG_FILE_SIZE`	Execution environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASE\log` Development environment (Windows only) `shared-documents-folder\Hitachi\JP1AS\JP1ASD\log` Execution environment (UNIX only) `/opt/jp1as/log`	`CRWD` (Windows) `0777` (UNIX)
Directory for traces	`TRACE_DIR` `TRACE_FILE_CNT` `TRACE_FILE_SIZE` `TRACE_LEVEL`	Execution environment (Windows only) `common-application-data-folder\Hitachi\JP1AS\JP1ASE\trace` Development environment (Windows only) `common-application-data-folder\Hitachi\JP1AS\JP1ASD\trace` Custom job definition program (Windows only) `common-application-data-folder\Hitachi\JP1AS\JP1ASV\trace` Execution environment (UNIX only) `/opt/jp1as/trace`	`CRWD` (Windows) `1777` (UNIX)

Legend:

The letters shown in the Default permissions column indicate the following Windows permissions:

C: Create, R: Read, W: Write, D: Delete

Organization of this subsection

(1) Required permissions
(2) File systems

(1) Required permissions

This subsection describes the permissions required for the users who execute batch jobs.

(a) In Windows

Grant full control to the users who will be executing batch jobs.

(b) In UNIX

Grant to the users who will be executing batch jobs the file permissions shown below for each type of directory.

Table 2‒19: File permissions for directories
Directory type	Read permission (r)	Write permission (w)	Execution permission (x)	Sticky bit (t)
Directory for temporary files	R	R	R	S
Directory for the spool	R	R	R	S
Directory for system execution logs	R	R	R	N
Directory for traces	R	R	R	S

Legend:

R: Specification is required.

S: Specify according to system operation guidelines.

N: Do not specify.

Specify the sticky bit for directories according to the system operation guidelines.

If no sticky bit is specified for a directory for which a user has write permission, that user can delete any file directly under that directory.

If a sticky bit is specified for a directory, only the owner of the directory or files can delete any file directly under that directory. No other user can delete these files even if the user has write permission for the directory.

To Page Top

(2) File systems

Because the size of the spool might become large depending on the applications, we recommend that you create and use a dedicated file system. Note that JP1/Advanced Shell does not support NFS or Hitachi Striping File System (HSFS).

To Page Top