2.7.2 Defining and executing a jobnet

(a) For PC jobs and UNIX jobs

• Environment variables configured in the Define Execution dialog box of JP1/Advanced Shell

  ADSH_AJS_SCRF: Job definition script file name

  ADSH_AJS_ENVF: Job environment file name

  ADSH_AJS_LHOST: Logical host

  ADSH_AJS_GCHE: Precheck

• Environment variables passed to job controller of JP1/Advanced Shell

  Environment variables are defined as env parameters of the unit definition file.

  The following table shows the setting items for environment variables passed to the job controller of JP1/Advanced Shell.

  Table 2‒28: Setting items for environment variables passed to the job controller of JP1/Advanced Shell

  Item name	Description
  Input range	Number of bytes that can be specified as the value (character string following "=") of an environment variable (Shift-JIS)
  Settings	Types of characters that can be defined Character string: Characters other than control characters (0x00 to 0x1f, 0x7f) Symbol name: Half-width alphanumeric characters, "@", "#", and "_" Numeric characters
  Initial value	Value loaded when a custom job is started as a new job
  Omission	If a required value is omitted, the job controller of JP1/Advanced Shell returns an error.

  The following table shows the input range and settings of environment variable items passed to the job controller of JP1/Advanced Shell.

  Table 2‒29: Input range and settings of environment variable items passed to the job controller of JP1/Advanced Shell.

  Environment variable	Input range	Settings	Initial value	Omission
  ADSH_AJS_SCRF	PC job: 1 to 247 bytes UNIX job: 1 to 1,023 bytes	Character string	Null character string	Not permitted
  ADSH_AJS_ENVF	PC job: 0 to 247 bytes UNIX job: 0 to 1,023 bytes	Character string	Null character string	Permitted
  ADSH_AJS_LHOST	0 to 2 bytes	If checked -h If not checked Null character string	Null character string	Permitted
  ADSH_AJS_GCHE	0 to 2 bytes	If checked -c If not checked Null character string	Null character string	Permitted
  AJS_BJEX_STOP	4 bytes	"TERM"	"TERM"	Not permitted

• Details of parameters passed to the job controller of JP1/Advanced Shell

  The field Runtime parameters is defined as the prm parameter in the unit definition file and passed as a parameter for the job controller of JP1/Advanced Shell. The permitted values are as follows:

  Input range: 1 to 1,023 bytes^*

  Setting: Character string

  Initial value: Null character string

  Omission: Permitted

  To define for run-time parameters in the Define Execution dialog box a value equivalent to the null character string, define a single-byte space for the prm parameter in the unit definition file.

  *:

  The maximum length of 1,023 bytes applies only when a character string consisting only of spaces is specified for the prm parameter. If any non-space characters are specified, the permitted maximum length is 1,022 bytes. If a character string consisting only of spaces is specified for the prm parameter, the specified character string minus a one-byte space is displayed in the Runtime parameters text box in the Define Execution dialog box.

  Important

  Note the following points when deleting definition information in the unit definition file:

  - For the env parameter, delete the value specified for the environment variable (character string following "=") or delete the specification of the env parameter itself.

  - For the prm parameter, specify a single-byte space as the value for prm or delete the specification of the prm parameter itself.

The following is an example of a unit definition:

unit=Unit name,,Running user,;
{
        ty=cpj;
        cty="ADSHUX";
        sc="/opt/jp1as/bin/adshexec";
        env="AJS_BJEX_STOP=TERM";                               -->1.
        env="ADSH_AJS_SCRF=/tmp/JP1AS/scr/samplescrfile.ash";   -->2.
        prm="param1 param2";                                    -->3.
        env="ADSH_AJS_ENVF=/tmp/JP1AS/env/sampleenvfile";       -->4.
        env="ADSH_AJS_LHOST=-h";                                -->5.
        env="ADSH_AJS_GCHE=-c";                                 -->6.
        tho=0;
}

The following are descriptions corresponding to the numbers shown in the right margin:

1. AJS_BJEX_STOP: Because the AJS_BJEX_STOP environment variable is used by the system, make sure that you define this environment variable and specify TERM as its value.

2. ADSH_AJS_SCRF: Specifies the name of the job definition script file.

   You must define the ADSH_AJS_SCRF environment variable.

3. The prm parameter is specified in the unit definition file.

4. ADSH_AJS_ENVF: Specifies the job environment file name.

