The List function is used to list a range of objects in a source environment and/or display the source code of single or multiple objects.

This section provides instructions for specifying list options in the Object Maintenance - List dialog box.

To list objects

1. In the Library list box, enter the name of the library that contains the object(s) you want to list or select a library from the drop-down list.

   The default is the current library. The Library list box does not apply to DDMs (data definition modules) in a remote mainframe environment. Therefore, the box disappears when the Views (DDM) check box is selected.

2. In the DBID (database ID) and FNR (file number) boxes, replace the values if the library is not in the current system file. The default is the current FNAT or FUSER, or FDIC for DDMs on mainframes. In a remote environment, you can specify security information for these files as described in File Security for Remote Environments.

3. In a remote environment, use the FSEC/FDIC button if you want to specify security information for the system file FSEC or FDIC for XRef data; see also File Security for Remote Environments and XRef Considerations.

4. In the Name box, enter the name of a single object or specify a range of names; see Specifying a Range of Names. The default is asterisk (*), indicating all objects.

5. In the Type group box, select the type(s) of object by choosing one of the following options:

   Select Programming (default) for all types of object (including program and subprogram) except DDM. You can limit the types of object by choosing Object Types and selecting or deselecting the required item(s) from the list provided:

   • To select list items:

     Click on a single item.

     Or:
     Press UP ARROW or DOWN ARROW to go to and select the required item.

     Or:
     Press and hold down CTRL or SHIFT and click on multiple non-consecutive or consecutive items respectively.

     Or:
     Press SHIFT+UP ARROW or SHIFT+DOWN ARROW to select multiple consecutive items.

     Or:
     Choose Select All to select all items.

   • To deselect list items:

     Press and hold down CTRL and click on a selected item again.

     Or:
     Choose Deselect All if all items have been selected.

   Or:
   Select Views (DDM) for DDMs only.

6. In the Code group box, select Source and/or Cataloged to list all objects for which either the source object or the cataloged object, or both exist. The default is both the source object and the cataloged object.

7. In the User ID box, enter the ID of a user if you want to list only the objects that were last saved or cataloged by this user. The default is no user ID.

8. In the Date box, enter a start date to list only objects that were saved or cataloged on or after this date. A date must be entered in the format associated with the preset value in the Date box. The default date is 0000.00.00 (no date). The date is given in the format YYYY.MM.DD (YYYY = year, MM = month, DD = day).

   If you have specified a date, you can enter a start time in the Time box to list only objects that were saved or cataloged at or after this time. The default time is 00:00 (no time). The time is given in the format HH:II (HH = hours, II = minutes).

9. Choose Object List when you have finished specifying object selection criteria.

   If you have specified a single object name, proceed with Step 13.

   If you have specified a range of object names, proceed with Step 10.

10. A dialog box similar to the example below appears with a list of all matching objects:

    

11. Select or deselect single or multiple objects by proceeding as described in To select/deselect list items.

12. Choose List to display the source code of the selected objects.

    (Cancel exits the dialog box without any action.)

13. The Object Maintenance - List dialog box is closed and the Object Maintenance menu appears.

    In addition, for each object selected, an Object Listing window similar to the example below appears, with the source code of the object:

    

    The window title shows the name of the object (here: HELLO) and the name of the library (here: SAGTEST) where the object is stored. The Object Listing window is identical to the window that appears when using the LIST system command.

14. From the Object Maintenance menu, choose Cancel to exit SYSMAIN and activate an open Object Listing window.