IMS アダプタ環境プロパティーの設定

サーバー

サーバーホストの名前を指定します。このパラメータは必須です。 

サーバーホスト名。 

ポート

IMS Connect が待機するポートを指定します。このパラメータは必須です。 

IMS Connect が待機するポートを示す数値。デフォルトは 7777 です。 

IRM_LEN

IRM 構造の長さを指定します。ユーザー定義出口の最小サイズは 36 です。HWSIMSO0 および HWSSMPL1 の IRM の最小の長さは 80 です。 

IRM 構造の有効な長さを示す整数。設定済みのデフォルトは 80 です。 

IRM_ID

完全なメッセージの受信後に実行されるユーザー出口の識別子 (文字列) を指定します。 

プログラムでは、呼び出されたルーチンから呼び出し側のルーチンに戻るために出口を使用します。1 つのルーチンに複数の出口ポイントを設定し、各種の条件に応じて終了することができます。 

IMS Connect が提供するユーザーメッセージ出口では、次の ID が使用されます。 

• *IRMREQ* (HWSIMSO0 用)

• *SAMPL1* (HWSSMPL1 用)

適切な識別子の文字列。設定済みのデフォルトは *SAMPL1* です。 

IRM_TIMER

ACK または RESUME TPIPE のあとのデータストアに対する受信の遅延時間を指定します。次の 3 つの定義済みタイマーオプションのいずれかを選択できます。 

• 「.25 SEC」: 0.25 秒。

• 「No_Wait」: タイマーが設定されず、遅延が発生しません。

• 「Block」: 受信が無期限で待機します。この設定は、非同期出力機能の「自動」オプションをサポートするために使用されます。

  または、

  タイマーの値として、次のいずれかの 16 進値を入力できます。

• X01 - X19: 0.01 秒から 0.25 秒まで (0.01 秒単位)。

• X19 - X28: 0.25 秒から 1 秒まで (0.05 秒単位)。

• X28 - X63: 1 秒から 60 秒まで (1 秒単位)。

• X63 - X9E: 1 分から 70 分まで (1 分単位)。

3 つの定義済みオプションのいずれかを選択するか、有効な 16 進値を入力します。設定済みのデフォルトは「.25 SEC」です。 

注: 次の 16 進値は、ドロップダウンメニューの 3 つの定義済みオプションに対応しています。 

• X00 = デフォルト (「.25 SEC」)。

• XE9 = 「No_Wait」(タイマーが設定されない)。

• XFF = 「Block」

IRM_SOCT

ソケット接続のタイプを指定します。 

• 「Transaction」: トランザクションソケット。ソケット接続が 1 つのトランザクションを通して持続します。

• 「Persistent」: 持続ソケット。ソケット接続が複数のトランザクションにまたがって持続します。

• 「Non_Persistent」: 非持続ソケット。ソケット接続が 1 回の入力と 1 回の出力で構成される 1 回の交換の間だけ持続します。対話型トランザクションを実装している場合は、接続と切断が何度も行われるため、「Non_Persistent」を使用しないでください。

3 つのオプションのいずれかを選択します。設定済みのデフォルトは「Persistent」です。 

このプロパティーのデフォルトは、以前のバージョンから変更されました。

IRM_CLIENTID

IMS Connect が使用するクライアント ID (文字列) の名前を指定します。  

IMS アダプタは、シリアルモードとパラレルモードの両方をサポートします。シリアルモードは、クライアント ID を指定することでサポートされます。パラレルモードは、* の付いたクライアント ID を指定することでサポートされます。 

クライアント ID は、配備ごとに一意である必要があります。

IMS Connect が使用するクライアント ID。 

IRM_F1 (MFS MOD 名)

MFS MOD (メッセージ出力記述子) が出力の一部として返されるかどうかを指定します。 

MFS: ユーザーは MFS MOD 名を返すように要求します。 

NO_MFS: ユーザーは MFS MOD 名を返さないように要求します。 

「MFS」を指定すると、出力メッセージの最初の構造として、RMM (MOD メッセージの要求) が返されます。この構造には、*REQMOD* という ID と、その直後に MFS MOD 名が含まれています。詳細は、IBM の『IMS Connect Guide and Reference』(SC27-0946-00) の 59 ページを参照してください。 

「MFS」または「NO_MFS」。デフォルトは「NO_MFS」です。 

IRM_F2 (コミットモード)

コミットモードを指定します。 

• 「COMMIT_MODE_0」 - 「commit-then-send」とも呼ばれます。

• 「COMMIT_MODE_1」 - 「send-then-commit」とも呼ばれます。

  IRM ヘッダーの詳細は、IBM の『IMS Connect Guide and Reference』(SC27-0946-00) を参照してください。

「COMMIT_MODE_0」または「COMMIT_MODE_1」。デフォルトは「COMMIT_MODE_1」です。 

