CICS Runtime構成ファイル

概要

CICS Runtimeの管理は、Tuxedoのネイティブ・ツールと、CICSに固有の機能に使用される、限られた数の構成表に基づいて行われます。CICS構成では、現在、リソースはCSD内で定義されていますが、以前は独立した表として定義されていました。この後者の手法が、CICS Runtimeで使用されるものです。

リソース構成表は、トランザクション、トランザクション・クラス、プログラム、ファイル、TSキュー・モデルなど、それぞれ特定のタイプのリソースを記述しています。各表には、リソースに関連する特定のパラメータが含まれます。

Tuxedoとリソース・ファイルの担当内容

トランザクションのようなCICSリソースとそのすべての特性(優先プログラム、再起動可能など)は、リソース構成ファイルに記述されます。どのマシン上にあるどのグループの何台のサーバーがこのトランザクションを提供するかなど、Tuxedo構成の要素はTuxedo構成ファイルUBBCONFIGに記述されます。

このようにして、担当内容は明確に分けられます。

•	リソースの構成は、CICSアプリケーションの機能動作を保証します。

•	Tuxedoシステムの構成は、本番での最適パフォーマンスと堅牢さを保証します。

リソース定義ディレクトリ

リソース構成ファイルはすべて、Well Known環境変数${KIXCONFIG}によって示される共通ディレクトリに格納されます。

CICSタイプの情報を記述する各表は、起動時にサーバーが読み取るファイルに格納されます。

構成ファイルの紹介

一般的な内容

各リソース構成表は、トランザクション、トランザクション・クラス、プログラム、ファイル、TSキューなどのリソース・タイプを、このリソースに関連するすべての固有パラメータとともに記述しています。

中央ファイルでは、リソース・グループのリストを定義します。ART CICSサーバーを構成する際、管理者はロードするリストを指定します。1つのリストに、何百あるいは何千という個別リソースを含む数十のリソース・グループが含まれる場合があります。

構造

各リソース表には、パラメータの列が3つあります。

 

フィールド名	タイプ	値	説明
表におけるパラメータの名前。	フィールドのデータ型。	特定の値が必要な場合は、ここにリストされます。	フィールドの目的とその使用方法の説明

この項では、これらの構成ファイルの各々を詳細に説明していきます。

•	グループ構成ファイルのリスト

•	トランザクション構成ファイル

•	Tranclasses構成ファイル

•	プログラム構成ファイル

•	TSキュー・モデル構成ファイル

•	ENQモデル構成ファイル

•	TDキュー・エクストラ・パーティション構成ファイル

•	TDキュー・イントラ・パーティション構成ファイル

•	マップセット構成ファイル

•	システム構成ファイル

•	ターミナル構成ファイル

•	Typeterm構成ファイル

•

接続構成ファイル

•	Webサービス構成ファイル

•	プログラム・リスト構成ファイル

•	POOL定義ファイル

•	TCP/IPソケット・リスナー構成ファイル

•	URIMAP構成ファイル

グループ構成ファイルのリスト

表4-1では、アプリケーション・サーバーがロードできるリソース・グループのリストを定義します。

ファイル名はlist_of_groups.descです。

list_of_groups.desc定義の書式は次のとおりです。

List_name;group_name

List_name;group_name

… …

List_name;group_name

例:

LIST1;SIMPAPP

LIST1;SIMPAPP1

 

表4-1 グループ・リスト・パラメータ

フィールド名	タイプ	値	説明
LIST	X(10)	必須	リスト名。 アプリケーション・サーバーの- Lオプションによって参照されます。
GROUP	X(10)	必須	リストに含まれるグループ名。 この表には、リスト内でグループごとに1行が含まれます。 同一のグループが1つ以上のリストに存在する場合があります。

トランザクション構成ファイル

表4-2では、アプリケーション・ユーザーが使用できるトランザクションをその特性とともにリストします。

ファイル名はtransactions.descです。

 

表4-2 トランザクション・パラメータ

フィールド名	タイプ	値	説明
TRANSACTION	X(4)	必須	トランザクションの名前。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト・コメント領域。
PROGRAM	X(8)	必須	このトランザクションのために呼び出される最初のプログラムの名前。
ALIAS	X(4)	オプション	将来使用するために予約されたフィールド。 トランザクションの別名を定義するために使用されます(通常は小文字)。
CMDSEC	X(1)	N|Y	将来使用するために予約されたフィールド。 システム・プログラミング・リクエストのために呼び出されるESM。 デフォルト値はNです。
CONFDATA	X(1)	N|Y オプション	将来使用するために予約されたフィールド。 機密データ内で: CONFDATAシステム初期化パラメータにHIDETCが指定されているCICSトレース・エントリからのユーザー・データを、CICSが非表示にするかどうかを指定します。 システム初期化パラメータでCONFDATA=SHOWが指定されている場合、トランザクション定義のCONFDATAは無視されます。 デフォルト値はNです。
PRIORITY	9(3)	1 | n オプション	将来使用するために予約されたフィールド。 トランザクションの優先度を指定します。0から255までのこの1から3桁の10進値は、全体的なトランザクション処理の優先度を設定する際に使用します。(トランザクション処理の優先度は、ターミナルの優先度、トランザクションの優先度および演算子の優先度の合計に等しく、255以下です。)数値が大きいほど、優先度が高くなります。 デフォルト値はです1
RESSEC	X(1)	N|Y	このトランザクションによってアクセスされるリソースに、リソース・セキュリティ・チェックを使用するかどうかを指定します。 デフォルト値はNです。
RESTART	X(1)	N|Y オプション	将来使用するために予約されたフィールド。 異常終了に続いて動的なトランザクション・バックアウト・ファシリティによってバックアウトされたタスクを、トランザクション再起動ファシリティを使用して再起動するかどうかを指定します。 デフォルト値はNです。
STATUS	X(10)	ENABLED| DISABLED	トランザクション・ステータスを指定します。 • ENABLED: トランザクションの通常実行を可能にします。 • DISABLED: トランザクションの実行を阻止します。 デフォルト値はENABLEDです。
TASKDATAKEY	X(5)	USER |CICS	将来使用するために予約されたフィールド。 デフォルト値はUSERです。
TPNAME	X(64)	オプション	将来使用するために予約されたフィールド。 4文字というTRANSACTION属性の長さ制限が不便すぎる場合に、APPCパートナが使用できるトランザクションの名前を指定します。この名前の長さは最大64文字です。
TRACE	X(1)	Y|N オプション	将来使用するために予約されたフィールド。 このトランザクションのアクティビティをトレース対象にするかどうか指定します。 デフォルト値はYです。
TRANCLASS	X(8)	オプション	トランザクションが属するトランザクション・クラスの名前を指定します。トランザクション・クラスに属するトランザクションは、スケジューリング制約の影響を受けてからでないと、実行が可能になりません。 ターゲット・プラットフォーム上でのこのパラメータの使用方法の詳細は、「Tranclasses構成ファイル」を参照してください。 定義されたtranclassがないトランザクションは、それを提供するサーバーの数以外のスケジューリング制約を持ちません。
TWASIZE	9(5)	オプション	このトランザクションのために取得されるトランザクション作業領域のサイズ(バイト単位)を指定します。0から32767までの範囲の1から5桁の10進値を指定してください。 デフォルト値はです0
REMOTESYSTEM	X(4)	オプション	トランザクション・アタッチ・リクエストが送信される相互通信リンクを識別する名前を指定します。

