はじめに
CICSはz/OS上で稼働する代表的なトランザクション管理製品の1つです。CICSの構成/管理をサポートする新たなツールが提供されましたのでそれについて試してみた結果を整理します。
このツールは当記事執筆時点(2025年11月時点)ではまだBeta版の位置づけです。正式版リリース時には異なる点があるかもしれませんのでご注意ください。
※当記事は2025年9月時点でリリースされているV0.4.0をベースにしています。
CICS TS構成ツール概要
CICS Transaction Server for z/OS V6.3が2025年9月にリリースされましたが、それと同時にCICS Transaction Server Configuration Tool(ここではCICS TS構成ツールと表記します)という新たなツールが提供されました。
ただし2025年11月時点で提供されているのはまだBeta版という位置づけです。
参考:
Release notes for CICS Transaction Server configuration tool beta
このツールは、CICSリージョンの構成(主にCICSシステム・データセット)の作成/管理を効率化するためのツールです。具体的には、CICSリージョンの構成情報をYAML形式のファイルとして記述しておき、それをツールへのインプットとして指定すると、YAMLファイルに記述された定義に従ってCICSリージョンを構成してくれる、というものです。
Ansibleに代表されるようなIaC(Infrastracture as Code)のツールの一種という位置づけです。
※このツールはAnsibleと同様Pythonベースで実装されていますし、考え方もAnsibleに近いものです。CICS構成専用の簡易版Ansibleといったイメージでしょうか。Ansibleのような別サーバーを立てずにお手軽に利用できるというのは利点だと思いますが、個人的には将来的にAnsibleのCollectionとして提供されることを期待しています。
全体像
CICS TS構成ツールの利用イメージは以下の通りです。
CICS TS構成ツールの本体(実行環境)は、USS上で稼働するPythonモジュールとして実装されています。このツールをUSS上でセットアップするとUSSのシェルで実行できるCLI(Command Line Interface)が提供されます。CICS構成内容を定義したYAMLファイルを準備しておき、それをインプットにコマンドを実行すると、定義内容に従ったCICSリージョンが構成されるという流れです。
YAML形式の構成情報を作成する際には、汎用的なYAMLのエディターが使えます。例えば、てYAML Language Support by Red HatというVS CodeのExtensionが提供されていますので、こちらが利用可能です。CICS TS構成ツールではCICS構成をYAML形式でどのように構成するかフォーマットを示したShcemaファイルも一緒に提供されますので、それをYAMLエディターに取り込むことで、YAML作成時にパラメーター設定のアシストなどを行ってくれます。
また、VS Codeでは、Zowe ExplorerというExtensionも提供されており、VS Code - z/OS間の接続設定をしておけば、VS CodeからUSS上のYAMLファイルを直接編集することができます。
Zowe Explorerの環境がなければPC上で作成したYAMLをFTPなどでUSSに転送することも可です。
以下にデモ動画も公開されていますのでこちらもご参照ください。
Configuration simplification in CICS TS 6.3
製品提供形態
当記事執筆時点(2025年11月時点)では当ツールはまだBeta版です。当初はCICS TS V6.3のBeta版と合わせて提供されていましたが、CICS TS V6.3自体は正式版が既にリリースされており、現時点では当ツールのみベータ版のサイトから入手できるようになっています。
参考:
マニュアルリンク
CICS Transaction Server configuration tool
CICS Transaction Server for z/OS
最終的にどのような提供形態になるかは不明ですが、上のようにマニュアルがCICS Transaction Server本体とは独立して提供されているので、ツールとしても別の独立したものとして提供されるのではないかと推察されます。
実体としては大きく以下の2つが提供されることになります。
- cicsconfig-xxx.zip: 実行環境のUSS上にインストールするPythonモジュール(whlファイル)
- cics_region_xxx.schema.json: 開発環境で使用するYAMLのスキーマファイル
参考:
Installing CICS TS configuration tool using a Python wheel
Using schemas
前提条件
当ツール(V0.4.0)の稼働前提はこちらです。
- z/OS V2.4以降
- IBM Open Enterprise SDK for Python V3.1.1以降
- Z Open Automation Utilities V1.3
使用例
ここからは、実際にCICS TS構成ツールをインストール、実行した時の手順例を示します。
インストール/セットアップ
今回試した環境情報は以下の通りです。
実行環境(z/OS側)
- z/OS V3.1
- IBM Open Enterprise SDK for Python V1.13.1
- IBM Z Open Automation Utilit V1.3.6
開発環境(PC側)
- Windows11
- VS Code V1.106.2
- YAML Language Support V1.19.1
- Zowe Explorer V3.3.1
実行環境(z/OS側)
z/OS側はUSS上での作業になるのでここでの作業は基本的にSSHクライアント(teratermなど)からSSHでUSSに接続し、シェルでの操作をすることになります。
インストーラーの準備
入手した構成ツールのファイル"cicsconfig-0.4.0.zip"をUSS上の適当なディレクトリに転送しておきます。
TAGUCHI:/u/TAGUCHI/CICS # ls -la
total 3728
drwxr-xr-x 2 TAGUCHI SYS1 8192 Nov 5 19:11 .
drwxr-x--- 7 TAGUCHI SYS1 8192 Nov 5 19:16 ..
-rw-r--r-- 1 TAGUCHI SYS1 1882196 Nov 5 19:11 cicsconfig-0.4.0.zip
解凍
TAGUCHI:/u/TAGUCHI/CICS # jar -xvf cicsconfig-0.4.0.zip
inflated: META-INF/MANIFEST.MF
inflated: META-INF/CICSSET0.SF
inflated: META-INF/CICSSET0.RSA
created: cicsconfig/
inflated: cicsconfig/cicsconfig-0.4.0-py3-none-any.whl
inflated: cicsconfig/networkx-3.4.2-py3-none-any.whl
inflated: cicsconfig/pyyaml-6.0.2.tar.gz
inflated: cicsconfig/install.sh
inflated: cicsconfig/Notices.txt
created: cicsconfig/samples/
created: cicsconfig/samples/basic/
inflated: cicsconfig/samples/basic/region.yaml
created: cicsconfig/samples/cics_cmci/
inflated: cicsconfig/samples/cics_cmci/region.yaml
created: cicsconfig/samples/resource_builder/
inflated: cicsconfig/samples/resource_builder/region.yaml
inflated: cicsconfig/samples/resource_builder/resource-definitions.yaml
inflated: cicsconfig/samples/resource_builder/resource-model.yaml
解凍されたファイルの確認
TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # ls -laT
total 3936
drwxr-xr-x 3 TAGUCHI SYS1 8192 Sep 5 22:42 .
drwxr-xr-x 4 TAGUCHI SYS1 8192 Nov 5 19:18 ..
- untagged T=off -rw-r--r-- 1 TAGUCHI SYS1 4638 Sep 5 22:42 Notices.txt
- untagged T=off -rw-r--r-- 1 TAGUCHI SYS1 82798 Sep 5 22:42 cicsconfig-0.4.0-py3-none-any.whl
- untagged T=off -rw-r--r-- 1 TAGUCHI SYS1 313 Sep 5 22:42 install.sh
- untagged T=off -rw-r--r-- 1 TAGUCHI SYS1 1723263 Sep 5 22:42 networkx-3.4.2-py3-none-any.whl
- untagged T=off -rw-r--r-- 1 TAGUCHI SYS1 130631 Sep 5 22:42 pyyaml-6.0.2.tar.gz
drwxr-xr-x 5 TAGUCHI SYS1 8192 Sep 5 22:42 samples
Python仮想環境作成、アクティベート
CICS TS構成ツール用に個別に仮想環境を作成することにします。
z/OS上でのPythonについての詳細は以下の記事も参考にしてください。
バージョン確認
TAGUCHI:/u/TAGUCHI/Python # python --version
IBM Open Enterprise SDK for Python 3.13.1
TAGUCHI:/u/TAGUCHI/Python # pip --version
pip 24.3.1 from /usr/lpp/IBM/cyp/v3r13/pyz/lib/python3.13/site-packages/pip (python 3.13)
Python仮想環境作成
TAGUCHI:/u/TAGUCHI/Python # python -m venv venv_test01 --system-site-packages
※ここで--system-site-packageオプションを指定しているのは、Globalに提供されているデフォルトパッケージを仮想環境に引き継ぐためです。
仮想環境のアクティベート
TAGUCHI:/u/TAGUCHI/Python # . ./venv_test01/bin/activate
(venv_test01) TAGUCHI:/u/TAGUCHI/Python #
確認
(venv_test01) TAGUCHI:/u/TAGUCHI/Python # pip list
Package Version
------------ -------
cffi 1.17.1
cryptography 3.3.2
ibm_db 3.2.7
pip 24.3.1
pycparser 2.20
setuptools 80.9.0
six 1.16.0
wheel 0.45.1
zoautil_py 1.3.6.0
前提ZOAU関連パッケージのインストール
前提となるZOAU関連のPthonパッケージをインストールしておきます。
ZOAU関連のwhlファイル確認
(venv_test01) TAGUCHI:/usr/lpp/IBM/zoautil # ls
IBM conf samples zoautil_py-1.3.6.0-cp313-none-any.whl
LICENSES docs zoautil_py-1.3.6.0-cp310-none-any.whl zoautil_py-1.3.6.0-cp39-none-any.whl
README.txt include zoautil_py-1.3.6.0-cp311-none-any.whl zoautil_py-1.3.6.0.tar.gz
bin lib zoautil_py-1.3.6.0-cp312-none-any.whl zoautil_py-stubs
Python V3.13環境なので、cp313が含まれるwhlファイルを指定してインストール
(venv_test01) TAGUCHI:/usr/lpp/IBM/zoautil # pip install zoautil_py-1.3.6.0-cp313-none-any.whl
Processing ./zoautil_py-1.3.6.0-cp313-none-any.whl
zoautil-py is already installed with the same version as the provided wheel. Use --force-reinstall to force an installation of the wheel.
[notice] A new release of pip is available: 24.3.1 -> 25.3
[notice] To update, run: pip install --upgrade pip
(venv_test01) TAGUCHI:/usr/lpp/IBM/zoautil # pip list
Package Version
------------ -------
cffi 1.17.1
cryptography 3.3.2
ibm_db 3.2.7
pip 24.3.1
pycparser 2.20
setuptools 80.9.0
six 1.16.0
wheel 0.45.1
zoautil_py 1.3.6.0
zoautil_pyが追加されました。
CICS TS構成ツール関連パッケージのインストール
Beta版のせいか、zipを解凍したときに作成されるinstall.shを実行してもうまくうごきませんでした。そこで、install.shの中身を参考に、各モジュールを個別に手動でインストールすることにします。
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # pip install pyyaml-6.0.2.tar.gz --no-index --no-build-isolation
Processing ./pyyaml-6.0.2.tar.gz
Preparing metadata (pyproject.toml) ... done
Building wheels for collected packages: PyYAML
Building wheel for PyYAML (pyproject.toml) ... done
Created wheel for PyYAML: filename=pyyaml-6.0.2-cp313-cp313-os390_29_00_8562.whl size=54902 sha256=e4d275fb4596ccd994d759b54f84ce142274cf18f8b47747d0c4c9207ab6027a
Stored in directory: /u/TAGUCHI/.cache/pip/wheels/84/97/12/87664d143a5ac1fd72bffd8bdd388e5d8e721a06ccd05fa7d8
Successfully built PyYAML
Installing collected packages: PyYAML
Successfully installed PyYAML-6.0.2
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # pip install networkx-3.4.2-py3-none-any.whl
Processing ./networkx-3.4.2-py3-none-any.whl
Installing collected packages: networkx
Successfully installed networkx-3.4.2
[notice] A new release of pip is available: 24.3.1 -> 25.3
[notice] To update, run: pip install --upgrade pip
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # pip install cicsconfig-0.4.0-py3-none-any.whl
Processing ./cicsconfig-0.4.0-py3-none-any.whl
Requirement already satisfied: PyYAML<7.0.0,>=6.0.2 in /u/TAGUCHI/Python/venv_test01/lib/python3.13/site-packages (from cicsconfig==0.4.0) (6.0.2)
Requirement already satisfied: networkx<4.0,>=3.3 in /u/TAGUCHI/Python/venv_test01/lib/python3.13/site-packages (from cicsconfig==0.4.0) (3.4.2)
Installing collected packages: cicsconfig
Successfully installed cicsconfig-0.4.0
確認
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # pip list
Package Version
------------ -------
cffi 1.17.1
cicsconfig 0.4.0
cryptography 3.3.2
ibm_db 3.2.7
networkx 3.4.2
pip 24.3.1
pycparser 2.20
PyYAML 6.0.2
setuptools 80.9.0
six 1.16.0
wheel 0.45.1
zoautil_py 1.3.6.0
cicsconfigおよび、関連パッケージが追加されました。
これでCICS TS構成ツールのインストールは一通り完了です。
コマンド確認
CICS TS構成ツールはcicsconfigというコマンドとして提供されるのでコマンド実行を試してみます。
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # cicsconfig --version
cicsconfig version: 0.4.0
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS/cicsconfig # cicsconfig --help
usage: cicsconfig [-h] [-V] {apply,ls,rm} ...
This tool helps configure CICS TS regions using declarative YAML files. It supports a configuration-as-code approach, where you define the entire setup of a CICS region in YAML ―
including region data sets, system initialization parameters, and other CICS-specific resources.
options:
-h, --help Show this help message and exit.
-V, --version Show version of the installed cicsconfig tool.
actions:
{apply,ls,rm} Actions
apply Apply the configuration to the system
ls List all the configurations that have been applied
rm Remove the configurations with given ID
コマンド実行が確認できました。
開発環境(PC側)
VS Code Extensionのインストール
VS CodeのMarketplaceから、YAML Language Support Extensionを選択してインストールします。(やり方としては他のExtensionと同様なので詳細は割愛します)
さらに、ここではZowe Explorerを使ってz/OSにアクセスできるようにしていますが、Zowe Explorerの詳細は別の記事など参考にしてください。
参考: VS Code - z/OS連携[Zowe Explorer V3編] (1)概要, 基本構成
スキーマの適用
CICS TS構成ツール用のスキーマファイルを利用できるようにセットアップしておきます。
0.4.0用のスキーマファイルは、cics_region_0.4.0.schema.jsonというJSONファイルで提供されています。このファイルをPC上の適当なフォルダに配置しておきます。ここでは、C:/y/VSCode_workspace/eplex_work3/cicsconfigtool/cics_region_0.4.0.schema.jsonとします。
次に、YAMLファイルを作成した時にどのスキーマを参照するかというのを、VS Codeの設定で指定しておきます。今回はプロジェクトごとの設定ファイル(settings.json)にてyaml.shcemaの設定を以下のように追記します。
"yaml.schemas": {
"file:///C:/y/VSCode_workspace/eplex_work3/cicsconfigtool/cics_region_0.4.0.schema.json": "*cicsregion.y*ml"
}
これは、*cicsregion.y*ml(*はワイルドカード)という名前のYAMLファイルを編集する際はcics_region_0.4.0.schema.jsonのスキーマに従うようにする、というファイル名とスキーマのマッピングを定義していることになります。
画面イメージ
これで一通りセットアップは完了です。
CICSリージョン構成
では、実際にCICSリージョンの構成をYAMLで定義し、CICS TS構成ツールで作成する流れを見ていきましょう。
前提
CICS TS構成ツールでできることは、基本的にCICSリージョンのシステムデータセット、起動JCL(orプロシージャー)、資源定義あたりのカスタマイズといったあたりの構成が中心となります。
つまり、z/OS上の資源、VTAM Application Major Node、RACF、Loggerなどの設定を行わせることはできません。(少なくともV0.4.0では)
従って、その辺りのCICS稼働前提となるz/OS上のリソースについては汎用的な定義をしておき、ここではその運用ルールに従ってCICSを構成する、ということにします。
VTAM Application Major Node
参考:
Defining specific APPL definitions and APPL parameters to SNA
CICSANSB VBUILD TYPE=APPL
CICS* APPL AUTH=(ACQ,VPACE,PASS),EAS=100,HAVAIL=YES, X
PARSESS=YES,SONSCIP=YES,VPACING=5
CICSのAPPLIDとしては頭にCICSというキーワードを付けるようなネーミングルールを前提としています。
Logger
参考:
Mapping of CICS system log streams
How CICS selects and connects to a system log stream during system initialization
Model log streams for CICS system logs
CICSリージョンを稼働させる際にはSystem Log Streamとして DFHLOG、DFHSHUNTの2つのLog Streamが必要になります。一般的には事前にこれらのLog Streamを定義しておくことになりますが、今回は柔軟にCICS構成を行うことを想定しているので、Log Streamも動的に作成することを前提に考えます。
デフォルトでは、userid.applid.DFHLOG、userid.applid.DFHSHUNTというLog Streamを使用しにいきますが、これが無ければモデル定義から動的にLog Streamが作成されることになります。この時使用されるモデル定義としては、それぞれ&sysname.DFHLOG.MODEL、&sysname.DFHSHUNT.MODEL が使われることになります。
従って、ここではこのモデル定義を使用することにします。
LOGSTREAM NAME(VS01.DFHLOG.MODEL) STRUCTNAME() LS_DATACLAS()
LS_MGMTCLAS() LS_STORCLAS() HLQ(IXGLOGR) MODEL(YES) LS_SIZE(0)
STG_MGMTCLAS() STG_STORCLAS() STG_DATACLAS() STG_SIZE(3000)
LOWOFFLOAD(40) HIGHOFFLOAD(80) STG_DUPLEX(YES) DUPLEXMODE(UNCOND)
RMNAME() DESCRIPTION() RETPD(0) AUTODELETE(NO) OFFLOADRECALL(YES)
DASDONLY(YES) DIAG(NO) LOGGERDUPLEX() EHLQ(NO_EHLQ) GROUP()
MAXBUFSIZE(64000)
LOGSTREAM NAME(VS01.DFHSHUNT.MODEL) STRUCTNAME() LS_DATACLAS()
LS_MGMTCLAS() LS_STORCLAS() HLQ(IXGLOGR) MODEL(YES) LS_SIZE(0)
STG_MGMTCLAS() STG_STORCLAS() STG_DATACLAS() STG_SIZE(500)
LOWOFFLOAD(40) HIGHOFFLOAD(80) STG_DUPLEX(YES) DUPLEXMODE(UNCOND)
RMNAME() DESCRIPTION() RETPD(0) AUTODELETE(NO) OFFLOADRECALL(YES)
DASDONLY(YES) DIAG(NO) LOGGERDUPLEX() EHLQ(NO_EHLQ) GROUP()
MAXBUFSIZE(64000)
RACF
ここは作成するリージョンをどのようなセキュリティ設定でどのように使わせたいかという要件に応じて細かく設計しないといけないところですが、今回はとりあえずCICS TS構成ツールで作成したリージョンを起動するところまでを手っ取り早く確認することを目的として、必要最低限の定義のみしておくことを想定します。
例えば、ここではJCL起動ではなくプロシージャーでCICSリージョンを起動することを想定するため、リージョンのユーザーをSTARTED Classのプロファイルで指定しておきます。ここではCICSUSERをリージョン・ユーザーIDとして起動させることにします。
※環境の都合上、ここでは今回作成する想定のリージョン名CICSE4A2を指定してプロファイルを作成していますが、CICS*のようにより汎用的な定義にしてしまえば汎用化も可能と思います(リージョンごとに個別に作成しなくてもよい)。
RLIST STARTED CICSE4A2.* STDATA
CLASS NAME
----- ----
STARTED CICSE4A2.* (G)
LEVEL OWNER UNIVERSAL ACCESS YOUR ACCESS WARNING
----- -------- ---------------- ----------- -------
00 IBMUSER NONE NONE NO
INSTALLATION DATA
-----------------
NONE
APPLICATION DATA
----------------
NONE
AUDITING
--------
FAILURES(READ)
NOTIFY
------
NO USER TO BE NOTIFIED
STDATA INFORMATION
------------------
USER= CICSUSER
GROUP=
TRUSTED= NO
PRIVILEGED= NO
TRACE= NO
YAMLファイル作成
さて、前置きが長くなりましたが、上のような環境の前提で、CICSE4A2という名前のCICSリージョンを構成するためのYAMLファイルを作成していきます。
cics_region:
sysid: E4A2
applid: "CICS{{ cics_region.sysid }}"
region_hlq: "TEST01.{{ cics_region.applid }}"
cics_hlq: CICSTS62.CICS
le_hlq: CEE
cics_data_sets:
sdfhlic: CICSTS62.SDFHLIC
region_jcl:
type: proc
dsn: "SYS1.PROCLIB({{ cics_region.applid }})"
上の例はほぼ最小構成でYAMLを作成しています。上のYAML定義内容について補足します。
YAMLファイル:
先にスキーマファイルをマッピングしたファイル名のルールに合致する名前でYAMLファイルを作成する必要があります。それによってVS Code上エディターでYAMLを編集する際にアシスト機能が利用できるようになります。(必須パラメーターを自動で表示する、指定できるパラメーターの候補をリストしてくれるなど。)
また、ファイルはUSS上にUTF-8で作成します。
変数利用:
他のパラメーターで指定した値や、明示的に変数として定義した値を、パラメーターの指定値(または指定値の一部)として利用することができます。具体的には{{ }}で囲った部分は変数として認識されて参照されます。例えば上の例ではapplidとしてCICS{{ cics_region.sysid }}となっていますが、{{ cics_region.sysid }}はYAML定義内のcics_region.sysidの値に置き換わりますので、実際のAPPLIDとしてはCICSE4A2を指定しているのと同義になります。
cics_hlq, le_hlq:
CICSやLEなどのライブラリが展開されているHLQは環境ごとに異なりますので、それらのHLQを指定します。デフォルトのネーミングルールと異なるライブラリ構成になっている場合は、その部分について個別にデータセット名を指定することになります。(上の例ではcics_data_sets.sdfhlic
region_jcl:
デフォルトではCICSリージョン起動用のJCLが作成されることになりますが、ここでは起動プロシージャーを作成したいのでそのための設定を行い(region_jcl.type: proc)、生成したいプロシージャーのメンバー名を指定しています(region_jcl.dsn: "SYS1.PROCLIB({{ cics_region.applid }})"
構成作業
構成したいCICSリージョンの内容を指定したYAMLファイルを作成したので(ほぼデフォルト構成ですが...)、これを基に構成ツールを動かしてCICSリージョン構成を実施してみます。
cicsconfigコマンドのapplyというオプションを使用して、上のYAMLファイルをインプットとして指定するだけです。
(venv_test01) TAGUCHI:/u/TAGUCHI/CICS # cicsconfig apply E4A2_cicsregion.yaml
WARNING: Job parameters are ignored when the region JCL is a procedure (PROC)
OUTPUT: Successfully created and initialized data set: TEST01.CICSE4A2.DFHLCD
OUTPUT: Successfully created data set member: SYS1.PROCLIB(CICSE4A2)
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHBUXT
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHDMPA
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHINTRA
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHTEMP
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHLRQ
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHDMPB
OUTPUT: Successfully created and initialized data set: TEST01.CICSE4A2.DFHGCD
OUTPUT: Successfully created data set: TEST01.CICSE4A2.DFHAUXT
OUTPUT: Successfully created and initialized data set: TEST01.CICSE4A2.DFHCSD
メッセージにあるように、システム・データセットが作成されました。また、起動用のプロシージャーが以下のように作成されました。
//CICSE4A2 PROC
// EXEC PGM=DFHSIP,PARM=SI
//STEPLIB DD DSN=CICSTS62.CICS.SDFHAUTH,DISP=SHR
// DD DSN=CICSTS62.SDFHLIC,DISP=SHR
// DD DSN=CEE.SCEERUN,DISP=SHR
// DD DSN=CEE.SCEERUN2,DISP=SHR
//DFHRPL DD DSN=CICSTS62.CICS.SDFHLOAD,DISP=SHR
// DD DSN=CEE.SCEERUN,DISP=SHR
// DD DSN=CEE.SCEERUN2,DISP=SHR
// DD DSN=CEE.SCEECICS,DISP=SHR
//DFHAUXT DD DSN=TEST01.CICSE4A2.DFHAUXT,DISP=SHR
//DFHBUXT DD DSN=TEST01.CICSE4A2.DFHBUXT,DISP=SHR
//DFHDMPA DD DSN=TEST01.CICSE4A2.DFHDMPA,DISP=SHR
//DFHDMPB DD DSN=TEST01.CICSE4A2.DFHDMPB,DISP=SHR
//DFHCSD DD DSN=TEST01.CICSE4A2.DFHCSD,DISP=SHR
//DFHGCD DD DSN=TEST01.CICSE4A2.DFHGCD,DISP=SHR
//DFHINTRA DD DSN=TEST01.CICSE4A2.DFHINTRA,DISP=SHR
//DFHLCD DD DSN=TEST01.CICSE4A2.DFHLCD,DISP=SHR
//DFHLRQ DD DSN=TEST01.CICSE4A2.DFHLRQ,DISP=SHR
//DFHTEMP DD DSN=TEST01.CICSE4A2.DFHTEMP,DISP=SHR
//CEEMSG DD SYSOUT=*
//CEEOUT DD SYSOUT=*
//DFHCXRF DD SYSOUT=*
//LOGUSR DD SYSOUT=*
//MSGUSR DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN DD *
GRPLIST=(DFHLIST,XDFHCFG)
***********************************************************************
* The following SIT parameters are generated based on the *
* configuration parameters provided in your configuration yaml. *
***********************************************************************
APPLID=CICSE4A2
SYSIDNT=E4A2
AUXTRSW=NEXT
DUMP=YES
DUMPDS=AUTO
AICONS=AUTO
DUMPSW=NEXT
AUXTR=OFF
/*
//
これをSTARTコマンドで実行すると、CICSリージョンが起動することが確認できました！
CICS TS構成ツールで作成されたCICSリージョンの情報やログは、実行ユーザーのディレクトリの.cicsconfigディレクトリ下に管理されます。
TAGUCHI:/u/taguchi/.cicsconfig # ls -laR
.:
total 64
drwxr-xr-x 4 TAGUCHI SYS1 8192 Nov 6 23:12 .
drwxr-x--- 15 TAGUCHI SYS1 8192 Nov 17 09:08 ..
drwxr-xr-x 2 TAGUCHI SYS1 8192 Nov 13 18:40 logs
drwxr-xr-x 2 TAGUCHI SYS1 8192 Nov 13 18:40 state
./logs:
total 7424
drwxr-xr-x 2 TAGUCHI SYS1 8192 Nov 13 18:40 .
drwxr-xr-x 4 TAGUCHI SYS1 8192 Nov 6 23:12 ..
-rw-r--r-- 1 TAGUCHI SYS1 57902 Nov 6 23:12 cics_region_CICSE4A1-06-11-2025_23:12:01.txt
-rw-r--r-- 1 TAGUCHI SYS1 305679 Nov 6 23:45 cics_region_CICSE4A1-06-11-2025_23:45:16.txt
-rw-r--r-- 1 TAGUCHI SYS1 314428 Nov 7 00:05 cics_region_CICSE4A1-07-11-2025_00:05:22.txt
-rw-r--r-- 1 TAGUCHI SYS1 318100 Nov 7 00:06 cics_region_CICSE4A1-07-11-2025_00:05:55.txt
-rw-r--r-- 1 TAGUCHI SYS1 303487 Nov 11 09:53 cics_region_CICSE4A2-11-11-2025_09:53:43.txt
-rw-r--r-- 1 TAGUCHI SYS1 303487 Nov 11 09:56 cics_region_CICSE4A2-11-11-2025_09:55:54.txt
-rw-r--r-- 1 TAGUCHI SYS1 313576 Nov 13 16:53 cics_region_CICSE4A2-13-11-2025_16:52:46.txt
-rw-r--r-- 1 TAGUCHI SYS1 313856 Nov 13 16:53 cics_region_CICSE4A2-13-11-2025_16:53:23.txt
-rw-r--r-- 1 TAGUCHI SYS1 315490 Nov 13 16:54 cics_region_CICSE4A2-13-11-2025_16:54:01.txt
-rw-r--r-- 1 TAGUCHI SYS1 313576 Nov 13 18:38 cics_region_CICSE4A2-13-11-2025_18:38:02.txt
-rw-r--r-- 1 TAGUCHI SYS1 313576 Nov 13 18:39 cics_region_CICSE4A2-13-11-2025_18:39:17.txt
-rw-r--r-- 1 TAGUCHI SYS1 303729 Nov 13 18:40 cics_region_CICSE4A3-13-11-2025_18:40:23.txt
-rw-r--r-- 1 TAGUCHI SYS1 1321 Nov 6 23:38 log-06-11-2025_23:38:07.txt
-rw-r--r-- 1 TAGUCHI SYS1 1929 Nov 6 23:38 log-06-11-2025_23:38:44.txt
-rw-r--r-- 1 TAGUCHI SYS1 1321 Nov 6 23:40 log-06-11-2025_23:40:18.txt
-rw-r--r-- 1 TAGUCHI SYS1 17269 Nov 6 23:40 log-06-11-2025_23:40:28.txt
-rw-r--r-- 1 TAGUCHI SYS1 1081 Nov 6 23:40 log-06-11-2025_23:40:53.txt
-rw-r--r-- 1 TAGUCHI SYS1 1321 Nov 6 23:54 log-06-11-2025_23:54:02.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 11 09:54 log-11-11-2025_09:54:43.txt
-rw-r--r-- 1 TAGUCHI SYS1 7514 Nov 11 09:54 log-11-11-2025_09:54:55.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 11 09:55 log-11-11-2025_09:55:21.txt
-rw-r--r-- 1 TAGUCHI SYS1 15993 Nov 11 09:55 log-11-11-2025_09:55:25.txt
-rw-r--r-- 1 TAGUCHI SYS1 1321 Nov 11 09:55 log-11-11-2025_09:55:42.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 13 16:51 log-13-11-2025_16:51:56.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 13 16:53 log-13-11-2025_16:53:15.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 13 18:38 log-13-11-2025_18:38:45.txt
-rw-r--r-- 1 TAGUCHI SYS1 1561 Nov 13 18:40 log-13-11-2025_18:40:14.txt
./state:
total 80
drwxr-xr-x 2 TAGUCHI SYS1 8192 Nov 13 18:40 .
drwxr-xr-x 4 TAGUCHI SYS1 8192 Nov 6 23:12 ..
-rw-r--r-- 1 TAGUCHI SYS1 1283 Nov 7 00:06 cics_region_CICSE4A1
-rw-r--r-- 1 TAGUCHI SYS1 1281 Nov 13 18:39 cics_region_CICSE4A2
-rw-r--r-- 1 TAGUCHI SYS1 1281 Nov 13 18:40 cics_region_CICSE4A3
cicsconfig lsコマンドでCICS TS構成ツール管理下のリージョンをリストできます。
(venv_test01) TAGUCHI:/u/TAGUCHI/Python # cicsconfig ls
TYPE CONFIG TASK ID LAST UPDATED
cics_region cics_region://CICSE4A1 2025-11-07T00:06:08+09:00
cics_region cics_region://CICSE4A2 2025-11-13T18:39:31+09:00
cics_region cics_region://CICSE4A3 2025-11-13T18:40:31+09:00
cicsconfig rmコマンドで、CICSリージョンの構成を破棄することができます。
おわりに
今回はシンプルなCICSリージョン構成の流れを試してみました。
ほぼデフォルト構成なのであまり面白味はないと思いますが、事前にYAMLで構成情報を定義しておけばリージョン構成が自動化できるということはイメージしていただけるのではないかと思います。
現状このCICS TS構成ツールでできることとしては、SITパラメーターのカスタマイズや、CSDの資源定義のカスタマイズなども行えます。具体的には、製品提供のカタログ・マネージャーのサンプルのための資源定義を含めた形でCSDを作成してリージョンを構成するということもできたりします。
使いどころとしては、例えば開発環境においてアプリケーションの単体テストを行う環境をユーザーごとに動的にプロビジョニングするといったユースケースなど、柔軟にリージョンの構成/破棄を行いたいシチュエーションで活用できるのではないかと思います。
また、まだBeta版なので、今後機能拡張や使い勝手が洗練されていくことも期待されます。