このプロパティーのデフォルトは、以前のバージョンから変更されました。

IRM_F3 (同期レベル)

コミットモード 1 の処理で、メッセージを ACK で確認するかどうかを指定します。コミットモード 0 の場合は、「IRM_F3」を「SYNC_LEVEL_CONFIRM」に設定する必要があります。 

• 「SYNC_LEVEL_CONFIRM」: 「IRM_F2」パラメータのコミットモードが「COMMIT_MODE_0」に設定されている場合に使用する必要があります。

• 「SYNC_LEVEL_NONE」: 同期レベルを設定しません。

「SYNC_LEVEL_CONFIRM」または「SYNC_LEVEL_NONE」。「IRM_F2」パラメータが「COMMIT_MODE_0」に設定されている場合は、同期レベルを「SYNC_LEVEL_CONFIRM」に設定する必要があります。デフォルトは「SYNC_LEVEL_NONE」です。 

このプロパティーのデフォルトは、以前のバージョンから変更されました。

IRM_F4 (ACK/NAK 応答)

IMS Connect に送信され、IMS に転送される ACK/NAK (肯定的/否定的確認) 応答の表現を指定します。ACK/NAK/DEALLOCATE/RESUME (A/N/D/R) の各値は、データ要素なしで IMS Connect に送信する必要があります。 

• 「NO_ACK」: 確認または解放の要求がありません。IMS Connect に応答モードトランザクションまたは対話型トランザクションが送信される場合は、「IRM_F4」を「NO_ACK」に設定する必要があります。

• 「ACK」: 肯定的な確認応答。同期レベルが COMFIRM (「SYNC_LEVEL_CONFIRM」) に設定されているクライアントに送信されたメッセージへの応答として使用されます。

• 「DEALLOCATE」: 接続を解放します。対話が完了する前に対話を終了させるために使用されます。

• 「NACK」: 否定的な確認応答。同期レベルが COMFIRM (「SYNC_LEVEL_CONFIRM」) に設定されているクライアントに送信されたメッセージへの応答として使用されます。

6 つのオプションのいずれかを選択します。設定済みのデフォルトは「NO_ACK」です。 

• 「RESUME」: TPIPE を再開します。IMS からの非同期出力データを要求するために使用されます。「RESUME」は、トランザクションソケットに対して「COMMIT_MODE_0」として実行する必要があります。

• 「SENDONLY」: 送信のみを行います。非応答トランザクションおよび IMS へのデータ送信に使用されます。「SENDONLY」は「COMMIT_MODE_0」として実行する必要があります。

IRM_F5 (フロー制御)

フロー制御プロパティーを指定します。 

デフォルト値の「No_Auto_Flow」を使用することをお勧めします。 

「No_Auto_Flow」以外の値を使用する場合は、事前に Sun サポートにお問い合わせください。

• 「Client_Translation」: トランザクションがクライアントによって実行されます。

• 「Single_Message」: TPIPE 再開後の受信時に 1 つのメッセージだけを返します。

• 「No_Auto_Flow」: メッセージの自動フローを行いません (意味は「No_Auto_Flow_Out」を参照)。

• 「Auto_Flow_Out」: 自動メッセージフロー。現在のすべてのメッセージを一度に 1 つずつ返し、「IRM_TIMER」の値が示す時間だけ、次のメッセージのために最後の受信を待機します。「IRM_TIMER」を大きい値に設定してください。これは、出力専用のクライアントでのみ使用します。

• 「No_Auto_Flow_Out」: メッセージの自動フローを行いません。現在のすべてのメッセージを一度に 1 つずつ返し、「IRM_TIMER」の値が示す時間だけ、次のメッセージの最後の受信を待機します。「IRM_TIMER」を小さい値に設定してください。これは、出力専用のクライアントでのみ使用します。この値は前述の「Auto_Flow_Out」に似ていますが、「IRM_TIMER」によって最後の受信が終了する点が異なります。

推奨される設定は、「No_Auto_Flow」(デフォルト) です。 

IRM_TRNCOD

デフォルトの IMS トランザクションコードを指定します。 

有効なトランザクションコード。 

IRM_TRNCOD_SRC

トランザクションコードの取得元を指定します。 

• 「CFG」: トランザクションコードを設定ファイルから取得します。

• 「MESSAGE」: トランザクションコードはメッセージの最初の 8 バイトです。

2 つのオプションのどちらかを選択します。設定済みのデフォルトは「CFG」です。 

IRM_DESTID

データストア名 (IMS 送信先 ID) を指定します。このフィールドは必須です。 

文字列セット。データベース名/IMS 送信先 ID (文字列)。 

IRM_LTERM

IMS LTERM オーバーライド名を指定します。このフィールドには、名前または空白を設定できます。 

適切な LTERM 名または空白。 

IRM_RACF_GRNAME