各トランザクションは、CICSランタイム・サーバー(ARTSTRN、ARTATRNなど)によってOracle Tuxedoサービスとして通知されます。各サーバーがそれぞれ独自のサービスのみを通知するように、-lオプションを使用して、トランザクションを別々のグループに分け、そのグループを別々のサーバーに割り当てることができます。

注意:	全トランザクションを1つのグループに定義すると、全サービスが全サーバーによって通知され、Oracle Tuxedoサービスの負荷が膨大になるためお薦めしません。

Tranclasses構成ファイル

表4-3では、並列トランザクション・アクティビティを規制するために使用できるtranclassをリストし、定義します。

ファイル名はtranclasses.descです。

 

表4-3 Transclassパラメータ

フィールド名	タイプ	値	説明
TRANCLASS	X(8)	必須	トランザクション・クラスの名前。 tranclassは、並列動作を許されないトランザクションのカテゴリを定義します。理由は、おそらく一部のリソースを直列化できない手段で使用するためです。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト・コメント領域。
MAXACTIVE	9(3)	0 - 999	実行の並列度を定義します。 特別な処理をする唯一の値は値1ですが、詳細情報は下記を参照してください。

セマンティック情報

ネイティブ・ソースのCICS定義

トランザクション・クラスに属するものとして定義されたトランザクションは、スケジューリング制約の影響を受けてからでないと、実行が可能になりません。アクティブなトランザクション・クラスに属するトランザクションがすでに実行されている場合、新しいトランザクションはすべて、キューに登録されます。実行するトランザクションの最大数を指定するには、MAXACTIVE属性を使用します。列のサイズを制限するには、PURGETHRESH属性を使用できます。

トランザクションをトランザクション・クラスに入れることによって、CICSがタスクをディスパッチする方法を制御できます。

ターゲット・プラットフォームの概念へのマッピング

Tuxedoでは、トランザクションのスケジューリングと、リソースがトランザクションのグループに対して与える影響とは、異なる方法で実行されます。指定のトランザクションを提供するサーバーの数により、トランザクションのスケジューリングや、影響を受けるリソースの、トランザクションのグループに対する相対的な量が管理されます。

MAXACTIVE 1の特殊な事例

この事例は非常に特殊で、アプリケーションの機能特性に影響を与えます。

これにより、このクラスの2つのトランザクションが同時に実行されることがなくなります。ターゲット・プラットフォーム上で維持される相互排他的な動作を定義することで、アプリケーションの正しい動作が保証されます。

単一のサーバーARTSTR1が、MAXACTIVE = 1である1つのTRANCLASSに属するトランザクションを提供します。

プログラム構成ファイル

表4-4では、トランザクションの最初のプログラムとして、またはEXEC CICS LINKおよびXCTLによって起動されるものとして参照できるプログラムをリストし、定義します。

ファイル名はprograms.descです。

 

表4-4 プログラム・パラメータ

フィールド名	タイプ	値	説明
PROGRAM	X(8)	必須	プログラムの名前。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト・コメント領域。
LANGUAGE	X(8)	COBOL | C | C++	プログラムの言語で、通信方法を認識するために必要です。 現在のリリースは、COBOLおよびCをサポートします。
EXECKEY	X(4)		将来使用するために予約されたフィールド。 CICS共有構造のメモリー保護に関連します。
STATUS	X(10)	ENABLED|DISABLED	プログラム・ステータスを指定します。 • ENABLED: プログラムの通常実行を可能にします。 • DISABLED: プログラムの実行を阻止します。
REMOTESYSTEM	X(4)	オプション	プログラムがローカルに提供されていず、DPLサーバーにあることを指定します。
REMOTENAME	X(10)	オプション	遠隔サイト上で、DPLプログラムのためにプログラムの名前を指定します。 リモート名がローカル名と異なる場合のみ役に立ちます。
RESCOUNT-STAT	X(10)	ENABLED|DISABLED	指定されたプログラムのRESCOUNT情報を有効にするかどうかを指定します。デフォルト値はDISABLEDで、このフィールドが指定されない場合に使用されます。
IN-TYPE	X(64)	オプション	プログラムの入力タイプ。プログラムに渡されるCOMMAREAを記述します。 これは、使用するTuxedoバッファのサブタイプと同じである必要があります。Tuxedo RECORDバッファで呼び出される場合、ARTDPLのみでサポートされます。
OUT-TYPE	X(64)	オプション	プログラムの出力タイプ。プログラムが返すCOMMAREAを記述します。 これは、使用するTuxedoバッファのサブタイプと同じである必要があります。Tuxedo RECORDバッファで呼び出される場合、ARTDPLのみでサポートされます。

TSキュー・モデル構成ファイル

表4-5では、CICSアプリケーションで参照できるTSキュー・モデルをリストし、定義します。

ファイル名はtsqmodel.descです

 

表4-5 TSキュー・パラメータ

フィールド名	タイプ	値	説明
TSMODEL	X(8)	必須	TSキュー・モデルの名前。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト領域。
LOCATION	X(9)	AUXILIARY | MAIN	使用する記憶域の種類を指定します。 • AUXILIARY (デフォルト): RDBMSベースの場所とファイルベースの場所の両方がサポートされます。RECOVERYがYに設定されている場合、データベースベースの場所が使用されます。RECOVERYがNに設定されている場合、ファイルベースの場所が使用されます。 • MAIN: 主記憶域のTSQが使用されます。これにより、アクセスのパフォーマンスが向上します。主記憶域に格納されているTSQデータはリカバリ不能です。
PREFIX XPREFIX	X(16)	必須	このモデルの接頭辞として使用される文字列を指定します。接頭辞の長さは最大16文字です。
RECOVERY	X(1)	N|Y	このモデルと一致するキューがリカバリ可能であるかどうかを指定します。 • Y: キューはRDBMSに格納され、リカバリ機能を提供します。 • N (デフォルト): キューはファイルまたは主記憶域に格納され、リカバリ機能はサポートされません。
POOLNAME	X(8)	オプション	非推奨。ターゲットで同じ結果に到達するためには他の方法があります。 このTSMODEL定義で使用する共有TSプール定義の8文字の名前を指定します。
REMOTESYSTEM	X(4)	オプション	将来使用するために予約されたフィールド。 ソース・プラットフォームで、ローカル・システムと、一時記憶域キューが存在するリモート・システムをリンクする接続の名前を指定します。 ターゲット・プラットフォームでは、別のシステム(別のTUXEDOシステムまたはネイティブのCICSシステム)へのTS出荷の場合のみ使用されます。
REMOTEPREFIX XREMOTEPREFIX	X(16)	オプション	将来使用するために予約されたフィールド。 リモート・システムで接頭辞として使用される文字列を指定します。接頭辞の長さは最大16文字です。 これらのオプションは、システム間でTSキュー・アクセスを出荷するときにキュー名を変換する場合のみ役に立ちます(ソースとターゲットの両プラットフォーム上で)。
SECURITY	X(1)	N|Y	将来使用するために予約されたフィールド。 このモデルと一致するキューに対してセキュリティ・チェッキングが実行されるかどうかを指定します。 デフォルト値はNです。

