2.4.2　システムで使用する言語種別と文字コードについて検討する

■ マネージャーホストとエージェントホストで文字コードが異なるときの注意事項

言語種別が日本語，および英語の場合で，マネージャーホストとエージェントホストで文字コードが異なるときは，マネージャーホスト・エージェントホスト間の通信時に，次に示す定義，入力ファイル，および実行結果の文字コードは通信先で使用している文字コードに変換されます。つまり，マネージャーホストからエージェントホストに通信する場合は，エージェントホストで使用している文字コードに，エージェントホストからマネージャーホストに通信する場合は，マネージャーホストで使用している文字コードに変換されます。

PCジョブ，UNIXジョブ，フレキシブルジョブ，およびQUEUEジョブの場合

定義

• ［実行ファイル名］

• ［コマンド文］

• ［パラメーター］

• ［スクリプトファイル名］

• ［環境変数］

• ［環境変数ファイル名］

• エージェントプロセス実行時のワークディレクトリ名

• ［標準入力ファイル名］

• ［標準出力ファイル名］

• ［標準エラー出力ファイル名］

• ［転送ファイル名］

• ［ジョブ名］（QUEUEジョブの場合）

• ジョブに定義したマクロ変数の値

入力ファイル

• 転送ファイル1〜4の内容

実行結果

• 標準出力ファイルの内容

• 標準エラー出力ファイルの内容（実行結果詳細）

HTTP接続ジョブの場合

定義

• ［接続設定ファイル名］

• ［送信情報ファイル名］

• ［送信情報ファイル名（URLパラメーター）］

• ［送信情報ファイル名（メッセージボディ）］

• ［ステータス格納ファイル名］

• ［受信ヘッダ格納ファイル名］

• ［受信ボディ格納ファイル名］

• ［標準出力ファイル名］

• ［標準エラー出力ファイル名］

実行結果

• 標準出力ファイルの内容

• 標準エラー出力ファイルの内容（実行結果詳細）

アクションジョブ，カスタムジョブの場合

定義

• ジョブに定義した情報

• ジョブに定義したマクロ変数の値

実行結果

• 標準エラー出力ファイルの内容（実行結果詳細）

イベントジョブ，カスタムイベントジョブの場合

定義

• ジョブに定義した情報

実行結果

• 標準エラー出力ファイルの内容（実行結果詳細）

• 引き継ぎ情報（ジョブに定義したマクロ変数の値）

中国語の場合は，マネージャーホスト・エージェントホスト間の通信時に文字コードが変換されません。すべてのマネージャーホスト・エージェントホストの文字コードを中国語に統一する必要があります。

■ 日本語の文字コード種別が混在する場合の注意事項

日本語の文字コード種別が混在する場合，次の制限があります。

• コマンドのリモート実行

  コマンドをリモート実行する場合，コマンド実行元の文字コード種別と，コマンド実行先の文字コードを合わせてください。

  また，コマンド実行先の文字コードがUTF-8コードの場合，コマンド実行元の文字コードをEUCコードに設定することで，コマンドをリモート実行できます。

  コマンドのリモート実行については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　1.1.7 コマンドのリモート実行」を参照してください。

  コマンド実行元の文字コード種別とは，コマンド実行時の，環境変数LANGなどのOS上で設定した文字コード種別です。

  コマンド実行先の文字コード種別とは，次のことを示します。

  • 環境設定パラメーターAJSCHARCODEに指定した文字コード種別

  • JP1/AJS3サービス起動時のOS上の設定

• リモートジョブネット

  リモートジョブネットを実行する場合，リモートジョブネット定義元の文字コード種別と，リモートジョブネット実行先の文字コードを合わせてください。

  リモートジョブネット定義元の文字コード種別，およびリモートジョブネット定義先の文字コードとは，次のことを示します。

  • それぞれのホストで環境設定パラメーターAJSCHARCODEに指定した文字コード種別

  • JP1/AJS3サービス起動時のOS上の設定

• UNIXジョブ・HTTP接続ジョブ・フレキシブルジョブ・アクションジョブ・イベントジョブ・カスタムイベントジョブ

  JP1/AJS3 - Viewやコマンドで，UTF-8環境のエージェントホストで実行するジョブの各項目に日本語を含める場合には，日本語1文字当たり4バイトで見積もり，各項目の制限値以内になるように定義してください。ただし，環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合，次の項目で指定できる文字数はシフトJIS環境と同じです。

  • ユニット詳細定義のユニット名

  • ユニット詳細定義のコメント

  • スケジュール設定の排他ジョブネット名

  マネージャーホストがシフトJISまたはEUC環境，エージェントホストがUTF-8環境のシステム構成で，UNIXジョブ，アクションジョブ，イベントジョブ，カスタムイベントジョブを実行する場合，ジョブに定義した情報サイズは，ジョブを実行時にエージェントホストの文字コードに変換したあとのバイト数でチェックします。その結果，JP1/AJS3 - Viewやコマンドでジョブの各項目に入力できるバイト数以内の定義をした場合でも，ジョブ実行時にエラーが発生する場合があります。

