ユーザー・ガイド

CICS Runtimeの初期構成

CICS Runtimeの構成

CICS Runtime環境を作成するためには、CICSアプリケーションをインストールする前に、いくつかのテクニカル変数とパスを定義しておく必要があります。

CICS Runtimeと連携する場合、個々のCICSアプリケーションを構成する前に、これらの操作を完了する必要があります。

CICS Runtimeは、次のファイルを使用します。

CICS Runtimeが独自の必要のため、またはTuxedoのために使用する値とパスを集中管理する、UNIXシステムの~/.profileファイル。
Tuxedoが使用するパラメータ、変数およびパスが含まれるTuxedo envfile。
必要なすべてのCICS Runtime Tuxedoサーバーを宣言するTuxedo ubbconfigファイル。
CICS Runtime Tuxedoサーバーで使用される、CICSランタイム・リソース構成ファイル。

UNIX ~/.profileファイル

UNIXユーザーの場合、必要な変数の大部分は、コマンドとアプリケーションのためにユーザーが使用する一般的な変数とパスのすべてを集中管理する.profileファイルで、定義されています。

CICS Runtime、またはそれにより起動される他のテクニカル・ソフトウェアまたはミドルウェア(Oracle、Tuxedo、MQ Seriesなど)で後から必要になる様々な構成ファイルで使用される一般的な変数とパスは、すべてこのファイルで設定します。

続いて、このファイルをエクスポートします。

次の変数を~/.profileファイルの初期設定で設定します。

表3-1 .profileの変数
変数	値	使用方法	変数の使用
`TUXDIR`	インストール時に設定	必須。インストール済Oracle Tuxedo製品を含んでいるディレクトリ。	TUXEDO
`TUXCONFIG`	インストール時に設定	必須。Tuxedo tuxconfigファイルのフル・パス名	TUXEDO
`KIXDIR`	インストール時に設定	必須。CICS Runtime製品を含んでいるディレクトリの絶対パス	CICS Runtime
`APPDIR`	${KIXDIR}/bin	必須。CICSランタイム・サーバーのバイナリがあるディレクトリ	CICS Runtime
`KIXCONFIG`	インストール時に設定	必須。CICS Runtimeのリソース構成ファイルがあるディレクトリ	CICS Runtime
`KIX_TS_DIR`	インストール時に設定	必須。回復不能のCICSキューTSのために使用されるディレクトリ。	CICS Runtime

リスト3-1 .profileファイル初期設定例

export TUXDIR=/product/TUXEDO11GR1	# Directory containing the Installed Tuxedo product

export TUXCONFIG=${HOME}/SIMAPP/config/tux/tuxconfig	# Full path name of the  Tuxedo tuxconfig file

export KIXDIR=${HOME}/KIXEDO				# Absolute path of the  CICS Runtime product directory

export APPDIR=${KIXDIR}/bin				# Directory containing  the  CICS Runtime Servers Binaries

export KIXCONFIG=${HOME}/SIMAPP/config/resources  # Directory for resources files (*.desc)

export KIX_TS_DIR=${HOME}/SIMAPP/KIXTSDIR		# Directory for TS no recovery

Tuxedoシステム・ファイル

Tuxedo Envfileファイル

このenvfileには、TuxedoとCICS Runtimeによって使用される変数とパスが含まれます。Tuxedo管理者が設定するパラメータのほか、これらのパラメータも設定してください。

次の変数は、envfileファイルの初期設定で設定します。

表3-2 envfile変数
変数	値	使用方法
`LC_MESSAGES`	`C`	情報メッセージと診断メッセージのUNIX書式
`OBJECT_MODE`	`64`	UNIX 64ビット・アーキテクチャ
`APPDIR`	`${APPDIR}`	TUXEDO環境。
`TUXCONFIG`	`${TUXCONFIG}`	TUXEDO環境
`USER_TRACE`	`SID`	TUXEDO環境。トレース・タイプ(ユーザーあたり1つ)
`KIXCONFIG`	`${KIXCONFIG}`	CICSランタイム・リソース・ファイルを含んでいるCICSランタイム・ディレクトリ
`PATHTS`	`${KIX_TS_DIR}`	回復できない一次記憶域のために使用されるCICSランタイム・ディレクトリ