ENQモデル構成ファイル

表4-6では、CICSアプリケーションで参照できるENQモデルをリストし、定義します。

ファイル名はenqmodel.descです。

 

表4-6 ENQモデル・パラメータ

フィールド名	タイプ	値	説明
ENQMODEL	X(8)	必須	ENQモデルの名前。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト領域。
ENQNAME	X(255)	必須	1 - 255文字のリソース名を指定します。
ENQSCOPE	X(4)	オプション	省略されたか、空白として指定された場合、一致するエンキュー・モデルはローカルなスコープを持ち、それ以外の場合は、グローバルなスコープを持ちます
STATUS	X(1)	E|D	将来使用するために予約されたフィールド。 E = 有効。 D = 無効。

TDキュー・エクストラ・パーティション構成ファイル

表4-7では、CICSアプリケーションで使用できるエクストラ・パーティションTDキューをリストし、定義します。

ファイル名はtdqextra.descです。

 

表4-7 TDキュー・パラメータ

フィールド名	タイプ	値	説明
TDQUEUE	X(4)	必須	一時データ・キューの名前を1 - 4文字で指定します。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト領域。
DDNAME	X(8)	必須	起動JCLで定義されたデータ・セットを参照する可能性がある1文字から8文字の値を指定します。
DISPOSITION	X(3)	オプション	モデムの配置を指定します。 • MOD: ART-CICSは、まずデータ・セットが存在すると想定します。既存の順編成データ・セットの場合、MODでは、読取り/書込みメカニズムがデータ・セットの最後のレコードの後に置かれます。読取り/書込みメカニズムは、データ・セットが出力のために開かれるたびに、最後のレコードの後に置かれます。ART-CICSがデータ・セットのボリューム情報を検出できない場合は、次のようになります。 - DD文の場合。 この方法で動的に割り当てられたデータ・セットは、キューが閉じられると削除され、すべてのレコードが失われます。新規データ・セットの場合、MODでは、読取り/書込みメカニズムがデータ・セットの先頭に置かれます。 • OLD: データ・セットが、このジョブ手順以前に存在しました。 • SHR: データ・セットはこのジョブ手順以前に存在し、他の同時ジョブからも読み取れます。
ERRORPTION	X(1)	I | S	UNSUPPORTED I/Oエラーが発生したときに実行されるアクションを指定します。これは次のいずれかです。 • I = IGNORE: エラーを引き起こしたブロックは、受け入れられます。 • S = SKIP: エラーを引き起こしたブロックは、スキップされます。
OPENTIME	X(1)	D | I	UNSUPPORTED データ・セットの初期ステータスを指定します。初期ステータスは次のいずれかです。 • D = DEFERRED: CEMT INQUIRE|SET TDQUEUEコマンドを使用して開くように指示するまで、データ・セットは閉じたままです。 • I = INITIAL: データ・セットはインストール時に開きます。ただし、DSNAME属性が指定されていず、起動JCLのDD文でデータ・セット名が指定されていない場合、一時データ・キューはCICS起動時にJESに割り当てられます。
RECORDFORMAT	X(1)	F | V	データ・セットのレコード書式を指定します。 • F= FIXED: 固定レコード。RECORDFORMAT FIXEDを指定する場合、ブロック書式も指定する必要があります。 • V= VARIABLE: 可変レコード。RECORDFORMAT VARIABLEを指定する場合、ブロック書式も指定する必要があります。
PRINTCONTROL	X(1)	A |	UNSUPPORTED 使用する制御文字を指定します。デフォルトはありません。デフォルトでRECORDFORMATが空白になることを許可した場合、PRINTCONTROLフィールドには何も指定できません。使用できる制御文字は次のとおりです。 • A= ASA: ASA制御文字。 • 空白: 制御文字は使用されません。
RECORDSIZE	9(4) COMP	オプション	レコード長を0 - 32767の範囲のバイト数で指定します。
TYPEFILE	X(6)	オプション	キューが関連付けられるデータ・セットのタイプを指定します。 • INPUT: 入力データ・セット。 • OUTPUT: 出力データ・セット。
DSNAME	X(80)	オプション	このエクストラ・パーティション・キューに書き込まれるレコードを格納するために使用されるファイルの名前を指定します。 このファイルは、空でもよいから存在する必要があります。
SYSOUTCLASS	X(1)	オプション	UNSUPPORTED エクストラ・パーティション・キューを物理データ・セットに割り当てるかわりに、システム出力データ・セット(SYSOUTと呼ばれる)に割り当てることができます。SYSOUTデータ・セットのクラスを指定するには、SYSOUT CLASS属性を使用します。 A..Z|0..9 CICSランタイム・ジョブが実行されるはずのz/OSシステム上で設定された出力クラスを表す英数字1文字。
TRT	X(1)	S | I	新しいオプションのCICS Runtime引数で、インテグレータや顧客による、エクストラ・パーティション・キューの独自の特定の実装を可能にします。 値がないか、S (StandardのS)の場合、通常のCICS Runtime TDQueue機能が起動されます 値Iを設定すると、関数td_extra_actions_int (インテグレータが提供する必要があります)の呼出しがトリガーされます。
INTRDR	X(1)	Y | N	TDQをJCLの内部リーダーとして定義するかどうかを指定します。 • Y: 追加のTDQがJCLの内部リーダーです。 • Nまたは指定なし: 通常のTDQ。
BLOCKFORMAT	X(1)	B | U	BLOCK書式を指定します。 • B: ブロック書式 • U: 非ブロック化書式

TDキュー・イントラ・パーティション構成ファイル

表4-8では、CICSアプリケーションで使用できるイントラ・パーティションTDキューをリストし、定義します。

ファイル名はtdqintra.descです。

 

表4-8 TDキュー・パラメータ