• イベントジョブ・カスタムイベントジョブ

  イベントジョブおよびカスタムイベントジョブの引き継ぎ情報は，エージェントホスト側で，マクロ変数名と引き継ぎ情報のサイズの合計が4,096バイトを超えた部分の情報を切り捨てます。

  UTF-8環境で，日本語を含む情報を引き継ぐ場合は，日本語1文字当たり4バイトで見積もってください。

  また，UTF-8環境から発行されたJP1イベントをUTF-8未対応のJP1/AJS3で受信する場合は，JP1/Baseを文字コード互換モードで動作するように設定してください。文字コード互換モードを使用しない場合，JP1イベントを正しく検知できないなどの問題が発生するおそれがあります。

  文字コード互換モードについては，マニュアル「JP1/Base 運用ガイド」を参照してください。

• サブミットジョブの実行に使用するコマンド

  シフトJISまたはEUC環境のホストからUTF-8環境のマネージャーホストに対してコマンドを実行した場合，コマンド実行ホスト上ではオプション指定値が制限バイト数を超えていなくても，マネージャーホストでエラーが発生することがあります。これは，コマンド実行ホストからマネージャーホストへデータ転送する際の文字コード変換で，日本語を含むオプション指定値のバイト数が大きくなるためです。

  そのため，UTF-8環境のマネージャーホストに対してコマンドを実行する際にオプション指定値に日本語を含める場合は，日本語1文字を4バイトに換算して見積もり，各オプション指定値の制限バイト数以内になるように指定してください。

  該当コマンド：

  jpqjobsub，jpqjobcan，jpqjobalt，jpqjobmove，jpqjobget，jpqjobshow，jpqendjobshow，jpqjobdel，jpqqueopen，jpqqueclose，jpqqueshow，jpqqueadd，jpqquedel，jpqquealt，jpqagtlink，jpqagtunlink，jpqagtshow，jpqagtadd，jpqagtdel，jpqagtalt，jpqresshow，jpqresadd，jpqresdel

■ UTF-8コード使用時の注意事項

• UTF-8コードを使用しているホストからコマンドをリモート実行する際，実行先ホストの文字コード種別（AJSCHARCODE）もUTF-8コードである場合は，環境変数AJSCONVERTUTF8に「no」を指定する必要があります。環境変数AJSCONVERTUTF8を指定しない，または「yes」でコマンドをリモート実行した場合，表示結果に文字化けが発生したり，ユニットに対する処理が正しく行われなかったりします。

  環境変数AJSCONVERTUTF8については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス　1.4 環境変数一覧」を参照してください。

• UTF-8環境で使用できる文字は，「(a) 使用できる文字の範囲」を参照してください。

• UTF-8コードを使用しているマネージャーホストから，UTF-8コードに対応していないエージェントホストにキューレスジョブを実行する場合は，マネージャーホストで環境設定パラメーターQLMANCHARCODEの設定が必要です。QLMANCHARCODEの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.10 キューレスジョブ実行環境設定」を参照してください。

• 文字コードUTF-8を使用していて，環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合，次の項目で指定できる文字数はシフトJIS環境と同じ文字数になります。

  • ユニット詳細定義のユニット名

  • ユニット詳細定義のコメント

  • スケジュール設定の排他ジョブネット名

  ただし，ユニットの最大ネスト数（最大階層数）は10になります（デフォルトは30）。

• JP1/AJS3 - Viewのバージョンが09-50以前の場合，環境設定パラメーターDEFLENTYPEに「sjis」が設定されていると，スケジューラーサービスおよびその配下のユニットが表示されません。すべてのスケジューラーサービスで環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合，メッセージKAVV187-Eが出力され，すべてのスケジューラーサービスおよびその配下のユニットが表示されません。また，環境設定パラメーターDEFLENTYPEに「sjis」が設定されているスケジューラーサービスに対して，ajsコマンド，マネージャージョブネットなどからアクセスすると，メッセージKAVV455-Eが出力されて，スケジューラーサービスおよびその配下のユニットが表示されません。

■ JP1/AJS3 - ManagerおよびJP1/AJS3 - Agent

設定手順を次に示します。

1. OSの言語設定を変更する。

2. JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをインストールする。

3. 次のコマンドを実行する。

   jajs_config -k "[JP1_DEFAULT\JP1AJS2COMMON]" "AJSI18N"="yes"

■ JP1/AJS3 - View

設定手順を次に示します。

1. OSの言語設定を変更する。

2. JP1/AJS3 - Viewをインストールする。

3. 環境設定ファイル（ajs.conf）に定義行「SetCharEncodingNameI18N」を追加し，次の表に示す値を指定する。

   ファイルの格納場所

   JP1/AJS3 - Viewのインストール先フォルダ\conf\ajs.conf

   表2‒36　環境設定ファイル（ajs.conf）に指定する内容

   使用する言語	接続先JP1/AJS3 - ManagerのOS	SetCharEncodingNameI18Nに指定する値
   韓国語	Windows	EUC_KR
   	Linux	EUC_KR
   ドイツ語 フランス語 スペイン語	Windows	ISO8859_1
   	Linux	ISO8859_1
   ロシア語	Windows	CP1251
   	Linux	KOI8_R
   タイ語	Windows	MS874
   	Linux	UTF8

