2.7.1 Registering custom jobs in JP1/AJS - View

Use of custom jobs makes job definition easier and more accurate compared with directly specifying commands and batch files in jobs.

Custom jobs are templates for jobs that make job creation easy when jobs that link JP1/AJS - View and other programs are defined.

With custom jobs, you can use GUI to define jobs for JP1/Advanced Shell.

To register custom jobs into JP1/AJS - View:

From the Windows Start menu, select All Programs, JP1_Automatic Job Management System 3 - View, and then Register Custom Jobs.

The Register Custom Job dialog box is displayed.
Click the Add button.

The Set Properties of Custom Job dialog box is displayed.
Register a custom job for JP1/Advanced Shell. You register a custom job for a Windows execution environment and for a UNIX execution environment as shown in the following.
- In Windows
  
  Name: Specify ADSHPC.
  
  Comment: We recommend that you specify the fixed character string JP1/AS_PC job execution. You can specify any character string up to 40 bytes in length or you can omit this field.
  
  Defining program: installation-folder\JP1ASV\bin\adshctmjpc.bat. This is the folder on the PC on which the custom job is installed.
  
  Executing program: installation-folder\JP1ASE\bin\adshexec.exe. This is the folder on the PC on which the execution environment is installed.
  
  Version: 0600. This is the interface version of JP1/AJS - View.
  
  Class: Specify ADSHPC.
  
  Job Type: For a job for JP1/Advanced Shell, always select PC.
- In UNIX
  
  Name: Specify ADSHUX.
  
  Comment: We recommend that you specify the fixed character string JP1/AS_UNIX job execution. You can specify any character string up to 40 bytes in length or you can omit this field.
  
  Defining program: installation-directory\JP1ASV\bin\adshctmjunix.bat. This is the folder on the PC on which the custom job is installed.
  
  Executing program: /opt/jp1as/bin/adshexec
  
  Version: 0600. This is the interface version of JP1/AJS - View.
  
  Class: Specify ADSHUX.
  
  Job Type: For a job for JP1/Advanced Shell, always select PC.
Click the OK button.

The custom job is registered into JP1/AJS - View.

If you are installing the custom job definition program while a JP1/AJS3 - View whose version is earlier than 09-50 is installed, copy the custom job icons to the following folder:

JP1/AJS-View-installation-folder\image\custom

The following table explains the icons used in JP1/AJS.

Table 2‒20: Explanation of icons used in JP1/AJS
name	File name	Description
Job icon for execution in Windows	`CUSTOM_PC_ADSHPC.gif`	This is the Windows custom job icon used in JP1/AJS - View's jobnet editor. It is displayed on the Custom Jobs page in the Jobnet Editor window.
Job icon for execution in UNIX	`CUSTOM_PC_ADSHUX.gif`	This is the UNIX custom job icon used in JP1/AJS - View's jobnet editor. It is displayed on the Custom Jobs page in the Jobnet Editor window.
JP1/Advanced Shell (execution definition) icon	`adshctmj.exe`	This is the definition program that links JP1/AJS in custom jobs.

Notes:

If JP1/Advanced Shell is installed on multiple machines and their paths differ from one machine to another, specify the JP1/Advanced Shell installation path in a variable and then specify the variable's name, instead of the full path, in Executing program during custom job registration. For details about the specification method, see Defining the work path used during job execution as a variable in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1.

The following shows an example specification:

jajs_config -k "[JP1_DEFAULT\JP1NBQAGENT\Variable]" "jp1asebin"="C:\Program Files\Hitachi\JP1AS\JP1ASE\bin"

You can share multiple paths in JP1/AJS - View by specifying the path of JP1/Advanced Shell as a variable in JP1/AJS on each machine on which JP1/Advanced Shell is installed and then specifying $jp1asebin$\adshexec.exe in Executing program during custom job registration in JP1/AJS - View.

To Page Top