フィールド名	タイプ	値	説明
TDQUEUE	X(4)	必須	一時データ・キューの名前を1 - 4文字で指定します。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト領域。
RECOVSTATUS	X(8)	NO | LOGICAL	キューが論理的に回復可能かどうか指定します。 キューが論理的に回復可能である場合、その要素はトランザクションのコンテキスト内でtuxedo /Qに書き込まれ、ロールバックの場合は、トランザクションの残りとともにロールバックされます。 キューが回復不可能の場合、/Qキュー内の各エンキューは恒久的になり、ロールバックまたは中止の場合、ロールバックされません。
TRANSID	X(4)	オプション	トリガー・レベルに達した場合に自動的に開始されるトランザクションの名前を指定します。トランザクションはこの方法で開始され、キューからレコードを読み取ります。TRANSID属性を指定しない場合(または、TRIGGERLEVEL(0)を指定した場合)、別の方法でトランザクションをスケジュールして、一時データ・キューからレコードを読み取る必要があります。
TRIGGERLEVEL	X(1)	1 | n	ここで指定した数のレコードが蓄積されると、タスクが自動的に開始されてそれらを処理します。(この数はトリガー・レベルと呼ばれます。) TRANSID属性を指定した場合、TRIGGERLEVELはデフォルトで1になります。ATI処理を無効にするには、トリガー・レベル0を指定します。トランザクションIDを指定しない場合、トリガー・レベルは無視されます。 論理的に回復可能な一時データ・キューの場合、ATIタスクが前方コミットするまで、タスクはアタッチされません。これは、ATIが発生する前に、トリガー・レベルをはるかに超過していることを意味する場合があります。
USERID	X(8)	オプション	TRANSIDフィールドで指定されたトリガー・レベル・トランザクションを検証するときに、CICSがセキュリティ・チェックのために使用するユーザーIDを指定します。
WAIT	X(1)	YES | NO	INACTIVEフィールド リソース・ロードでのみ受け入れられます
WAITACTION	X(6)	REJECT | QUEUE	INACTIVEフィールド リソース・ロードでのみ受け入れられます
QSPACENAME	X(15)	必須	新しい必須のCICS Runtime引数で、このキューが物理的に格納されるtuxedo /Q QSPACEの名前を指定します。 qspacesとキュー管理の詳細情報は、Tuxedo/Qのドキュメントを参照してください。
TRT	X(1)	S | I	新しいオプションのCICS Runtime引数で、インテグレータや顧客による、イントラ・パーティション・キューの独自の特定の実装を可能にします。 値がないか、S (StandardのS)の場合、通常のCICS Runtime TSQueue機能が起動されます 値Iを設定すると、関数td_intra_actions_int (インテグレータが提供する必要があります)の呼出しがトリガーされます。
ATIFACILITY	X(1)	T	Tに設定されている場合、TERMINALを示します。
FACILITYID	X(4)	オプション	ATIFACILITYがTに設定されている場合、ターミナル名。

マップセット構成ファイル

表4-9では、CICSアプリケーションで参照できるマップセットをリストし、定義します。詳細は、「システム・コマンドとトランザクション」の「tcxmapgen(1)」を参照してください。

ファイル名はmapsets.descです。

MAPSET定義の書式は次のとおりです。

[mapset]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

… …

<field_name_n>=<field_value_n>

例:

[mapset]

name=ABANNER

filename=abanner.mpdef

 

表4-9 マップセット・パラメータ

フィールド名	タイプ	値	説明
NAME	X(8)	必須	マップセットの名前。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト・コメント領域。
FILENAME	X(79)	必須	tcxmapgenツールによって生成されるマップセットの物理的な(バイナリ)ファイル名を指定します。 絶対パスを指定しなかった場合、KIX_MAP_PATH環境変数で定義されたディレクトリでこれが検索されます。 このフィールドを指定しない場合、デフォルトのマップセット・バイナリ・ファイル名<MAPSET_name>.mpdefが使用されます(<MAPSET_name>は、CICS MAP関連のAPIで指定されたMAPSET名のパラメータです)。
RESIDENT	X(3)	NO | YES	マップセットの駐在ステータスを指定します。 • NO: マップセットは常駐しません。 • YES: マップセットは最初リファレンスでロードされ、その後仮想記憶域に常駐します。ただし、システムからページング可能である必要があります。
swastatus	X(10)	ENABLED|DISABLED	リソース・ステータスを指定します。 • ENABLEDに設定されている場合、リソースは使用可能です。 • DISABLEDに設定されている場合、リソースをシステムで使用することはできません。
Usage	X(10)	NORMAL | TRANSIENT	この属性では、MAPSETがロードされると使用されるキャッシング・スキームを指定します。NORMALでは、キャッシュにMAPSETがロードされたままの状態になります。キャッシュがオーバーフローし、それがキャッシュ内で最も古くて使用頻度の少ないMAPSETである場合、アンロードします。TRANSIENTでは、MAPSETが使用中でない場合はそれをアンロードします。

 

システム構成ファイル

表4-10では、CICSアプリケーションで使用できるsystemをリストし、定義します。

ファイル名はsystem.descです。

system.desc定義の書式は次のとおりです。

[SYSIDNT]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

… …

例:

[KIXA]

APPLID = DBDCKIXA

INITPARM =(DBCONNA=’instance1,database1,artuser1,abc123’)

[KIXB]

APPLID = DBDCKIXB

INITPARM =(DBCONNA=’instance2,database2,artuser2,123abc’)

注意:	空白行およびコメント行がサポートされています。1列目でアスタリスクを使用してコメントをコーディングしたり、CICSの特定の実行から初期化パラメータを一時的に削除できます。

\を使用すると、別の行にパラメータを続けて記述できます。Oracle Tuxedo Application Runtime for CICSでは、現在の行の「\」より後ろの空白を省略して、オペランドを連結できます。この場合、現在の行の「\」の後ろには空白のみ記述できます。それ以外の場合は、「\」はバックスラッシュとして扱われます。

定義済のシステム初期化パラメータのロード/検出

定義済のシステム初期化パラメータをロードしたり、検出するには、CLOPT -sを指定する必要があります。

例:

ARTSTRN

CLOPT=”-- -s KIXA”

この例では、ARTSTRNはKIXAという名前のシステム・セクションのみをロードします(KIXBはロードされません)。

現在のCICSリージョンのAPPLIDの定義

現在のCICSリージョンのAPPLIDを定義するには、CLOPT -aを指定するか(リスト4-1)、APPLIDパラメータをsystem.descで指定します(リスト4-2)。

リスト4-1 CLOPT -aを指定する例

*SERVERS

CLOPT=”-- -a abcdefgh“

 

リスト4-2 APPLIDを指定する例

[KIXR]

APPLID=1234567a

 

Oracle Tuxedo Application Runtime for CICSでは、まずCLOPT -aが指定されているかどうかがチェックされます。指定されている場合、値はJOBNAMEとして使用されます。指定されていない場合、system.descファイルに設定されているAPPLIDの値はJOBNAMEとして使用されます。-aまたはAPPLIDのどちらもsystem.descに設定されていない場合は、デフォルト値DBDCCICSが使用されます。

どちらにしても、値が8文字を超える場合、最初の8文字のみが含まれるように切り捨てられます。値が8文字未満の場合は、ちょうど8文字になるように後でAPPLIDに空白が追加されます。

GMTEXTの指定

GMTEXTを指定するには、次の例を参照してください。

リスト4-3 GMTEXTを指定する例

[KIXR]

APPLID=DBDCKIXR

GMTEXT='An Information Development CICS Terminal'

 

GMTEXTには、次の2つの形式があります。

•	メインフレームCICS形式

メッセージ全体を一重引用符で囲む必要があります。テキスト内でアポストロフィを句読点として使用できます。そのためには、アポストロフィを2つ続けてコーディングして1つのアポストロフィを表す必要があります。

例:

GMTEXT='User''s logon message text.'

•	ART for CICS形式

アポストロフィはエスケープ文字として機能しません。(この方法により、メッセージの編集が簡単になっています。)

例:

GMTEXT=User's logon message text.

 

表4-10 システム・パラメータ

