FCCT OPEN 関数

OPEN機能は、結合機能データテーブルを定義し CICS®との接続を確立します。テーブル名にアクセスするためのセキュリティー検査が実行されます。テーブルが存在しない場合、暗黙的に作成されます。テーブルでロードが必要な場合、オープンできるのは、アクセス・モードが排他的アクセス (または必要に応じて排他的アクセスを許可する prefer_shared) を指定する場合のみです。

FCCT は、テーブル状況機能 (オープン、クローズなど) のためにカップリング・ファシリティー・データ・テーブル・クロスメモリー・サーバー DFHCFMN との通信にファイル制御で使用されるパラメーター・リストです。

入力パラメーター

TABLE_NAME

CFDT の 16 文字の名前 (末尾スペースが埋め込まれた 8 文字) です。

RECORD_LENGTH

最大レコード長を 1 から 32767 の範囲で指定します。

KEY_LENGTH

キー長を 1 から 16 の範囲で指定します。

MAXIMUM_RECORDS

テーブルに保管できる最大レコード数を指定します。

UPDATE_MODEL

更新に使用する方式を指定します。以下のいずれかの値を取ることができます。

CONTENTION|LOCKING|RECOVERABLE

Contention はバージョンの比較交換を意味します。 Locking は通常の更新ロックを意味します。 Recoverable には、基本ロック・モデルに加えてバックアウト・サポートも含まれます。

INITIAL_LOAD

初期ロードが必要であるかどうかを指定します。以下の値を取ることができます。

YES|NO

OPEN_MODE

read_only または read_write オープンを指定します。以下の値を取ることができます。

READ_ONLY|READ_WRITE

ACCESS_MODE

テーブルをオープンするのが排他的使用のためか、共用使用のためかを指定します。以下の値を取ることができます。

EXCLUSIVE|SHARED|PREFER_SHARED

排他的オープンをアクティブにすることができるユーザーは一度に 1 人のみです。テーブルでロードが必要であり、まだロードされていない場合、排他モードでのみオープンできます。 PREFER_SHARED が指定される場合、ロードが必要であれば、テーブルは排他モードでオープンされ、そうでない場合、共用モードでオープンされます。

SHARED_ACCESS

他のユーザーが同時にファイルに共用アクセスすることを許可するかどうかを、排他モードのオープンに対して指定します。以下の値を取ることができます。

NONE|READ_ONLY|READ_WRITE

TRANSACTION_NUMBER

使用される場合、デバッグ・トレース内の要求タスクを識別します。

出力パラメーター

TABLE_TOKEN

このテーブルとの接続を表す固有のトークンです。クローズと設定を含めて、そのオープン・テーブルに対する後続のすべての要求で渡されなければなりません。

RECORD_LENGTH

テーブルの最大レコード長を戻します。

KEY_LENGTH

テーブルのキー長を戻します。

MAXIMUM_RECORDS

テーブルに対する最大レコード数の制限を戻します。

UPDATE_MODEL

データ・テーブルの更新モデルを戻します。以下のいずれかの値を取ることができます。

CONTENTION|LOCKING|RECOVERABLE

INITIAL_LOAD

データ・テーブルが初期ロードを必要とするかどうかを戻します。以下の値を取ることができます。

YES|NO

ACCESS_MODE

テーブルをオープンしたのが排他的使用のためか、共用使用のためかを戻します。以下の値を取ることができます。

EXCLUSIVE|SHARED

LOADED

テーブルがロードされたかどうかの標識を戻します。テーブルが空として作成された場合、ロードがすでに行われたかのように、これは YES に設定されます。以下の値を取ることができます。

YES|NO

CURRENT_USERS

テーブルに対して現在アクティブな明示オープンの数を戻します (サーバーによって発行された内部のリカバリー可能オープンを含みません)。

CURRENT_RECORDS

データ・テーブル内のレコード数を戻します。

CURRENT_HIGH_KEY

要求の時点でテーブル内の最終レコードのキーを戻すか、またはテーブルにレコードが含まれていない場合は小さい値を戻します。

対応

呼び出しに対する DFHFCCT の応答です。以下のいずれかの値にすることができます。

OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED

[REASON]

RESPONSE が EXCEPTION である場合に戻されます。可能な値は次のとおりです。

対応	可能な REASON 値
EXCEPTION	SERVER_CONNECTION_FAILED ACCESS_NOT_ALLOWED TABLE_NOT_AVAILABLE NOT_YET_LOADED SHARED_ACCESS_CONFLICT EXCLUSIVE_ACCESS_CONFLICT INCOMPATIBLE_ATTRIBUTES INCOMPLETE_ATTRIBUTES INCORRECT_STATE RECOVERY_NOT_ENABLED OPTION_NOT_SUPPORTED NO_SPACE_IN_POOL MAXIMUM TABLES_REACHED TOO_MANY_USERS TABLE_DESTROYED POOL_STATE_ERROR CF_ACCESS_ERROR