Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


15.1.10 Setting for changing the number of characters specifiable for a unit name in a UTF-8 environment

When you use UTF-8 as the character encoding, a multi-byte character such as Japanese is represented with more bytes than the number of bytes used when you use another character encoding. Because the maximum number of bytes that can be specified for each item of a unit does not depend on the character encoding, the maximum number of characters that can be defined in UTF-8 is less than in Shift JIS.

In a UTF-8 environment, after setting up the embedded database, if one of the following conditions is met, the maximum number of characters that can be specified for some items (such as the unit name) is the same as that in a Shift JIS environment:

For the following items, the maximum number of specifiable characters is the same as that in a Shift JIS environment:

The following describes the procedure for matching the number of characters that can be specified for a unit name in a UTF-8 environment to the number of characters in a Shift JIS environment when you migrate JP1/AJS - Manager to a UTF-8 environment.

Cautionary notes:
  • When you set up an embedded database so that items such as a unit name can be specified with the same number of characters as that is specified in a Shift JIS environment, the maximum number of nested units (the maximum number of hierarchical levels) is 10. Therefore, in a unit configuration consisting of more than 10 levels, you cannot migrate JP1/AJS3 - Manager to a UTF-8 environment. To migrate JP1/AJS3 - Manage in such cases, you need to change the unit configuration before starting the migration.

  • When you want to migrate JP1/AJS3 - Manager to a UTF-8 environment, you need to do so in a standard configuration. If you have upgraded JP1/AJS2 - Manager, change the product to a standard configuration and then migrate it.

    For details about how to change the product to a standard configuration, see 8.5 Upgrading JP1/AJS2 - Manager to JP1/AJS3 - Manager in the JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

  • When the version of JP1/AJS3 - View is 09-50 or earlier, and sjis is set for the DEFLENTYPE environment setting parameter, the scheduler service and lower units are not displayed. If sjis is set for the DEFLENTYPE environment setting parameter for all the scheduler services, a message (KAVV187-E) is output and none of the scheduler services or lower units are displayed. Also, if a scheduler service for which sjis is set for the DEFLENTYPE environment setting parameter is accessed by the ajs command or from manager jobnets, a message (KAVV455-E) is output and the scheduler service and lower units are not displayed.

Organization of this subsection

(1) Definition procedure for a new installation of JP1/AJS3 - Manager

(a) Non-cluster configuration

  1. Save the unit definition.

    Execute the ajsprint command to save the unit definition defined in JP1/AJS - Manager.

  2. Change the character encoding in the unit definition saved in step 1 to UTF-8.

  3. Install JP1/AJS3 - Manager in the UTF-8 environment.

  4. Delete the database.

    Execute the following command to delete the database:

    ajsembdbsetup -del -F service-name

    The following is an example of executing the command:

    ajsembdbsetup -del -F AJSROOT1
  5. Set UTF-8 for the AJSCHARCODE environment setting parameter.

    If the AJSCHARCODE environment setting parameter value is not UTF-8, execute the following command to change the AJSCHARCODE environment setting parameter to UTF-8.

    jajs_config -k "[{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name]" "AJSCHARCODE"="UTF-8"

    The following is an example of executing the command:

    jajs_config -k "[JP1_DEFAULT\JP1AJSMANAGER\AJSROOT1]" "AJSCHARCODE"="UTF-8"
  6. Set up the database.

    Execute the following command to set up the database so that the same number of characters can be specified for items such as unit name in the Shift JIS environment and the UTF-8 environment.

    ajsembdbsetup -e sjis -F service-name -id setup-identifier -p port-number -tp table-name-prefix

    The following is an example of executing the command:

    ajsembdbsetup -e sjis -F AJSROOT1 -id _JF0 -p 22220 -tp AJS1
  7. Stop the embedded database.

    Execute the following command to stop the embedded database.

    ajsembdbstop -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstop -id _JF0
  8. Start JP1/AJS3 - Manager.

  9. Restore the unit definition.

    Execute the ajsdefine command to restore the unit definition converted in step 2.

Supplement:

If you execute the ajsembdbsetup command, the following value is automatically set for the DEFLENTYPE environment setting parameter.

  • When the -del option is specified: byte

  • When the -e sjis option is specified: sjis

(b) Cluster configuration

  1. Save the unit definition.

    Execute the ajsprint command to save the unit definition defined in JP1/AJS - Manager.

  2. Change the character encoding in the unit definition saved in step 1 to UTF-8.

  3. Install JP1/AJS3 - Manager in the UTF-8 environment.

  4. Configure the logical host environment.

    Execute the jajs_setup_cluster command to configure the logical host environment.

    In this case, you need to specify the -E sjis option in the jajs_setup_cluster command.

    If you want to execute the jajs_setup_cluster command with the -S option specified to set up the embedded database separately, you need to specify the -e sjis option for the ajsembdbsetup command, which is the command used to execute setup of the embedded database.

    For details about configuration of a logical host environment, see 17.2.2 Procedure for setting up a cluster system environment (in UNIX version of JP1/AJS3 - Manager).

  5. Stop the embedded database.

    Execute the following command to stop the embedded database.

    ajsembdbstop -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstop -id _JF1
  6. Start JP1/AJS3 - Manager on the logical host.

  7. Restore the unit definition.

    Execute the ajsdefine command to restore the unit definition converted in step 2.

Supplement:
  • If you execute the jajs_setup_cluster command with the -E sjis option specified, the following values are automatically set for the AJSCHARCODE and the DEFLENTYPE environment setting parameters:

    - AJSCHARCODE value: UTF-8

    - DEFLENTYPE value: sjis

  • If you execute the ajsembdbsetup command, the following value is automatically set for the DEFLENTYPE environment setting parameter.

    - When the -del option is specified: byte

    - When the -e sjis option is specified: sjis

(2) Definition procedure for setting the definition in an environment in which JP1/AJS3 - Manager has been installed

(a) Non-cluster configuration

  1. Save the unit definition.

    Execute the ajsprint command to save the unit definition defined in JP1/AJS - Manager.

  2. Change the character encoding in the unit definition saved in step 1 to UTF-8.

  3. Stop the JP1/AJS3 - Manager installed in the UTF-8 environment.

    If the installed JP1/AJS3 - Manager is running, stop it.

    Stop JP1/AJS3 - Manager on all the configured hosts.

  4. Execute the ajsshmdel command to delete the shared memory information.

    Delete the JP1/AJS3 shared memory information. The path of the ajsshmdel command is /opt/jp1ajs2/bin/ajsshmdel.

    The following is an example of executing the command:

    For sh

    /opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

    For csh

    /opt/jp1ajs2/bin/ajsshmdel >&/dev/null

  5. Start the embedded database that will be used for operations.

    If the embedded database to be used for operations is not running, execute the following command to start it.

    ajsembdbstart -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstart -id _JF0
  6. Delete the database.

    Execute the following command to delete the database.

    ajsembdbsetup -del -F service-name

    The following is an example of executing the command:

    ajsembdbsetup -del -F AJSROOT1
  7. Set UTF-8 for the AJSCHARCODE environment setting parameter.

    If the AJSCHARCODE environment setting parameter value is not UTF-8, execute the following command to change the AJSCHARCODE environment setting parameter value to UTF-8.

    jajs_config -k "[{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name]" "AJSCHARCODE"="UTF-8"

    The following is an example of executing the command:

    jajs_config -k "[JP1_DEFAULT\JP1AJSMANAGER\AJSROOT1]" "AJSCHARCODE"="UTF-8"
  8. Set up the database.

    Execute the following command to set up the database so that the same number of characters can be specified for items such as unit name in the Shift JIS environment and the UTF-8 environment.

    ajsembdbsetup -e sjis -F service-name -id setup-identifier -p port-number -tp table-name-prefix

    The following is an example of executing the command:

    ajsembdbsetup -e sjis -F AJSROOT1 -id _JF0 -p 22220 -tp AJS1
  9. Stop the embedded database.

    Execute the following command to stop the embedded database.

    ajsembdbstop -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstop -id _JF0
  10. Start JP1/AJS3 - Manager.

  11. Restore the unit definition.

    Execute the ajsdefine command to restore the unit definition converted in step 2.

Supplement:

If you execute the ajsembdbsetup command, the following value is automatically set for the DEFLENTYPE environment setting parameter:

  • When the -del option is specified: byte

  • When the -e sjis option is specified: sjis

