CICS Runtime環境を作成するためには、CICSアプリケーションをインストールする前に、いくつかのテクニカル変数とパスを定義しておく必要があります。
CICS Runtimeと連携する場合、個々のCICSアプリケーションを構成する前に、これらの操作を完了する必要があります。
UNIXユーザーの場合、必要な変数の大部分は、コマンドとアプリケーションのためにユーザーが使用する一般的な変数とパスのすべてを集中管理する.profile
ファイルで、定義されています。
CICS Runtime、またはそれにより起動される他のテクニカル・ソフトウェアまたはミドルウェア(Oracle、Tuxedo、MQ Seriesなど)で後から必要になる様々な構成ファイルで使用される一般的な変数とパスは、すべてこのファイルで設定します。
次の変数を~/.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
このenvfileには、TuxedoとCICS Runtimeによって使用される変数とパスが含まれます。Tuxedo管理者が設定するパラメータのほか、これらのパラメータも設定してください。
# <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
PATHTS=${KIX_TS_DIR}
LC_MESSAGES=C
# End
一部のCICS Runtime Tuxedoサーバーはどうしても必要ですが、他のサーバーは、オプションで起動することも可能ですがここで絶対的に必要ではありません。
これらのサーバーは、起動してCICS Runtimeを実行し、CICS Runtimeの「Good Morning」画面を表示させることで、初期設定が正しいことを検証する必要があります(ホスト接続の「ようこそ」画面)。
ARTTCPL
サーバー)は、3270ターミナルまたはエミュレータで表示されるマップを介して、エンド・ユーザーとCICS Runtimeアプリケーションの間の通信を確立するため、必要です。ARTCNXサーバー
)も、ユーザー接続フェーズと切断フェーズでテクニカル接続サービスを提供するため、必要とされます。システム・トランザクションCSGMを介して、CICSシステム・トランザクションのCICS Runtime「Good Morning」画面を表示するためにも使用されます。ARTADM
サーバー)も、CICS Runtimeを管理するために必要です。未インストールのCICSアプリケーションで使用されるだけなので、これらのサーバーを起動する必要はありません。
これらのサーバーを起動しないためには、再コンパイルする前に、ubbconfigファイルの対応する行をコメントアウトします。
ARTSTRN
およびARTSTR1
) ARTATRN
およびARTATR1
)。ARTTSQ
サーバー)。*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"
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 --"
Tuxedoサーバーを起動するには、ubbconfigファイルで事前に定義されたTuxedoサーバー・グループで定義されている必要があります。ARTTCPL
およびARTCNX
サーバーが必須であるため、ubbconfigファイルでグループが定義され、存在し、コメントアウトされていないことを確認します。
この例では、ARTTCPL
はTuxedoサーバー・グループTCP00(SRVGRP=TCP00
)に属しており、ARTCNX
はサーバー・グループ(SRVGRP=GRP01
)に属しています。このため、ubbconfigファイルには、次の例におけるこれら2つのサーバー・グループの定義が含まれます。
*GROUPS
DEFAULT: LMID=KIXR
# Applicative groups
TCP00 LMID=KIXR
GRPNO=1
TMSCOUNT=2
GRP01
GRPNO=11
ENVFILE="/home2/work9/demo/config/tux/envfile"
これらのグループは、オプションのサーバーを含むために使用されます。最初のグループは、Tuxedoサーバーのサーバー・グループによって使用されます(CICSアプリケーションによって使用されるARTSTRN
、ARTSTR1
、ARTATRN
、ARTATR1
、ARTTSQ
)。第2のものは、TSキュー管理のためだけに使用されます。
CICS Runtimeが動作するためには、たとえ空であっても、次のファイルがすべて${KIXCONFIG}
パスに存在する必要があります。
CSGMトランザクションを開始して、「Good Morning」
画面を表示するためには、少なくとも次の定義がこのファイルに含まれている必要があります。
[mapset]
name=ABANNER
filename=<KIXDIR>/sysmap/abanner.mpdef
注意: | ABANNERシステム・マップセットの特定の事例では、ファイル名は${KIXDIR} ディレクトリ配下にあります。カッコ内のテキスト<KIXDIR >を、UNIXの~/.profile システム・ファイルの${KIXDIR} 変数の値で置換する必要があります。 |
[mapset]
name=ABANNER
filename=/product/art11gR1/Cics_RT/sysmap/abanner.mpdef
次のファイルはすべて、最初は空のままにしておくことができます。
注意: | これらのファイルを空のままにしておくと、TuxedoがCICS Runtimeサーバーを起動したときに、ARTSTRN、ARTSTR1、ARTATRN およびARTATR1 サーバーのブート・メッセージの後、なんらかのエラー・メッセージCMDTUX_CAT:1685: 「エラー:アプリケーションの初期化が失敗しました」が表示されることがありますが、これは、CICS Runtimeがそれを異常とみなしていることを示しています。 |
注意: | これらのメッセージを表示するサーバーの実数とタイプは、最初にubbconfig ファイルによって起動されたサーバーによって異なります。 |
注意: | この場合、関係するサーバーは、マウントされません。 |
注意: | これらのエラー・メッセージはさしあたり無視され、初期設定には影響がありません。 |
すべてのファイルが変更され(て、ubbconfig用にコンパイルされ)た場合、変更を有効にするには、Tuxedoを停止して、再起動します。
最初に、Tuxedo CICS Runtime Tuxedoサーバーの起動メッセージを目視し、TuxedoとOracleによって個別に正しく受け入れられたことを確認します。
この最初のチェックが済んだら、Tuxedo tmadmin psr
コマンドを入力して、すべてのCICS Runtimeサーバーが実行され、そのメッセージがTuxedoのドキュメントとこのドキュメントに適合していることを確認します。。
ARTADM
、ARTTCPL
およびARTCNX
の必須のサーバーのみを起動した場合、次のメッセージが表示されます。
# tmadmin
tmadmin - Copyright (c) 2007-2010 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
> 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
コマンドを使用して確認することもできます。
これらのサービスは、CICS Runtimeにより管理されているシステム・トランザクションを含みます。
# tmadmin
tmadmin - Copyright (c) 2007-2010 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
> 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
> quit
#
注意: | ある視点から見ると、このTuxedoコマンドは、指定されたz/OS CICS環境で使用できるトランザクションの表示を可能にする、z/OS CICSシステム・トランザクションCEMT I TRAN(…) と同等です。 |
この最初の監査が行われると、3270ターミナルまたはエミュレータで、URLアドレス${HOSTNAME}:${TCPNETADDR}
を使用して、CICS Runtimeにアクセスできます。
次の画面は、コマンド# x3270 deimos:2992を実行した後に、UNIX X11 Windowに表示されます。
この画面が正常に表示された場合、CICS Runtimeを使用してCICSアプリケーションの実装を継続できます。