After you have completed a remote z/OS® search, the results are reported in the Remote
z/OS Search view. Use this view to sort or filter the search
results, edit or browse returned files, refine the search results,
or add returned files to a project or subproject.
About this task
The
Remote z/OS Search view opens automatically
after a search request is issued. This view is used to report the
results of searches in the following scopes:
- z/OS systems
- z/OS projects
- MVS™ subprojects
You can set several search options and preferences to limit the
number of search results returned in this view. For more information
about these options and preferences, see the related topics.
- Use the Search results limit field of the Remote
z/OS Search window to set the maximum number of search
results to return. The default setting is 10000.
- Use the Remote z/OS Search preferences page
to control how frequently search results are updated. Rational® Developer for System z® returns search results incrementally,
so that you can begin working with search results before all results
are returned. These preferences control how often the search results
are updated.
Procedure
- To sort the search results, click the heading of the column
you want to sort the results by. This action toggles
the sort order between ascending and descending order.
- To filter the search results, type a string in the Filter
text field. This field filters the search results
as you type.
- When the view is showing the results of a file search, the filter
string is compared to the value in the Name column
for top-level results. Results that do not match the filter are removed
from the view. The filter text is not applied to the second-level
items, such as data set members of partitioned data set search results.
- When the view is showing results of a content string search, the
filter string is compared to the value in the Name column
for top-level and second-level items. Results that do not match the
filter are removed from the view. If the filter removes all second-level
items, the parent top-level item is also removed. If any second-level
item matches, the parent top-level item is retained.
Filter string comparisons are not case-sensitive. If you use
* in a filter string, it matches any string. Wildcard characters are
not allowed in the high-level qualifier. If your original
search request returns all sequential data sets that match MYUSERID.*, for
example, you can type MYUSERID.COBOL.* in this
field to show only the search results that match this filter.
- To view a member or a file in read-only mode, select the Browse action
from the pop-up menu. To edit a member or file, select Open.
Note: The Browse and Open actions appear only if you select
a partitioned data set member or sequential file. They do not appear
if you select a partitioned data set.
- To add a data set, member, folder, or file to an existing
subproject, select the result and choose Add to Subproject from
the menu.
Note: The Add to Subproject action
is available only if an MVS subproject
is available for each z/OS system
on which results are collected.
- If you already have at least one MVS subproject
defined, a window opens to prompt you to choose a destination subproject.
- If you do not have any MVS subprojects
defined, an error message prompts you to create a subproject before
attempting the addition.
- If your selection has already been added to an MVS subproject, selecting Add to Subproject changes
the focus to your selection on the z/OS Projects or Enterprise
Projects view.
- To show the results of previous searches, click the drop-down
menu and select a search result set from the list.