Tape Record Scan (option 4.10)

Use Tape Record Scan to find specific data on a tape.

When you select Tape Record Scan, the Tape Record Scan panel shown in Figure 1 is displayed.
Figure 1. Tape Record Scan panel
 Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 Z Data Tools                   Tape Record Scan

 Tapes:  No tapes allocated


 Input:
    DDNAME to use . ________     enter new name, or select one from above
    Record format . U__          F,FB, V,VB,VS,VBS, D,DB,DS,DBS, or U
    Record length . _______      if deblocking desired, fixed format only

 Scan Options:
    Pattern scan  . NO_          YES or NO
    Scan position . 1____        byte position within record to start at
    Scan argument . _________________________________________________
    Number of hits  1_______     or ALL to list all scan hits in the file
    Records . . . . ALL_____     limit number of records to be scanned

 Command ===> _________________________________________________________________
 F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
 F9=Swap     F10=Actions  F12=Cancel
When using Tape Record Scan:
  • You identify the tape device (DDNAME to use)
  • You can specify a record format (Record format) and, if the records are fixed-length, the record length (Record length), to deblock the tape records while searching.
  • You can specify where in each record you want to search (Scan position). The default is to search for strings that start in column 1.
    • To search for strings that start in column n, enter NO in the Pattern scan entry field and enter n in the Scan position entry field.
    • To search for strings anywhere in the record, enter YES in the Pattern scan entry field.
    • To search for strings anywhere from column n to the end of the record, enter YES in the Pattern scan entry field and enter n in the Scan position entry field.
  • The string to search for has the same format as used by the FIND command in all functions, as well as for Disk Record Scan.
    • A character string not starting or ending with a quotation mark and not containing any embedded blanks or commas. The case of the string is ignored. Uppercase and lowercase representations of the same character match. For example, 'Mixed' matches 'MIXED'.
    • A character string enclosed in quotation marks. The string can contain blanks and commas. The case of the string is ignored. For example, 'Exact string' matches 'exact string'
    • C followed by a character string enclosed in quotation marks (C'Frog'), or a character string enclosed in quotation marks followed by C ('Frog'C). The string can contain blanks and commas. The string must match exactly (including case). For example, 'Exact string' does not match 'exact string'
    • X followed by a hexadecimal string enclosed in quotation marks. For example, X'C1C2'.
  • You can specify the number of occurrences of the string that should be found before the search stops. The default is to stop after the first occurrence.
  • You can specify the number of records to search through. The default is to scan to the end of the file.

Tape Record Scan stops after finding the specified number of occurrences of the string. The tape is positioned immediately after the record containing the last occurrence. If the string is not found, the tape stops after the next tape mark.

For further information, refer to the online help or TRS (Tape Record Scan).