Reporting environment variables in DataStage

These environment variables are concerned with various aspects of DataStage® jobs reporting their progress.

APT_DUMP_SCORE environment variable in DataStage

Set the APT_DUMP_SCORE environment variable so that DataStage prints a report that shows the operators, processes, and data sets in a running job.

APT_MSG_FILELINE environment variable in DataStage

Set the APT_MSG_FILELINE environment variable so that DataStage logs extra internal information for parallel jobs.

APT_PM_PLAYER_MEMORY environment variable in DataStage

Set the APT_PM_PLAYER_MEMORY environment variable so that each player process reports the process heap memory allocation in the job log when returning.

APT_PM_PLAYER_TIMING environment variable in DataStage

Set the APT_PM_PLAYER_TIMING environment variable so that each player process reports 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 environment variable in DataStage

Set the APT_RECORD_COUNTS environment variable so that, for each operator player, DataStage prints the number of records input and output to the job log.

OSH_DUMP environment variable in DataStage

Set the OSH_DUMP environment variable so that DataStage puts a verbose description of a job in the job log before attempting to execute it.

OSH_ECHO environment variable in DataStage

Set the OSH_ECHO environment variable so that DataStage echos its job specification to the job log after the shell has expanded all arguments.

OSH_EXPLAIN environment variable in DataStage

Set the OSH_EXPLAIN environment variable so that DataStage places a terse description of the job in the job log before attempting to run it.

OSH_PRINT_SCHEMAS environment variable in DataStage

Set the OSH_PRINT_SCHEMAS environment variable so that DataStage prints the record schema of all data sets and the interface schema of all operators in the job log.

APT_MSG_HANDLER_PATH environment variable in DataStage

It sets the path to a message handler file which defines message handlers for this job. This variable has a FilePath type.

APT_MSG_LEVEL environment variable in DataStage

It sets the message level for parallel jobs. You can provide following values:
  • 0 - Info (default)
  • 1 - Warning
  • 2 - Error
  • 3 – Fatal

Its default value is “0”. This variable has a List type.

APT_NO_JOBMON environment variable in DataStage

It disables job monitoring and process meta data reporting for parallel jobs. Its default value is False. This variable has a Boolean type.

APT_PERFORMANCE_DATA environment variable in DataStage

It enables production of advanced runtime performance data files. The value of the environment variable is the directory name into which these files should be placed. This variable has a String type.

APT_SHOW_METRICS environment variable in DataStage

It enables logging job metrics at the end of the job log. Its default value is “all”. You can choose one of following values:
  • all
  • stages
  • links

This variable has a List type.

APT_WRITE_DS_VERSION environment variable in DataStage

It enables saving data sets in formats compatible with old versions of the Parallel environment. Its default value is “v41”. You can choose one of following values:
  • "v3_0"
  • "v3"
  • "v4"
  • "v4_0_3"
  • "v41"

This variable has a List type.