（例）ドイツ語を使用する場合

変更前

[STARTUP]
lang=1

変更後

[STARTUP]
lang=1
SetCharEncodingNameI18N=ISO8859_1

■ JP1/AJS3 - Web Console

設定手順を次に示します。

1. OSの言語設定を変更する。

2. JP1/AJS3 - Web Consoleをインストールする。

3. 環境設定ファイル（ajscharcodemapping.properties）の定義行「I18N」に，次の表に示す値を指定する。

   指定する場所

   Web_Data_Path^※\conf\ajscharcodemapping.properties

   クラスタ運用している場合に指定する場所

   共有ディレクトリ\jp1ajs3web\conf\ajscharcodemapping.properties

   注※

   「Web_Data_Path」は次のパスを表します。

   インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

   %ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\jp1ajs3web

   「%ALLUSERSPROFILE%」のデフォルトは「システムドライブ\ProgramData」です。

   「システムで保護されたフォルダ」とは，次のパスを指します。

   ・「システムドライブ\Windows」配下

   ・「システムドライブ\Program Files」配下

   インストール先フォルダが上記以外の場合

   JP1/AJS3 - Web Consoleのインストール先フォルダ

   表2‒37　環境設定ファイル（ajscharcodemapping.properties）に指定する内容

   言語	接続先JP1/AJS3 - ManagerのOS	I18Nの値
   韓国語	Windows	EUC_KR
   	Linux	EUC_KR
   ドイツ語 フランス語 スペイン語	Windows	ISO8859_1
   	Linux	ISO8859_1
   ロシア語	Windows	CP1251
   	Linux	KOI8_R
   タイ語	Windows	MS874
   	Linux	UTF8

（例）ドイツ語を使用する場合

変更前

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=GB18030

変更後

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=ISO8859_1

■ JP1/AJS3 - ManagerおよびJP1/AJS3 - Agent

設定手順を次に示します。

1. 環境変数LANGに「C」を指定する。

   export LANG=C

2. JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentをインストールする。

   言語設定が英語の状態で，JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentがインストールされます。

3. jajs_configコマンドで環境設定パラメーターAJSI18Nに「yes」を設定する。

   jajs_config -k "[JP1_DEFAULT\JP1AJS2COMMON]" "AJSI18N"="yes"

4. JP1/AJS3環境定義ファイル（jp1ajs_env.conf）で定義された環境変数LANGの値を変更する。

   物理ホストの場合

   /etc/opt/jp1ajs2/conf/jp1ajs_env.conf

   論理ホストの場合

   共有ディレクトリ/jp1ajs2/conf/jp1ajs_env.conf

   表2‒38　使用できる環境変数LANG

   言語	文字コード種別	使用できる環境変数LANGの値
   韓国語	EUC-KR	ko_KR.EUC-KR
   ドイツ語	ISO-8859-1	de_DE.ISO-8859-1
   フランス語	ISO-8859-1	fr_FR.ISO-8859-1
   スペイン語	ISO-8859-1	es_ES.ISO-8859-1
   ロシア語	KOI8-R	ru_RU.KOI8-R
   タイ語	UTF-8	en_US.UTF-8 en_US.utf8

（例）ドイツ語を使用する場合

変更前

LANG=C

変更後

LANG=de_DE.ISO-8859-1

■ JP1/AJS3 - Web Console

設定手順を次に示します。

1. 環境変数LANGに「C」を指定する。

   export LANG=C

2. JP1/AJS3 - Web Consoleをインストールする。

   言語設定が英語の状態で，JP1/AJS3 - Web Consoleがインストールされます。

3. 環境設定ファイル（ajscharcodemapping.properties）の定義行「I18N」に，次の表に示す値を指定する。

   指定場所

   /etc/opt/jp1ajs3web/conf/ajscharcodemapping.properties

   クラスタ運用している場合に指定する場所

   共有ディレクトリ/jp1ajs3web/conf/ajscharcodemapping.properties

   表2‒39　環境設定ファイル（ajscharcodemapping.properties）に指定する内容

   言語	接続先JP1/AJS3 - ManagerのOS	I18Nの値
   韓国語	Windows	EUC_KR
   	Linux	EUC_KR
   ドイツ語 フランス語 スペイン語	Windows	ISO8859_1
   	Linux	ISO8859_1
   ロシア語	Windows	CP1251
   	Linux	KOI8_R
   タイ語	Windows	MS874
   	Linux	UTF8

（例）ドイツ語を使用する場合

変更前

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=GB18030

変更後

C=ASCII
SJIS=MS932
EUC=EUC_JP
UTF-8=UTF8
I18N=ISO8859_1