Copying the started task to the procedures library

Copy the started task to the procedures library and set the environment variables for the IBM® z/OS® console listener.

About this task

You can administer IBM App Connect Enterprise on IBM z/OS Container Extensions (zCX) by using console commands. You must set the necessary environment variables in your environment file. You must also run a supplied console listener program as a started task (one console listener program for each IBM App Connect Enterprise integration server). The console listener program is provided by the IBM z/OS Management Facility installation process, as described in Installing and configuring IBM App Connect Enterprise on zCX.

Procedure

  1. Optional: If you supply your own docker image, you must configure the integration server to output logs to the IBM App Connect Enterprise command line in ibmjson format.
    For more information, see Building your own Docker image.
  2. Set the environment variables that are specific to the console listener in your environment file:
    • ACE_SCRIPTS_DIR - set this variable to the UNIX System Services directory where the scripts are installed.
    • SERVER_REUSE - if you want the integration server to persist after it is stopped or if you want to reconnect to a stopped or running integration server, then set this variable to yes. By default, the integration server is deleted when the started task is stopped.
    For more information, see Environment variables in STDENV and BIPENVS.
  3. Copy the Started Task JCL into an appropriate procedures library, with the name that you agreed with the systems programmer.
    For example, copy BIPXCLIS into USER.PROCLIB. For more information, see Planning and customization tasks on z/OS.
  4. Customize the Started Task JCL according to the instructions in the job. For more information, see Customizing the JCL.

What to do next

You can start and stop the integration server and run IBM App Connect Enterprise commands (with the naming convention mqsi*) from the console. For more information, see the following topics: