IBM Support

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

Question & Answer


Question

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

Answer

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
LD_LIBRARY_PATH=$APT_ORCHHOME/lib:$LD_LIBRARY_PATH;export LD_LIBRARY_PATH

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:

PATH=$APT_ORCHHOME/bin:$PATH;export PATH

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.

[{"Product":{"code":"SSZJPZ","label":"IBM InfoSphere Information Server"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"8.7;8.5;8.1;8.0.1;7.5","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
16 June 2018

UID

swg21621480