Installing and configuring IBM App Connect Enterprise on zCX

Install and configure IBM® App Connect Enterprise on zCX.

About this task

You can install and configure IBM App Connect Enterprise on zCX by completing the following steps:

Procedure

  1. Go to IBM Passport Advantage (https://www.ibm.com/software/passportadvantage/pao_customer.html) and download the appropriate IBM App Connect Enterprise Linux on Z for IBM zCX Multilingual portable software instance image.
  2. Transfer the image to your z/OS UNIX file system. If you are using FTP to transfer the file, ensure that the mode is set to binary.
  3. Extract the files from the downloaded image, by using the pax -rvf image.pax.Z command. This command extracts the files into the current directory.
  4. Log on to the IBM z/OS Management Facility for your z/OS system.
  5. In the main navigation, expand Software and select Software Management.
  6. In the Software Management table, click Portable Software Instances.
  7. In the table header, click the Actions drop-down menu and select Add from z/OSMF system.
  8. Select the following details for where your image is stored:
    • System. The logical partition (LPAR) where your image is located. Select this value by using the drop-down list or the Select button.
    • File location. The file system location for the image; for example /u/jo/ace.
  9. Click Retrieve, check that the IBM App Connect Enterprise PSI is shown in the table, then click OK.
  10. In the table, select IBM App Connect Enterprise. In the Switch To drop-down menu, select Deployments.
  11. Initially, no deployments are displayed. In the table header, click the Actions drop-down menu and select New to create a new one.
  12. In the Deployment Checklist, click Specify the properties for this deployment.
  13. Enter a name for the deployment; for example, ACE. Click OK.
  14. In the Deployment Checklist, click Select the software to deploy.
  15. Set the software type by clicking Portable Software Instance.
  16. Select the PSI that you created previously, then click OK.
  17. In the Deployment Checklist, click Select the objective for this deployment.
  18. In the Select Deployment Objective tab, select the following parameters:
    • Set Objective to Create a new software instance and connect to the following global CSI, then select A new global zone CSI.
    • Set Target system to be the LPAR to install on.
  19. Click OK.
  20. In the Deployment Checklist, click Check for missing SYSMODs.
  21. Click Next, then clear the following reports, which are not required for a new installation:
    • Requisite SYSMODs and Fix Categories reports.
    • Regressed SYSMODs and HOLDDAATA Delta reports.
  22. Click Finish and ignore the warning that is issued when no reports are selected.
  23. In the Deployment Checklist, click Configure this deployment.
  24. Work through the configuration wizard. To use the existing values, click Next, or to change the values, click Modify.
  25. When the wizard is complete, in the Deployment Checklist, click Define the job settings. z/OSMF creates the deployment summary and jobs.
  26. Make updates to the JOB statement as required. When the changes are complete, click OK.
  27. In the Deployment Checklist, click Submit deployment jobs.
  28. The jobs in the Submit Deployment Jobs tab must be submitted one at a time in the specified sequence. When a job completes successfully, submit the next job. To submit a job, select the checkbox next to the job, then open the Actions drop-down menu and click Submit.
  29. When all the jobs are completed, the file system is ready, but is not mounted. Update the SYS1.PARMILIB BPXPRMxx configuration file to mount the file system. The standard mount point for IBM App Connect Enterprise is /usr/lpp/ace/v12/.
  30. In the Deployment Checklist, click Specify the properties for the target software instance.
  31. By default, the software instance name and description are copied from the source software instance, but you can edit them. When the name and description are appropriate, click OK. Software deployment is complete.
  32. Ensure that the environmental requirements for IBM z/OS® Container Extensions (zCX) are met, as described in Planning and customization tasks on z/OS.

Results

The IBM z/OS Management Facility installation process on zCX provides the following libraries and file systems:
Table 1. Libraries and file systems that are provided by the IBM z/OS Management Facility installation process:
Name Description
<hlq>.SACECNTL Contains sample JCL
<hlq>.SACELOAD Contains the load module for the console listener task.
Mounted file system Contains the shell scripts and sample Dockerfile to build the docker image.

What to do next

Customize the JCL as described in Customizing the JCL.