Transient Data Definitions (TDD)

Transient Data Definitions (TDD) は、一時データが領域にルーティングされる際の送り元と送り先の記号宛先のそれぞれを定義します。領域で使用可能な一時データ・キューをアプリケーション・プログラムで使用するには、それぞれのキューの名前を CICS® に定義しておく必要があります。TDD にリモートおよびローカル・キューを 定義できます。一時記憶域キューとは異なり、一時データ・キューは、アプリケーションから EXEC CICS WRITEQ コマンドを使用して動的に作成することはできません。このトピックでは、Transient Data Definitions (TDD) の以下の属性について説明します。
注: 属性名はコマンド行で使用されるとおりに表示されており、 AIX® System Management Interface Tool (SMIT) で使用される説明が括弧内に続いています。
<Key>
この属性は、一時データ・キューの名前を指定し、TDD 項目のキーになります。CICS は、一時データ操作で、宛先を指定する際にこの名前を使用します。キュー名は、各国語サポート (NLS) ではサポートされていません。! から ~ まで (10 進数の 33 から 126 まで) の最大 4 文字を含めることができます。キュー名を C という文字または「DFH」という文字で始めることはできません。これらの文字は、一部の CICS 機能が必要とする宛先を定義するために予約されています。すべての永続データベース操作、および実行時データベースの挿入操作では、CICS は、データベース・キーを構成するバイトに対し、クラス固有の妥当性検査を行います。

SMIT (CICS for AIX) または SAM (CICS for HP-IA) を使用してこの値を設定する場合は、文字の使用に関する制約事項を参照してください。

ActivateOnStartup (リソースをコールド・スタート時に活動化しますか?)
この属性は、領域のコールド・スタート時に永続データベースからランタイム・データベースに リソース定義を常にコピーするかどうかを指定します。 この属性が yes に設定されると、永続データベースからランタイム・データベースに リソース定義が常にコピーされます。属性が no に設定されている場合、リソース定義のグループがRegion Definitions (RD) の Groups 属性に指定されている場合を除いて、リソース定義は実行時データベースにコピーされません。デフォルト値は yes です。
AmendCounter (更新の数)
この属性は CICS 内部使用に予約されています。
DestType (キューのタイプ)
この属性は、一時データ・キューが intrapartition、extrapartition、indirect、または remote のいずれであるかを指定します。詳細は、一時データ・キュー (TDQ) についてを参照してください。デフォルト値は intrapartition です。
ExtrapartitionFile (EP キュー・データ・ファイルのファイル名またはパス)
この属性は、区画外キューのパスとファイル名を指定します。ファイルは cics が所有している必要があります。デフォルト値は "" です。
FacilityId (トリガー・タスクのシステム/端末装置)
この属性は、トランザクションの開始の原因となった端末または論理装置 (基本機能 と呼ばれます) の ID を指定します。FacilityType 属性の値に応じて、システム ID か端末 ID のいずれかになります。 FacilityType が file に設定されている場合は、FacilityId に値を指定しないでください。 %R、%H、および %S という省略表現は、FacilityId では展開されません。 例えば、"%H" という値は、実際にはストリング "%H" を意味します。デフォルト値は "" です。 FacilityId 属性は区画内キューにのみ適用できます。
FacilityType (トリガー・タスクに割り振られた機能のタイプ)
この属性は、トリガー・タスクに割り振られた基本機能のタイプを指定します。可能な値は terminal、system、または file です。 値 terminal を指定すると、FacilityId 属性で示される端末でトリガー・トランザクションが実行されます。トランザクションを実行するための端末が存在している必要があります。system を指定すると、CICS は、FacilityId で示されるリモート・システムとの分散トランザクション処理 (DTP) 会話を割り振ってから、そのリモート・システムを始動します。値 file は、トリガー・トランザクションが非機能タスクまたはバックグラウンド・タスクとして実行され、そのトランザクションには端末がないことを意味します。FacilityId 属性の値は無視されます。デフォルト値は file です。
GroupName (リソースが属するグループ)
この属性は、このリソース定義が属するグループの名前を指定します。名前は 8 バイトのストリングで指定します。コールド・スタートでは、 Region Definitions (RD) の Groups 属性で指定されたグループに属するリソース定義を、CICS が永続データベースからランタイム・データベースへコピーすることを指定できます。 (これは 定義を永続データベースからランタイム・データベースへ始動時にコピーするリソースの ActivateOnStartup 属性を yes に設定するのに追加して行えます。) デフォルト値は "" で、グループの指定はありません。
IndirectQueueId (間接的なキュー名)
この属性は、一時データ・キューの別名を指定します。間接宛先は、実際のファイルを指すのではなく、区画外、区画内、またはリモートの別の宛先を指します。さらに別の間接宛先になることもあります。間接キューが必要な場合に、この属性に値を指定してください。 この値は、ASCII テキストで指定します。省略表現 %R、%H、および %S はこの属性では展開されません。例えば、"%H" という値は、実際にはストリング "%H" を意味します。デフォルト値は "" です。
IOMode (EP キューの入出力モード)
この属性は、区画外キューが読み取り専用 (データがキューから読み取られる) なのか、または書き込み専用 (データがキューに書き込まれる) なのかを指定します。値 input はデータが読み取られることを指定し、値 output はデータがキューに書き込まれることを指定します。デフォルト値は output です。
MaxSize (EP キュー・データ・ファイルの最大サイズ)
この属性は、ExtrapartitionFile によって定義されたキューに関連付けられているファイルのサイズをバイト数で指定します。値を 0 に設定した場合、ExtrapartitionFile への書き込みの際に、ファイル・サイズの検査は行われません。 値を 0 よりも大きくした場合には、EXEC CICS WRITEQ TD 呼び出しにより、トランザクションが区画外ファイルに何らかのデータを書き込むたびに、検査が行われます。区画外ファイルのサイズがこの値よりも大きくなった場合は、ExtrapartitionFile は ExtrapartitionFile.timestamp としてバックアップされます。その次に、新しいファイルが ExtrapartitionFile として開き、レコードがその新しいファイルに書き込まれます。 この属性は、キューが出力モードで開いた場合にのみ適用でき、キューが入力モードで開いた場合は無視されます。デフォルト値は 0 です。最大値は 4294967296、つまり 4 GB です。

