CICS コンテナー デモンストレーションの実行

For users of Enterprise Developer for Eclipse:

CICS コンテナー デモンストレーションには、デモンストレーションを実行するプロセスができるだけ簡単になるように設計されたバッチ ファイル (bld.bat) が含まれています。本トピックでは、bld.bat の実行時に指定できるパラメーターについて説明します。

バッチ ファイルを実行して CICS コンテナー デモンストレーションを実行するためのコマンドは次のとおりです。

bld.bat { {dn|x64|x86} [debug]  |
         rmi }

パラメーターは次のとおりです。

debug
CICS アプリケーションを実行するだけでなく、デバッグも行えるように指定します。debug を指定すると、Dockerfile の代わりに Dockerfile.debug が実行されます。
dn
CICS アプリケーションを .NET 環境で実行するように指定します。dn を指定すると、Dockerfile の代わりに Dockerfile.dn が実行されます。
x64
CICS アプリケーションを 64 ビット環境で実行するように指定します。x64 を指定すると、Dockerfile の代わりに Dockerfile.x64 が実行されます。
x86
CICS アプリケーションを 32 ビット環境で実行するように指定します。x86 を指定すると、Dockerfile の代わりに Dockerfile.x86 が実行されます。
rmi
以前に作成した CICS コンテナー デモンストレーション イメージを削除するように指定します。rmi を指定すると、すべての CICS コンテナー デモンストレーション イメージが削除されるまで docker rmi --force または podman rmi --force コマンドが複数回実行されます。
注: CICS コンテナー デモンストレーションで作成されるイメージを実行する際、コンテナーのエンタープライズ サーバーをホスト マシン以外のマシンから Micro Focus Directory Server (MFDS) および Enterprise Server Monitor and Control (ESMAC) を使用して管理できるようにするには、docker run または podman run コマンドでいくつかの追加のパラメーターを指定する必要があります。追加のパラメーターは次のとおりです。
  • -p 16001:86/udp -p16001:86/tcp -p 9000-9010:9000-9010

    コンテナーのポート (86) をホスト マシンのポート (16001) にマップします。

  • -e MFDS_EXTERNAL_ADDR=host-computer-name

    MFDS が ESMAC に移動するために使用するホスト マシンの名前を指定します。

For users of Enterprise Developer UNIX Components:

CICS コンテナー デモンストレーションには、デモンストレーションを実行するプロセスができるだけ簡単になるように設計されたシェル スクリプト (bld.sh) が含まれています。本トピックでは、bld.sh の実行時に指定できるパラメーターについて説明します。

シェル スクリプトを実行して CICS コンテナー デモンストレーションを実行するためのコマンドは次のとおりです。

./bld.sh IacceptEULA  
         [dryrun]
         [esadmgid=admin-gid]
         [esadminuser=admin-id]
         [esadmuid=admin-uid]
         [login|nologin] 
         [logingid=login-gid]
         [loginid=login-id]
         [logingname=login-gname]
         [loginname=login-name]
         [nojava | (java | oraclejava) [javaversion=java-version]]
         [notools]
         [package]
         [rmi]
         [settings]
         [verbose]

パラメーターは次のとおりです。

IacceptEULA
Indicates that you accept the Micro Focus End User License Agreement (EULA). If you do not specify IacceptEULA, no image is created.
dryrun
Indicates that you do not want bld.sh to run any Docker or podman commands. Use dryrun with the verbose parameter to display the Docker or podman commands without running them.
esadminuser=admin-id
Specifies the ID to be used for the Enterprise Server admin user.
esadmgid=admin-gid
Specifies the group ID to use for the Enterprise Server admin user.
esadmuid=admin-uid
Specifies the user ID to use for the Enterprise Server admin user.
java
Indicates that you want the image to include Java support provided by the AdoptOpenJDK OpenJDK. Use the javaversion parameter to specify the version of Java that you want support for.
javaversion=java-version
When specified with the java or oraclejava parameters, specifies the version of Java that you want support for. java-version can be 8, 9, or 10.
login
Indicates that you want to create a login image. Using this option results in image that you can use to log in to (using any details specified by the logingid, loginid, logingname and loginname parameters). Once logged in to this image you can execute shell or Enterprise Developer commands.

This option is useful if you are not adding any application files to a base image but want to be able to use Enterprise Developer commands from it.

When you specify login the tag of the image created is suffixed with "_login".

logingid=login-gid
Specifies the group ID to use for the user specified by the loginid parameter.
loginid=login-id
Specifies the user ID to use for the login image.
logingname=login-gname
Specifies the group name to use for the user specified by the loginid parameter.
loginname=login-name
Specifies the user name to use for the user specified by the loginid parameter.
nojava
Indicates that you do not want Java to be installed in the base image. You might want to use this parameter if your system already includes a number of different versions of Java and you don't want to introduce another version unnecessarily.
nologin
Indicates that you do not want to create a login image. You would typically want to use this option when creating an image that contains an application rather than just a base image for Enterprise Developer. This is the default.
notools
Indicates that you do not want the image to contain the IP tools (such as ping and netcat) that are included in the image by default. Use this option if you do not need the tools and want to minimize the size of the image.
oraclejava
Indicates that you want the image to include Java support provided by the Oracle JDK. Use the javaversion parameter to specify the version of Java that you want support for.
package
Indicates that you want to rebuild the COBOL application in this image.
rmi
以前に作成した CICS コンテナー デモンストレーション イメージを削除するように指定します。rmi を指定すると、すべての CICS コンテナー デモンストレーション イメージが削除されるまで docker rmi --force または podman rmi --force コマンドが複数回実行されます。
settings
Causes the settings that will be used for various properties of the image to be displayed on-screen. Properties that are displayed include the names of the installable file and the license file for Enterprise Developer, the details to be used for the Enterprise Server admin user, and the details to be used for the login image. Specifying settings does not cause an image to be created.
verbose
Causes Docker or podman commands to be displayed on-screen as they are executed.