SAVE command

The SAVE primary command writes the data set list to the ISPF list data set or to a sequential data set. ISPF writes the data set list in its current sort order. If the Display Catalog Name option is selected and Volume Serial was not entered, the catalog name associated with each data set is included in the Data Set List written to the sequential file. Use this format:


>>-SAVE--+---------+-------------------------------------------><
         '-list-id-'

where list-id is an optional user-specified qualifier of the data set to which the member list will be written. ISPF names the data set:

prefix.userid.list-id.DATASETS

where:

prefix: Your data set prefix, as specified in your TSO user profile. If you have no prefix set, or if your prefix is the same as your user ID, the prefix is omitted and the data set name will be: userid.list-id.DATASETS.
userid: Your TSO user ID.

The data set is created if it does not exist, or written over if it exists, and has compatible attributes. If you omit the list-id operand, the list is written to the ISPF list data set and includes the list and column headings and this data set information:

Data set name
Volume
Org
Recfm
Lrecl
Blksz
Trks
%Used
XT
Created
Catalog Name (depending on the setting of the Display Catalog Name option)

If you enter SAVE without a list-id and the Display Total Tracks option is selected, an additional header line with the accumulated tracks of all data sets and the number of all data sets in the list is written above the column headings. If you provide the list-id operand, the list does not include the column headings and contains all the data set information of the list without the listid provided, plus this information:

Device
Expires
Referred

This command would tell ISPF to write the list to a sequential data set named either prefix.userid.MY.DATASETS or userid.MY.DATASETS.

SAVE MY

If the sequential data set already exists, ISPF writes over it; if not, ISPF creates it.

ISPF displays a progress status pop-up panel when the necessary information to perform a SAVE or SORT primary command has to be retrieved and the data set list comprises 50 or more data sets. The keyboard locks when this pop-up panel appears and stays locked until the SAVE or SORT command is completed. This happens regardless of the setting of Display Total Tracks option and the value entered in the Initial View field.

Note: When Display Total Tracks is ON and Initial View = 2 (Space) or 4 (Total), the pop-up panel appears during the data set list display when it comprises 50 or more data sets and all the track information is to be retrieved. When the SAVE command is subsequently issued the pop-up is not displayed as the data is already available.