Datastage Environment Variables

General Job Administration

These environment variables are concerned with details about the running of WebSphere DataStage parallel jobs.

APT_CONFIG_FILE: This environment variable is available in the WebSphere DataStage Administrator under the Parallel branch. Sets the path name of the configuration file. (You might want to include this as a job parameter, so that you can specify the configuration file at job run time).

APT_DISABLE_COMBINATION: This environment variable is available in the WebSphere DataStage Administrator under the Parallel branch. Globally disables operator combining. Operator combining is WebSphere DataStage’s default behavior, in which two or more (in fact any number of) operators within a step are combined into one process where possible. You might need to disable combining to facilitate debugging. Note that disabling combining generates more UNIX processes, and hence requires more system resources and memory. It also disables internal optimizations for job efficiency and run times.

 

APT_MONITOR_SIZE: This environment variable is available in the WebSphere DataStage Administrator under the Parallel branch. Determines the minimum number of records the WebSphere DataStage Job Monitor reports. The default is 5000 records.

APT_MONITOR_TIME: This environment variable is available in the WebSphere DataStage Administrator under the Parallel branch. Determines the minimum time interval in seconds for generating monitor information at runtime. The default is 5 seconds. This variable takes precedence over APT_MONITOR_SIZE.

APT_NO_JOBMON: Turn off job monitoring entirely.

APT_PERFORMANCE_DATA: Set this variable to turn on performance data output generation. APT_PERFORMANCE_DATA can be either set with no value, or be set to a valid path which will be used as the default location for performance data output.

APT_NO_PART_INSERTION: WebSphere DataStage automatically inserts partition components in your application to optimize the performance of the stages in your job. Set this variable to prevent this automatic insertion

 

APT_DUMP_SCORE: This environment variable is available in the WebSphere DataStage Administrator under the Parallel → Reporting. Configures WebSphere DataStage to print a report showing the operators, processes, and data sets in a running job.

APT_PM_PLAYER_MEMORY: This environment variable is available in the WebSphere DataStage Administrator under the Parallel → Reporting branch. Setting this variable causes each player process to report the process heap memory allocation in the job log when returning.

APT_PM_PLAYER_TIMING: This environment variable is available in the WebSphere DataStage Administrator under the Parallel → Reporting branch. Setting this variable causes each player process to report its call and return in the job log. The message with the return is annotated with CPU times for the player process.

APT_RECORD_COUNTS: This environment variable is available in the WebSphere DataStage Administrator under the Parallel → Reporting branch. Causes WebSphere DataStage to print to the job log, for each operator player, the number of records input and output. Abandoned input records are not necessarily accounted for. Buffer operators do not print this information.