The Find function is used to locate single or multiple objects in single or multiple libraries and display the source code of the objects found.

This section provides instructions for specifying search options in the Object Maintenance - Find dialog box.

To find objects

1. In the Library list box, enter the name of the library in which you want to search for objects or select a library from the drop-down list. The default is the current library. If you enter an asterisk (*), a dialog box appears (see Step 10), where you can select multiple libraries from a list of all libraries available in the specified system file.

   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 File Security for Remote Environments.

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 find 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 find 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 find 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 find 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 library, proceed with Step 13.

   If you have entered an asterisk (*) in the Library list box, proceed with Step 10.

10. A dialog box similar to the example below appears with a list of all libraries available in the specified system file:

    

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

12. Choose OK.

    (Cancel exits the dialog box without any action.)

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

    

    The Skip button only appears if you selected multiple libraries.

    The dialog box shows the library locations, the number of objects found and the object names and types. It also indicates whether a source (S) and/or a cataloged (C) object exists and the ID of the user who saved and/or cataloged an object.

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

    Or:
    Choose Skip if you do not want to select any objects from the current dialog box but open the dialog box for the next library with matching objects if found. Dialog boxes are opened in alphabetical order of library names.

15. Choose List if you want to list the source code of the selected objects.

    (Cancel exits the dialog box without any action.)

16. 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.

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