11.7.16 Setting whether the Start button is displayed in the Monitor Details dialog box and which external program it launches

When you double-click a job icon or a unit displayed in the map area or list area of the Jobnet Monitor window, the Monitor Details dialog box appears. You can specify whether the Start button appears in the Monitor Details dialog box, and configure the button to launch a different external program for each custom job.

By assigning a suitable external program to the Start button, you can more easily check the detailed execution status of custom jobs.

Specify from:

Custom job extended settings file

The location of the model file for the custom job extended settings file is as follows:

%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2V\custom.dir\CJNAME.cjx.model

The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

Procedure

1. Register a custom job.

   Skip this step if you are assigning an external program to an existing custom job.

   For details about how to register a custom job, see the following references:

   • For a default custom job

     See 3.2 Registering default custom jobs in the JP1/Automatic Job Management System 3 Linkage Guide.

   • For a custom PC job or custom Unix job

     See 3.3 Registering custom PC jobs or custom Unix jobs in the JP1/Automatic Job Management System 3 Linkage Guide

2. Copy the custom job extended settings file.

   Copy the model custom job extended settings file and give it the following name:

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2V\custom.dir\custom-job-name^#.cjx

   The default value of %ALLUSERSPROFILE% is system-drive\ProgramData.

   #

   The character string you specified in the Name field of the Set Properties of Custom Job dialog box in step 1.

3. Edit the file you copied in a text editor such as Notepad.

   Use the following format. Do not change any entries that are not described here.

   <DTLSHWBTN SHOW="true|false">

   Specify true to display the Start button in the Monitor Details dialog box, and false to not display the button.

   <DTLSHWPROG>"path-of-external-program" parameters-passed-to-external-program</DTLSHWPROG>

   The character string in this format must not exceed 2,048 bytes in total.

   Specify the following information:

   - path-of-external-program

   Specify an absolute or relative path to the external program to be launched when you click the Start button. Specify relative paths from the installation folder of JP1/AJS3 - View.

   If the path to the external program contains spaces, enclose the entire path in double quotation marks (").

   - parameters-passed-to-external-program

   Specify an arbitrary character string or alternate string to pass to the external program. If you specify an alternate string, the string is replaced with the value obtained when the Monitor Details dialog box opens. If you specify the same alternate string more than once, each instance of the alternate string is replaced with the same value. If the system cannot acquire the information needed to replace the string, the alternate string is passed as-is to the external program.

   The following table lists the variable strings you can specify.

   No.	Variable string	Information passed to external program
   1	(MAN_HOST)#1	Name of manager host where job execution is requested
   2	(SERVICE_NAME)	Name of scheduler service where job execution is requested
   3	(UNIT_NAME)#2	Full unit name of job
   4	(EXEC_ID)	Job execution ID
   5	(JOB_ID)	Job number
   6	(EXEC_HOST)#3	Name of job execution host

   #1

   Replaced by the logical host name (in short format) of the manager host that requested the job. If you are connected to a version 09-00 or earlier of JP1/AJS3 - Manager, the variable is not replaced and the string (MAN_HOST) is passed as-is to the external program.

   #2

   If a unit name contains any of the following characters, an error occurs when the external program starts:

   " (double quotation mark), &, ' (right single quotation mark), *, <, >, ?, [, \, ], ^, ' (left single quotation mark), {, |, }, and ~

   #3

   Replaced by the execution host name in the execution agent definition that was in effect at the manager host when the job was executed.

4. Save the custom job extended settings file you edited in UTF-8 format.

   If you are using Notepad, choose Save As from the File menu, and then select UTF-8 from the Encoding drop-down menu.

To Page Top