(b) Cluster configuration

  1. Save the unit definition.

    Execute the ajsprint command to save the unit definition defined in JP1/AJS - Manager.

  2. Change the character encoding in the unit definition saved in step 1 to UTF-8.

  3. Stop the JP1/AJS3 - Manager installed in the UTF-8 environment.

    If the installed JP1/AJS3 - Manager is running, stop it.

    Stop JP1/AJS3 - Manager on all the configured hosts.

  4. Execute the ajsshmdel command to delete the shared memory information.

    Delete the JP1/AJS3 shared memory information. The path of the ajsshmdel command is /opt/jp1ajs2/bin/ajsshmdel.

    The following is an example of executing the command:

    For sh

    /opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

    For csh

    /opt/jp1ajs2/bin/ajsshmdel >&/dev/null

  5. Start embedded database that will be used for operations.

    If embedded database to be used for operations is not running, execute the following command to start it.

    ajsembdbstart -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstart -id _JF1
  6. Delete the database.

    Execute the following command to delete the database.

    ajsembdbsetup -del -mh logical-host-name -F scheduler-service-name

    The following is an example of executing the command:

    ajsembdbsetup -del -mh logicalhost -F AJSROOT2
  7. Set UTF-8 for the AJSCHARCODE environment setting parameter.

    If the AJSCHARCODE environment setting parameter value is not UTF-8, execute the following command to change the AJSCHARCODE environment setting parameter to UTF-8.

    jajs_config -k "[{JP1_DEFAULT|logical-host-name}\JP1AJSMANAGER\scheduler-service-name]" "AJSCHARCODE"="UTF-8"

    The following is an example of executing the command:

    jajs_config -k "[logicalhost\JP1AJSMANAGER\AJSROOT2]" "AJSCHARCODE"="UTF-8"
  8. Set up the database.

    Execute the following command to set up the database so that the same number of characters can be specified for items such as unit name in the Shift JIS environment and the UTF-8 environment.

    ajsembdbsetup -e sjis -mh logical-host-name -F scheduler-service-name -id setup-identifier -p port-number -tp table-name-prefix

    The following is an example of executing the command:

    ajsembdbsetup -e sjis -mh logicalhost -F AJSROOT2 -id _JF1 -p 22222 -tp AJS2
  9. Stop the embedded database.

    Execute the following command to stop the embedded database.

    ajsembdbstop -id setup-identifier

    The following is an example of executing the command:

    ajsembdbstop -id _JF1
  10. Apply the environment setting parameters on the primary node to the secondary node.

    The command to be executed on the primary node and the command to be executed on the secondary node are given below.

    Primary node:

    jbsgetcnf -h logical-host-name > backup-file-name

    Secondary node:

    jbssetcnf backup-file-name

    Execution examples for the above commands are given below.

    Primary node:

    jbsgetcnf -h logicalhost > /tmp/param_output.txt

    Secondary node:

    jbssetcnf /tmp/param_output.txt

  11. Start JP1/AJS3 - Manager on the logical host.

  12. Restore the unit definition.

    Execute the ajsdefine command to restore the unit definition converted in step 2.

Supplement:

If you execute the ajsembdbsetup command, the following value is automatically set for the DEFLENTYPE environment setting parameter:

  • When the -del option is specified: byte

  • When the -e sjis option is specified: sjis

(3) Definition procedure for adding a scheduler service to JP1/AJS3 - Manager

(a) Non-cluster configuration

  1. Add a scheduler service.

    Execute the jajs_setup command to add a scheduler service. In this case, you need to specify the -E sjis option for the jajs_setup command.

    If you want to execute the jajs_setup command with the -S option specified to set up the embedded database separately, you need to specify the -e sjis option for the ajsembdbsetup command, which is executed to set up the embedded database.

    For details about how to add a scheduler service, see 15.1.1 Settings for starting multiple scheduler services or 17.2.10 Setting startup of multiple scheduler services on a logical host.

Supplement:

If you execute the jajs_setup command with the -E sjis option specified, the following values are automatically set for the AJSCHARCODE and the DEFLENTYPE environment setting parameters.

  • Value of AJSCHARCODE: UTF-8

  • Value of DEFLENTYPE: sjis

(b) Cluster configuration

See (a) Non-cluster configuration.