Trace configuration using XMS environment variables
As an alternative to using an application configuration file, you can turn on trace using XMS environment variables. These environment variables are only used if there is no trace specification in the application configuration file.
To configure trace for an XMS .NET application, set the following environment variables before running the application:
Environment variables | Default | Settings | Meaning |
---|---|---|---|
XMS_TRACE_ON | Not applicable | Not applicable: the value of this variable is ignored | If XMS_TRACE_ON is set, all trace is enabled by default. |
XMS_TRACE_FILE_PATH | Current® working directory | /dirpath/ | The directory path that trace and FFDC records are written to. XMS creates FFDC and trace files in the current working directory, unless you specify an alternative location. You can specify an alternative location by setting the environment variable XMS_TRACE_FILE_PATH to the fully qualified path name of the directory where you want XMS to create the FFDC and trace files. You must set this environment variable before you start the application that you want to trace. You must make sure that the user identifier under which the application runs has the authority to write to the directory where XMS creates the FFDC and trace files. |
XMS_TRACE_FORMAT | BASIC | BASIC, ADVANCED | Specifies the required trace format, which can be either BASIC or ADVANCED. The default format is BASIC. The ADVANCED format is compatible with trace analyzer tools. |
XMS_TRACE_SPECIFICATION | Not applicable | See Trace configuration using an application configuration file | Overrides the trace specification, which follows the format specified in Trace configuration using an application configuration file. |