RACF グループ名を指定します。RACF を使用する場合は、クライアントが RACF グループ名を提供する必要があります。 

適切な RACF グループ名。 

IRM_RACF_USERID

RACF ユーザー ID を指定します。RACF を使用する場合は、クライアントが RACF ユーザー ID を提供する必要があります。 

有効な RACF ユーザー ID。 

IRM_RACF_PW

RACF PASSTICKET を指定します。RACF を使用する場合は、クライアントが RACF PASSTICKET を提供する必要があります。 

適切な RACF PASSTICKET。 

IRM_HEADER_ENCODING

IMS Connect に送信される IRM ヘッダープロパティーのエンコーディングを指定します。 

• メッセージ本文が ASCII テキストの場合は、値を ISO-8859-1 に設定します。IMS Connect の *SAMPL1* ユーザー出口は、データを EBCDIC に変換します。

• メッセージが EBCDIC テキストまたはバイナリデータの場合は、値を EBCDIC コードセット (cp500 など) に設定します。データ変換は行われません。

ASCII トランザクションコンテンツの場合は ISO-8859-1、EBCDIC トランザクションコンテンツの場合は EBCDIC コード (cp500 など)。 

SEND_DATA_ENCODING

IMS Connect に送信されるメッセージ本文に適用されるエンコーディング変換 (使用される場合) を指定します。 

• 変換なしで IMS Connect にメッセージ本文を送信する場合、および IRM ヘッダーとメッセージ本文が ASCII 形式のときに *SAMPL1* ユーザー出口を使用する場合は、「NO TRANSLATION」を設定します。

• IMS Connect に送信する前にメッセージ本文を ASCII から EBCDIC に変換する場合は、EBCDIC コード (cp500 など) を設定します。

• コンテンツが日本語などの 2 バイト文字セットである場合は、その言語の EBCDIC コードページ (たとえば、日本語の場合は cp390) を設定します。

「NO TRANSLATION」または次に示す適切なコードページ。 

• *SAMPL1* ユーザー出口を使用している場合、および IRM ヘッダーとメッセージコンテンツが ASCII 形式である場合は、「NO TRANSLATION」を入力します。

• IMS Connect に送信する前に ASCII メッセージコンテンツを EBCDIC に変換する場合は、EBCDIC コード (cp500 など) を入力します。

• 2 バイト文字セットの場合は、その言語の適切なコードページ (たとえば、日本語の場合は cp390) を入力します。

REPLY_DATA_ENCODING

IMS Connect から受信するメッセージ本文のエンコーディングを指定します。 

メッセージテキストが ASCII の場合は、ISO-8859-1 に設定します。 

• 返信メッセージが EBCDIC の場合、コンテンツの変換が不要な場合、またはその両方の場合は、EBCDIC コード (cp500 など) に設定します。

• コンテンツセットが日本語などの 2 バイト文字である場合は、その言語の適切な EBCDIC コードページ (たとえば、日本語の場合は cp390) を設定します。

適切なコードページを次に示します。 

ASCII 変換の場合は、ISO-8859-1 を入力します。 

• EBCDIC トランザクションの場合は、EBCDIC コード (cp500 など) を入力します。

• 2 バイト文字セットの場合は、その言語の適切なコードページ (たとえば、日本語の場合は cp390) を入力します。

待機タイムアウト 

「IRM_CLIENTID」が静的な場合は、要求が直列化されるため、同じクライアント ID を使用する複数のスレッドによる要求ロックの競合が起こります。別のスレッドによって保持されている要求ロックが競合するスレッドは、保留状態の要求スレッドがロックを解放するまで待機します。このパラメータは、要求スレッドがロックを待機する時間 (ミリ秒単位) を制御します。 

スレッドがロックを待機する時間の設定を示す整数。デフォルトは 6000 (ミリ秒) です。

最大再試行回数 

IMS アダプタデータベースとの接続の取得に失敗したときに接続を確立するために行う再試行の回数を指定します。 

接続を確立するために行うことができる再試行の回数を示す整数。設定済みのデフォルトは 5 です。

再試行間隔 (ミリ秒) 

宛先ファイルへのアクセスを次に再試行するまでの設定された一時停止の長さを指定します。このプロパティーは、「最大再試行回数」プロパティーと組み合わせて使用します。

宛先ファイルへのアクセスを次に再試行するまでの時間 (ミリ秒単位) の設定された長さを示す整数。設定済みのデフォルト値は 5000 (1 秒) です。

通常プールサイズ 

維持する接続の初期数および最小数を指定します。 

維持する接続の初期数および最小数を示す数値。設定済みのデフォルトは 2 です。 

最大プールサイズ 

プール内で常に使用可能にする物理接続の最大数。0 (ゼロ) は、最大数がないことを示します。 

有効な数値。デフォルトは 10 です。