Running IBM App Connect Enterprise commands on IBM z/OS Container Extensions (zCX) by using JCL
Run IBM® App Connect Enterprise commands (with the naming convention mqsi*) on IBM z/OS® Container Extensions (zCX) by using the JCL job, BIPXISCM.
About this task
mqsiAssemblyInstall
, mqsicommandconsole
,
mqsicredentials
, and mqsivault
are not supported on IBM
z/OS Container Extensions (zCX). Procedure
Some commands require parameters to specify the work directory of an independent integration server. For example, mqsiwebuseradmin command - Windows, Linux, and AIX systems requires you to specify -w workDir, or --working-directory workDir, depending on whether you decide to use the short names or the alternative long names for the parameters. For these commands, you must specify /home/aceuser/ace-server for workDir.
Some commands require parameters to specify the hostname or IP address of the computer on which the integration server is running, and the port on which the web user interface HTTP connection listener is listening. For example, mqsistartmsgflow command requires you to specify -i ipAddress, or --admin-host ipAddress, and -p port, or --admin-port port, depending on whether you decide to use the short names or the alternative long names for the parameters. For these commands, you must specify 0.0.0.0 for ipAddress. For -p or --admin-port, you must specify the value that you set for REST_PORT in your environment file ENVFILE.
Some commands, for example mqsideploy
, require one or more input files to first
be made available on the docker container that runs the integration server. If the files are not
available on the integration server docker container, you must use the BIPXPUT
sample JCL to transfer them.
Some commands produce output. You can copy or move files from the integration server docker container by using the BIPXGET sample JCL.
BINARY
mode. IBM
z/OS Container Extensions (zCX) run in
ASCII mode. You can convert a file from ASCII to
EBCDIC in UNIX System Services by using iconv
. For
example:iconv -f ISO8859-1 -t IBM-1047 props.txt > props.ebcdic.txt
Results
- If you submit the JCL job
BIPXPUT
, the job runs, and the input files are transferred. - When you submit the JCL job
BIPXISCM
, the job runs. The output from the IBM App Connect Enterprise command is displayed in the job log. - If you submit the JCL job
BIPXGET
, the job runs, and the output files are copied or moved.