サンプルの接続ルーチンおよびサインオン・ルーチンでの処理

IBM® が提供するサンプル・ルーチンは、接続ルーチンおよびサインオン・ルーチンで必要とされる処理のモデルとして使用することができます。

プログラム固有のプログラミング・インターフェース情報の開始
推奨事項: ユーザー独自のルーチンを作成するときは、サンプル・ルーチンを土台に使用して作成することを考えてください。

サンプル接続ルーチン (DSN3SATH) とサンプル・サインオン・ルーチンのどちらにも、セットアップ、定数、およびストレージ域に関する類似したセクションがあります。 どちらのルーチンも、3 つの番号付きセクションの中で、1 次 ID、SQL ID、および 2 次 ID の値を設定します。

サンプル接続ルーチン (DSN3SATH) の場合: サンプル接続ルーチンの 3 つのセクションは、以下の機能を実行します。

セクション 1
セクション 1 は、デフォルト接続ルーチンの場合と同じ機能を実行します。 この機能は、入力 1 次 ID の最初の文字の値がブランク (16 進数 40) より大きいかどうかを判別し、以下の操作を行います。
  • 最初の文字が 16 進数 40 より大きい場合は、値は変更されません。
  • 最初の文字が 16 進数 40 より大きくない場合は、値は以下の規則に従って設定されます。
    • 要求が TSO フォアグラウンド・アドレス・スペースからのものである場合は、1 次 ID はログオン ID に設定されます。
    • 要求が TSO フォアグラウンド・アドレス・スペースからのものではない場合は、1 次 ID は JES ジョブ・コントロール表からのジョブ・ユーザー ID に設定されます。
    • 1 次 ID が見つからない場合は、セクション 2 はバイパスされます。
セクション 2
セクション 2 の先頭で、1 つのコメント化された命令をリストアして、1 次許可 ID が 7 文字に切り捨てられるようにすることができます。(この命令は、コーディング中にコメントとして示されています。)

セクション 2 は、次に RACF® オプションをテストし、2 次 ID の リストに次の変更を加えます (このリストは最初はブランクです)。

  • RACF がアクティブでない場合は、リストはブランクのままになります。
  • 「グループのリスト」オプションがアクティブではなく、ACEE が存在する場合は、 接続されているグループ名が唯一の 2 次 ID としてコピーされます。ACEE のソースは、次のいずれかです。
    • 呼び出し元によりパス済みの ACEE
    • アドレス・スペース・レベルの ACEE
    • 接続がバッチ・ユーティリティーの場合、タスク・レベルの ACEE。
  • 「グループのリスト」オプションがアクティブの場合は、ICHPCGRP ブロック内のグループ名リストが、AIDLSEC の中の許可 ID リストにコピーされます。
セクション 3
セクション 3 は、次のステップを実行します。
  1. SQL ID は、1 次 ID に等しい値に設定されます。
  2. TSO データ・セット名接頭部が有効な 1 次または 2 次 ID の場合は、SQL ID は TSO データ・セット名接頭部で置き換えられます。 そうでない場合は、SQL ID は 1 次 ID に設定されたままになります。

サンプル・サインオン・ルーチン (DSN3SSGN) の場合: サンプル・サインオン・ルーチンの 3 つのセクションは、以下の機能を実行します。

セクション 1
セクション 1 は 1 次 ID を変更しません。
セクション 2
セクション 2 は、SQL ID を 1 次 ID の値にセットします。
セクション 3
セクション 3 は、RACF オプションをテストし、2 次 ID の リストに次の変更を加えます (このリストは最初はブランクです)。
  • RACF がアクティブでない場合は、リストはブランクのままになります。
  • 「グループのリスト」オプションがオンの場合は、セクション 3 は既存の ACEE を見つけ出そうとします (この ACEE から許可 ID リストがコピーされます)。
    • AIDLACEE に有効な ACEE が含まれている場合は、それが使用されます。

      そうでない場合は、TCB または ASXB からチェーニングされた有効な ACEE を見つけるか、あるいは使用可能な ACEE が存在していない場合は、RACROUTE を発行して、RACF が 1 次 ID 用の ACEE 構造を作成するようにします。

      ACEE 構造からのグループ名リストを、2 次許可リストにコピーします。

    • 出口が RACROUTE を出して ACEE を作成した場合は、再び RACROUTE マクロが発行され、その構造が削除されます。
  • 2 次許可 ID のリストが作成されておらず、AIDLSAPM がゼロでない 場合は、AIDLSAPM が指し示しているデータが AIDLSEC にコピーされます。
    プログラム固有のプログラミング・インターフェース情報の終了