Getting started with z/OS Explorer

This topic explains how to get started with z/OS® Explorer and the IMS™ Configuration Manager Eclipse plug-in.

Before you begin

For large IMS topologies, the IMS Configuration Manager Eclipse plug-in can often present large amounts of parameter, resource, or type-2 command response data from requests whose scope extends across many IMS systems and IMSplexes. If when using the IMS Configuration Manager Eclipse plug-in with z/OS Explorer you encounter an out of memory condition where the Java™ heap space has been exhausted due to large volumes of data being returned, try increasing the maximum java heap size to rectify the issue. To do this:
  1. Open the zosexplorer.ini file (or eclipse.ini file as applicable) located in the z/OS Explorer installation directory.
  2. If present, remove option -XX:MaxPermSize=xxxx.
  3. On a new line, add option -Xms256M. This sets the minimum heap size to 256 MB.
  4. On a new line, add option -Xmx4096M. This sets the maximum heap size to 4096 MB.
  5. Save the file and restart your z/OS Explorer.
If you continue to receive out of memory errors after this change, increase the maximum value as required and try again. To monitor the heap size, select Window > Preferences > General and then select Show heap status.

Procedure

  1. Double-click the z/OS Explorer shortcut.
  2. Select Window > Open Perspective > Other.
  3. Select IMS Configuration Manager, and then click OK.
  4. Follow the prompts to complete the User ID and Password fields using the TSO credentials you normally use when using the IMS Configuration Manager ISPF dialog.

What to do next

The first time that the IMS Configuration Manager Eclipse plug-in is run, none of your systems are displayed. See Connecting to a Common Services Library server to connect the IMS Configuration Manager Eclipse plug-in with one or more running instances of the Common Services Library server.