Browse panel

You use the Browse panel to display a selected data set or data set member, scroll through the records and find specific information within the records.

The Browse panel displays different fields in the header area, depending upon the type of data set shown and whether or not a template has been used.

Panel and field definitions

Figure 1. Browse panel showing text file
  Process   Options   Help
 ───────────────────────────────────────────────────────────────────────────────
 Browse           HFM.V1R1M0.SHFMSAM1(HFMCDATA)                 Rec 0 of 40
                                                    Record 0        Format TABL
 REC-TYPE REC-ID NAME                 EMPLOYEE-NO     AGE   SALARY    MONTH(1)
 #2       #3 R # #4                            #5      #6       #7          #8
 AN 1:2   AN 1:2 AN 3:20                  BI 23:2 BI 25:2  PD 27:4     BI 31:4
 <>       <>     <---+----1----+---->      <---+>  <---+> <---+--> <---+----1>
 ****  Top of data  ****
 01       01     Grant Smith                 7712      35    75000           6
 01       01     Andrew Apple                6645      53    78500          30
 01       01     Graham Prestcott            5583      28    48000           7
 01       01     Bill Somers                 4418      33    68000           5
 01       01     Ted Dexter                  3327      52    60250          14
 01       01     Roddy Armstrong             5683      34    77000          28
 01       01     Cliff Roberts               2265      57   100000          44
 01       01     James Browne                1117      46   125000          47
 01       01     Silvia Carrot               2308      29    61400           1
 01       01     Dan Peters                  4479      54    63000          38
 01       01     John Laws                   3422      21    46750          14
 01       01     Liz Childs                  3439      55    66000          44
 Command ===> _____________________________________________________ Scroll PAGE
  F1=Help      F2=Zoom      F3=Exit      F4=CRetriev  F5=RFind     F7=Up
  F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel
Title
The Title identifies the function (Browse) and the data set being used. For a PDS or PDSE member the data set name includes the member name. Record number information, or short messages, appear to the right.
Record
The Record field shows the record number of the record that is currently at the top of the data area. You can scroll to a specific record by entering a new value in this field.
Note: The number shown is that of the record within the entire data set, regardless of any restrictions, such as selection criteria, that you may have used to limit the display of records.
The default value for this field is 0, which positions the display before the first record. When the field contains 0, the data area displays the
****  Top of data  ****
message. Once you have scrolled away from this position, you cannot return to it by typing 0 in the Record field. Instead you need to enter a scrolling command, such as TOP, to return to 0.
Col
The Col field shows the column number of the column that is currently at the far left of the data area. You can scroll to a specific column (left or right) by typing a new value. The default value for this field is 1.
Scale
The Scale shows the columns of the data area.
Data Area
The Data Area shows the data in the selected display format. For a description of the different display formats, see Selecting a display format.
Command
The Command line is a field in which you can enter Primary Commands, such as FIND.
Scroll
The Scroll field defines the current scroll amount. You can type a new value.

When a VSAM data set is displayed, additional fields can be seen.

Figure 2. Browse panel showing VSAM data set
Browse           HFM.REQ77.RRDS                                       Rec 0
                          Type RRDS Slot            RBA            Format CHAR
       Col 1         
RBA         Len    ----+----1----+----2----+----3----+----4----+----5----+----
80           80    01Tyrone Dallas       .0...-................................
Type
The type of VSAM data set, for example, RRDS. IAM files are also indicated.
Slot
The slot number of the currently selected RRDS file. You can type a new value in this field to move to a new file.
RBA
The Relative Byte Address of the currently selected RRDS file.
Column Headings
The Scale shows the column headings for the RBA (Relative Byte Address) and Len (Record Length) of each RRDS file in the data set.

When the VSAM data set is a KSDS file, the Key field can be used to position yourself within the data set.

Figure 3. VSAM KSDS data set
 Browse           HFM.REQ77.KSDS                                       At top
        Type KSDS     Key                            RBA            Format CHAR
        Col 1         
 RBA         Len    <===+====1====+====2====+====3====+====4====+====5====+====
 ****  Top of data  ****
 0            64    00000010AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAb
 64           64    00000020AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA          
Key
If the value you enter contains leading, embedded or trailing blanks, commas or quotation marks, it must be enclosed in quotation marks. You may also enter a hexadecimal string enclosed in quotation marks and preceded by X or x, for example, X'C1C2'. The maximum number of characters, including any required characters, is 250.

When your cursor is in this field, you can use the LEFT/RIGHT commands to scroll within the field (function keys F10/F11). You can also use the EXPAND function (F4), to open the Key field in a window.

When a data set is displayed in TABL format with a template, the column headings show the field names defined in the template.

Figure 4. PDSE data set member in TABL format
Browse           HFM.V1R1M0.SHFMSAM1(HFMCDATA)                 Rec 0 of 40
                                                   Record 1        Format TABL
REC-TYPE NAME                 EMPLOYEE-NO     AGE   SALARY  MONTH(1)  MONTH(2)
#2       #3                            #4      #5       #6        #7        #7
AN 1:2   AN 3:20                  BI 23:2 BI 25:2  PD 27:4   BI 31:4   BI 35:4
<>       <---+----1----+---->      <---+>  <---+> <---+--> <---+---> <---+--->
01       Grant Smith                 7712      96    75000         6        15 

When a data set is displayed in SNGL format with a template, the field and record number of the current record is shown.

Figure 5. PDSE data set in SNGL format
Browse           HFM.V1R1M0.SHFMSAM1(HFMCDATA)                Rec 21 of 40
Current type is REC-TYPE02                                         Format SNGL
                                  Top Line is 1    of 7     in Record 21
Ref Field    Picture Typ Start   Len   Data
  2 REC-TYPE
             XX      AN      1     2   02
  3 NAME     X(20)   AN      3    20   Grant Smith
  5 ADDR1    X(20)   AN     37    20   22  Montrose St
  6 ADDR2    X(20)   AN     57    20   Thornlie
  7 POSTCODE
             X(4)    AN     77     4   6145
****  End of record  ****                                                      

Parent panels

Child panels

From the Browse panel, you can use primary commands to access the following panels:

Equivalent functions