8.2.1 Migrating the character encoding in Linux from an EUC environment to a UTF-8 environment

(a) Backing up the job execution environment definition

To back up the job execution environment definition:

1. Execute the following command to output the job execution environment definition.

   # jpqexport -dt isam -co file-name [-mh logical-host-name]

   The job execution environment definition is output to the file specified in file-name.

   Cautionary note

   For centralized management, we recommend that you use jpqsetup.conf as the file to be set by the jpqimport command.

   To back up the definition of a logical host, specify the logical host name in the -mh option.

2. Copy the contents of the output file to jpqsetup.conf.

   Copy the contents of the file you output in step 1 to jpqsetup.conf.

(b) Backing up the unit definition

The following describes how to back up the jobnet settings and calendar information.

Cautionary notes

• The jobnet settings and calendar information must be backed up for each scheduler service. Accordingly, back up the information for each scheduler service separately.

• A user with superuser privileges for the OS must perform the following procedure.

1. Backing up the definition information for units other than the root job group.

   Execute the following command to back up the definition information for the units in the scheduler service. The definition information includes the base time, comments, and all other definitions for each unit, but does not include information about the root job group (/), such as the base time, base day, and base month. To back up the root job group information, use the procedures in step 2 and step 3 below.

   # ajsprint -F scheduler-service-name -a '/*' > unitbackup.txt

   Cautionary note

   When you back up a jobnet that was created by copying the root jobnet for which schedule rules have been defined to a nested jobnet, specify no for the AJSPRINTNETSCHPRF environment setting parameter.

   This setting is specified by default in a new installation of JP1/AJS version 08-00 or later. If you upgrade a version of JP1/AJS earlier than 08-00 and this setting has not been specified yet, you will need to change the environment setting parameter. For details about how to change the parameter, see 4.2 Environment setting parameter settings in the JP1/Automatic Job Management System 3 Configuration Guide (for Windows) or 14.2 Environment setting parameter settings in the JP1/Automatic Job Management System 3 Configuration Guide (for UNIX). For details about the environment setting parameter, see 20.4 Setting up the scheduler service environment in the JP1/Automatic Job Management System 3 Configuration Guide.

2. Backing up the information about the root job group.

   Record the following information about the root job group:

   • Comments

   • Owners

   • JP1 resource groups

   • Base time

   • Base day

   • Base month

3. Backing up the calendar information for the root job group.

   Execute the following command to back up the calendar information (open days and close days) for the root job group.

   # ajsprint -F scheduler-service-name -d / > rootcal.txt

   Cautionary note

   If no calendar information is output to rootcal.txt, recovery is not needed.

(a) Recovering an execution environment definition for QUEUE jobs and submit jobs

Use the backed-up configuration definition file (jpqsetup.conf) for the execution environment for QUEUE jobs and submit jobs to create the execution environment for QUEUE jobs and submit jobs.

To recover the execution environment definition for QUEUE jobs and submit jobs:

1. Delete the files in the folder containing the queue information database.

   (a) For a physical host

   # rm /var/opt/jp1ajs2/database/queue/*

   (b) For a logical host

   # rm shared-folder/jp1ajs2/database/queue/*

2. Execute the following command to create an execution environment for QUEUE jobs and submit jobs.

   # jpqimport -dt isam -ci jpqsetup.conf [-mh logical-host-name]

   To recover a logical host definition, specify the logical host name in the -mh option.

(b) Recovering the unit definition

The following describes how to recover the jobnet settings and calendar information.

Cautionary notes

• The jobnet settings and calendar information are recovered for each scheduler service. Accordingly, recover the setup information for each scheduler service separately.

• A user with superuser privileges for the OS must perform the procedure described below.

• Make sure that JP1/AJS2 - Manager is running.

1. Starting the JP1/AJS2 - Manager.

   In a physical host environment, execute the startup command to start JP1/AJS2 - Manager. In a logical host environment, register JP1 in the cluster software and then start JP1/AJS2 - Manager.

2. Recovering the definition information for units other than the root job group.

   Execute the following command to recover the definition information for the units in the scheduler service. The definition information includes the base time, comments, and all other definitions for each unit, but does not include information about the root job group (/), such as the base time, base day, and base month. To recover the root job group information, use the procedures in step 3 and step 4 below.

   # ajsdefine -F scheduler-service-name unitbackup.txt

3. Recovering the information about the root job group.

   Set the following information about the root job group that you have recorded.

   • Comments

   • Owners

   • JP1 resource groups

   • Base time

   • Base day

   • Base month

4. Recovering the calendar information for the root job group.

   Execute the following command to recover the calendar information (open days and close days) for the root job group.

   # ajscalendar -F scheduler-service-name -df rootcal.txt /

   Cautionary note

   This command recovers the calendar of the scheduler service (AJSROOT1) itself.

   If no calendar information has been output to rootcal.txt, recovery is not needed. For details, see (2) Backing up the definition information.