For macOS: starting CICS Explorer in a national language

In the macOS operating system, you can start CICS Explorer® in a supported national language by creating and using an Automator application, using a command in a Terminal window, or editing the CICS Explorer zosexplorer.ini file.

• Use the following steps to create and use an Automator application.
  1. Open Automator.
     1. Press cmd+space and type automator. The spotlight shows the Automator application name.
     2. Press Return to load the Automator application.
  2. In the Template Chooser, click Application, then click Choose.
     
  3. Type shell into the search window to locate the Run Shell Script action, then drag the Run Shell Script action into the right pane, as shown in the following screen capture.
     
  4. Paste the shell script command to run CICS Explorer into the Run Shell Script window.

     Optional: You can try the command in a terminal window first to ensure that it is correct and CICS Explorer runs in the language that you specified.

     The format of the command is as follows, where path is the path to the folder where CICS Explorer is installed and xx is the code for the language, as listed in Starting CICS Explorer in a translated language:

     open /path/zosexplorer.app --args -nl xx

     For example:

     open /Users/user_name/zosexplorer/zosexplorer.app --args -nl ja

     
  5. Click Run to test the automator script.
     When the warning message This application will not receive input when run inside Automator is displayed, click OK. Check that CICS Explorer runs in the language that you specified.
  6. Click Save.
     1. Type the name of your application, for example CICS Explorer (ja).app.
     2. Choose the folder where you want to save the application, for example, Desktop.
     3. Ensure that File Format is set to Application.
     4. Click Save.
  7. Close Automator.
     You can now run CICS Explorer from an application shortcut.
  8. Optional: You can use the z/OS® Explorer icon for the new Automator application.
     1. Right-click the original zosexplorer.app in the zosexplorer folder and click Get Info.
     2. Click the z/OS Explorer application icon in the upper left of the zosexplorer.app Info window. A circle is displayed around the icon. Press cmd+C to copy the icon, then close the Info window.
     3. Right-click your new Automator application, for example CICS Explorer (ja).app, then click Get Info. Click the application icon in the upper left of the Automator application window. A circle is displayed around the icon. Press cmd+V to paste the z/OS Explorer icon, then close the Info window.
     Your new Automator application shows the z/OS Explorer icon.

     
• Use the following steps to use a command in a Terminal window.
  1. Open a Terminal window.
  2. Type the full path to the CICS Explorer executable file, followed by -nl xx, where xx is the code for the language, as listed in Starting CICS Explorer in a translated language.
     For example:

     open /Users/user_name/zosexplorer/zosexplorer.app --args -nl ja

  3. To start CICS Explorer in the national language that you specified, press Enter.
• Use the following steps to edit the CICS Explorer zosexplorer.ini file.
  1. Navigate to the zosexplorer folder where you downloaded the CICS Explorer.
  2. Press cmd+click on the zosexplorer.app file, then click Show package contents on the menu.
  3. Double-click the zosexplorer.ini file to open it in a text editor, and add the following two lines of text after the startup section , where xx is the code for the language, as listed in Starting CICS Explorer in a translated language.

     -nl
      xx

     The text must be on two lines, as shown in the following example.

     
  4. Save and close the file.
  5. To start CICS Explorer in the national language that you specified, double-click the zosexplorer file.