z/OS ISPF User's Guide Vol I
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Processing the log and list data sets during an ISPF session

z/OS ISPF User's Guide Vol I
SC19-3627-00

The LOG and LIST commands allow you to process the log and list data sets, respectively, at any time during an ISPF session. The log and list data sets must have been allocated. You control the data set processing by specifying on the LOG or LIST command one of the three keyword options: PRINT, DELETE, or KEEP.

If you issue the LOG or LIST command with no parameter specified, ISPF displays a panel that allows you to select the data set processing options. The panels for the LOG and LIST commands are shown in Figure 1 and Figure 2, respectively.

Figure 1. Log Data Set Defaults Panel (ISPLLP01)
                      Specify Disposition of Log Data Set

   Log Data Set (USERID.SPFLOG2.LIST) Disposition:
     Process Option . . . .    1. Print data set and delete
                               2. Delete data set without printing
                               3. Keep existing data set and
                                  continue with new data set
     Batch SYSOUT class . .                
     Local printer ID or
     writer-name  . . . . .                  
     Local SYSOUT class . .                

   Press ENTER key to process the log data set.
   Enter END command to exit without processing the log data set.

 Job statement information:  (Required for system printer)
  ===>                                                                         
  ===>                                                                         
  ===>                                                                         
  ===>                                                                         

 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel
Figure 2. List Data Set Defaults Panel (ISPLLP02)
                      Specify Disposition of List Data Set

   List Data Set (USERID.SPF1.LIST) Disposition:
     Process Option . . . .    1. Print data set and delete
                               2. Delete data set without printing
                               3. Keep existing data set and
                                  continue with new data set
     Batch SYSOUT class . .                
     Local printer ID or
     writer-name  . . . . .                  
     Local SYSOUT class . .                

   Press ENTER key to process the list data set.
   Enter END command to exit without processing the list data set.

 Job statement information:  (Required for system printer)
  ===>                                                                         
  ===>                                                                         
  ===>                                                                         
  ===>                                                                         

 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F12=Cancel

With the appropriate panel displayed, type in the process option of your choice. If you specify Print data set and delete, you must also specify a Batch SYSOUT class, or local printer ID or writer name. After you have typed in all information that you wish to specify, press Enter to pass the input to ISPF. ISPF takes the specified action for the data set and then returns you to the panel from which you issued the LOG or LIST command. ISPF issues a message indicating whether the action requested was successful.

If you issue the END command from the Log or List Data Set Defaults panel, ISPF returns you to the panel from which you issued the LOG or LIST command without processing the data set.

ISPF initializes the Log or List Data Set Defaults panel fields with the default values specified with the Log/List pull-down on the ISPF Settings panel. If a default disposition of Keep data set has been specified, ISPF translates the value to Keep data set and allocate new data set before displaying the panel. If you modify the process option field, the new value is used to process the data set; however, it is not saved in the system profile. All other fields modified on the panel are saved in the system profile and become the default values the next time the data set is processed.

If you issue the LOG or LIST command with the PRINT, DELETE, or KEEP option, ISPF does not display a panel. Specifying PRINT, DELETE, or KEEP on the command causes data set processing equivalent to specifying Print data set and delete, Delete data set, and Keep data set and allocate new data set, respectively, on the Log or List Data Set Defaults panel.

Two system variables, ZLOGNAME and ZLSTNAME, contain the fully qualified names of the log and list data sets, respectively. If either data set is not allocated or has not been used in the session, the corresponding system variable value is blank.

Note: The values of ZLOGNAME and ZLSTNAME are set to blank immediately after the log and list data sets have been processed because the data sets are freed by the LOG/LIST command processing. A new data set will not be allocated until it is written to. If you intend to use the log or list data set name for your processing, be sure to retrieve it before issuing the LOG or LIST command.

The system variables are summarized in z/OS ISPF Dialog Developer's Guide and Reference.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014