Formats for the trace file name

To specify the APPLTRACEFILENAME keyword setting, you can use either JCL DD statement format or z/OS® UNIX environment HFS format.

JCL DD statement format for a trace file name

The primary use of the JCL DD statement format is to write to a z/OS preallocated sequential data set.

You can also specify z/OS UNIX HFS files on a DD statement. The JCL DD statement format is APPLTRACEFILENAME="DD:ddname". The ddname value is the name of the DD statement that is specified in your job or TSO logon procedure.

Example: Assume that the keyword setting is APPLTRACEFILENAME="DD:APPLDD". You can use the following JCL DD statements in your job or TSO logon procedure to specify the z/OS trace data set.

Write to preallocated sequential data set USER01.MYTRACE.
```
//APPLDD   DD      DISP=SHR,DSN=USER01.MYTRACE
```
Write to preallocated UNIX HFS file MYTRACE in directory /usr/db2.
```
//APPLDD        DD      PATH='/usr/db2/MYTRACE'
```
Allocate UNIX HFS file MYTRACE in directory /usr/db2 specifying permission for the file owner to read from (SIRUSR) and write to (SIWUSR) the trace file:
```
//APPLDD     DD  PATH='/usr/db2/MYTRACE',
             PATHOPTS=(ORDWR,OCREAT,OTRUNC),
             PATHMODE=(SIRUSR,SIWUSR)
```

z/OS UNIX environment HFS format for a trace file name

The z/OS UNIX environment HFS format is used only for writing to HFS files.

The z/OS UNIX HFS file name format is APPLTRACEFILENAME=hfs_filename. The hfs_filename value specifies the path and file name for the HFS file. The HFS file does not have to be preallocated. If the file name does not exist in the specified directory, the file is dynamically allocated.

Example: The following statements use the APPLTRACEFILENAME keyword to specify a z/OS UNIX environment HFS trace file.

Create and write to HFS file named APPLTRC1 in the fully qualified directory /usr/db2.
```
APPLTRACEFILENAME=/usr/db2/APPLTRC1
```
Create and write to HFS file named APPLTRC1 in the current working directory of the application.
```
APPLTRACEFILENAME=./APPLTRC1
```
Create and write to HFS file named APPLTRC1 in the parent directory of the current working directory.
```
APPLTRACEFILENAME=../APPLTRC1
```