フィールド名	タイプ	値	説明
SYSIDNT	X(4)	必須	CICSリージョンを定義するためのシステム・セクションの名前。名前の長さは1 - 4文字です。デフォルト名はCICSです。 システム・セクションの名前と定義したCICSリージョンの名前は同じである必要があります。 注意: 複数のセクションが同じSYSIDNTを共有する場合、このCICSリージョンの最終的な構成には、それらのセクションに定義されているすべてのパラメータが含まれます。これらのセクションに同じパラメータが複数定義されている場合は、最後のパラメータのみが有効です。
APPLID	X(8)	DBDCCICS|applid、 オプション	VTAMネットワーク内でCICSリージョンを識別します。名前の長さは1 - 8文字です。デフォルト値はDBDCCICSです。
INITPARM	X(60)	必須	ASSIGN INITPARMを呼び出す各CICSアプリケーション・プログラムのシステム初期化表(SIT)の初期化パラメータを指定します。 INITPARMの書式は、INITPARM=(pgmname_1='parmstring_1'[,...,pgmname_n='parmstring_n'])です。現在program='parmstring'のセットを255までサポートします。 programの値は1 - 8文字の英数字で構成される必要があり、長さ制限を超える場合は切り捨てられます。 parmstringの値は最大60文字で、長さ制限を超える場合は切り捨てられます。パラメータの文字列は一重引用符で囲みます。文字列内に含まれる引用符はすべて重複している必要があります。 注意: 各セクションにINITPARMパラメータが複数指定されている場合は、最後の定義のみが有効になります。
LGNMSG	X(3)	NO | YES、オプション	アプリケーション・プログラムでログオン・データを使用できるかどうかを指定するシステム初期化パラメータ。
GMTEXT	X(246)	オプション	GMTEXTは、システム初期化パラメータです。GMTEXTでは、デフォルト・ログオン・メッセージ・テキスト(Oracle Tuxedo Application Runtime for CICS)または独自のメッセージ・テキストのいずれをログオン画面に表示するかを指定します。メッセージ・テキストは、ターミナルでART for CICSにログオンするとCSGMトランザクションによって表示されます。 GMTEXTは最大246文字で、それより長い場合は切り捨てられます。(例については、「GMTEXTの指定」を参照してください。) GMTEXTを有効にするには、ARTCNXサーバーの[SYSIDNT]でCLOPT -sオプションを構成する必要があります。詳細は、「ARTCNX構成」を参照してください。
GMTRAN	X(4)	オプション	ターミナルがART CICSにログオンしたときにATIによって開始されるトランザクションの名前を指定するシステム初期化パラメータ。GMTRANの書式はGMTRAN={CSGM|CESN|transaction-id}で、デフォルト値はCSGMです。 注意: GMTRANを有効にするには、typeterms.descでLOGONMSG=YESを指定することも必要です。ただし、LOGONMSGをNOに指定した場合は、画面がクリアされます。
BMS	X(60)	DDS|NODDS、 オプション	DDS (入出力装置依存サポート)を有効にするかどうかを指定します。デフォルト値はDDSで、DDSが有効であることを意味します。 DDSが有効な場合、BMSは次のルールを使用して物理マップを選択します。 • 使用されている画面サイズが代替の画面サイズと同じ場合、BMSはALTSUFFIXで指定される接尾辞をマップセット名に追加します。つまり、トランザクションがTYPETERM定義で指定されるSCRNSIZE(ALTERNATE)を持つ場合、またはデフォルト画面と代替画面のサイズが同じ場合、BMSのマップ選択ルーチンは、ALTSUFFIXで指定される接尾辞を使用して、マップセットのロードを試みます。 • このようなマップセットが見つからない場合、BMSは接尾辞がないマップセットのバージョンのロードを試みます。
TYPE	X(8)	ARTCICS | TMASNA	オプション。デフォルト値はARTCICSです。
PLTPI	X(2)	オプション	PLT接尾辞の名前。SUFFIXの長さは1-2文字です。
PLTSD	X(2)	オプション	PLT接尾辞の名前。SUFFIXの長さは1-2文字です。
SRM_IPCKEY	9(6)	IPCKEY	オプション。SRM_IPCKEYでは、共有メモリー・セグメントのIPCKEY (識別子)を指定します。 SRM_IPCKEYは、ARTSRMサーバーが共有メモリーを使用してランタイム情報を格納する場合にのみ使用します(ARTSRMがデータベースを使用する場合、SRM_IPCKEYは無視されます)。共有メモリーを使用するときにSRM_IPCKEYを指定しない場合、ARTSRMはそのTuxedoグループ番号を使用してIPCKEYを生成します。 1つのCICSリージョン内では、そのリージョンのすべてのARTSRMについてSRM_IPCKEYが同じである必要があり、それらのARTSRMサーバーはすべて同じマシンで実行されている必要があります。
SRM_LOCATION	X(32)	MEMORY|DB	ARTSRMのストレージ・メディアを指定します。 • Memory (デフォルト): 共有メモリーを使用してデータを格納します • DB: データベースを使用してデータを格納します
PGAIPGM	X(8)	INACTIVE|ACTIVE	PGAIPGMシステム初期化パラメータでは、初期化時のプログラム自動インストール機能の状態を指定します。 • INACTIVE: プログラム自動インストール機能は無効です。 • ACTIVE (デフォルト): プログラム自動インストール機能は有効です。
CICS_RELEASE	X(4)	オプション	CICSのINQUIRE SYSTEM RELEASEコマンドで返されるCICSシステム・コードを指定します。 CICSシステム・コードは、環境変数KIX_CICS_RELEASEを介して、またはシステム構成ファイルのCICS_RELEASEを介して指定できます。 KIX_CICS_RELEASEとsystems.descのCICS_RELEASEが両方とも構成されている場合は、systems.desc内の値が返されます。 KIX_CICS_RELEASEとsystems.descのCICS_RELEASEが両方とも構成されていない場合は、値0660 (CICS 4.1に対応)が返されます。

注意:	セクション名とキーでは大文字と小文字が区別されされません。ただし、値は大文字と小文字が区別されます。各キーの最大長は64文字で、各値については32767文字です。

ターミナル構成ファイル

表4-11では、CICSアプリケーションで使用できるterminalをリストし、定義します。

ファイル名はterminals.descです。

terminal定義の書式は次のとおりです。

[terminal]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

… …

例:

[terminal]

name=0001

netname=CICS0001

katakana=YES

[terminal]

name=0002

netname=CICS0002

katakana=YES

ART CICSは、Tuxedo /Qを使用してすべてのターミナル・ランタイム・ステータスを格納します。Tuxedo /Qの構成および使用の詳細は、「非同期CICS遅延トランザクションの実装」を参照してください。

 

表4-11 Terminalパラメータ

