Edit - Dataset Specification panel

The following figure allows you to select the mode to begin your edit session, and specify information about the edit, record layout, XREF, and selection criteria data sets.

Field Descriptions

Edit Mode

Select the edit mode for the initial display:

F

Formatted mode displays the data with the record layout (Assembler, COBOL or PL/I).

C

Character mode (full-screen) displays the data one record per line. (Does not use record layouts.)

V

Vertical formatted mode displays the data one record per line using the record layout fields as column headings.

U

Unformatted mode displays the data one record at a time without using a record layout.

Specify Edit Information:

Dataset name or zFS path

Specify the dataset or path name. Use the naming conventions described in Specifying a data set Name and Specifying a zFS Pathname.

You can enter a pattern dataset or path name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern dataset names for a complete description.

Specify the z/OS UNIX path. If the entered path is a complete path, then the file is processed directly for the Edit, Browse, Compare or Copy function. When a partial path is entered, File-AID displays the z/OS UNIX Directory List enabling you to continue the drill down process at the last directory level entered. For more information on specifying an z/OS UNIX path, see Specifying a zFS Pathname .

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. See Last Referenced File List.

Data File Dataset in File-AID-data-set-types describes the types of data sets that File-AID can edit.

Member name

Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

Volume serial

Specify the volume serial of the direct access device that contains the data set. This field is required only when the data set is uncataloged.

Disposition

Specify a disposition of SHR or OLD (see also Editing with DISP=SHR: a Warning).

SHR

Other users may access the data set.

OLD

(Default) Restricts other users from accessing the data set.

Create audit trail

Specify Y (Yes) or N (No). N is the default. When Y is specified, before and after images of changed, new, and deleted records are written to the audit trail dataset. See Audit Trail Feature for information on this feature.

I/O exit name (Optional)

If the I/O exit option has been installed, this input area is provided. For more information, see Installing or your system programmer. I/O exit install options are:

NO

I/O exit name field is not presented.

YES

I/O exit name field is presented blank for entry of a site written I/O exit program name.

exitname

I/O exit name field is presented prefilled with the name of a site-written I/O exit program.

Specify Record Layout and XREF Information:

Record layout usage

Specify one of the following values:

S

Single record layout. Valid for all Edit modes except unformatted.

X

XREF (record layout cross reference). Specify when more than one record layout is needed for a single data set. Not valid for Edit mode V.

N

None (default). No record layout. File-AID does not attempt to validate or process the record layout or XREF dataset. Valid for Edit mode C or U.

Record layout dataset

Specify the name of a data set that contains the Assembler, COBOL or PL/I record layout. This file is required when the Record layout usage field is S (single) or X (XREF).

You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern dataset names for a complete description.

Specifying a Concatenation List

To specify a concatenation list to be used in place of the Record Layout dataset, enter a plus sign followed by the member name (+membername) of the member containing the list. Enter this in the Record layout dataset field instead of the Record Layout dataset name. For example, if the member RLPROD contains the list to be used, enter +RLPROD instead of a Record Layout Dataset name. You specified the name of the concatenation list data set in Option 0.1, File-AID system parameters (see Concatenation List DSN). The concatenation list data set contains members known as concatenation lists. Each such list contains names of record layout datasets, each of which in turn contains record layout members.

The concatenation list is used in place of the single Record Layout dataset name. If the concatenated libraries contain duplicate member names, File-AID will always select the first occurrence of the member name.

Member name

Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

XREF dataset name

Specify the name of a data set that contains the record layout cross reference (XREF) members to use with multiple record type data sets. See Record Layout XREF Dataset.

You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.

Member name

Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

Specify Selection Criteria Information:

Refer to Selection-Criteria-function for a complete description of selection criteria.

Selection criteria usage

Specify one of the following valid entries:

E

Use existing selection criteria. Enter a dataset name in the Selection dataset name field.

T

Create temporary selection criteria. File-AID displays the Temporary Selection Criteria Menu. Temporary selection criteria is not automatically saved. To retain temporary selection criteria use the SAVE primary command on the Selection Criteria Menu screen.

M

Modify existing selection criteria. Enter a dataset name in the Selection dataset name field.

Q

Quick selection criteria. File-AID displays the Unformatted Selection Criteria screen for you to enter selection criteria. Quick selection criteria is not automatically saved. Use the SAVE primary command to retain quick selection criteria.

N

(Default) None -- Do not use selection criteria.

The following details outline the usage limitations and guidelines for implementing Selection Criteria:

• Selection Criteria is only available in Standard (31-bit Memory Mode) Edit. When Selection Criteria is used, File-AID reads only a portion of the data into memory. If the selected data is still larger than available memory, it results in an INSUFFICIENT MEMORY error (see also Storage Management).
• For VSAM LDS, Selection Criteria is only allowed in BROWSE; set Selection criteria usage to N or leave it blank to edit VSAM LINEAR data sets as Selection Criteria is not supported for editing VSAM LINEAR data sets.
• If you want to browse or edit a Version 2 PDSE generation member other than the current generation (0), set Selection criteria usage to N and blank out I/O exit name.

Selection Dataset Name

Specify the name of the data set containing existing selection criteria for options E and M.

You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern dataset names for a complete description.

Member name

Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

This section provides information about the following topic: