TDQUEUE 属性

TDQUEUE リソースの構文および属性について説明します。

区画外キューの属性

区画内キューの属性

間接キューの TDQUEUE 属性

未指定の TYPE のリモート・キューの TDQUEUE 属性

ATIFACILITY({TERMINAL|FILE|SYSTEM}) (区画内キューのみ)

キューが表す宛先のタイプを指定します。

FILE: 一時データ・キューは、特定の端末またはシステムに関連しないデータ・レコードのファイルとして使用されます。 ATI は、端末が使用可能であることを必要としません。
SYSTEM: 一時データ・キューは指定されたシステムIDに関連付けられます。システムは、RDO CONNECTION 定義を使用してローカル CICS® システムに定義されている必要があります。
ATIFACILITY(SYSTEM)を指定すると、分散トランザクション処理 (DTP)セッションが開始されます。アプリケーション・プログラミングにおける DTP の考慮事項について詳しくは、分散トランザクション処理 (DTP)を参照してください。
端末: 一時データ・キューは端末に関連付けられます。この端末は、CICS に定義されていなければなりません。 TERMINAL を指定しない場合、これはデフォルト値である FACILITYID になります。 ATI を使用する場合は、TRANSID 属性および TRIGGERLEVEL 属性で指定された内容に従って、開始されたトランザクションが指定端末と関連付けられます。この端末はトランザクションの開始前に使用可能になっている必要があります。

BLOCKFORMAT({BLOCKED|UNBLOCKED|ブランク}) (区画外キューのみ)

データ・セットのブロック・フォーマットを指定します。デフォルトはありません。レコード形式 (RECORDFORMAT 属性) を未定義として指定した場合 (またはデフォルトが適用されるようにした場合)、BLOCKFORMAT 属性には何も指定できません。

ブランク: このデータ・セットに対してブロック形式が定義されていないことを示します。 RECORDFORMAT をブランクにする場合は、このフィールドもブランクにします。
BLOCKED: ブロック化レコード形式。
UNBLOCKED: 非ブロック化レコード形式。

JES内部読み取りプログラムへのインターフェースとして使用される区分外キューには非ブロック化レコード形式を指定することを強く推奨します。ブロック化レコード形式を使用する場合、ジョブは SYSOUT データ・セットに保留され、以下のいずれかの処置が行われるまで JES に直接送信されません。

JES /*EOF 制御ステートメントの後に 2 番目の /*EOF ステートメントを指定します。
アプリケーションは、別のジョブを同じキューに書き込みます。
ジョブの書き込み後に、明示的にキューをクローズします。
CICS を正常にシャットダウンします。

BLOCKSIZE({length}) (区画外キューのみ)

ブロックの長さ (バイト数) を 0 から　32767 の範囲で指定します。

指定できる最大値は、SYSOUTCLASS が (明示的に、あるいはデフォルトで) 指定されているか、および RECORDFORMAT が FIXED であるか VARIABLE であるかによって異なります。

SYSOUTCLASS を指定した場合、RECORDSIZE の最大値は 8968 です。
可変長フォーマットのデータ・セット内の各ブロックは、ブロック記述子ワードと、その後に続く 1 つ以上の論理レコードから構成されます。したがって、RECORDFORMAT(VARIABLE) を指定した場合、BLOCKSIZE に指定する値には、ブロック記述子ワード用の 4 バイトと、可能性のある最大の論理レコード用のスペースが含まれている必要があります。

これらの制限の要約は、以下の表に示しています。

SYSOUTCLASS が指定されているか

はい

いいえ

RECORDFORMAT

VARIABLE

FIXED

VARIABLE

FIXED

RECORDSIZE の最大値

8968

32763

32767

BLOCKSIZE の最大値

8972

8968

32767

DATABUFFERS({1|number}) (区画外キューのみ)

提供されるバッファーの数 (最大 255) を指定します。

DDNAME(DD 名)

始動 JCL で定義されたデータ・セットを参照できる 1 から 8 文字の値を指定します。名前は、 DFHという文字で開始してはなりません。この文字は、 CICSで使用するために予約されています。ただし、その名前が標準宛先の 1 つを記述している場合は除きます。

DESCRIPTION(テキスト)

このフィールドには、定義するリソースの説明を入力することができます。説明文の長さは最大 58 文字です。使用できる文字の制限はありません。ただし、括弧を使用する場合は、それぞれの左括弧に、対応する右括弧が必要です。 CREATE コマンドを使用する場合は、テキスト内のそれぞれの単一アポストロフィごとに、2 つのアポストロフィをコーディングしてください。

DISPOSITION({SHR|OLD|MOD}) (区画外キューのみ)

データ・セットの後処理を指定します。

MOD

CICS は、まずデータ・セットが存在すると想定します。既存の順次データ・セットでは、MOD は読み取り/書き込み機構がデータ・セット内の最終レコードの後に配置されるようにします。 read/writeメカニズムは、データ・セットが出力のため開かれるたびに最終レコードの後に置かれます。

CICS は、DD ステートメント上のデータ・セット、カタログ内のデータ・セット、または前のステップから渡されたデータ・セットのボリューム情報を検出できない場合、そのデータ・セットがこのジョブ・ステップで作成されていると想定します。このように動的に割り振られるデータ・セットは、キューが閉じられると削除され、すべてのレコードが失われます。

新規データ・セットでは、MODはデータ・セットの先頭に read/writeメカニズムを配置します。

OLD

データ・セットはこのジョブ・ステップの前に存在していました。

「SHR」

データ・セットはこのジョブ・ステップの前に存在しており、他の並行ジョブはそれを読み取ることができます。

DSNAME({dsname|DUMMY}) (区画外キューのみ)

この区画外キューに書き込まれたレコードを保管するために使用する QSAM データ・セットの名前を指定します。

許容文字:

A-Z 0-9 $ @ # . -

CICS が区画外一時データ・キューをオープンする要求を受け取ると、データ・セット定義が作成されているかどうかを検査するために始動 JCL が参照されます。見つからない場合は、 DSNAME属性で指定された44文字の名前を使用して、必要なデータ・セットが動的に割り振られます。

このキューについて DSCNAME 値を DSNAME 値に事前割り振りする JCL がある場合、リソース定義内の DSNAME 値は、JCL の DSNAME 値でオーバーライドされます。 JCL割り振りは常に優先されます。

区分データ・セット(PDS)はDSNAME属性でサポートされません。区分外キュー・データ・セットに PDSメンバーを使用する場合は、JCLで明示的にコード化します。このキューを照会しても、返される DSNAME 値でメンバー名は示されないので注意してください。

DUMMY: ダミー・データ・セット名。
名前: 物理データ・セットの44文字の名前。
重要: 区画外キュー・データ・セットにログ・ストリームを使用すると、予測不能な結果が生じる可能性があります。

ERROROPTION({IGNORE|SKIP}) (区画外キューのみ)

入出力エラーが発生した場合に実行されるアクションを指定します。これは以下のいずれかです。

無視: エラーの原因となったブロックが受け入れられます。
SKIP: エラーの原因となったブロックがスキップされます。

FACILITYID(端末|接続) (区画内キューのみ)

以下のいずれかを含む 4 文字のフィールドを指定します。

ATIFACILITY(SYSTEM)を指定する区分内キューのシステムID。
ATIFACILITY(TERMINAL)が指定された端末ID。

FACILITYID フィールドに何も指定しない場合、デフォルトでそれぞれのキューの名前になります。

ATIFACILITY(FILE) が指定された場合は、FACILITYID フィールドをブランクのままにする必要があります。

GROUP(グループ名)

各リソース定義には、GROUP 名が必要です。リソース定義はグループのメンバーになり、グループのインストール時に CICS システムにインストールされます。

許容文字:

A-Z 0-9 $ @ #

小文字を入力した場合は、大文字に変換されます。

GROUP 名は、8 文字以内の長さにすることができます。小文字は大文字として扱われます。

INDIRECTNAME(tdqueue) (間接キューのみ)

この間接キューがデータを送信する一時データ・キューの名前を指定します。一時データ・キューは CICSに定義する必要があり、区画内、区画外、リモート、または間接にすることができます。

JOBUSERID(userid) (区画外キューのみ)

JCL の JOB カードに USER パラメーターが指定されていない場合に、内部読み取りプログラムに実行依頼された JCL ジョブの実行に使用するユーザー ID を指定します。

JOBUSERID が定義されていない場合のデフォルトは、 CICS 領域ユーザー ID です。

注: JOBUSERID が指定された TDQUEUE リソース定義がインストールされており、 CICS 領域で使用されている場合、その JOBUSERID をブランクに変更するには、変更された TDQUEUE リソース定義を再インストールする前に、TDQUEUE を閉じて破棄する必要があります。再インストールの前に TDQUEUE をクローズして破棄しなかった場合は、以前に指定された JOBUSERID が引き続き使用されます。

JOBUSERID を他の特定の値に変更する場合は、破棄ステップは必要ありません。

OPENTIME({INITIAL|DEFERRED}) (区画外キューのみ)

データ・セットの初期状況を指定します。初期状況は、以下のいずれかの値です。

DEFERRED: データ・セットは、CEMT INQUIRE|SET TDQUEUE コマンドを使用して開く指示を出すまで、閉じられたままです。
初期: データ・セットはインストール時に開かれます。ただし、DSNAME 属性が指定されておらず、始動 JCL の DD ステートメントにデータ・セット名が指定されていない場合、一時データ・キューは CICS の始動時に JES に割り振られます。

PRINTCONTROL({ASA|MACHINE|ブランク}) (区画外キューのみ)

使用する制御文字を指定します。デフォルトはありません。

RECORDFORMAT をデフォルトのブランクにした場合、PRINTCONTROL フィールドには何も指定することができません。以下の文字を使用することができます。

ASA: ASA制御文字。
ブランク: 制御文字は使用されません。
MACHINE: マシン制御文字。

RECORDFORMAT({FIXED|VARIABLE|ブランク) (区画外キューのみ)

データ・セットのレコード形式を指定します。

ブランク: RECORDFORMAT を指定しない場合 (つまり、ブランクのまま)、BLOCKFORMAT フィールドおよび PRINTCONTROL フィールドもブランクのままにする必要があります。 RECORDFORMAT がリソース定義に指定されていない場合、TD は、キューをオープンしようとするときに、 CICS 始動 JCL または QSAM データ・セット定義からこの属性を導出しようとします。どちらのソースからもこの情報を導出できない場合、オープン要求は失敗します。
FIXED: 固定レコード。 RECORDFormat(Fixed) を指定する場合、ブロック形式も指定する必要があります。
VARIABLE: 可変レコード。 RECORDFormat(Variable)を指定する場合は、ブロック形式も指定する必要があります。

RECORDSIZE({1|number}) (区画外キューおよびリモート・キュー)

レコード長 (バイト数) を 0 から 32767 の範囲で指定します。

1: デフォルトのレコード長は1バイトです。
数値: 最大32767バイトのレコード長。

SYSOUTCLASS を指定した場合、RECORDSIZE の最大値は 8968 です。
V フォーマット・データ・セットの場合、各論理レコードは、データ・レコードが後に続くレコード記述子で構成されます。 RECORDSIZE フィールドに入力される値には、レコード記述子ワード (または LLBB) 用の 4 バイトが含まれている必要があり、可能性のある最大のデータ・レコードを許容する値でなければなりません。

これらの制限の要約は、BLOCKSIZE 属性の説明に示されています。

TDQUEUE が RECORDSIZE(0) で定義されている場合、レコード長は、入力キューまたは出力キューの操作のデータ・セット DCB LRECL パラメーターから取得されます。

TDQUEUE がゼロ以外の RECORDSIZE で定義されている場合、EXEC CICS READQ コマンドまたは EXEC CICS WRITEQ コマンドの LENGTH パラメーターは RECORDSIZE 値と等しくなければならず、また、基礎となる DCB LRECL 値はオーバーライドされます。

RECOVSTATUS({NO|PHYSICAL|LOGICAL}) (区画内キューのみ)

CICS またはキューを処理しているトランザクションのいずれかが異常終了した場合の、キューのリカバリー可能性属性を指定します。リカバリー可能性属性は次のとおりです。

LOGICAL

このキューは論理的にリカバリー可能です。アプリケーション・プログラムによるアクセスの追跡を保持するために自動ログ記録が実行されます。このキューにアクセスしたトランザクションが、異常終了時、あるいは、その後の緊急時再始動や動的トランザクション・バックアウト時に実行中であった場合、キューは、実行中の UOW によって変更される前の状態に復元されます。

このキューにアクセスすると、DELETEQ TD, WRITEQ TD またはREADQ TDコマンドを発行したタスクは、一時データ・キューの入力端、出力端、または両端にエンキューされます。アクセス先のデータの整合性を確実にするため、エンキューは、タスクが終了するまで（またはUOWの終わりを示す同期点要求を発行するまで）維持されます。これは、エンキューを長時間維持できることを意味し、キューにアクセスするアプリケーション・プログラムが、同期点要求を発行することによって個々の UOW を CICS に定義せずに、キューに対して複数の UOW を実行すると、キューがロックアウトされる可能性があることを意味します。

さらに、論理的にリカバリー可能なキューに対して DELETEQ要求が発行されると、キューの入力端と出力端の両方がエンキューされます。これにより、エンキュー・ロックアウトの可能性が大きくなります。

注: CICS は、リカバリー可能ファイルの場合と同様に、論理的にリカバリー可能な (物理的にリカバリー可能なものとは異なる) TD キューに対するエンキュー保護機能を提供します。ただし、 CICS は、論理的にリカバリー可能な各宛先を、書き込み用と読み取り用の 2 つの別個のリカバリー可能リソースと見なします。

ファイル・レコードの場合、レコードは単一資源として扱われ、必要なロックは1つだけです。一方で、TD キューには、読み取り側と書き込み側の 2 つの「端」があり、これらは別個にエンキュー (ロック) することができます。これは、TD キューからの読み取りと書き込みの両方を (同時に) 制御するために、 CICS は 2 つのポインター (カーソル) (1 つは読み取り用、もう 1 つは書き込み用) を維持する必要があり、これらは競合するトランザクションから保護する必要があるためです。

キュー・レコードは、1 つ以上の制御インターバル (CI) で保持されます。 CI上の最終レコードが読み取られるとすぐ、各CIに解放のマークが付けられます。ただし、タスクの終了または次のユーザー同期点の通過まで、解放は行われません。

いいえ

このキューはリカバリー不能です。このキューへのアクセスを追跡するための自動ロギングは実行されません。キュー・レコードは、1 つ以上の制御インターバル (CI) で保持されます。各 CI は、その CI 上の最後のレコードが読み取られると、すぐに解放されます。

PHYSICAL

このキューは物理的にリカバリー可能です。アプリケーション・プログラムによるアクセスの追跡を保持するために自動ログ記録が実行されます。緊急再始動が行われると、このキューは CICS終了時の状況にリカバリーされます。

キューに対する最後のアクションが READQ 要求であった場合、および関連する作業単位 (UOW) が変更をコミットしなかった場合、キューは CICS の終了時の状況にリカバリー されません 。緊急再始動では、最後の読み取り操作がバックアウトされ、実行されていないように見えます。

キュー・レコードは、1 つ以上の制御インターバル (CI) で保持されます。各 CI は、その CI 上の最後のレコードが読み取られると、すぐに解放されます。

REMOTENAME(tdqueue) (リモート・キューのみ)

一時データ・キューがリモート・システム上にある場合に、キューが存在するシステムまたは領域がそのキューを認識するために使用する 4 文字の名前を指定します。

許容文字:

A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

REMOTELENGTH({1|number}) (リモート・キューのみ)

長さ (バイト数) を 1 から 32767 の範囲で指定します。

SYSOUTデータ・セットでは、REMOTELENGTHフィールドに 8968バイトより大きい値を入力することはできません (SYSOUTCLASS属性が指定されている場合）。

1: 長さは1バイトです。
数値: 最大32767バイトの長さ。

キューがTYPE=EXTRAで定義され、REMOTELENGTHの値が指定されていない場合は、RECORDSIZE属性の値がインストール時に使用されます。

REMOTESYSTEM(接続)

リモート一時データ・キューが存在するシステムまたは領域の 4 文字の英数字名を指定します。入力する名前は、RDO CONNECTION で指定された名前、あるいは RDO IPCONN 定義で指定された名前の最初の 4 文字と同じでなければなりません。接続定義について詳しくは、 CONNECTION 属性または IPCONN 属性を参照してください。

許容文字:

A-Z 0-9 $ @ #

CREATE コマンドを使用しているのでなければ、小文字を入力した場合は、大文字に変換されます。

一時データ・キュー定義がインストールされると、 REMOTESYSTEM属性に入力された名前がシステムIDと比較されます。名前が異なる場合は、システムまたは領域がリモートです。名前が同じ場合は、TYPE属性で指定された値が使用されます。 TYPE属性がブランクである場合、インストールは失敗します。

REWIND({LEAVE|REREAD}) (区画外キューのみ)

テープ・データ・セットの後処理を指定します。後処理は次のいずれかです。

LEAVE: 現行テープ位置はデータ・セットの論理終了に置かれます。
REREAD: 現行テープ位置はデータ・セットの論理開始に置かれます。

SYSOUTCLASS({ブランク|A。Z|0..9|*}) (区画外キューのみ)

区画外キューを物理データ・セットに割り振る代わりに、それをシステム出力データ・セット (SYSOUT と呼ばれる) に割り振ることができます。 SYSOUTCLASS属性を使用して、SYSOUTデータ・セットのクラスを指定します。

ブランク

これはデフォルトのクラスです。

A.Z|0 から 9

CICS ジョブが実行される z/OS システム上にセットアップされている出力クラスを表す単一の英字または数字。

許容文字:

A-Z 0-9

CREATE コマンドを使用しているのでなければ、小文字を入力した場合は、大文字に変換されます。

*

SYSOUT データ・セットのクラスのデフォルトは、 CICS ジョブの JOB ステートメントの MSGLCASS パラメーターに指定されているクラスです。

SYSOUTCLASSをDSNAMEの代わりに使用できます。 DSNAMEと同様に、キューはすでにJCL DDステートメントを使用してSYSOUTに事前割り振りされている場合があります。 JCL DD ステートメントは、TDQUEUE資源定義を使用して作成された仕様を指定変更します。

SYSOUTがJCL内のキューに対して指定されている場合は、クラス以外の属性も指定できます（例えば、形式タイプ）。

注: RDO を使用して SYSOUT データ・セットを指定する場合は、クラス・パラメーターのみがサポートされます。その他のパラメーターが必要な場合は、JCLでSYSOUTデータ・セットを指定します。

SYSOUT およびその関連クラスについて詳しくは、「 z/OS MVS JCL ユーザーズ・ガイド」を参照してください。

TDQUEUE(名前)

一時データ・キューの 1 から 4 文字の名前を指定します。

許容文字:

A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >

指定された名前が4文字より短い場合は、左寄せにされ、 4文字になるようブランクが埋め込まれます。

注:

名前にコンマ (,) を使用すると、以下のようなコマンドを使用できなくなります。
```
CEMT INQUIRE TDQUEUE(value1,value2)
CEMT SET     TDQUEUE(value1,value2)
```
これらのコマンドでは、コンマがリスト区切り文字として機能します。リソース ID のリストの使用については、リソース ID のリストを参照してください。
RACF®を使用して一時データ・キューを保護する場合は、名前に % および & を使用しないでください。 RACF コマンドは、プロファイル名で使用されるときに、これらの文字に特別な意味を割り当てます。一時データのセキュリティーを参照してください。

TRANSID(トランザクション) (区画内キューのみ)

トリガー・レベルに達したときに自動的に開始されるトランザクションの名前を指定します。このようにトランザクションを開始し、キューからレコードを読み取ります。 TRANSID属性が指定されていない（またはTRIGGERLEVEL(0)が指定されている）場合は、別の方法を使用してトランザクションによる一時データ・キューからのレコードの読み取りをスケジュールに入れる必要があります。

指定するトランザクションは、リモート CICS システムにあってはなりません。リモート・システムに置くと、トランザクションの開始が失敗し、警告メッセージがコンソールに出力されます。

TRIGGERLEVEL({1|number}) (区画内キューのみ)

レコードを処理するためにタスクが自動的に開始される前に集計するレコードの数を指定します。（この数はトリガー・レベルと呼ばれます）。

TRANSID 属性を指定すると、TRIGGERLEVEL はデフォルトで 1 になります。 ATI 処理を使用不可に設定するには、トリガー・レベルを 0 に指定します。トランザクションIDを指定しない場合、トリガー・レベルは無視されます。

ATIFACILITY(TERMINAL)を指定した場合は、指定した端末が使用可能になるまでタスクが開始されません。 ATIFACILITY(FILE)を指定した場合、タスクの開始に端末は不要です。

最大タスクで端末以外の宛先にストレージ不足またはスペース不足の条件がある場合、タスクは開始されません。これは、初期化のステージ1と2, およびシャットダウンの最終ステージにも当てはまります。タスクはストレス条件が存在しなくなったときに開始され、その後にTD WRITEが発生します。

論理的にリカバリー可能な一時データ・キューでは、タスクが前方にコミットするまでATIタスクは接続されません。つまり、トリガー・レベルをかなり超えてからATIが発生する場合があります。

z/OS® Communications Server 端末が、トリガー・レベル 1 の 2 つの ISC CICS システムで CSTL トランザクションの宛先として定義されている場合、両方のシステムがセッション開始メッセージおよびセッション終了メッセージを書き込むために端末を繰り返し獲得および解放すると、パフォーマンス上の問題が発生する可能性があります。

CEMT トランザクションを使用して、 CICS の実行中にトリガー・レベルを変更できます。これまでに累積されたレコードと同じ（またはそれより少ない）数にトリガー・レベルを下げると、次のレコードが正常にキューに置かれたときにタスクが開始されます。

1: 累積できるレコードは1つだけです。
数値: 累積レコード数がこの値を超えると、ATIが発生します（最大値は32767）。

TYPE({EXTRA|INTRA|INDIRECT})

以下のタイプの一時データ・キューを指定します。

EXTRA

CICS 領域の外部にあるキューは、 CICSに割り振られます。

区分外キューの用途：

CICS 領域外でのデータの送信: 例えば、バッチ・プログラムで処理するためにトランザクションによって作成されたデータ。
領域外からのデータの取得。例えば、トランザクションへの入力として端末から受信されたデータ。

区分外データは順次であり、QSAMによって管理されます。

INDIRECT

間接キューは、実際のデータ・セットではなく別のキューを指すキューです。間接キューは、区分外、区分内、リモート、または別の間接キューです。

例えば、いくつかの異なるメッセージ・タイプのそれぞれに異なるシンボル名INDIRECTDESTを付けることができます。次に、同じ物理キュー(INDIRECTDEST)または別の物理キューへこれらすべてのメッセージ・タイプを送信できます。

DFH$TDWTサンプル・プログラムは、間接キューを使用して異なるカテゴリーのメッセージを同じ端末へ送信する方法を示しています。 DFH$TDWT のプログラミング情報については、一時データ端末書き込みプログラム (DFH$TDWT) の使用を参照してください。 DFH$TDWT サンプル定義は、「 CICS/ESA 4.1 Sample Applications Guide」に記載されています。

EXEC CICS WRITEQ TD、EXEC CICS READQ、または EXEC CICS DELETEQ コマンドの QUEUE オペランドが間接キューを指定する場合、アクセスは最終ターゲット・キューのセキュリティー設定によって決定されます。

INTRA

一時的に保管されるデータのキュー。

区分内宛先は、端末、ファイル、または別のシステムです。すべての区分内キューのデータを保持するため、 VSAMによって管理される単一のデータ・セットが使用されます。

レコードを処理するトランザクションと区分内キューごとのトリガー・レベルを指定できます。トリガー・レベルは、指定したトランザクションが開始される前に累積が許されるレコード数を示します。トリガー・レベルについて詳しくは、TRIGGERLEVEL属性の説明を参照してください。

区分内キューは、論理的にリカバリー可能、物理的にリカバリー可能、またはリカバリー不能として定義できます。

論理的にリカバリー可能なキューは、（個々のトランザクションの失敗またはシステム全体の障害の後）最後に完了した作業単位(UOW)が終了した時の状況に復元されます。 (UOWは、タスクの開始時または同期点で開始され、タスクの終了時または同期点で終了します）。

物理的にリカバリー可能なキューは、（システム全体の障害の後）システム障害の発生時の状況に復元されます。

TDQUEUE リソース定義では、TYPE=REMOTE を指定することはできません。リモート一時データ・キューを定義したい場合は、TYPE 属性をブランクのままにし、リモート属性 REMOTELENGTH、REMOTENAME、および REMOTESYSTEM の値を指定します。あるいは、リモート属性を他の一時データ・キュー・タイプのリソース定義の一部として組み込むこともできます。

TYPEFILE({INPUT|OUTPUT|RDBACK})

キューを関連付けるデータ・セットのタイプを指定します。

入力: 入力データ・セット。
OUTPUT: 出力データ・セット。
RDBACK: 逆方向読み取りされる入力データ・セット。
注: これは、磁気テープ上に定義されているデータ・セットにのみ適しています。

区分外キューは入力または出力ですが、その両方にすることはできません。

DCB マクロ・フィールドについて詳しくは、「 z/OS DFSMS Macro Instructions for Data Sets」を参照してください。

USERID(userid) (区画内キューのみ)

TRANSID フィールドに指定されたトリガー・レベル・トランザクションを検査するときに、 CICS がセキュリティー検査に使用するユーザー ID を指定します。ユーザー ID の最大長は 8 文字です。

許容文字:

A-Z 0-9 $ @ #

CREATE コマンドを使用しているのでなければ、小文字を入力した場合は、大文字に変換されます。

USERIDフィールドに入力された値は、ATIFACILITY(FILE)も指定されている場合のみ有効になります。

安全保護がアクティブである場合、トリガー・レベル・トランザクションは、指定されたユーザーID権限下で実行されます。このユーザーIDは、トリガー・レベル・トランザクションで使用されるすべての資源に対して許可されている必要があります。

一時データ・キュー定義からユーザー ID を省略すると、 CICS は、DFLTUSER システム初期設定パラメーターで指定された CICS デフォルト・ユーザー ID を使用します。安全保護検査は、ユーザーIDを含む区分内定義のインストール時に実行されます。安全保護検査が不合格になると、その区分内キューの資源定義はインストールされません。

代理ユーザー・セキュリティーについて詳しくは、一時データ・トリガー・レベル・トランザクションを参照してください。

WAIT({YES|NO}) (区画内キューのみ)

論理的にリカバリー可能なキューを変更した未確定の作業単位 (UOW) が、変更をコミットするか取り消すかを決めるために、コーディネーターとの再同期を待機する必要があるかどうかを指定します。

いいえ: UOW は待機しません。リカバリー可能リソースに対する変更は、トランザクション・リソース定義の ACTION 属性での指定に応じて、バックアウトされるかまたはコミットされます。
はい: UOWは待機し、待機中に必要なアクションはWAITACTION属性によって決定されます。

この属性は、UOWのトランザクション定義で定義された WAIT属性を指定変更します。 TDQUEUE 定義と TRANSACTION 定義の未確定属性の相互作用については、表 1 を参照してください。

WAITACTION({REJECT|QUEUE}) (区画内キューのみ)

このキューの定義で WAIT (YES) が指定されている場合に、未確定の作業単位 (UOW) に対して CICS が行うアクションを指定します。可能なアクションは以下のとおりです。

QUEUE

UOW は未確定で待機中です。このキューに対して UOW が保持しているすべてのロックは、UOW の最終状態が判明するまでアクティブのまま残ります。つまり、タスクは LOCKED 応答を受け取るのではなく、中断状態になります。 UOW の最終状態が判明したら、その UOW による変更はコミットされるか取り消されます。それまで、アクティブなロックのいずれかを必要とする次のタイプの今後の要求は待機する必要があります。

READQ (未確定 UOW が READQ 要求または DELETEQ 要求を発行した場合)
WRITEQ (未確定 UOW が WRITEQ 要求または DELETEQ 要求を発行した場合)
DELETEQ (未確定 UOW が READQ 要求、WRITEQ 要求、または DELETEQ 要求を発行した場合)

リジェクト

UOW は未確定で待機中です。このキューに対して UOW が保持しているロックは、UOW の最終状態が判明するまで保持されます。最終状態が判明したら、UOW による変更はコミットされるか取り消されます。それまでは、保持されているロックのいずれかを必要とする今後の要求はすべて拒否され、LOCKED 応答が返されます。 WAITACTION=REJECT により、QUEUE によってトランザクションが待機するようになる状況と全く同じ状況で、LOCKED が起きるようになります。