11.1.1 Types of customization methods

(1) List of customization methods

You can customize windows and dialog boxes in the following five ways:

Customization by using dialog boxes and menus from JP1/AJS3 - View

A customization that uses dialog boxes and menus from JP1/AJS3 - View is applied to each login JP1 user on each JP1/AJS3 - View host.

Some of the customization can be saved as a common user profile. To apply a customization to multiple JP1 users, use the common user profile.

For details about common user profiles, see 11.1.2 Using common user profiles.

Customization by using a JP1/AJS3 - Manager file (jajsDisableMenu)

A customization that uses a JP1/AJS3 - Manager file (jajsDisableMenu) is applied to each login JP1 user regardless of the JP1/AJS3 - View host.

Customization by using a JP1/AJS3 - Manager file (jajsExecutableCommand)

A customization that uses the jajsExecutableCommand file of JP1/AJS3 - Manager can be applied to all JP1 users or to a specific JP1 user.

Customization by using the JP1/AJS3 - View user-specified option file (ajs2view_opt.conf)

A customization that uses the JP1/AJS3 - View user-specified option file (ajs2view_opt.conf) is applied to each login JP1 user on each JP1/AJS3 - View host.

Part of the customization can be saved as a common user profile. To apply a customization to multiple JP1 users, use a common user profile.

For details about common user profiles, see 11.1.2 Using common user profiles.

Customization by using the JP1/AJS3 - View system common settings file (ajs2view_common.conf)

A customization that uses the JP1/AJS3 - View system common settings file (ajs2view_common.conf) is applied to each JP1/AJS3 - View host regardless of the login JP1 user.

Customization by using the JP1/AJS3 - View file (ajs2.conf)

A customization that uses the JP1/AJS3 - View file (ajs2.conf) is applied to each JP1/AJS3 - View host.

To Page Top

(2) Customization by using dialog boxes and menus from JP1/AJS3 - View

You can use dialog boxes and menus from JP1/AJS3 - View to customize JP1/AJS3 - View.

To Page Top

(3) Customization by using the JP1/AJS3 - Manager file (jajsDisableMenu)

You can edit the JP1/AJS3 - Manager file (jajsDisableMenu) to customize JP1/AJS3 - View.

To customize JP1/AJS3 - View by using the JP1/AJS3 - Manager file:

1. In JP1/AJS3 - Manager, create a folder for storing the customization file (jajsDisableMenu).

   Create a folder for each customization-target JP1 user, and specify the JP1 user name for the folder name.

   The following shows the location of the folder to be created.

   For Windows Server 2016, Windows Server 2012, or Windows Server 2008, if the installation folder is the default installation folder or is in a folder protected by the system:

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\conf\profiles\JP1-user-name^{#1, #2}

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

   A folder protected by the system is the path to a folder in any of the following:

   - system-drive\Windows

   - system-drive\Program Files

   - system-drive\Program Files (x86) (for 64-bit Windows)

   For Windows Server 2016, Windows Server 2012, or Windows Server 2008, if the installation folder is other than the above:

   JP1/AJS3 - Manager-installation-folder\conf\Profiles\JP1-user-name^{#1, #2}

   For Windows Server 2003:

   JP1/AJS3 - Manager-installation-folder\conf\Profiles\JP1-user-name^{#1, #2}

   For UNIX:

   /etc/opt/jp1ajs2/conf/profiles/JP1-user-name^{#1, #2}

   #1

   JP1-user-name cannot have uppercase alphabetic characters. If you use alphabetic characters, make sure that they are all lowercase.

   #2

   If you use any of the following names as the JP1 user name, the folder that is created for each JP1 user name is enclosed in single-byte parentheses ( ).

   In Windows:

   - A device name (such as NUL, CON, AUX, COM1 to COM9, LPT1 to LPT9, and PRN)

   - A name consisting of a device and extension

   - A name beginning with a period (.)

   In UNIX:

   - A name beginning with a period (.)

2. In the JP1-user-name folder that you created in step 1, create a customization file (jajsDisableMenu), and then open the file with a text editor.

3. Specify the settings that you want to customize, and then save them.

4. Start JP1/AJS3 - View.

   The customization is enabled from JP1/AJS3 - View, which starts after the customization file is created.

Cautionary note

The specifications in the JP1/AJS3 - Manager file take effect for both physical and logical hosts. If you specify customization settings for a logical host, you must specify them for both the executing and standby systems.

To Page Top

(4) Customization by using the JP1/AJS3 - Manager file (jajsExecutableCommand)

You can edit the JP1/AJS3 - Manager file (jajsExecutableCommand) to customize JP1/AJS3 - View.

To customize JP1/AJS3 - View by using the JP1/AJS3 - Manager file:

1. Copy the model file (jajsExecutableCommand.model) for the JP1/AJS3 - Manager file (jajsExecutableCommand) to any folder.

   The model file (jajsExecutableCommand.model) is located in the following folder:

   In Windows:

   JP1/AJS3 - Manager-installation-folder\conf

   In UNIX:

   /etc/opt/jp1ajs2/conf

2. Use a text editor to open the copied model file.

3. Specify the settings that you want to customize, and then save the file.

   For details about the file specification format, see 11.3.18 Allowing execution of JP1/AJS3 commands.

4. Change the file name to jajsExecutableCommand, and then move the file to the appropriate location.

   The location of the common customization file for all JP1 users and the location of the customization file for a specific JP1 user are different. If both the common customization file and a user-specific customization file exist in the same location, the settings in the user-specific customization file take precedence. For details, see 4.5.4 JP1/AJS3 commands that can be executed from JP1/AJS3 - View in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

   The following table shows the location of the jajsExecutableCommand file.

   Table 11‒1: Location of the jajsExecutableCommand file

   OS	File containing the common settings for all JP1 users	File containing the settings for a specific JP1 user
   Windows (Physical host)	JP1/AJS3-folder#1\profiles\(jajsExecutableCommand)#2	JP1/AJS3-folder#1\profiles\(jajsExecutableCommand)#2\JP1-user-name
   Windows (Logical host)	shared-folder\jp1ajs2\conf\profiles\(jajsExecutableCommand)#2	shared-folder\jp1ajs2\conf\profiles\(jajsExecutableCommand)#2\JP1-user-name
   UNIX (Physical host)	/etc/opt/jp1ajs2/conf/profiles/(jajsExecutableCommand)#2	/etc/opt/jp1ajs2/conf/profiles/(jajsExecutableCommand)#2/JP1-user-name
   UNIX (Logical host)	shared-directory/jp1ajs2/conf/profiles/(jajsExecutableCommand)#2	shared-directory/jp1ajs2/conf/profiles/(jajsExecutableCommand)#2/JP1-user-name

   #1

   Substitute the following folder for JP1/AJS3-folder:

   In Windows Server 2016, Windows Server 2012, or Windows Server 2008, if the installation folder is the default installation folder or is in a folder protected by the system	%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\conf
   In Windows Server 2016, Windows Server 2012, or Windows Server 2008, if the installation folder is other than the above	JP1/AJS3-Manager-installation-folder\conf
   In Windows Server 2003	JP1/AJS3-Manager-installation-folder\conf

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

   A folder protected by the system is a folder under any of the following:

   - system-drive\Windows

   - system-drive\Program Files

   - system-drive\Program Files (x86) (for 64-bit Windows)

   #2

   The (jajsExecutableCommand) folder is not created during installation or setup of JP1/AJS3 - Manager.

To Page Top

(5) Customization by using user-specified option file (ajs2view_opt.conf)

You can edit the JP1/AJS3 - View user-specified option file (ajs2view_opt.conf) to customize JP1/AJS3 - View.

To customize JP1/AJS3 - View by using the user-specified option file:

1. Copy the model file (ajs2view_opt.conf.model) for the user-specified option file to any folder.

   The following folder contains the model file (ajs2view_opt.conf.model):

   JP1/AJS3 - View-installation-folder\conf

2. Use a text editor to open the copied model file.

3. Specify the settings that you want to customize, and then save them.

   Delete the hash mark (#) preceding an option you want to customize, and then specify a value.

4. Change the file name to ajs2view_opt.conf, and then move the file to the following folder.

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2V\conf\JP1-user-name^#

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

   #

   If the system has been logged in to even once, the folder has already been created with that login JP1 user name.

   If you use any of the following names as the JP1 user name, the folder that is created for each JP1 user name is enclosed in single-byte parentheses ( ).

   - A device name (such as NUL, CON, AUX, COM1 to COM9, LPT1 to LPT9, and PRN)

   - A name consisting of a device and extension

   - A name beginning with a period (.)

5. Start JP1/AJS3 - View.

   The customization is enabled from JP1/AJS3 - View, which starts after the user-specified option file is saved.

Cautionary note

• If no user-specified option file exists, JP1/AJS3 - View uses default values.

• Since version 11-00, the default values have changed for some of the customizable items in the user-specified option file. Whether the new defaults apply in version 11-00 depends on the method you used to install JP1/AJS3, and whether the user-specified option file you are using was created in version 10-50 or earlier.

  The following table describes the circumstances in which the new default values apply in version 11-00.

  Table 11‒2: Application of new default values for version 11-00

  Installation method	Status of user-specified option file for version 10-50 or earlier	Application of new default values in version 11-00
  New installation of version 11-00 or later	Not applicable.	The new default values apply.
  Upgrade installation from version 10-50 or earlier to version 11-00 or later	File has been customized.	The new default values do not apply. Consider whether you need to change the settings in the file to the new default values for version 11-00.
  	File has not been customized.	The new default values apply. Consider whether you need to restore the old default values used in version 10-50 and earlier.

  For details about the items whose default values have changed in version 11-00, and how to change the default values back to those used in version 10-50, see D.1 List of customizable items whose default values have changed in version 11-00.

To Page Top

(6) Customization by using the JP1/AJS3 - View system common settings file (ajs2view_common.conf)

You can edit the JP1/AJS3 - View system common settings file (ajs2view_common.conf) to customize JP1/AJS3 - View.

To customize JP1/AJS3 - View by using the system common settings file:

1. Copy the model file (ajs2view_common.conf.model) for the system common settings file to any folder.

   The following folder contains the model file (ajs2view_common.conf.model):

   JP1/AJS3 - View-installation-folder\conf

2. Use a text editor to open the copied model file.

3. Specify the settings that you want to customize, and then save them.

   Delete the hash mark (#) preceding an option you want to customize, and then specify a value.

4. Change the file name to ajs2view_common.conf and move the file to the following folder.

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2V\conf

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

5. Start JP1/AJS3 - View.

   The customization is enabled from JP1/AJS3 - View, which starts after the system common settings file is saved.

Cautionary notes

• We recommend that users who do not need to change the system common settings file be granted either only read and execute permissions or read only permission.

• If there is no system common settings file, JP1/AJS3 - View uses default values.

To Page Top

(7) Customization by using the JP1/AJS3 - View file (ajs2.conf)

You can edit the JP1/AJS3 - View file (ajs2.conf) to customize JP1/AJS3 - View.

To customize JP1/AJS3 - View by using the file (ajs2.conf):

1. Use a text editor to open the JP1/AJS3 - View file (ajs2.conf).

   The following folder contains the file (ajs2.conf):

   JP1/AJS3 - View-installation-folder\conf

2. Specify the settings that you want to customize, and then save them.

3. Start JP1/AJS3 - View.

   The customization is enabled from JP1/AJS3 - View, which starts after the JP1/AJS3 - View file (ajs2.conf) is saved.

To Page Top