リスト3-2 envfile初期設定例

# <TUXDIR>

#	Refers to the location where you installed TUXEDO.  The default

#	location is "/usr/tuxedo".

# <APPDIR>

#	Refers to the fully qualified directory name where your application

#	runs (i.e., the location of the libraries, mapdefs, and MIB files).

# <TUXCONFIG>

#	Refers to the fully qualified binary version of the TUXEDO

#	configuration file.  (This is usually the "tuxconfig" in the $APPDIR

#	directory.)

# Copyright ï¿½1998, BEA Systems, Inc., all rights reserved.

#--------------------------------------------------------------------------

# TUXEDO environment

APPDIR=${KIXDIR}/bin

CONFDIR=${APPHOME}/config/tux

TUXCONFIG=${CONFDIR}/tuxconfig

FLDTBLDIR32=${KIXDIR}/src

FIELDTBLS32=msgflds32

OBJECT_MODE=64

#resource files directory

KIXCONFIG=${APPHOME}/config/resources

# Command executable paths

HAB_TRAN=none

# Other environment

LC_MESSAGES=C

# End

Tuxedo ubbconfigファイル

次に示すCICS Runtimeの初期構成は、3270sクライアント指向のトランザクションを使用した、典型的なユーザーのシナリオ用に構成されています。一部のCICS Runtime Tuxedoサーバーは必須ですが、他のサーバーは、オプションで起動することも可能で、ここでは必ず必要なわけではありません。

必須サーバー

これらのサーバーは、起動してCICS Runtimeを実行し、CICS Runtimeの「Good Morning」画面を表示させることで、初期設定が正しいことを検証する必要があります(ホスト接続の「ようこそ」画面)。

ターミナル制御プログラム・リスナー(ARTTCPLサーバー)は、3270ターミナルまたはエミュレータで表示されるマップを介して、エンド・ユーザーとCICSランタイム・アプリケーションの間の通信を確立するため、必要です。
接続サーバー(ARTCNXサーバー)も、ユーザー接続フェーズと切断フェーズでテクニカル接続サービスを提供するため、必要とされます。システム・トランザクションCSGMを介して、CICSシステム・トランザクションのCICS Runtime「Good Morning」画面を表示するためにも使用されます。
他のすべてのサーバー用にリソース・ファイルをレプリケートするために、管理サーバー(ARTADMサーバー)が必要です。

オプションのサーバー

未インストールのCICSアプリケーションで使用されるだけなので、これらのサーバーを起動する必要はありません。

これらのサーバーを起動しないためには、再コンパイルする前に、ubbconfigファイルの対応する行をコメントアウトします。

同期トランザクションCICSアプリケーションを管理する同期トランザクション・サーバー(ARTSTRNおよびARTSTR1)
非同期トランザクションCICSアプリケーションを管理する非同期トランザクション・サーバー(ARTATRNおよびARTATR1)。
Cobol CICSプログラムで使用されるTSキューを管理する一時記憶域サーバー(ARTTSQサーバー)。
遅延CICSトランザクションに対してのみ使用されるTuxedo /Q TMQUEUEサーバーおよびTMQFORWARDサーバー。

注:	次のものをサポートするには、TMQUEUEが`ARTCNX`より前に起動される必要があります。

INQUIRE NETNANE TERMINAL() ACQSTATUS()
INQUIRE TERMINAL NETNAME() ACQSTATUS()
SET TERMINAL RELEASED/ACQUIRED/CREATE
3270ターミナルからの静的LUNAME

リスト3-3 ubbconfig初期サーバー構成例

*SERVERS

ARTTCPL SRVGRP=TCP00

                SRVID=101

                CLOPT="-o /home2/work9/demo/Logs/TUX/sysout/stdout_tcp -e /home2/work9/demo/Logs/TUX/sysout/stderr_tcp -- -M 4 -m 1 -L //deimos:2994 -n //deimos:2992"

ARTADM      SRVGRP=ADM00

            SRVID=3000

            SEQUENCE=1

            MIN=1 MAX=1

            CLOPT="-o /home2/work9/trf/Logs/TUX/sysout/stdout_adm -e /home2/work9/trf/Logs/TUX/sysout/stderr_adm -r --"

