IBM Support

How to run the osh command of the InfoSphere Parallel Engine in unix

Technote (FAQ)


How can I run the osh command of the InfoSphere Parallel Engine in unix or linux platforms?


Note: This Tech note explains how use this command in unix or linux platforms. For Windows environments please refer to Tech Note 1660714.
The osh command is the main program of the InfoSphere Parallel Engine. This command is used by DataStage to perform several different tasks including parallel job execution and dataset management. Normally, there is no need to run this command directly but sometimes it is useful to use it for troubleshooting purposes.

To run this command there are 3 environment variables that must be set. These are:

  1. APT_ORCHHOME should point to Parallel Engine location
  2. APT_CONFIG_FILE should point to a configuration file
  3. LD_LIBRARY_PATH should include the path to the parallel engine libraries. Please note that the name of this environment variable may take a different name (such as LIBPATH in AIX or SLIB_PATH in HP-UX) depending on your Operating System. Note: This variable does not need to be set in Windows environments.

Here is an example on how to set these variables:

APT_ORCHHOME=/IBM/InformationServer/Server/PXEngine; export APT_ORCHHOME
APT_CONFIG_FILE=/IBM/InformationServer/Server/Configurations/1.apt; export APT_CONFIG_FILE

In addition to these variables it is also recommended to add the location of the osh command to the $PATH so you can execute it regardless of where you are located. Example:


If you don't set variable you will have to either cd to $APT_ORCHHOME/bin or to provide the full location to run osh.

To test if you can execute osh simply run it without parameters. If it returns with the syntax of the osh command then the environments are properly set.

Document information

More support for: InfoSphere Information Server

Software version: 7.5, 8.0.1, 8.1, 8.5, 8.7

Operating system(s): AIX, HP-UX, Linux, Solaris

Reference #: 1621480

Modified date: 23 December 2013

Translate this page: