Printing a List

To print a copy of a list being viewed or a copy of a saved list, use the ISMF LISTPRT command. With LISTPRT, you can generate the list in standard format or in roster format, store the list in a new or existing data set, and specify which columns are printed.

You can also use ISPF PRINT or PRINT–HI to print what is currently being displayed. See Printing a List Using the ISPF PRINT or PRINT-HI Command for information on how to use these commands.

Printing a List Using the LISTPRT Command

With LISTPRT, you can print lists generated by various ISMF applications. You can print saved lists or lists that are currently being displayed.

There are two ways to use the LISTPRT command:

You can enter LISTPRT without parameters on the command line of a list panel.
You can enter LISTPRT with parameters on the command line of a list panel.

Using the LISTPRT Command without Parameters

From the Data Set or Volume List panels enter LISTPRT on the command line to display the Print Entry panel, as shown in Figure 1.

Figure 1. Printing a List Using the LISTPRT Command

  Panel  List  Dataset  Utilities  Scroll  Help
---------------------------------------------------------------------------------
                                 DATA SET LIST
Command ===> listprt                                            SCROLL ===> PAGE
                                                       Entries 1-5 of 5
Enter Line Operators Below:                            Data Columns 20-22 of 42

    LINE                                      CREATE      EXPIRE     LAST REF
    OPERATOR          DATA SET NAME            DATE        DATE       DATE
   ---(1)----  ------------(2)------------  ---(20)---  ---(21)---  ---(22)---
               USER230.ISMF.ALIST           1998/09/08  0000/00/00  1998/09/10
               USER230.ISMF.CLIST           1996/04/29  NEVER       1998/09/11
               USER230.ISMF.DGTLLIB         1998/04/12  NEVER       1998/09/11
               USER230.ISMF.DGTMLIB         1998/05/08  NEVER       1998/09/11
               USER230.ISMF.DGTPLIB         1998/04/05  NEVER       1998/09/11
----------  ------  -----------  BOTTOM OF  DATA  -----------  ------ ---------

From the Print Entry panel, you can specify the report format, the columns that should be printed, the number of lines to be printed on each page, and the data set in which the output should be stored.

Rule: If you specify an existing output data set, you must also specify whether or not the contents should be replaced by the new list.

Specify one or more of the following options:

Parameter

Description

Select Format Type

Enter this parameter to specify the format of the report as either STANDARD or ROSTER. If you specify STANDARD, information for each entry in the list is printed by column, just as it is in the list panel. If you specify ROSTER, information for each list entry printed one after the other, by row.

Report Data Set Name

Enter this parameter to specify the name of the data set in which the report should be stored. If you enter a data set name you must also enter Y or N in the Replace Report Contents field. If you enter a new data set name, the system will create a data set with that name along with these characteristics:

Physical sequential
LRECL=133
RECFM=FBA

Requirement: If you specify an existing data set name, you must also use the Replace Report Contents parameter to specify whether or not the contents should be replaced by the new list.

Replace Report Contents

Enter this parameter to specify whether or not you want the existing contents of the named data set to be replace by the new list. Entry in this field is required if you specify a data set name in the Report Data Set Name parameter. A value of Y, yes, replaces the contents. A value of N, no, does not replace the contents. The default is N.

Lines/Page

Use this parameter to specify the number of lines that should be printed on each page of the report. The header information occupies the first eleven lines. The default value is 55 lines.

Specify Tags to be Printed

Enter column numbers in the order you want them printed. The * character represents the column tags in default order. Place an * as the final element in your tag sequence to print all remaining columns in default order (19 6 8 *).

Exception: You cannot specify the LINE OPERATOR (1) and DATA SET NAME (2) columns on the Specify Tags field because they always appear as the first two columns on a list panel.

Enter DOWN on the command line to display page 2 of the Data Set Print Entry Panel, as shown in Figure 2.

Figure 2. Page 2 of the Data Set Print Entry Panel

    Panel  Utilities  Scroll  Help                                             
------------------------------------------------------------------------------
                          DATA SET PRINT ENTRY PANEL               Page 2 of 2
Command ===>                                                                  
                                                                              
Select Format Type  . . . . . 1  (1 - Standard, 2 - Roster)                   
Report Data Set Name  . . . .                                                 
Replace Report Contents . . . N  (Y or N)  Lines/Page . . . 55  (12 to 99)    
Specify Tags to be Printed:                                                   
===>  *                                                                       
  
 (42)  EATTR                             (5)  % Space not Used                 
 (32)  Entry Type                        (7)  % User Data Reduction            
 (21)  Expiration Date                  (33)  Reblockable Indicator            
 (23)  Last Backup Date                 (12)  Record Format                   
 (22)  Last Ref Date                    (13)  Record Length                   
 (26)  Mgmnt Class Name                 (10)  Secondary Allocation            
 (18)  Multi-vol Data Set               (27)  Storage Class Name              
  (8)  Number of Extents                 (4)  Used Space                      
 (31)  Number of Stripes                (17)  Volume Serial Number            
 (15)  Opt Block Size                                                         
 (28)  Owner                                                                  
Use ENTER to Perform Print; Use UP Command for previous Panel;                
Use HELP Command for Help; Use END Command to Exit.

Press ENTER to display the Job Submission Entry panel, as shown in Figure 3.

Figure 3. Print Job Submission Entry Panel

  Panel  Utilities  Help
--------------------------------------------------------------------------------
                       PRINT JOB SUBMISSION ENTRY PANEL       REPORT GENERATED
Command ===>

Select one of the following:
  1  1. Submit Job for Background Processing
     2. Save Generated Job in a Data Set

If Save Option is Selected, Specify:
  Data Set Name . . .
  Replace Contents  . . N        (Y or N)
Job Statement Information:       (verify before proceeding)
  ===> //USER10B  JOB  (ACCOUNT),'NAME'
  ===> //*
  ===> //*
  ===> //*
  ===> //*
  ===> //*
  ===> //*

Enter "/" to select option   /  View or Change Execute Stmts from Profile
Use ENTER to Continue;
Use HELP Command for Help; Use END Command to Exit.

Press ENTER to display the Print Execute Statement Entry panel, as shown in Figure 4.

Figure 4. Data Set Print Execute Statement Entry Panel

--------------------------------------------------------------------------------
              ISMF DATA SET PRINT EXECUTE STATEMENT ENTRY PANEL
Command ===>

Specify Data Set Print Execute Statement Information:

 ===> //*
 ===> //*
 ===> //*
 ===> //STEP1  EXEC  PGM=IEBPTPCH
 ===> //*
 ===> //SYSPRINT  DD  SYSOUT=*
 ===> //SYSUT2    DD  SYSOUT=*,DCB=(LRECL=133,RECFM=FBA)








Use ENTER to Continue;
Use HELP Command for Help; Use END Command to Exit.

Press ENTER to submit the batch job.

When you are done, you have printed the list.

Using the LISTPRT Command with Parameters

When you use LISTPRT with parameters, you bypass the Print Entry Panel.

Enter LISTPRT from the command line of the list panel, using the following syntax:

LISTPRT [listname format tags]

where:

LISTPRT: is the command name.
listname: is the name of a saved list (for example, SAMPLIST).
format: format STANDARD (STD) or ROSTER (RST).
tags: can specify column order or * for default order.

Figure 5 shows an example the LISTPRT command with parameters:

Figure 5. Printing a List Using the LISTPRT Command

   Panel  List  Dataset  Utilities  Scroll  Help
 --------------------------------------------------------------------------------
                                 DATA SET LIST
 Command ===> listprt samplist std *                           SCROLL ===> PAGE
                                                        Entries 1-13 of 29
 Enter Line Operators Below:                            Data Columns 18-20 of 42

     LINE                                      CREATE      EXPIRE     LAST REF
     OPERATOR          DATA SET NAME            DATE        DATE       DATE
    ---(1)----  ------------(2)------------  ---(20)---  ---(21)---  ---(22)---
                USER230.ISMFDCR9.SCRIPT      1998/09/09  0000/00/00  1998/09/09
                USER230.ISMF.PLS3            1998/09/08  0000/00/00  1998/09/11
                USER230.ISMF.PLIST           1998/09/08  0000/00/00  1998/09/11
                USER230.ISMF.OBJ             1998/09/08  0000/00/00  1998/09/11
                USER230.ISMF.ALIST           1998/09/08  0000/00/00  1998/09/11
                USER230.ISMF.LKED            1998/09/08  0000/00/00  1998/09/11
                USER230.ISMF230.DGTPLIB      1998/08/21  0000/00/00  1998/09/11
                USER230.ISMF.TESTHMI3        1998/08/08  NEVER       ----------
                USER230.ISMF.TESTHMI2        1998/08/08  NEVER       ----------
                USER230.ISMF.TESTHMI1        1998/08/08  NEVER       ----------
                USER230.ISMF.TESTCOPY        1998/08/08  NEVER       ----------
                USER230.ISMF.JCL             1998/07/26  NEVER       1998/09/08
                USER230.ISMF.TESTJCL         1998/07/01  NEVER       1998/09/04

If the Print Entry Panel is primed with values from the last time you used the LISTPRT command, these values are used as print criteria along with the parameters you specify with the LISTPRT command. The message OTHER VALUES ALSO USED is displayed to remind you that ISMF filtered the list using values from the entry panel as well as those you specified from the list panel.

Printing a List Using the ISPF PRINT or PRINT-HI Command

If you want to print only the portion of the list that is currently displayed on the screen, you can use the ISPF commands PRINT or PRINT-HI.

Enter the PRINT command on the command line of the list panel to print the screen without highlighting any of the fields. If you enter the PRINT-HI command, overstriking simulates the highlighted fields. When you enter either the PRINT or PRINT-HI command, the screen display is formatted for output and placed in the ISPF list data set.

For more information on PRINT and PRINT-HI, see ISPF and ISPF/PDF Reference Summary.