ARTCNX     SRVGRP=GRP01

            SRVID=15

            CONV=Y

            MIN=1 MAX=1 RQADDR=QCNX015 REPLYQ=Y

            CLOPT="-o /home2/work9/demo/Logs/TUX/sysout/stdout_cnx -e /home2/work9/demo/Logs/TUX/sysout/stderr_cnx -r --"

ここで:

*SERVERS

サーバー定義を示すTuxedo ubbconfigキーワードです。

ARTTCPLサーバーの場合:

SRVGRP

ARTTCPLが属するTuxedoグループ名です。

SRVID

ARTTCPL Tuxedoサーバーの識別子です。

CLOPT

パラメータを含むサーバーに渡される引用符付きテキスト文字列です。

-o

ファイルがサーバーの標準出力メッセージのために使用されることを示します。

-e

ファイルがサーバーのエラー出力メッセージのために使用されることを示します。

-M 4

TCPLハンドラ・プロセス数の最大値が4であることを示します。

-m 1

TCPLハンドラ・プロセス数の最小値が1であることを示します。

-L //deimos:2994

TCPLとTCPHによって独自の通信に使用される内部URLアドレスを示します。

-n //deimos:2992

TN3270ターミナルがTCPLに接続するURLアドレスを示します。

ARTADMサーバーの場合:

SRVGRP

ARTADMが属するOracle Tuxedoグループ名です。

SRVID

ARTADMのTuxedoサーバーの識別子です。

SEQUENCE=1

この行は必須です。このサーバーを最初に起動させる必要があることを示します。

MIN=1 and MAX=1

このサーバーのインスタンスは1つのみ実行可能であることを示します。

CLOPT

パラメータを含むサーバーに渡される引用符付きテキスト文字列です。

-o

ファイルがサーバーの標準出力メッセージのために使用されることを示します。

-e

ファイルがサーバーのエラー出力メッセージのために使用されることを示します。

-r

統計レポートを作成するために使用されるTuxedoパラメータです。

ARTCNXサーバーの場合:

SRVGRP

ARTCNXが属するTuxedoグループ名です。

SRVID

ARTCNXのTuxedoサーバーの識別子です。

CONV=Y

このサーバーが対話モードで動作していることを示します。

MIN=1 and MAX=1

このサーバーのインスタンスは1つのみ実行可能であることを示します。

REPLYQ=Y

このサーバーが応答することを示します。

RQADDR=QCNX015

レスポンスに使用されるTuxedoキューの名前。

CLOPT

パラメータを含むサーバーに渡される引用符付きテキスト文字列です。

-o

ファイルがサーバーの標準出力メッセージのために使用されることを示します。

-e

ファイルがサーバーのエラー出力メッセージのために使用されることを示します。

-r

統計レポートを作成するために使用されるTuxedoパラメータです。

必須サーバーのグループ

Tuxedoサーバーを起動するには、ubbconfigファイルで事前に定義されたTuxedoサーバー・グループで定義されている必要があります。ARTTCPLおよびARTCNXサーバーが必須であるため、ubbconfigファイルでグループが定義され、存在し、コメントアウトされていないことを確認します。

この例では、ARTTCPLはTuxedoサーバー・グループTCP00 (SRVGRP=TCP00)に属しており、ARTCNXはサーバー・グループ(SRVGRP=GRP01)に属しています。このため、ubbconfigファイルには、次の例におけるこれら2つのサーバー・グループの定義が含まれます。

リスト3-4 サーバー・グループの定義

*GROUPS

DEFAULT:    LMID=KIXR

# Applicative groups

TCP00           LMID=KIXR

                GRPNO=1

                TMSCOUNT=2

ADM00           GRPNO=5

GRP01

   GRPNO=11

   ENVFILE="/home2/work9/demo/config/tux/envfile"

ここで:

*GROUPS

サーバー・グループの定義を示すTuxedo ubbconfigキーワード。

LMID=

CICSの名前。

GRPNO=

Tuxedoグループ。

TMSCOUNT=

Tuxedoトランザクション・マネージャ・サービスの数

ENVFILE

Tuxedo envfileのパス。

オプションのサーバー・グループ

これらのグループは、オプションのサーバーを含むために使用されます。最初のグループは、Tuxedoサーバーのサーバー・グループによって使用されます(CICSアプリケーションによって使用されるARTSTRN、ARTSTR1、ARTATRN、ARTATR1、ARTTSQ)。第2のものは、TSキュー管理のためだけに使用されます。

CICSランタイム・リソース構成ファイル

CICS Runtimeが動作するためには、たとえ空であっても、次のファイルがすべて${KIXCONFIG}パスに存在する必要があります。

必須の移入済ファイル

typeterms.desc構成ファイル

TCPサーバーで使用されるこのファイルは、3270ターミナルまたはエミュレータで使用される、様々な種類のターミナルを記述しています。

リスト3-5 typeterm記述例

[typeterm]

name=IBM-3279-5E

color=YES

defscreencolumn=80

defscreenrow=24

description="IBM 327x family terminal"

hilight=YES

logonmsg=YES

outline=NO

swastatus=ENABLED

uctran=NO

userarealen=0

説明:

[typeterm]

ターミナル・タイプを定義するキーワード。

name=

ターミナルのタイプ。

color=YES

ターミナルが拡張カラー属性を使用するかどうかを示します。

defscreencolumn= 80

ターミナルの列数。

defscreenrow=24

ターミナルの行数

description="…"

ターミナルについてのコメント。

hilight=YES

このターミナルがハイライト機能をサポートすることを示します。

logonmsg=YES

ログオン時に、ターミナル上で「Good Morning」(CSGM)トランザクションが自動的に起動されることを示します。

outline=NO

このターミナルがフィールドの外枠表示をサポートしないことを示します。

swastatus=ENABLED

システムがこのターミナル・タイプを使用できることを示します。

uctran=NO

小文字のアルファベットが大文字に変換されないことを示します

userarealen=0

ターミナル制御表ユーザー領域(TCTUA)の、ターミナル用の領域サイズ。

mapsets.desc構成ファイル

CSGMトランザクションを開始して、「Good Morning」画面を表示するためには、少なくとも次の定義がこのファイルに含まれている必要があります。

リスト3-6 mapsets.descの例

[mapset]

name=ABANNER

filename=<KIXDIR>/sysmap/abanner.mpdef

ここで:

name=

プログラム内部で、EXEC CICS SEND/RECEIVE MAP(マップ名)MAPSET(マップセット名)…END-EXEC文で使用されている論理マップセット名です。

filename=

CICS z/OS BMS形式でコーディングされたマップセット・ファイル・ソースのコンパイルにより作成されたバイナリ・ファイルがある物理パスです。

注:	ABANNERシステム・マップセットの特定の事例では、ファイル名は`${KIXDIR}`ディレクトリ配下にあります。カッコ内のテキスト<`KIXDIR`>を、UNIXの`~/.profile`システム・ファイルの`${KIXDIR}`変数の値で置換する必要があります。

この例では、結果は次のようになります。

リスト3-7 ${TUXDIR}を代入したmapsets.descの例

[mapset]

name=ABANNER

filename=/product/art11gR1/Cics_RT/sysmap/abanner.mpdef

オプションの初期移入済ファイル

次のファイルはすべて、最初は空のままにしておくことができます。

transclasses.desc構成ファイル
transactions.desc構成ファイル
programs.desc構成ファイル
tsqmodel.desc構成ファイル
mapsets.desc構成ファイル
connections.desc構成ファイル
program_list_table.desc構成ファイル

これらのファイルの内容と使用方法は、後で説明します。

注:	これらのファイルを空のままにしておくと、TuxedoがCICSランタイム・サーバーを起動したときに、`ARTSTRN、ARTSTR1、ARTATRN`および`ARTATR1`サーバーのブート・メッセージの後、なんらかのエラー・メッセージ`CMDTUX_CAT:1685:`「エラー:アプリケーションの初期化が失敗しました」が表示されることがありますが、これは、CICS Runtimeがそれを異常とみなしていることを示しています。

注:	これらのメッセージを表示するサーバーの実数とタイプは、最初に`ubbconfig`ファイルによって起動されたサーバーによって異なります。

注:	この場合、関係するサーバーは、マウントされません。