フィールド名	タイプ	値	説明
ALTSUFFIX	X(1)	0-9|a-z|A-Z、 オプション	ターミナルの1文字のALTSUFFIX名を指定します。英数字または空白(接尾辞なし)のみ指定できます。値は大文字と小文字が区別されず、自動的に大文字に変換されます。
KATAKANA	x (3)	NO | YES、オプション	KATAKANAのサポートが必要かどうかを指定します。 NO: デフォルト値。KATAKANA機能は無効です。 YES: KATAKANA機能は有効です。 その他の値: 無効な値。システムは自動的にtypeterms.desc内でKATAKANAを検索します。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
NAME	X(4)	必須	ターミナル識別子。 注意: 同じTERMIDのエントリが複数存在する場合、最後のエントリが有効です。 長さが超えると、値は無視され、警告メッセージがULOGに記録されます。長さが4文字より短い場合は、右側に空白が追加されます。
NETNAME	X(8)	必須	ターミナルのネットワーク名。 注意: NETNAMEの値は一意である必要があります。そうでない場合、ARTCNXサーバーは起動に失敗し、ULOGおよびstdoutにエラー出力をレポートします。 長さが超えると、値は無視され、警告メッセージがULOGに記録されます。長さが8文字より短い場合は、右側に空白が追加されます。
INSERVICE	X(3)	NO | YES、オプション	定義されているターミナルのステータスを指定します。 YES: トランザクションが開始され、メッセージが自動的にターミナルに送信されます。 NO: ターミナルはメッセージを受信することも、入力を送信することもできません。 デフォルト値はYESです。このフィールドが前述のどちらの値にも定義されていない場合は、YESとして処理されます。
ATI	X(3)	NO | YES、オプション	CICSで自動的に開始されたトランザクションでターミナルが使用可能かどうかを指定します。 YES: CICS内から自動的に開始されたトランザクションでターミナルを使用できます。 NO: CICS内から自動的に開始されたトランザクションでターミナルを使用できません。 このフィールドが前述のどちらの値にも定義されていない場合は、UNKNOWNとして処理されます。ただし、typeterms.desc内の同じフィールドもUNKNOWNに定義されている場合、このフィールドの値は最終的にYESです。
TTI	X(3)	NO | YES、オプション	トランザクションをユーザーがターミナルで開始できるかどうかを指定します。 YES: トランザクションをユーザーがターミナルで開始できます。ATI(YES)も指定すると、トランザクションを自動的に開始することもできます。この場合、一時データ制御と間隔制御のどちらによる場合でも、自動トランザクション開始は、ターミナル制御表の適切なターミナル・エントリに条件を設定します。ATIとTTIの両方がYESとして指定され、ターミナルにトランザクションがない場合、ターミナル制御はユーザー定義タスクを開始します。このタスクは、ターミナルにメッセージを送信することが想定されます。 問合せやオーダー・エントリなどのトランザクション処理で使用されるターミナルの場合は、TTI(YES)およびATI(NO)を指定します。これは、ターミナル・リクエストなしではメッセージが送信されなかったり、それを経由してトランザクションが入力される、ディスプレイ・ステーションやハードコピー・ターミナルにも適用されます。3790問合せ論理ユニットに指定できるのはこれのみです。 NO: トランザクションをユーザーがターミナルで開始できません。NOを指定した場合、ATI(YES)を指定すると、トランザクションを自動的に開始できます。このようなターミナルの例には、ウェアハウスなど、遠隔地にあり、無人だがメッセージを受信できるターミナルがあります。 このフィールドが前述のどちらの値にも定義されていない場合は、UNKNOWNとして処理されます。ただし、typeterms.desc内の同じフィールドもUNKNOWNに定義されている場合、このフィールドの値は最終的にYESです。

注意:	セクション名はterminalに設定する必要があります。すべてのキーワードは、大文字と小文字が区別されません。

ART CICSでは「.」が予約されています。terminals.descを定義する際、ユーザーはNAMEでもNETNAMEでもこれを使用できません。

Typeterm構成ファイル

表4-12では、ARTTCPでサポートされるTypetermをリストし、定義します。

ファイル名はtypeterms.descです。

typeterm定義の書式は次のとおりです。

[typeterm]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

… …

<field_name_n>=<field_value_n>

例:

[typeterm]

name=IBM-3278-2

userarealen=255

katakana=YES

 

表4-12 Typetermパラメータ

フィールド名	タイプ	値	説明
ALTSCREENCOLUMN	9(3)	{80|132|…}	ターミナルの画面サイズの合計列数を指定します。SCRNSIZE=alternateの場合、このパラメータは必須です。
ALTSCREENROW	9(3)	{24|32|43|27|…}	ターミナルの画面サイズの合計行数を指定します。SCRNSIZE=alternateの場合、このパラメータは必須です。
ALTSUFFIX	X(1)	0-9|a-z|A-Z オプション	typetermの1文字のALTSUFFIX名を指定します。英数字または空白(接尾辞なし)のみ指定できます。値は大文字と小文字が区別されず、自動的に大文字に変換されます。
DESCRIPTION	X(79)	オプション	リソースの説明のための小さなテキスト領域。
EXTERCODE	X(10)	{ibm-37 | ibm-1388|ibm-1380|…}	使用するアウトバウンド・データのエンコーディング・タイプを指定します。この属性の値は、z/OSプラットフォームで使用されるどのEBCDICエンコーディング・タイプでもかまいません。デフォルト値はibm-37です。
INTERCODE	X(10)	{ASCII | UTF-8|Shift-JIS|…}	使用するインバウンド・データのエンコーディング・タイプを指定します。この属性の値は、ユニバーサル・プラットフォームで使用されるどのエンコーディング・タイプでもかまいません。デフォルト値はASCIIです。
NAME	X(79)	必須	typetermの名前。
PROGSYMBOLS	X(3)	NO | YES	Programmed Symbol (PS)ファシリティをサポートするかどうかを指定します。デフォルト値はNOです。
SCRNSIZE	X(9)	DEFAULT|ALTERNATE	オプション。代替の画面サイズでマップ/テキストを送信/受信するかどうかを指定します。 デフォルト値はDEFAULTで、代替の画面サイズでマップ/テキストを送信/受信しません。
SOSI	X(3)	NO | YES	EBCDICと2バイトの混合文字セット(DBCS)がサポートされるかどうか指定します。デフォルト値はNOです。
color	X(3)	NO | YES	拡張color属性を指定します。
defscreencolumn	9(3)	80	デフォルト画面サイズの列数。
defscreenrow	9(3)	24	デフォルト画面サイズの行数。
hilight	X(3)	NO | YES	ターミナルがハイライト機能をサポートするかどうか示します。
logonmsg	X(3)	NO | YES	ターミナル上でGood Morning (CSGM)トランザクションが自動的に起動されるかどうかを示します。 Oracle Tuxedo ARTには、デフォルトのCSGMトランザクションが用意されています。デフォルトのGood Morning (CSGM)トランザクションの構成に関する項を参照してください。
outline	X(3)	NO | YES	ターミナルがフィールドの外枠表示をサポートするかどうか示します。
swastatus	X(10)	ENABLED| DISABLED	リソース・ステータスを指定します。 • ENABLEDに設定されている場合、リソースは使用可能です。 • DISABLEDに設定されている場合、リソースをシステムで使用することはできません
uctran	X(10)	NO | YES | TRAN	• YES: アルファベットの小文字を大文字に変換します。 • NO: アルファベットの小文字を大文字に変換しません • TRAN: トランザクションIDのみを小文字から大文字に変換します。
userarealen	9(3)	0 ~ 255	ターミナル制御表ユーザー領域(TCTUA)の、ターミナル用の領域サイズ。
KATAKANA	x(3)	NO | YES、オプション	KATAKANAのサポートが必要かどうかを指定します。デフォルト値はNOです。KATAKANA機能は、KATAKANAがYESに指定されている場合のみ有効です。 注意: KATAKANAは、terminals.descまたはtypeterms.descで設定できます。ただし、terminals.descのKATAKANAがYESまたはNOに指定されていない場合、typeterms.descのKATAKANAが有効になります。
ATI	X(3)	NO | YES、オプション	自動トランザクション開始により、トランザクションがターミナルで起動できるかどうかを指定します。 YES: トランザクションを自動トランザクション開始によりターミナルで開始できます。 NO: トランザクションを自動トランザクション開始によりターミナルで開始できません。 ATI(YES)を指定すると、一時データ制御によって、または別のトランザクションが発行したEXEC CICS STARTコマンドによって、トランザクションをターミナルで開始できます。ターミナルにすでにトランザクションがある場合は、それが終了するまで、ATIトランザクションは保留されます。ATI(YES)を指定する場合は、1バイト以上のIOAREALENを指定する必要があります。ただし、ATIおよびIOAREALENが、YESおよび0という強制的なデフォルト値を持つDEVICE(APPC)の場合は除きます。 ATIがYESとして指定され、CREATESESSがYESとして指定されている場合、ターミナルがACQUIREDでないときにトランザクションが開始されると、それが自動的に取得されます。 このフィールドが前述のどちらの値にも定義されていない場合は、YESとして処理されます。
TTI	X(3)	NO | YES、オプション	トランザクションをユーザーがターミナルで開始できるかどうかを指定します。 YES: トランザクションをユーザーがターミナルで開始できます。ATI(YES)も指定すると、トランザクションを自動的に開始することもできます。この場合、一時データ制御と間隔制御のどちらによる場合でも、自動トランザクション開始は、ターミナル制御表の適切なターミナル・エントリに条件を設定します。ATIとTTIの両方がYESとして指定され、ターミナルにトランザクションがない場合、ターミナル制御はユーザー定義タスクを開始します。このタスクは、ターミナルにメッセージを送信することが想定されます。 問合せやオーダー・エントリなどのトランザクション処理で使用されるターミナルの場合は、TTI(YES)およびATI(NO)を指定します。これは、ターミナル・リクエストなしではメッセージが送信されなかったり、それを経由してトランザクションが入力される、ディスプレイ・ステーションやハードコピー・ターミナルにも適用されます。3790問合せ論理ユニットに指定できるのはこれのみです。 NO: トランザクションをユーザーがターミナルで開始できません。NOを指定した場合、ATI(YES)を指定すると、トランザクションを自動的に開始できます。このようなターミナルの例には、ウェアハウスなど、遠隔地にあり、無人だがメッセージを受信できるターミナルがあります。 このフィールドが前述のどちらの値にも定義されていない場合は、YESとして処理されます。

接続構成ファイル

表4-13では、ART CICSアプリケーション・サーバーでロードできるconnectionをリストし、定義します。接続構成ファイルは、ARTCTRNの設定では必須ですが、他のサーバーの設定ではオプションです。

ファイル名はconnections.descです。

connection定義の書式は次のとおりです。

[CONNID]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

...

<field_name_n>=<field_value_n>

 

表4-13 接続パラメータ

フィールド名	タイプ	値	説明
CONNID	X(4)	必須	接続の名前。
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
PROTOCOL	X(4)	必須 APPC | LU61	接続を実装するプロトコルのタイプを指定します。
NETNAME	X(8)	必須	接続を受信する、CICSリージョンのAPPLIDを指定します。
MAXIMUM	0~999， 0~999	必須 (APPCのみ)	モードセット内の最大セッション数を指定します。書式はMAXIMUM=value_1,value_2で、Value_1はvalue_2以上である必要があります。
RECEIVECOUNT	999	必須 (LU61のみ)	受信セッション数を指定します。受信セッションは送信前にのみ受信できます。
SENDCOUNT	999	必須 (LU61のみ)	送信セッション数を指定します。送信セッションを送信してからでないと、受信できません。

Webサービス構成ファイル

表4-14では、CICSアプリケーションで使用できるweb serviceを定義します。

ファイル名はwebservice.descです。

 

表4-14 Webサービス・パラメータ

フィールド名	タイプ	値	説明
SERVICE	X(256)	必須	サービスの名前。
REQUEST	X(256)	必須	リクエストのRECORD名
RESPONSE	X(256)	必須	レスポンスのRECORD名
TRANSACTION	X(1)	N | Y オプション	サービスがトランザクションをサポートするかどうかを指定します。このフィールドが指定されていない場合、サービスはトランザクションをサポートしません。

プログラム・リスト構成ファイル

表4-15では、CICSアプリケーション・サーバーARTDPLの起動または停止に使用可能なプログラムのリストをリストし、定義します。

ファイル名はprogram_list_table.descです。

program_list_table.desc定義の書式は次のとおりです。

[plt]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

...

<field_name_n>=<field_value_n>

例:

[plt]

SUFFIX=p1

PROGRAM= RSSBT001, RSSBT002

注意:	空白行およびコメント行がサポートされています。1列目でアスタリスクを使用してコメントをコーディングしたり、CICSの特定の実行から初期化パラメータを一時的に削除できます。

\を使用すると、別の行にパラメータを続けて記述できます。Oracle Tuxedo Application Runtime for CICSでは、現在の行の\より後ろの空白を省略して、オペランドを連結できます。この場合、現在の行の\の後ろには空白のみを記述できます。それ以外の場合、\はバックスラッシュとして扱われます

定義済のプログラム・リストをロードしたり、検出するには、次の2つの方法があります。1つは、-bまたは-dオプションをARTDPL CLOPTに追加する方法で、もう1つは、SUFFIXをsystem.descのPLTPI/PLTSDパラメータに定義する方法です。

例:

ARTDPL CLOPT="-s KIXA -l SIMPAPP -b p1"

この例では、ARTDPLは、初期化時にRSSBT001、RSSBT002という名前のプログラムをロードし、実行します。

 

表4-15 CICSアプリケーション・プログラムのリスト

フィールド名	値	タイプ	説明
SUFFIX	X(2)	必須	PLT接尾辞の名前。SUFFIXの長さは1-2文字です
PROGRAM	X(1024)	必須	プログラム・リストを指定します。書式はPROGRAM=program [,...,programn]です。 プログラムの値は1-8文字の英数字です。

PROGRAMのプログラムがprograms.descに定義されていない、または無効になっている場合は、アプリケーション・サーバーが起動または停止する際に、このプログラムは無視されます。

Program_list_table.descに同じSUFFIXを持つ項目が複数定義されている場合は、最初の項目のみが有効になります。

POOL定義ファイル

表4-16では、CICSアプリケーションで使用できるpoolを定義します。

ファイル名はpool.descです。

pool.desc定義の書式は次のとおりです。

[POOL]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

…

例:

[POOL]

NAME=TSPOOL1

 

表4-16 POOLパラメータ

フィールド名	タイプ	値	説明
NAME	X(8)	A-Z 0-9 $ @ # _	必須。8文字のプール名を指定します。
MAXSIZE	9(18)	number	将来使用するために予約されたフィールド。 オプション。プールに割り当てられる最大サイズをKB単位で指定します。デフォルト値は0で、上限がないことを表します。
AUTOINCREASE	X(1)	Y|N	将来使用するために予約されたフィールド。 オプション。領域が残っていない場合に自動的に領域を増やすかどうかを指定します。デフォルト値はNです。
ELEMENTWARN	9(3)	1-100	将来使用するために予約されたフィールド。 オプション。警告メッセージの表示基準となる領域使用率を指定します。デフォルト値は80です。

