Browse Entry panel

You use the Browse Entry panel to select a data set for viewing in the Browse panel.

Panel and field definitions

Figure 1. Browse Entry panel
  Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 File Manager                  Browse Entry Panel

 Input Partitioned, Sequential or VSAM Data Set, or HFS file:
    Data set/path name 'MACHIND.SEQ1M'                                 +
    Member . . . . . .              Blank or pattern for member list
    Volume serial  . .              If not cataloged
    Start position . .                                 +
    Record limit . . .              Record sampling   

 Copybook or Template:
    Data set name  . . 'FMN.TEMPLATE'                                
    Member . . . . . . TEST01       Blank or pattern for member list
 Processing Options:
  Copybook/template   Start position type   Enter "/" to select option
  3  1. Above            1. Key                Edit template    Type (1,2,S)
     2. Previous         2. RBA                Include only selected records
     3. None             3. Record number      Binary mode, reclen      
     4. Create dynamic   4. Formatted key

 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
  F9=Swap     F10=Left     F11=Right    F12=Cancel
Data set/path name
Can be a fully-qualified data set name or a pattern, an HFS file or directory, a WebSphere® MQ queue name, or a CICS® resource.

For information about specifying a WebSphere® MQ queue name, see Specifying an MQ manager or queue.

For information about specifying a CICS® resource, see Specifying a CICS resource.

The data set name may include a member name or name pattern in parenthesis. If the member is specified here, the associated Member field must be empty.

When you specify an HFS file or directory, you must enter a full path name. If the path name is longer than the displayed entry field, press the Expand function key (F4) to display a pop-up window in which you can enter a longer name.

Member
If you specified the name of a partitioned data set (PDS) without including a member name or name pattern in parenthesis in the Data set name field, then you can use this field to specify the member name or a member name pattern.
Volume serial
Serial number of the volume which contains the data set. Required for data sets which are not cataloged.
Start position
Initial starting position for the data set to be browsed. The initial display is positioned at the specified record.

The default is the top of the data set. You can enter a negative record to indicate the number of records before the end of file. For example, to see just the last record on the file, enter -1 as the start point.

The format of the start position field is either numeric or character, depending upon the type of start position selected. For VSAM KSDS Key values, 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.

Note: The Erase EOF key only works on the displayed part of the key. When the key being displayed is larger than the field area on the screen, you must either scroll or expand the field to erase the unseen portions.

For all other data set formats, a valid unsigned number must be entered.

To specify a starting position as the number of records before the end of file, enter a negative record number. For example, to see just the last record on the file, enter a start position of -1.

If you specify a starting position, you should also specify the Start position type in the Processing Options. If you do not, File Manager assumes that the value provided in the Starting position field is a record number.

VSAM - KSDS: Key value
If the key is not matched, the record with a key greater than the value given is specified. If the key value is greater than the last record in the data set, the initial position is the “End of data” marker.
VSAM - ESDS: RBA (Relative Byte Address) Value
If the RBA is not matched, the record with a RBA greater than the value given is specified. If the RBA value is greater than that of the last record in the data set, the initial position is the “End of data” marker.
VSAM - RRDS: Slot value
If the slot number is greater than the last used slot in the data set, the initial position is the “End of data” marker.
QSAM: Record Number
If the Record Number is greater than that of the last record in the data set, the initial position is the “End of data” marker.
HFS
As for QSAM.
Record limit
This field restricts the number of records retrieved from a data set (from the start point or top) resulting in an edit or browse of a portion of the data set. You can use the keyword MEMORY as a record limit to restrict the number of records retrieved to as many as will fit comfortably in the available virtual storage.

The default start position is the top of the data set.

Record Sampling
Indicates whether you want record sampling to be performed on the data set. If you select this option, File Manager displays the Record Sampling panel.
Copybook or Template
Data set name and Member name of the template or copybook to be used to format your data.
Note: In the case of a copybook, this can be the name of a CA-Panvalet library, or a library accessed using the Library Management System Exit.
Copybook/template usage
Indicates if you want to use a template for a logical view of the data.
1
Use the template specified on the panel (or compile the specified copybook into a template, and use that).
2
Use the last template associated with the data set.
3
No logical view is to be used by the function.
4
Create a dynamic template.
Start position type
Determines how File Manager interprets the value provided in the Starting position field. If the Start position type is not specified, File Manager assumes that the value is a Record Number.
1. KEY
Only valid when the data set is a VSAM KSDS, VSAM AIX® or VSAM PATH.
2. RBA
Only valid when the data set is a VSAM KSDS, VSAM AIX® or VSAM ESDS.
3. Record Number
Default. Valid for any type of supported data set.
4. Formatted key
Only valid when the data set is a VSAM KSDS, VSAM AIX®, or VSAM PATH and when a template is provided. This displays the formatted key positioning panel.
Note: For templates with more than one layout, a 01 selection list is displayed first.
Edit template
Indicates if you want to edit the template before use. You edit the template when you need to change format, selection, data create attributes, and reformatting information for output copy templates.

Specify one of the following values:

blank
Invoke the current function without editing the template.
/
Edit the specified template. F3 will return to the entry panel and clear this option.
A
Always edit the specified template. When the template edit session is completed, F3 will invoke the current function. F12 will cancel the template edit session and return to the entry panel.
R
Edit the template and use the RUNTEMP command (F6) to invoke the current function. Exiting the function will re-edit the template. From the template edit session:
  • Press F6 to rerun the function.
  • Press F3 to save changes and return to the entry panel.
  • Press F12 to discard changes and return to the entry panel.
Type (1,2,S)
The type of editing you want to perform.
You can specify one of the following values:
1
Edit the Record Identification Criteria by field first
2
Edit the Record Selection Criteria by field first
S
Edit the source definition for a template using the advanced copybook selection facility.

This option is ignored when editing a dynamic template.

Include only selected records
When the Edit or Browse session is either in-storage (a record limit of MEMORY is used, or omitted and set on by means of this option) or when you have selected Record Sampling, only the records selected by template processing are included in the Edit or Browse session.

This option does not alter the operation of edit or browse if a template is not used.

Binary mode
When processing an HFS file, allows you to specify binary mode (selected) or text mode (unselected).
reclen
When processing an HFS file and the Binary mode option is selected, records are derived based on the fixed record length specified. The default is 80.

Can be in the range: 1–32760

Use I/O exit
Allows you to specify a user I/O exit for compressed or encrypted data sets.

This option has two fields. To select the option, enter “/” in the field to the left of Use I/O exit. With this selected, you can then specify which exit to use in the field to the right of the field label.

Note:
  1. The fields only display if File Manager is installed with the option USEIOX=ENABLE, and the Exit enabled field (in the Set System Processing Options panel) is set to YES. If a default is specified with either of those options, it is displayed in the field to the right of Use I/O exit.
  2. I/O exits can only be used to process the data sets that you are using. They cannot be used to process the copybook or template that you are using to format the data set.

Parent panels

Child panels

Depending upon the options selected in the Browse Entry panel, the next panel displayed can be:

Equivalent functions

Related tasks and examples