MaxSize 属性を設定すれば、CSMT.out ファイル (TDD スタンザに区画外ファイルとして定義されるファイル) のサイズを制限できます。CSMT.out のサイズが MaxSize に指定した値に達するたびに、ファイルはバックアップされ、新しい CSMT.out ファイルが作成されます。Windows では、他のアプリケーションが CSMT.out ファイルを使用した場合に、コンソール・ログに「CSMT.out ファイルのバックアップの作成中にシステム・エラー 13 が発生しました」と表示されることがあります。このファイルは、TXSeries に付属している cicstail ユーティリティーでも使用されます。したがって、コンソール・ログにこのメッセージが表示されたら、cicstail アプリケーションをしばらくの間、一時的に閉じると、バックアップを完了させることができます。

OpenMode (EP 出力ファイルを切り捨てモードまたは付加モードで開く)
この属性は、CICS が出力区画外一時データ・キューを空にするのか、またはそのキューにデータを付加するのかを指定します。可能な値は、truncate (始動時、またはいったん閉じてから開き直したときにキューが空になるように指定)、および append (データが常にキューに付加されるように指定) です。 デフォルト値は truncate です。
CICS は、この属性を append に設定して MaxSize を 0 に指定したキューを空にしないため、大きくなり過ぎたキューは、管理作業によって空にする必要があることに注意してください。 CICS がオフラインになっている場合は、キューに関連付けられているファイルを削除してください。このファイルは、ExtrapartitionFile 属性に指定されています。CICS がオンラインになっている場合は、以下の操作を実行します。
  1. トランザクション CEMT SET TDQUEUE または CICS コマンド EXEC CICS SET TDQUEUE を使用して、キューを閉じて無効にします。
  2. キューに関連付けられているファイルを削除します。
  3. トランザクション CEMT SET TDQUEUE またはコマンド EXEC CICS SET TDQUEUE を使用して、キューを開いて有効にします。
トランザクション CEMT SET TDQUEUE の詳細については、CEMT INQ/SET TDQUEUEを参照してください。また、コマンド EXEC CICS SET TDQUEUE については、SET TDQUEUEを参照してください。

このキューの MaxSize が 0 よりも大きい場合、CICS は、キューに関連付けられている既存のファイルのサイズが MaxSize の値を超えるとすぐに、そのファイルのバックアップを作成します。ExtrapartitionFile は閉じて、ExtrapartitionFile.timestamp としてバックアップされます。新しい ExtrapartitionFile が開き、それ以降の EXEC CICS WRITEQ TD 呼び出しでは、新しく開いたファイルに書き込みが行われます。

Permanent (リソースを変更から保護しますか?)
この属性は、永続データベース項目の変更または削除を許可するかどうかを指定します。属性が no に設定されている場合、項目は変更または削除できます。この属性を yes に設定した場合、項目の変更または削除はできません。項目を変更するには、属性を no にリセットします。項目を変更した後、この属性を再び yes に設定してください。デフォルト値は no です。
RecordLen (固定長の EP キューのレコード長)
この属性は、区画外一時データ・キューを格納するファイルのレコードの長さを数値で指定します。この値は、DestType 属性を extrapartition に設定し、RecordType 属性を fixed_length に設定した場合にのみ使用されます。デフォルト値は 1024 です。
RecordTerminator (固定長キューの終了文字の ASCII 値)
この属性は、一時データ・キュー・レコードのレコード区切り文字を 3 桁の ASCII 数値で指定します。この値は、DestType 属性を extrapartition に設定し、RecordType 属性を byte_terminated に設定した場合にのみ使用されます。デフォルト値は 000 です。
RecordType (EP キュー・データ・ファイルのレコード編成)
この属性は、区画外一時データ・キューの格納に使用されるファイルのフォーマットを指定します。可能な値は、fixed_length、variable_length、line_oriented、null_terminated、および byte_terminated です。デフォルト値は fixed_length です。
RecoveryType (IP キューのリカバリー可能性タイプ)
この属性は、区画内宛先が論理的にリカバリー可能なのか、物理的にリカバリー可能なのか、あるいはリカバリー可能でないのかを指定します。可能な値は logical、physical、および none です。