TCP/IPソケット・リスナー構成ファイル

この構成ファイルでは、TCP/IPソケット・リスナー情報を定義します。表4‑17では、そのパラメータをリストします。

ファイル名はlistener.descです。動的構成はサポートされていません。書式は次のとおりです。

[ListenerGroupID]

<field_name_1>=<field_value_1>

<field_name_2>=<field_value_2>

 

表4-17 TCP/IPソケット・リスナー・パラメータ

フィールド名	タイプ	値	説明
AF	X(5)	オプション	リスナー・アドレス・ファミリ。INET (デフォルト)またはINET6を使用します。
APPLID	X(8)	オプション	将来使用するために予約されたフィールド。 このリスナーのAPPLID。
BACKLOG	Short	オプション	このリスナーのキューに登録可能な受け入れられない接続の数。デフォルト値は20です。
CSDELAY	X(6)	オプション	将来使用するために予約されたフィールド。 このパラメータはエンハンス・バージョンのリスナーに固有で、CSSTTYPがICの場合にのみ適用可能です。EXEC CICS STARTコマンドで使用される遅延間隔をhhmmss(時間/分/秒)の書式で指定します。
CSSTTYP	X(2)	オプション (エンハンス・モードで使用)	このパラメータはエンハンス・バージョンのリスナーに固有で、ユーザー・トランザクションのデフォルト開始方法を指定します。 KC値(デフォルト)のみをサポートし、EXEC CICS STARTを使用して遅延間隔なしでユーザー・トランザクションが開始されることを示します。
CSTRAN	X(4)	オプション (エンハンス・モードで必須)	このパラメータはエンハンス・バージョンのリスナーに固有で、ARTATRN/ARTATR1でリスナーが開始するデフォルト・トランザクションを指定します。
FORMAT	X(8)	オプション	リスナーのモード。 デフォルト値のSTANDARDは、これが、クライアントが標準ヘッダーを送信する必要がある元のART for CICSリスナーであることを示します。値ENHANCEDは、これがクライアントからの標準ヘッダーを必要としないエンハンスされたART for CICSリスナーであることを示します。
GIVTIME	Short	オプション	このリスナーがTAKESOCKETへのレスポンスを待機する時間(秒単位)。この時間が過ぎると、リスナーはサーバー・トランザクションが開始しなかったか、TAKESOCKETが失敗したと見なします。この時点で、リスナーはサーバーが起動に失敗し、ソケット(接続)を閉じることを示すメッセージをクライアントに送信します。デフォルト値は60です。
IPADDRESS	X(46)	オプション	IPアドレス。
MSGLEN	Short	オプション (エンハンス・モードで使用)	このパラメータはエンハンス・バージョンのリスナーに固有で、クライアントから受信するデータの長さを指定します。有効な範囲は0から999バイトです。値が0の場合、リスナーはクライアントからデータを読み込みません。
PEEKDAT	Short	オプション (エンハンス・モードで使用)	このパラメータはエンハンス・バージョンのリスナーに固有で、MSGLENが0でない場合にのみ適用されます。 値NOは、リスナーがクライアント・データの標準読取りを実行することを示します。ユーザー・トランザクションでは、トランザクション入力メッセージ(TIM)のデータ領域2部分のこのデータにアクセスします。値YESは、リスナーがプレビュー・オプションを使用してデータを読み取ることを示します。データはTCP/IPのキューに残り、TIMを介したアクセスではなく、ユーザー・トランザクションで実際に読み取ります。
PORT	Short	必須	このリスナーが接続の受入れに使用するポート番号。
REATIME	Short	オプション	このリスナーがRECVリクエストへのレスポンスを待機する時間(秒単位)。この時間が過ぎると、リスナーはクライアントが失敗し、ソケットを閉じて接続を終了すると見なします。このパラメータが指定されない場合、読取りタイムアウトのチェックは実行されません。
TRANID	X(4)	オプション	将来使用するために予約されたフィールド。 このリスナーのトランザクション名。
TYPE	X(3)	オプション	作成されるソケットのタイプ。TCPのみをサポートします。

URIMAP構成ファイル

HTTPのURIに一致し、リクエストの処理方法に関する情報を提供するリソース定義。

ファイル名はurimaps.descです。

 

表4‑18 URIMAPパラメータ

フィールド名	タイプ	値	説明
UIRMAP	X(8)	必須	URIMAPの名前
GROUP	X(10)	必須	CICSのグループ概念で、関連するリソースのグループが、CICSシステムによって起動時に宣言され、インスタンス化されるかどうかを決定します。
DESCRIPTION	X(60)	オプション	リソースの説明のための小さなテキスト・コメント領域。
STATUS	X(10)	ENABLED| DISABLED	このパラメータは、URIMAPのステータスを示します。デフォルト値はENABLEDです。
PATH	X(255)	必須	このパラメータでは、URIMAP定義が適用されるURIのパス・コンポーネントを指定します。PATHは、パス・コンポーネントの先頭のスラッシュ(/)を含めて最大255文字です。
SCHEME	X(6)	HTTP|HTTPS	このパラメータでは、URIMAP定義が適用されるURIのスキーム・コンポーネントを指定します。デフォルト値はHTTPです。
USAGE	X(10)	CLIENT| SERVER| PIPELINE| ATOM	このパラメータでは、このURIMAP定義の対象が、HTTPサーバーとしてのCICS (SERVER)、HTTPクライアントとしてのCICS (CLIENT)、Webサービス(PIPELINE)、Atomフィード(ATOM)のいずれであるかを指定します。デフォルト値はSERVERです。 ART for CICSでは、CLIENTのみがサポートされています。

 

表4-19 クライアント・パラメータ

フィールド名	タイプ	値	説明
HOST	X(116)	必須	このパラメータでは、URIMAP定義が適用されるURIのホスト名か、そのIPv4またはIPv6アドレスを指定します。
PORT	X(8)	NO|Number	このパラメータでは、CICSアプリケーションがサーバーと通信する際に使用するポートを10進数で指定します。PORTは、1 − 65535の範囲の数値である必要があります。 この属性を使用しないことを示すには、NOを設定します。
CERTIFICATE	X(32)	オプション	サポートされていません。 このパラメータは、SSLハンドシェイクでSSLクライアント証明書として使用されるX.509証明書のラベルを指定します。
CIPHERS	X(56)	オプション	サポートされていません。 このパラメータは、最大56桁の16進数の文字列(最大28個の2桁の暗号スイート・コードのリストとして解釈されます)を指定します。
AUTHENTICATE	X(10)	NO|BASIC	サポートされていません。 このパラメータでは、HTTP Basic認証情報をHTTPサーバーに送信するかどうかを指定します。デフォルト値はNOです。
SOCKETCLOSE	X(6)	0|hhmmss	サポートされていません。 このパラメータは、CICSアプリケーションがクライアントHTTP接続の使用を終えてから、CICSがその接続を開いたまま維持するかどうか、および維持する時間を指定します。
SERVICE	X(64)	必須	このパラメータは、リモート・エンドポイント用にマップされるTuxedo SALTサービス名を指定します。