Installing IBM CICS Explorer for Aqua 3.2 on macOS releases, Catalina and Big Sur.

Question & Answer

Question

How do I complete the installation of IBM CICS Explorer for Aqua* 3.2 on macOS releases Catalina and Big Sur as it keeps getting blocked by the macOS Gatekeeper?

Cause

The macOS Catalina and Big Sur security restrictions prevent applications that are not notarized with Apple from installing; the files are not notarized and are thus not trusted by macOS Catalina or macOS Big Sur.

Answer

To resolve this problem**:

Download either of the following, according to per the instructions on https://ibm.github.io/mainframe-downloads/eclipse-tools.html:
- Installation Manager or
- IBM Explorer for z/OS Aqua (for Eclipse p2 installation)
Open the Terminal application.
cd to the directory where you stored the extracted folder.
Run the following command. This command recursively removes the extended attributes for all files in the current directory and all directories in it too. Some of these attributes are preventing the installation. Since these attributes are not required for the installation, it is safe to remove all of them.
- For Installation Manager:
  - ```
  sudo xattr -rcs aqua-3.2-im-imversion-macosx-x86_64
```
  where imversion is based on the version of Installation Manager, for example, for Installation Manager 1.9.1.5, imversion would be 1.9.1005. If you are using Safari, for example, this file might have been extracted already.
- For Eclipse p2:
  - ```
  sudo xattr -rcs IBM\ Explorer\ for\ zOS
```
  Note that for some browsers the archived file might not have been extracted so will be in the form of cicsexplorer-aqua-x.y.z-macosx-x86_64.zip where x.y.z is 5.5.17 in the case of fix pack 5.5.0.17.
Enter your sudo password.
Verify that all metadata was stripped by using this command:
```
sudo xattr -lr .
```
If the metadata was successfully stripped, this command returns no output. If there is output, this means that all metadata was not stripped. Do not proceed to the next step until all metadata has been stripped.
Go back to Finder
- Install Installation Manager according to the following:
  - User installation: InstallerImage_macosx_cocoa_x86_64/UserInst.app
  - Admin installation: InstallerImage_macosx_cocoa_x86_64/Install.app or imLauncherMac.sh
  - Installation Manager now starts and you can proceed with the installation.
- If using Eclipse p2, click on IBM Explorer for z/OS and it starts.

* Aqua refers to IBM Explorer for z/OS Aqua.

** Note that support is not yet claimed for Mac computers that use Apple silicon. See https://support.apple.com/en-gb/HT211814 for details as to which devices this relates.

[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"ARM Category":[{"code":"a8m0z00000007ipAAA","label":"CICS Transaction Server-\u003ECICS Explorer-\u003EInstalling"}],"ARM Case Number":"","Platform":[{"code":"PF017","label":"Mac OS"}],"Version":"All Versions"}]

Product Synonym

CICS/TS CICS TS CICS Transaction Server

Was this topic helpful?

Document Information

Modified date:
14 February 2023

UID

ibm16466647

Tips