View Entry panel

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

Panel and field definitions

Figure 1. View Entry panel
  Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 Z Data Tools                   View 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  . . 'HFM.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 viewed. 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, Z Data Tools 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 view 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, Z Data Tools 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 Z Data Tools interprets the value provided in the Starting position field. If the Start position type is not specified, Z Data Tools 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 dataset 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.
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 editor session is either in-storage (a record limit of "MEMORY" is used, or record limit is omitted and a record limit of "MEMORY" is implied by means of this option) or when you have selected Record Sampling, only the records selected by template processing are included in the editor session.

This option does not alter the operation of editing or viewing 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 Z Data Tools 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.

Child panels

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

Equivalent functions