論理的にリカバリー可能な宛先は、(個々のトランザクションまたは領域が異常終了した後で) 最後に完了した作業論理単位 (LUW) が終了した時点の状況に復元されます。

CICS は、物理的にリカバリー可能な宛先を、(領域が異常終了した後で) 異常終了が発生した時点の状況に復元します。CICS は最後に読み取られたレコードを復元し、リーダーがまだそのレコードを処理していない可能性があれば、そのレコードを再度読み取れるようにします。デフォルト値は logical です。

RemoteName (リモート・キュー名)
この属性は、リモート領域にあるキューを、その領域内で認識するための名前を指定します。値は ASCII 文字で指定します。この属性に値を指定しない場合、CICS はリモート領域にローカル ID を送信します。複数の領域に同じ名前の宛先がある場合は、ローカル・キーを使用して、一時データ要求を特定の領域にルーティングするための別名を定義できます。別名を使用している一時データ要求は、要求の送信先になるリモート名と領域を識別します。 省略表現 %R、%H、および %S はこの属性では展開されません。例えば、"%H" という値は、実際にはストリング "%H" を意味します。デフォルト値は "" です。
RemoteSysId (リモート・システム ID)
この属性は、リモート領域にキューがある場合に、そのリモート領域への接続を定義するCommunications Definitions (CD) 項目の名前を指定します。デフォルト値は "" で、ファイル・キューがローカル領域にあることを意味します。
ResourceDescription (リソース記述)
この属性は、この TDD 項目を 30 バイトのストリングで指定します。デフォルト値は「Transient Data Definition」です。
RSLKey (リソース・レベル・セキュリティー・キー)
この属性は、1 から 24 までの範囲で、この一時データ・キューのリソース・セキュリティー・キーを指定します。トランザクションがこのジャーナルに書き込む要求を発行し、そのトランザクションのユーザーのUser Definitions (UD) 項目の RSLKeyList 属性に、この RSLKey 値がない場合、CICS は NOTAUTH 条件を発生させます。あるいは、public または private の値を指定できます。 public を使用すると、任意のユーザーがキューにアクセスできるようになります。private を使用すると、CICS は、Transaction Definitions (TD) 項目で属性 RSLCheck が none に設定されているトランザクションからのみ、キューへのアクセスを許可します。 デフォルト値は private です。

リソース・セキュリティーについて詳しくは、CICS リソースへのユーザー・アクセスの許可を参照してください。

TemplateDefined (ユーザーの変換テンプレートは定義されていますか?)
この属性は、一時データ・レコードを記述する変換テンプレートが存在するかどうかを指定します。可能な値は yes および no です。この一時データ・キューに非 ASCII 領域からアクセスできる場合、あるいはキューの中にバイナリー・データまたはユーザー定義のデータが入っている場合は、そのようなテンプレートを定義する必要があります。 そのようなテンプレートが存在する場合はこの属性を yes に設定し、そうでない場合は no に設定します。デフォルト値は no です。
TriggeredTransId (トリガー対象のトランザクションの ID)
この属性は、TriggerLevel 属性の値に達したときに、自動的に開始するトランザクションを指定します。このようにして開始されるトランザクションの目的は、宛先からレコードを読み取ることです。この属性に値を指定しない場合、または TriggerLevel 属性に値 0 を設定した場合には、宛先からレコードを読み取ることができるように、他の方法でトランザクションをスケジュールする必要があります。このトランザクションをリモート CICS 領域に置いてはなりません。置いた場合、そのトランザクションを開始しようとすると、異常終了が発生します。デフォルト値は "" です。 TriggeredTransId 属性は区画内キューにのみ適用できます。
TriggerLevel (トリガー・レベル)
この属性は、蓄積されるコミット済みのレコードの数を指定し、この数に達すると、このレコードを処理するためにタスクが自動的に開始されます。値は 0 から 32767 までの間に設定します。デフォルト値は 0 です。TriggerLevel 属性は区画内キューにのみ適用できます。
WhenOpened (キューをオープンするタイミング)
この属性は、CICS が一時データ・キューを始動時に開くか、要求時に開くかを指定します。区画外キューにのみ適用されます。可能な設定値は at_startup および on_request です。 デフォルト値は at_startup です。TD キューを開くときと閉じるときには CEMT を使用する必要があることに注意してください。詳しくは、CEMT INQ/SET TDQUEUEを参照してください。