注:	これらのエラー・メッセージはさしあたり無視され、初期設定には影響がありません。

system.desc構成ファイル
terminals.desc構成ファイル

注:	詳細は、『Oracle Tuxedo Application Runtime for CICSリファレンス・ガイド』を参照してください。

初期設定構成の検証

Tuxedo tmadmin psrコマンドの使用

すべてのファイルが変更され(て、ubbconfig用にコンパイルされ)た場合、変更を有効にするには、Tuxedoを停止して、再起動します。

最初に、Tuxedo CICS Runtime Tuxedoサーバーの起動メッセージを目視し、TuxedoとOracleによって個別に正しく受け入れられたことを確認します。

この最初のチェックが済んだら、Tuxedo tmadmin psrコマンドを入力して、すべてのCICSランタイム・サーバーが実行され、そのメッセージがTuxedoのドキュメントとこのドキュメントに適合していることを確認します。。

ARTADM、ARTTCPLおよびARTCNXの必須のサーバーのみを起動した場合、次のメッセージが表示されます。

リスト3-8 tmadmin psrコマンドの例

# tmadmin

...

> psr

Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service

---------      ----------  --------      -- ------ --------- ---------------

BBL            200933      KIXR           0      1        50 (  IDLE )

ARTTCPL 00001.00101 TCP00        101      0         0 (  IDLE )

ARTCNX        QCNX015     GRP01         15      3       150 (  IDLE )

> quit

注:	BBL Serverは、z/OSのCICSサーバーに相当するTuxedoシステム・サーバーです。

Tuxedo tmadmin pscコマンドの使用

必要なTuxedoサービスが実行されていることを、tmadmin pscコマンドを使用して確認することもできます。

これらのサービスは、CICS Runtimeにより管理されているシステム・トランザクションを含みます。

CSGM: 「Good Morning」画面
CESN: サインオン・トランザクション
CESF: サインオフ・トランザクション

リスト3-9 tmadmin pscコマンドの例

# tmadmin

...

> psc

Service Name Routine Name Prog Name  Grp Name  ID    Machine  # Done Status

------------ ------------ ---------  --------  --    -------  ------ ------

authfail     cnxsvc       ARTCNX    GRP01     15       KIXR       0 AVAIL

CESF         cnxsvc       ARTCNX    GRP01     15       KIXR       0 AVAIL

CESN         cnxsvc       ARTCNX    GRP01     15       KIXR       0 AVAIL

CSGM         cnxsvc       ARTCNX    GRP01     15       KIXR       2 AVAIL

disconnect   cnxsvc       ARTCNX    GRP01     15       KIXR       0 AVAIL

connect      cnxsvc       ARTCNX    GRP01     15       KIXR       1 AVAIL

delsess      cnxsvc       ARTCNX     GRP01     15       KIXR       0 AVAIL

gensess      cnxsvc       ARTCNX     GRP01     15       KIXR       1 AVAIL

update       cnxsvc       ARTCNX     GRP01     15       KIXR       0 AVAIL

inquire      cnxsvc       ARTCNX     GRP01     15       KIXR       0 AVAIL

> quit

注:	ある視点から見ると、このTuxedoコマンドは、指定されたz/OS CICS環境で使用できるトランザクションの表示を可能にする、z/OS CICSシステム・トランザクション`CEMT I TRAN(…)`と同等です。

CSGM CICS「Good Morning」トランザクションの使用

この最初の監査が行われると、3270ターミナルまたはエミュレータで、URLアドレス${HOSTNAME}:${TCPNETADDR}を使用して、CICS Runtimeにアクセスできます。

ここで:

${HOSTNAME}

CICS Runtimeを実行しているUNIXマシンの名前を含んでいる、システムUNIX変数です。

${TCPNETADDR}

Oracle TuxedoのUBBCONFIGファイルでARTTCPサーバーの-nパラメータによって指定されるポート番号です。

次の画面は、コマンド# x3270 deimos:2992を実行した後に、UNIX X11 Windowに表示されます。

図3-1 コマンド#3270 deimos:2992を実行した後の画面

この画面が正常に表示された場合、CICS Runtimeを使用してCICSアプリケーションの実装を継続できます。