5. ADSH_AJS_LHOST: If you want the job to be executed on a logical host, specify -h. In all other cases, do not specify anything.

6. ADSH_AJS_GCHE: If you want to perform only the precheck, specify -c. If all other cases, do not specify anything.

After creating the unit definition file, you can define the job by using the ajsdefine command of JP1/AJS or JP1/AJS3 - Definition Assistant.

(b) For the GUI application execution job

• Environment variables configured in the Define Execution dialog box of JP1/Advanced Shell

  ADSH_AJS_APPNAME: Application path name

  ADSH_AJS_APPARG: Application parameter

  ADSH_AJS_WORKF: Work folder

  ADSH_AJS_SHOWN: Display name

  ADSH_AJS_AFEXECMV: Behavior after executing the executable application

  ADSH_AJS_MESOUT: Message output

• Environment variables passed to the GUI application execution program

  Environment variables are defined as env parameters of the unit definition file.

  The following table shows the setting items for environment variables passed to the GUI application execution program.

  Table 2‒30: Setting items for environment variables passed to the job controller of JP1/Advanced Shell

  Item name	Description
  Input range	Number of bytes that can be specified as the value (character string following "=") of an environment variable (Shift-JIS)
  Settings	Types of characters that can be defined Character string: Characters other than control characters (0x00 to 0x1f, 0x7f) Symbol name: Half-width alphanumeric characters, "@", "#", and "_" Numeric characters
  Initial value	Value loaded when a custom job is started as a new job
  Omission	If the value cannot be omitted, an error will occur in the GUI application execution program.

  The following table shows the input range and settings of environment variable items passed to the GUI application execution program.

  Table 2‒31: Input range and settings of environment variable items passed to the GUI application execution program

  Environment variable	Input range	Settings	Initial value	Omission
  ADSH_AJS_APPNAME	1 to 247 bytes	Character string	Null character string	Not permitted
  ADSH_AJS_APPARG	0 to 1,023 bytes	Character string	Null character string	Permitted
  ADSH_AJS_WORKF	1 to 247 bytes	Character string	Null character string	Permitted
  ADSH_AJS_SHOWN	0 to 247 bytes	Character string	Null character string	Permitted
  ADSH_AJS_AFEXECMV	0 to 2 bytes	If checked -n If not checked Null character string	Null character string	Permitted
  ADSH_AJS_MESOUT	0 to 2 bytes	If checked -m If not checked Null character string	Null character string	Permitted
  ADSH_AJS_APPEXEC	7 bytes	" APPEXEC "	" APPEXEC "	Not permitted

Important

If you delete definition information from the unit definition file, delete the value of the environment variable (character string following "=") or delete the specification of the env parameter itself for the env parameter.

The following is an example of a unit definition:

unit=Unit name,,Running user,;
{
        ty=cpj;
        cty="ADSHAPPEXEC";
        sc=" C:\Program Files\HITACHI\JP1AS\JP1ASE\bin\adshappexec.exe";
        env="ADSH_AJS_APPEXEC=APPEXEC";                            -->1.
        env="ADSH_AJS_APPNAME=C:\ExecApp.exe";                     -->2.
        env="ADSH_AJS_APPARG=param1 param2";                       -->3.
        env="ADSH_AJS_WORKF=C:\work-folder";                       -->4.
        env="ADSH_AJS_SHOWN=ExecApplication";                      -->5.
        env="ADSH_AJS_AFEXECMV=-n";                                -->6.
        env="ADSH_AJS_MESOUT=-m";                                  -->7.
        tho=0;
}

The following are descriptions corresponding to the numbers shown in the right margin:

1. Because the ADSH_AJS_APPEXEC environment variable is used by the system, you must define this environment variable and specify APPEXEC as its value.

2. ADSH_AJS_APPNAME: Specifies the application path name.

   You must define the ADSH_AJS_APPNAME.

3. ADSH_AJS_APPARG: Specifies the application parameter.

4. ADSH_AJS_WORKF: Specifies the work folder.

5. ADSH_AJS_SHOWN: Specifies the display name.

6. ADSH_AJS_AFEXECMV: If you want the action performed after the execution of the executable application to wait for termination, specify -n. In all other cases, do not specify anything.

7. ADSH_AJS_MESOUT: If you want to suppress output to the standard error output, specify -m. In all other cases, do not specify anything.

After creating the unit definition file, you can define the job by using the ajsdefine command of JP1/AJS or JP1/AJS3 - Definition Assistant.