AUTOLIST—Create a Source Listing Automatically

The AUTOLIST primary command sets autolist mode, which controls the automatic printing of data to the ISPF list data set.

Syntax

ON: Generates a source listing in the ISPF list data set for eventual printing when you end an edit session in which you changed and saved data.
OFF: No source listing is generated.

Description

Autolist mode is saved in the edit profile. To check the current setting of autolist mode:

On the command line, type:
```
PROFILE 3
```
Press Enter. The third line of the edit profile shows the autolist mode setting.

To turn on autolist mode:

On the command line, type:
```
AUTOLIST ON
```
Press Enter.

To turn off autolist mode:

On the command line, type:
```
AUTOLIST OFF
```
Press Enter.

Examples

This example shows how to use the AUTOLIST command to save a copy of a source code listing in the ISPF list data set and to print the list data set.

As you edit a data set, you decide to store a listing of the source code in the ISPF list data set so that you can print it later. Enter the PROFILE 3 command to display the first 3 lines of the edit profile. This shows you whether autolist mode is on or off.
```
PROFILE 3
```

You can see from the edit profile that autolist mode is off:

 =PROF> ....PLI (VARIABLE - 72)....RECOVERY ON....NUMBER OFF....................
 =PROF> ....CAPS OFF....HEX OFF....NULLS OFF....TABS OFF........................
 =PROF> ....AUTOSAVE ON....AUTONUM OFF....AUTOLIST OFF....STATS ON..............

Enter the AUTOLIST ON command to turn on autolist mode:

AUTOLIST ON

The edit profile changes accordingly:

 =PROF> ....PLI (VARIABLE - 72)....RECOVERY ON....NUMBER OFF....................
 =PROF> ....CAPS OFF....HEX OFF....NULLS OFF....TABS OFF........................
 =PROF> ....AUTOSAVE ON....AUTONUM OFF....AUTOLIST ON....STATS ON...............

After editing the data set, save your changes by entering the END command. The changes are saved because, as you can see in the preceding partial edit profile, autosave mode is on.
```
END
```
ISPF creates a list data set with the contents of the data set member that you were editing. The name of the list data set is:
```
prefix.user-id.SPFn.LIST
```
Note: See z/OS ISPF User's Guide Vol I for information about list data sets.
Before leaving ISPF, use the jump function to go to option 0.2 and check the log/list defaults:
```
=0.2
```
The Log and List Defaults panel shows the current default settings for the handling of log and list data sets.
Because you want to print the list data set, make sure that the PD option is entered in the Process Option field under the List Data Set Default Options heading:
```
Process option   ===> PD
```
Note: Also, make sure that the appropriate JCL information is entered at the bottom of the Log and List Defaults panel so that the print job is submitted.
You can now end the session, knowing that the list data set will be printed:
```
=X
```
When the session ends, TSO displays a message that says the print job has been submitted.