Searching with command FindText
In this sample scenario, members that match two specified search
criteria are searched for. The following tasks are performed:
- Specifying the first search criterion to OLIST command FindText for immediate search with no report and filtering out of relevant libraries.
- From the filtered list of relevant libraries, selecting one library for a detailed search.
- Specifying the first search criterion to MSL command FindText for a detailed report and an additional search criterion.
- Examining the FindText detailed report from an EDIT session.
- Exiting the report to a filtered MSL display of all relevant members.
Searching procedure
- Enter command
OL SYS1LIBS, and then press enter to open permanent object list SYS1LIBS. See Figure 1 for illustration.Figure 1. Opening permanent OLIST SYS1LIBS from the Primary Option Menu Menu Utilities Compilers Options Status Help ______________________________________________________________________________ z/OS Primary Option Menu Option ===> OL SYS1LIBS 0 Settings Terminal and user parameters User ID . : MROTTER 1 View Display source data or listings Time. . . : 11:48 2 Edit Create or change source data Terminal. : 3278 3 Utilities Perform utility functions Screen. . : 2 4 Foreground Interactive language processing Language. : ENGLISH 5 Batch Submit job for language processing Appl ID . : ISR 6 Command Enter TSO or Workstation commands TSO logon : DSCBETA 7 Dialog Test Perform dialog testing TSO prefix: MROTTER - Enter command
FT, and then press enter to display the FindText options menu. See Figure 2 for illustration.Figure 2. Opening FindText options menu from the display of object list SYS1LIBS File Edit Find Display Populate Settings Menu Util Test Help Exit ------------------------------------------------------------------------------- -DSC- OLIST (B) ----------- *** SYSTEM LIBRARIES *** --------- Row 1 to 7 of 7 Command ===> FT SCROLL ===> CSR Hotbar: Open list ===> SYS1LIBS (or BLANK for reference list) *EXEC*PERMANENT LIST* Command Member Numbr Data Set Names / Objects Class --------- -------- ----- ---------------------------------------------- ------- 1 !*** SYSTEM LIBRARIES *** 2 'SYS1.LINKLIB' PDS 3 'SYS1.MACLIB' PDS 4 'SYS1.MIGLIB' PDS 5 'SYS1.PARMLIB' PDS 6 'SYS1.SAMPLIB' PDS 7 'SYS1.VTAMLIB' PDS ---------------- END OF LIST ---------------- - In the OLIST Text Search Settings panel, enter the settings that
are used in Figure 3, and then press enter:
Figure 3. Specifying a single OLIST search criterion to be immediately executed -DSC- OLIST Text Search Settings COMMAND ===> Specify string to search within the OLIST objects SEARCH string ===> 'ABEND%*0C4' mode ===> M W (Word) or M (Mask) or N (Normal) WITH string ===> ABEND mode ===> W W (Word) or M (Mask) or N (Normal) WITHOUT string ===> ABENDED mode ===> N W (Word) or M (Mask) or N (Normal) Specify search range in target data records: START COLUMN ===> 1 END COLUMN ===> 99999 Specify how many objects to process before being prompted to resume: STOP AFTER ===> 999 Number of objects to process successfully PROMPT AFTER ===> 12345 Number of objects to process before a prompt Specify Y (Yes) or N (No) for the following options: AUTOMATIC ===> Y Process until reaches success limit? EXCLUDE ===> Y Exclude mismatched objects from displayed list? PACKED DATA ===> N Expand ISPF packed data format? FIND PROMPT ===> Y Prompt with FIND command upon selecting an object? FULL REPORT ===> N Report all found records with multiple search criteria? Press ENTER for more search criteria or the END key to cancel Note: use " (double quote) to search for ' (single quote) characters Note: use C'... or c'... for case sensitive search strings use X'... or x'... for hexadecimal search strings Note: use * for a pattern mask "any character string or none" indicator use % for a pattern mask "any single character" indicator - In the search result panel, all mismatched data sets are excluded.
Enter line command
Bon the line of library SYS1.MACLIB, and then press enter to select and browse the library. See Figure 4 and Figure 5 for illustration.Figure 4. OLIST FindText search results File Edit Find Display Populate Settings Menu Util Test Help Exit ------------------------------------------------------------------------------- -DSC- OLIST (B) ----------- *** SYSTEM LIBRARIES *** -------- Search completed Command ===> SCROLL ===> CSR Hotbar: Open list ===> SYS1LIBS (or BLANK for reference list) *EXEC*PERMANENT LIST* Command Member Numbr Data Set Names / Objects *EXCLUDE* Class --------- -------- ----- ---------------------------------------------- ------- -TXT FND- APIPPINV 2 'SYS1.LINKLIB' PDS -TXT FND- ERBSTGST 3 'SYS1.MACLIB' PDS -TXT FND- GIMDM64 4 'SYS1.MIGLIB' PDS -TXT FND- EDGCVRSX 6 'SYS1.SAMPLIB' PDS ---------------- END OF LIST ----------------Figure 5. Selecting a specific OLIST object by its sequence number File Edit Find Display Populate Settings Menu Util Test Help Exit ------------------------------------------------------------------------------- -DSC- OLIST (B) ----------- *** SYSTEM LIBRARIES *** ------------ Row 2 from 7 Command ===> SCROLL ===> CSR Hotbar: Open list ===> SYS1LIBS (or BLANK for reference list) *EXEC*PERMANENT LIST* Command Member Numbr Data Set Names / Objects *EXCLUDE* Class --------- -------- ----- ---------------------------------------------- ------- -TXT FND- APIPPINV 2 'SYS1.LINKLIB' PDS B 3 'SYS1.MACLIB' PDS -TXT FND- GIMDM64 4 'SYS1.MIGLIB' PDS -TXT FND- EDGCVRSX 6 'SYS1.SAMPLIB' PDS ---------------- END OF LIST ---------------- - Enter command
FT, and then press enter to display the FindText options menu. See Figure 6 for illustration.Figure 6. Opening FindText options menu from the MSL panel of library SYS1LIBS File Display Library Settings Menu Utilities Test Help Exit ------------------------------------------------------------------------------- -DSC--BROWSE L1---- SYS1.MACLIB ----------------------------ROW 00001 OF 02005 COMMAND ===> FT SCROLL ===> CSR HOTBAR? *SORT*SHOW* ON VOLUME: IPLC23 NAME PROMPT LIB VV.MM CHANGED SIZE INIT MOD USERID ABEND 1 ACB 1 ACBVS 1 ACI 1 ACYAPHDH 1 ADRDEX01 1 ADREID0 1 ADRMCLVL 1 ADSR 1 ADYDSTAT 1 ADYENF 1 AHLFFAP 1 AHLMCWRC 1 AHLWKAL 1 AHLZGTO 1 AHLZGTS 1 ALESERV 1 AMDSADMP 1 ANFUEXTP 1 ANTFEAT 1 ANTFQMAP 1 ANTPFCCI 1 ANTPQMAP 1 ANTPQMP2 1 - In the MSL Text Search Settings panel, enter the settings that
are used in Figure 7, and then press enter:
Figure 7. Specifying the first MSL search criterion to be executed with a detailed search report -DSC- MSL Text Search Settings COMMAND ===> Specify string to search within the MSL members SEARCH string ===> 'ABEND%*0C4' mode ===> M W (Word) or M (Mask) or N (Normal) WITH string ===> ABEND mode ===> W W (Word) or M (Mask) or N (Normal) WITHOUT string ===> ABENDED mode ===> N W (Word) or M (Mask) or N (Normal) Specify search range in target data records: START COLUMN ===> 1 END COLUMN ===> 99999 Specify how many members to process before being prompted to resume: STOP AFTER ===> 999 Number of members to process successfully PROMPT AFTER ===> 12345 Number of members to process before a prompt Specify Y (Yes) or N (No) for the following options: AUTOMATIC ===> Y Process until reaches success limit? EXCLUDE ===> Y Exclude mismatched members from displayed list? PACKED DATA ===> N Expand ISPF packed data format? FIND PROMPT ===> Y Prompt with FIND command upon selecting an member? FULL REPORT ===> Y Report all found records with multiple search criteria? DETAILED ===> Y Break down by search criteria? Press ENTER for more search criteria or the END key to cancel Note: use " (double quote) to search for ' (single quote) characters Note: use C'... or c'... for case sensitive search strings use X'... or x'... for hexadecimal search strings Note: use * for a pattern mask "any character string or none" indicator use % for a pattern mask "any single character" indicator - In the FINDTEXT Search Criteria panel, enter the settings that
are used in Figure 8, and then press enter
to specify a secondary search criterion for a detailed search report:
Figure 8. Specifying a secondary search criterion with a detailed search report -DSC- FINDTEXT Search Criteria Row 1 to 4 of 4 COMMAND ===> Specify string to search within the MSL members SEARCH string ===> c'Symptom%*Record' mode ===> M W (Word) or M (Mask) or N (Normal) WITH string ===> NAME mode ===> W W (Word) or M (Mask) or N (Normal) WITHOUT string ===> mode ===> N W (Word) or M (Mask) or N (Normal) Specify search range in target data records: START COLUMN ===> 2 END COLUMN ===> 71 Press ENTER to process or END key to start search or main command CANCEL No --- Criteria -- -------------------- Search strings -------------------- <01> SEARCH Mask: 'ABEND%*0C4' WITH Word: ABEND WITHOUT String: ABENDED Search data RANGE: START=1 END=99999 ******************************* Bottom of data ******************************** - Press the END key (PF3) to confirm the search criteria and execute
the searching. See Figure 9 for illustration.
Figure 9. FindText search criteria confirmation panel -DSC- FINDTEXT Search Criteria Row 1 to 8 of 8 COMMAND ===> Specify string to search within the MSL members SEARCH string ===> mode ===> N W (Word) or M (Mask) or N (Normal) WITH string ===> mode ===> N W (Word) or M (Mask) or N (Normal) WITHOUT string ===> mode ===> N W (Word) or M (Mask) or N (Normal) Specify search range in target data records: START COLUMN ===> 1 END COLUMN ===> 99999 Press ENTER to process or END key to start search or main command CANCEL No --- Criteria -- -------------------- Search strings -------------------- <01> SEARCH Mask: 'ABEND%*0C4' WITH Word: ABEND WITHOUT String: ABENDED Search data RANGE: START=1 END=99999 <02> SEARCH Mask: c'Symptom%*Record' WITH Word: NAME WITHOUT String: Search data RANGE: START=2 END=71 ******************************* Bottom of data ********************************
Search results
The following figures illustrate the searching results of this scenario:-DSC- EDIT L1----- ......MSL_FINDTEXT_HITS_REPORT........ COLUMNS 00001 00072
COMMAND ===> SCROLL ===> CSR
****** ***************************** Top of Data ******************************
000001 7 HITS IN 5 MEMBERS OUT OF 2399939 RECORDS IN 2005 MEMBERS
000002
000003 ****** MEMBER:SYS1.MACLIB(ADSR) VOL
000004 <02> SEARCH Mask:c'Symptom%*Record'
000005 WITH Word:NAME
000006 WITHOUT String:
000007 Search data RANGE:START=2 END=71
000008 RECNO:12 DATA:*/* Descriptive Name: Symptom Record
000009
000010 ****** MEMBER:SYS1.MACLIB(ERBSTGST) VOL
000011 <01> SEARCH Mask:'ABEND%*0C4'
000012 WITH Word:ABEND
000013 WITHOUT String:ABENDED
000014 Search data RANGE:START=1 END=99999
000015 RECNO:112 DATA:*'/* WB: ABEND 0C4, corrects number of DDBs
000016 RECNO:121 DATA:*'/* WBA: ABEND 0C4 in ERBMFDCQ after activate of dyn
000017
000018 ****** MEMBER:SYS1.MACLIB(IARST64) VOL
000019 <01> SEARCH Mask:'ABEND%*0C4'
000020 WITH Word:ABEND
000021 WITHOUT String:ABENDED
000022 Search data RANGE:START=1 END=99999
000023 RECNO:977 DATA:* abend with an 0C4, but if
000024
000025 ****** MEMBER:SYS1.MACLIB(IWM4ECRE) VOL
000026 <01> SEARCH Mask:'ABEND%*0C4'
000027 WITH Word:ABEND
000028 WITHOUT String:ABENDED
000029 Search data RANGE:START=1 END=99999
000030 RECNO:1112 DATA:* result in a
000031
000032 ****** MEMBER:SYS1.MACLIB(SYMRBLD) VOL
000033 <01> SEARCH Mask:'ABEND%*0C4'
000034 WITH Word:ABEND
000035 WITHOUT String:ABENDED
000036 Search data RANGE:START=1 END=99999
000037 RECNO:1215 DATA:* ABEND_C DC XL2'00C4'
000038 <02> SEARCH Mask:c'Symptom%*Record'
000039 WITH Word:NAME
000040 WITHOUT String:
000041 Search data RANGE:START=2 END=71
000042 RECNO:7 DATA:*01* DESCRIPTIVE NAME: Symptom Record Build
000043
****** **************************** Bottom of Data ****************************
File Display Library Settings Menu Utilities Test Help Exit
-------------------------------------------------------------------------------
-DSC--BROWSE L1---- SYS1.MACLIB --------------------------- Text found in:ADSR
COMMAND ===> SCROLL ===> CSR
HOTBAR?
*EXCLUDE*SORT*SHOW* 2000 HIDDEN* ON VOLUME: IPLC23
NAME PROMPT LIB VV.MM CHANGED SIZE INIT MOD USERID
ADSR +TXT-FND +------------------------------------------------Preview -+
ERBSTGST +TXT-FND | ....+....1....+....2.. ADSR .3....+....4....+....5... |
IARST64 +TXT-FND | * %GOTO SRPLS1; /* BILINGUAL MAPPING |
IWM4ECRE +TXT-FND | MACRO |
SYMRBLD +TXT-FND | ADSR |
--END-- | AGO .SRBAL ** SKIP PLS MACRO S |
| *%SRPLS1:; /* BAL/PLS HEADER |
| .SRBAL ANOP |
| * |
| */***************** Start of Specifications *********** |
| */* |
| */* Macro name: ADSR |
| */* |
| */* Descriptive Name: Symptom Record |
| */* |
| */* PROPRIETARY STATEMENT: |
| */* 5655-068 |
| */* THIS MODULE IS "RESTRICTED MATERIALS OF IBM" |
| */* (C) COPYRIGHT IBM CORP. 1980,1994 |
| */* LICENSED MATERIALS - PROPERTY OF IBM |
+---------------------------------------------------------+
File Display Library Settings Menu Utilities Test Help Exit
-------------------------------------------------------------------------------
-DSC--BROWSE L1---- SYS1.MACLIB ----------------------------ROW 00001 OF 00005
COMMAND ===> SCROLL ===> CSR
HOTBAR?
*EXCLUDE*SORT*SHOW* 2000 HIDDEN* ON VOLUME: IPLC23
NAME PROMPT LIB VV.MM CHANGED SIZE INIT MOD USERID
ADSR +TXT-FND Found: Descriptive Name: Symptom Record
ERBSTGST +TXT-FND Found: *'/* WB: ABEND 0C4, corrects number of DDBs
IARST64 +TXT-FND Found: abend with an 0C4, but if the
IWM4ECRE +TXT-FND Found: result in a ABEND 0C4 * 00111200
SYMRBLD +TXT-FND Found: DESCRIPTIVE NAME: Symptom Record Build
--END--