Ejecución de comandos de « IBM App Connect Enterprise » en las extensiones de contenedores de « IBM z/OS » ( zCX ) mediante los comandos de la consola de « IBM z/OS »

Ejecute comandos de « IBM® App Connect Enterprise » en las extensiones de contenedores de « IBM z/OS® » ( zCX ) mediante los comandos de la consola de « IBM z/OS ».

Antes de empezar

Establezca las variables de entorno necesarias. Para obtener más información, consulte Variables de entorno en STDENV y BIPENVS.
Para obtener más información sobre las opciones de acceso, consulte Configuración del acceso a los servidores de integración que se ejecutan en IBM z/OS Container Extensions ( zCX ).
Copie la tarea iniciada en la biblioteca de procedimientos, tal como se describe en Copia de la tarea iniciada en la biblioteca de procedimientos.

Acerca de esta tarea

Puede ejecutar comandos de « IBM App Connect Enterprise » (con las convenciones de nomenclatura «mqsi*» o «ibmint*») en las extensiones de contenedor de « IBM z/OS » ( zCX ) mediante los comandos de la consola de « IBM z/OS ». Los nombres de los comandos de « IBM App Connect Enterprise » distinguen entre mayúsculas y minúsculas. Los comandos mqsiAssemblyInstall, mqsicommandconsole, mqsicredentials, y no mqsivault son compatibles con las extensiones de contenedores de IBM z/OS ( zCX ).

Algunos mandatos, por ejemplo, mqsideploy, requieren uno o más archivos de entrada para que estén disponibles primero en el contenedor Docker que ejecuta el servidor de integración. Si los archivos no están disponibles en el contenedor Docker del servidor de integración, debe utilizar el JCL de ejemplo BIPXPUT para transferirlos.

Algunos mandatos generan salidas. Puede copiar o mover archivos del contenedor Docker del servidor de integración utilizando el JCL de ejemplo BIPXGET.

BIPXPUT y BIPXGET siempre sobrescriben un archivo que ya existe y siempre se transfieren en la modalidad BINARY. IBM z/OS Las extensiones de contenedor ( zCX ) funcionan en modo ASCII. Puede convertir un archivo de ASCII a EBCDIC en UNIX System Services utilizando iconv. Por ejemplo, si desea convertir el archivo ASCII props.txt a EBCDIC, ejecute el mandato siguiente:

iconv -f ISO8859-1 -t IBM-1047 props.txt > props.ebcdic.txt

Procedimiento

Opcional: Si el mandato requiere que uno o más archivos de entrada estén disponibles en el contenedor de docker que ejecuta el servidor de integración, personalice el trabajo JCL BIPXPUT tal como se recomienda en los comentarios del trabajo. Para obtener más información, consulte Personalización del JCL.
Opcional: Si el mandato genera una salida, personalice el trabajo JCL BIPXGET tal como se indica en los comentarios del trabajo. Para obtener más información, consulte Personalización del JCL.
Opcional: Someta el trabajo JCL BIPXPUT.
Ejecuta el comando de consola « IBM z/OS » para ejecutar un comando « IBM App Connect Enterprise ». Indique el nombre del JCL de la tarea iniciada, el nombre del comando IBM App Connect Enterprise que desea ejecutar y los parámetros que sean necesarios.
Por ejemplo, si la tarea que has iniciado se llama BIPXCLIS, y quieres ejecutar el comando IBM App Connect Enterprisemqsiexplain con el parámetro 3750, ejecuta el siguiente comando:
```
/F BIPXCLIS,APPL='mqsiexplain 3750' 
```
Algunos mandatos requiere parámetros para especificar el directorio de trabajo de un servidor de integración independiente. Por ejemplo, comando mqsiwebuseradmin - Windows, Linux, y AIX sistemas requiere que especifiques-w directoriotrabajo, o--working-directory directoriotrabajo, dependiendo de si decide utilizar los nombres cortos o los nombres largos alternativos para los parámetros. Para estos mandatos, debe especificar /home/aceuser/ace-server para workDir.

Algunos mandatos requiere parámetros para especificar el nombre de host o la dirección IP del sistema en el que se está ejecutando el servidor de integración, y el puerto en el cual escucha el proceso de escucha de la conexión HTTP de la interfaz de usuario web. Por ejemplo, Mandato mqsistartmsgflow requiere que especifiques-i dirección IP, o--admin-host dirección IP, y-p puerto, o--admin-port puerto, dependiendo de si decide utilizar los nombres cortos o los nombres largos alternativos para los parámetros. Para estos mandatos, debe especificar 0.0.0.0 para ipAddress. Para -p o --admin-port, debe especificar el valor que establece para REST_PORT en el archivo de entorno ENVFILE.

Para obtener más información sobre los comandos disponibles en IBM App Connect Enterprise, consulte «Comandos de tiempo de ejecución ».
Someter el trabajo JCL BIPXGET.

Resultados

La salida del mandato se escribe en ACECMDS en el registro de trabajo.

Qué hacer a continuación

Cuando termine de ejecutar los comandos, puede detener el servidor de integración mediante los comandos de la consola IBM z/OS. Para obtener más información, consulte Detención de un servidor de integración en IBM z/OS Container Extensions ( zCX ) mediante comandos de consola IBM z/OS.