Primary commands summary

record-layout

Specifies the record layout used in formatting the new segment.

HERE

Specifies that the new segment is to be inserted prior to the currently displayed segment.

AFTER

Specifies that the new segment is to be inserted after the current segment.

ALIGN

Controls display of ALIGNED/UNALIGNED term for PL/I data.

ARRAY

Controls display of array declaration information for PL/I data.

ON

Displays an array definition line for each subscripted item in a record layout.

OFF

Does not display an array definition line.

Selection Criteria Functionality

ANY, EVERY and ALL are only available in Formatted Selection Criteria.

ALL

Displays all occurrences separately with the subscript(s) and any criteria entered on a specific occurrence will only be applied to that occurrence.

ANY

Displays a single entry for the occurrences and any criteria entered for the ANY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if any of the occurrences meet the specified criteria. ANY is applied for initial display of Selection Criteria.

EVERY

Displays a single entry for the occurrences and any criteria entered for the EVERY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if all of the occurrences meet the specified criteria.

AUTOSAVE

Controls whether a modified data set is saved when the user exits.

BACK

Scrolls display to the previous record in formatted mode. Scrolls the display up in character or vertical formatted mode.

scroll-number

Number of records to scroll back. Attempts to scroll before the first (selected) record are treated as a maximum scroll.

M (maximum)

Scrolls the display to the first (selected) record of the file.

BOUNDS

Restricts the scope of a command to a specified range of columns.

left-column, right-column

Specifies valid left and right column numbers separated by a blank that sets the left and right bounds (endpoints) of editing. Subsequent editing commands are restricted to the specified range of columns including both bounds.

CANCEL

Exits from current display mode and ignores all changes made to the data set since the last SAVE command.

CAPS

Controls handling of entered characters as upper or mixed (upper and lower) case.

CHANGE

Changes data that meets specified conditions. When you enter the CHANGE command without parameters, File-AID displays the CHANGE Command screen. The screen field names are shown in parentheses next to their corresponding parameter terms.

rel (Operator)

Relational operator that specifies the relationship the edit data must have to the val1 parameter in order to be changed. Valid entries for this parameter are:

EQ: Matches any string equal to val1 (default)

NE: Matches any string not equal to val1

LT: Matches any string less than val1

GT: Matches any string greater than val1

LE: Matches any string less than or equal to val1

GE: Matches any string greater than or equal to val1.

The rel parameter can be used with a val1 parameter (or a substitute asterisk), but not with the parameters VALID, INVALID, or ANY. When val1 is a character string, the comparison is executed according to the EBCDIC collating sequence.

val1 (From string)

Provides a value to be matched using the comparison specified by the rel parameter. When used with a /field-name or /field-number parameter, val1 is required to be compatible with the field declaration in the record layout.

File-AID does not perform any case conversion for DBCS (double byte character set) data.

The val1 parameter may be any one of the following data type strings:

* (asterisk)

Enter an asterisk (*) in place of the val1 parameter to reuse the last value specified in a CHANGE, EXCLUDE, or FIND command.

VALID, INVALID

Changes valid or invalid data in a specified field.

A /field-name or /field-number parameter is required when one of these values is used.

ANY

Changes any value in a range of columns by specifying col-1, and optionally, col-2. Also changes any value in a field by using a specific field name.

val2 (To string)

Specifies the new value to be substituted for data matching the condition specified by the rel and val1 parameters. Data item length described by val2 and val1 must be the same.

* (asterisk)

Value for the val2 parameter that specifies File-AID to reuse the last value entered in a CHANGE command.

lrange (Start range, End range)

Confines the CHANGE command to a specified line range (records). For the line range limits, use any combination of user-defined labels, system labels, or line numbers prefixed by a period.

If a single line label or line number is specified (or the same line is specified twice), File-AID limits the search to the specified line.

X, NX (Lines to search)

X restricts the CHANGE command to excluded lines; NX restricts the CHANGE command to non excluded lines.

NEXT, PREV, FIRST, LAST, ALL (Modifier)

Use the NEXT, PREV, FIRST, or LAST values to specify the starting point and search direction.

Use the ALL parameter to process all lines (selected by rel and val1) that contain the specified data (within the lines defined by the lrange, X, and NX parameters).

col1, col2 (Start column, End column)

Specifies a valid single column (col1) or column range (col1 and col2). File-AID defaults to the current bounds settings if col1 and col2 are not specified. Specify a single column or column range to override the default column range. Data specified for a single column must begin at the col1 position. Data specified for a column range must be found within the specified range.

Specify the col1 and col2 parameters as integers. If the val1 or val2 parameters consist of the numbers 0 (zero) through 9, delimit the value of the val1 and/or val2 parameter to distinguish it from column numbers. Do not use col1 or col2 when the /field-name or /field-number parameter is used.

/field-name, /field-number (Field name, Field number)

The /field-name parameter specifies the data name given to the field in the record layout. The /field-number parameter specifies the number generated by File-AID for each data name in the record layout. If a name was specified in the record layout dataset or XREF dataset name fields on the Edit - Dataset Specification screen, you can use a /field-name or /field-number parameter to confine the search to a specific data field.

CHANGE (CHG or C)

Displays the Data Replace Criteria panel. Only valid on the Global Selection Criteria panel.

CHAR

Invokes character mode from formatted, vertical formatted, and unformatted modes of Browse and Edit.

COLS

Displays COLS information line to view column numbers.

COMPILE

Displays the Record Layout Specification screen which allows you to reload or switch a record layout or XREF.

COMPLEX

Controls display of COMPLEX term for PL/I data.

COPY

Inserts records from another file at a specified location.

dataset, member

Specifies the entire data set or a member to be copied.

If you omit the dataset parameter, the Edit COPY screen is displayed.

AFTER line-label, BEFORE line-label

Designates the destination. The line-label parameter must be specified as a sequence number (prefixed by a period), a system label (such as .ZFIRST, .ZLAST, or .ZCSR), or a user-defined label.

The A (after), B (before), H (here), or O (overlay) line commands can be used as an alternative to a label to specify the destination. You can specify multiple A (after), B (before), and H (here) line commands. If you do not specify a destination, File-AID displays the message: COPY IS PENDING.

CREATE

Creates a new member of a PDS. Specify source records with the C or M line command.

dataset(member)

To create a new member in a different PDS, specify the data set name followed by the member name enclosed in parentheses.

(member)

Specifies the name of a new member to be created in the same PDS as the member currently being edited.

CUT

Creates a temporary copy of a file (or portion of a file) that you are editing with File-AID/MVS Edit. Use the C or CC (copy) line command to specify the source of the 'cut'.

APPEND (A)

Use the A or APPEND parameter to add to the existing cut file.

DELETE

Deletes records or lines from the data set.

lrange

Optionally confines the scope of the DELETE command to the specified line range. A line range may be specified with one or two line labels. Use user-defined line labels, system-defined labels (.ZFIRST, .ZLAST, or .ZCSR), or line numbers in any combination preceded by a period (.).

ALL X

Causes all excluded lines within the specified line range to be deleted.

ALL NX

Causes all non excluded lines within the specified line range (or the entire data set) to be deleted.

DISPLAY

Specifies fields for display or a display format.

Field Selection Syntax:

ON, OFF, ONLY

Controls the display of specified fields as follows:

ON: Displays fields specified by the field-list parameter along with the fields that are already displayed.

OFF: Prohibits display of fields specified by the field-list parameter.

ONLY: Displays only the specified fields.

When formatted or vertical formatted modes are invoked, File-AID displays all fields defined in the record layout. To eliminate fields from the display, enter either DISPLAY OFF or DISPLAY ONLY.

field-list

Specifies any combination of field numbers and/or field number ranges. Field numbers are separated by either blanks or commas.

Field number ranges are specified by two field numbers separated by a dash (-), and represent the two range bounds and all intervening fields.

ALL

Selects every field in the record. Enter DISPLAY ALL to display all fields. Enter DISPLAY OFF ALL to eliminate all fields from the display. The ALL parameter is mutually exclusive with the field-list parameter.

Data Format Specification Syntax:

format

Specifies the format of the data to be displayed. Valid values, results, and any field size limitations are listed below. Abbreviations of the values are shown in parentheses.

BINARY or (BIN): Causes File-AID to interpret the data field as a binary number and display the integer (base 10) value of the binary number. Limited to 1, 2, 3, 4, or 8 bytes.

BIT: Displays the actual bit pattern.

CHAR or DISPLAY (AN, DISP): Displays data as alphanumeric characters. Invalid characters are displayed in hexadecimal format.

DECIMAL (DEC): Interprets data as packed decimal data. Limited to 1-16 bytes.

FLOAT: Interprets the data field as a decimal floating point number. Limited to 4, 8, or 16 bytes.

GRAPHIC: Displays data as DBCS characters. Invalid characters are displayed in hexadecimal format.

HEX (X): Displays data in hexadecimal format.

NATIONAL or UT16: Interprets data as Unicode UTF-16 and converts it to EBCDIC via IBM conversion services with the terminal CCSID. When conversion fails, original data are displayed in hexadecimal format. Limited to even bytes.

For any format value other than BIT, data items must be aligned on a byte boundary. If the format value is incompatible with any of the listed fields, any incompatible fields retain their prior formats.

The format parameter is mutually exclusive with the RESET parameter.

RESET (RES)

Restores the display of each listed field to the format specified by the record layout. The RESET parameter is mutually exclusive with the format parameter.

field-list

Specifies any combination of field numbers and/or field number ranges. Field numbers are separated by either blanks or commas.

Field number ranges are specified by two field numbers separated by a dash (-), and represent the two range bounds and all intervening fields.

ALL

Selects every field in the current layout. Enter DISPLAY format ALL to set the format of all fields to the specified format.

DISPLAY MAXREFER (DIS MAXREFER)

The DISPLAY MAXREFER command is used with a PL/1 layout that has a REFER clause. It allows you to specify the number of occurrences to display in the layout.

The command is available in the Formatted Selection Criteria screen.

field-number of object

Specifies the object of a PL/1 REFER clause.

#- of OCCURS

Specifies the number of occurrences to be displayed.

DISPLAY REDEF

Selects COBOL redefinition of a data item for display.

field-number

Specifies the COBOL data item redefinition to be displayed. Usually refers to a field that contains a REDEFINES clause, or is redefined by another field.

DOWN

Scrolls the display down. Default is the value in the SCROLL field. Scroll values include CSR, DATA, HALF, and PAGE.

scroll-number

Specifies the number of lines or fields to scroll down.

M

Scrolls down the maximum amount. The effect of this parameter varies by mode:

• 
  
  • Character and Vertical Formatted: Scrolls down to show the last lines of the data set.
  • Formatted: Scrolls down to display the last fields of the record layout.

END

Exits the current browse, edit, or selection criteria session.

EXCLUDE

Removes from display items that meet specified conditions. When you enter the EXCLUDE command without parameters, File-AID displays the EXCLUDE Command screen. The screen field names are shown in parentheses next to their corresponding parameter terms.

rel (Operator)

Relational operator that specifies the relationship the edit data must have to the val1 parameter in order to qualify a line for exclusion. Valid entries for this parameter are:

EQ: Matches any string equal to val1 (default)

NE: Matches any string not equal to val1

LT: Matches any string less than val1

GT: Matches any string greater than val1

LE: Matches any string less than or equal to val1

GE: Matches any string greater than or equal to val1.

The rel parameter may be used with a val1 parameter (or a substitute asterisk), but not with the parameters VALID and INVALID. When val1 is a character string, the comparison is executed according to the EBCDIC collating sequence.

val1 (Find string)

Provides a value to be matched using the comparison specified by the rel parameter. When used with a /field-name or /field-number parameter, val1 is required to be compatible with the field declaration in the record layout.

File-AID does not perform any case conversion for DBCS (double byte character set) data.

The val1 parameter may be any one of the following data type strings:

* (asterisk)

Value for the val1 parameter that specifies to reuse the last value specified in a CHANGE, EXCLUDE, or FIND command.

VALID, INVALID

Excludes valid or invalid data in a specified field. A /field-name or /field-number parameter is required when VALID or INVALID is used.

lrange (Start range, End range)

Confines the EXCLUDE command to a specified line range (records). For the line range limits, use any combination of user-defined labels, system labels, or valid line numbers, prefixed by a period.

If a single line label or line number is specified (or the same line is specified twice), File-AID limits the search to the specified line.

X, NX (Lines to search)

X restricts the EXCLUDE command to excluded lines. NX restricts the EXCLUDE command to non excluded lines.

NEXT, PREV, FIRST, LAST, ALL (Modifier)

Use the NEXT, PREV, FIRST, or LAST values to specify the starting point and search direction.

Use the ALL parameter to exclude all lines that contain the specified data (within the lines defined by the lrange and X, NX parameters).

col1, col2 (Start column, End column)

Specifies a valid single column (col1) or column range (col1 and col2). File-AID defaults to the current bounds settings if col1 and col2 are not specified.

Specify a single column or column range to override the default column range. Data specified for a single column must begin at the col1 position. Data specified for a column range must be found within the specified range.

Specify the col1 and col2 parameters as integers. If the val1 parameter consists of the numbers 0 (zero) through 9, delimit the value of the val1 parameter to distinguish it from the column values.

/field-name, /field-number (Field name, Field number)

The /field-name parameter specifies the data name given to the field in the record layout. The /field-number parameter specifies the number generated by File-AID for each data name in the record layout. If a name was specified in the record layout dataset or XREF dataset name fields on the Edit - Dataset Specification screen, you can use a /field-name or /field-number parameter to confine the search to a specific data field.

If a record layout was not entered on the Edit screen, attempting to specify a /field-name or /field-number produces the message: FIELD UNDEFINED - NO LAYOUT.

FBROWSE

Recursively invokes the File-AID Browse function.

dataset name

Qualified (quoted) or unqualified (no quotes) data set name to pass to the Browse screen. If no data set name is specified, the last data set referenced in File-AID is used as a default.

FEDIT

Recursively invokes the File-AID Edit function.

dataset name

Qualified (quoted) or unqualified (no quotes) data set name to pass to the Edit - Dataset Specification screen. If a data set name is not specified, File-AID uses the last data set referenced.

FILLER

Controls display of FILLER fields.

FIND

Searches for and displays items that meet specified conditions. When you enter the FIND command without parameters, File-AID displays the FIND Command screen. The screen field names are shown in parentheses next to their corresponding parameter terms.

rel (Operator)

Relational operator that specifies the relationship the data must have to the val1 parameter in order to be found. Valid entries for this parameter are:

EQ: Matches any string equal to val1 (default)

NE: Matches any string not equal to val1

LT: Matches any string less than val1

GT: Matches any string greater than val1

LE: Matches any string less than or equal to val1

GE: Matches any string greater than or equal to val1.

The rel parameter may be used with a val1 parameter (or a substitute asterisk), but not with the parameters VALID and INVALID. When val1 is a character string, the comparison is executed according to the EBCDIC collating sequence.

val1 (Find string)

Provides a value to be matched using the comparison specified by the rel parameter. When used with a /field-name or /field-number parameter, val1 is required to be compatible with the field declaration in the record layout.

File-AID does not perform any case conversion for DBCS (double byte character set) data.

The val1 parameter may be any one of the following data types:

* (asterisk)

Value for the val1 parameter that specifies File-AID to reuse the last value specified in a CHANGE, EXCLUDE, or FIND command.

VALID, INVALID

Searches for valid or invalid data in a specified field.

A /field-name or /field-number parameter is required when VALID or INVALID is used.

lrange (Start range, End range)

Confines the FIND command to a specified range of lines (records). For the line range limits, use any combination of user-defined labels, system labels, or line numbers, prefixed by a period.

If a single line label or line number is specified (or the same line is specified twice), the search is confined to the specified line.

X, NX (Lines to search)

X restricts the FIND command to excluded lines. NX restricts the FIND command to non excluded lines.

NEXT, PREV, FIRST, LAST, ALL (Modifier)

Use the NEXT, PREV, FIRST, or LAST values to specify the starting point and search direction.

The ALL value searches for all occurrences of the specified data (within the lines defined by the lrange, X, and NX parameters).

col1, col2 (Start column, End column)

Specifies a valid single column (col1) or column range (col1 and col2). File-AID defaults to the current bounds settings if col1 and col2 are not specified. To override the default, specify either a single column or column range. Data specified for a single column must begin at the col1 position. Data specified for a column range must be found within the specified range.

Specify the col1 and col2 parameters as integers. If the val1 parameter consists of the numbers 0 (zero) through 9, delimit the value of the val1 parameter to distinguish it from the column values. Do not use col1 or col2 when the /field-name or /field-number parameter is used.

/field-name, /field-number (Field name, Field number)

The /field-name parameter specifies the data name given to the field in the record layout. The /field-number parameter specifies the number generated by File-AID for each data name in the record layout. If a name was specified in the record layout dataset or XREF dataset name fields on the Edit - Dataset Specification screen, you can use a /field-name or /field-number parameter to confine the search to a specific data field.

FLIP

Reverses the exclude status of all the records in the file.

FMT

Invokes formatted mode from character, vertical formatted, and unformatted modes of Browse and Edit.

In Selection Criteria (Option 6), FMT displays the Formatted Selection Criteria screen.

FORWARD

Scrolls the display to the next record in formatted mode. Scrolls the display down in character or vertical formatted mode.

scroll-number

Number of records to scroll forward. Attempts to scroll past the last (selected) record are treated as a maximum scroll.

M (maximum)

Scrolls the display to the last (selected) record of the file.

FPRINT

Prints one or more records in formatted mode, presenting the data according to a COBOL or PL/I record layout. Use the DISPLAY primary command to tailor the current display of fields.

number

Specifies the number of records to print. The default is 1 (one). 0 (zero) prints the current and all subsequent records in the file.

ALL

Prints the current record and all subsequent records in the file.

GLOBAL (GBL)

Displays the GLOBAL Selection Criteria panel listing all defined variables. Only valid on the formatted Selection Criteria panel.

GO

The GO command switches your session into Browse (from Edit) or Edit (from Browse) while retaining your current record and cursor position. However, when using the GO command in a segmented record while positioned in a segment, the record will be re-positioned to the BASE.

BROWSE

Switches your session into Browse (from Edit).

EDIT

Switches your session into Edit (from Browse).

GROUP

Controls the display of occurrences of group-level items.

HEX

Changes data display to hexadecimal notation.

ON

Displays record data in hexadecimal notation in a three-line format. The three lines are followed by a separator line of dashes.

Line 1: Displays the data in standard character form. Valid Graphic DBCS data is displayed in DBCS form.

Lines 2 and 3: Displays the hexadecimal values of the data in Line 1, arranged vertically. Each of these lines is marked with the letter V in column 1. The high-order hexadecimal digit is displayed above the low-order hexadecimal digit.

OFF

Does not display record data in hexadecimal notation.

HIDE

Excludes fields or a range of fields from your display.

blank

If you specify the HIDE command without a parameter, File-AID displays the HIDE and HOLD Settings pop-up.

field-number

Specify the field number(s).

field-number-range

Specify the field number range(s). Reverse field range is supported.

ALL

Hides all fields and displays the HIDE and HOLD Settings pop-up.

HOLD

Specifies the ORDER of data items to HOLD on the screen while scrolling in Formatted and Vertical Format modes.

blank

If you specify the HOLD command without a parameter, File-AID displays the HIDE and HOLD Settings pop-up.

field-number

Specify the field number(s).

field-number-range

Specify the field number range(s). Reverse field range is supported.

INFO

Displays statistical information for a data set.

INIT

Initializes and displays all fields of the current record, according to the specified record layout. Each field is initialized to a null value appropriate to the field format.

record-layout

Specifies the record layout with which you want File-AID to initialize and display the current record.

Do not specify the record-layout parameter while a segmented record is being edited, unless the base (first) segment is being displayed. If the base segment is displayed, the record is initialized to contain a single segment of the specified type and any other segments are eliminated from the record.

Specifying the record-layout parameter while a segment other than the base segment is displayed produces the error message CANNOT USE NAME and prevents initialization.

INPUT / INSERT

Permits new formatted records to be created, edited, and added to a data set.

record-layout

Specifies a different record layout to use to format the new record. The specified layout must be included either as part of an XREF entry or as part of a record layout containing several 01 levels. If the specified record layout is not valid, the message LAYOUT NOT FOUND is produced. (Use the USE command to see the list of available record layouts.)

INPUT / INSERT (I) (Selection Criteria)

This command is available in the Selection Criteria function in Formatted and Unformatted mode. It inputs/inserts a new formatted selection criteria set or subset.

AND

Inserts an ANDed subset of selection criteria after (default) or before the current criteria set or subset.

After

Inserts a set or subset after (default) the current criteria set or subset.

Before

Inserts a set or subset before the current criteria set or subset.

INVALIDCHAR (INVCHAR or IVC)

Controls whether the character fields that include nondisplayable characters are displayed as ‘INVALID’ or not.

Valid in Browse and Edit in Vertical Formatted mode.

ON

Displays the character fields that include nondisplayable characters as ‘INVALID’.

OFF

Displays the displayable characters and replaces nondisplayable characters by ISPF attributes.

KEY

Scrolls to the record with the specified key (VSAM-KSDS only). If you omit the key-value, File-AID displays the Key Specification screen.

key value

Scrolls to the record with the specified key value. Use the following prefixes to distinguish the key value format:

X - Hex

C - Character (Case-sensitive)

F - Fullword (4 bytes).

H - Halfword (2 bytes).

NEXT

Retrieves the first record with a key greater than or equal to the key-value parameter.

LABEL

The LABEL . label command associates the specified label classification with the current record in Edit/Browse. The label is entered on the command line in the form:

LABEL . xxxxx (a period followed by five characters).

or

. xxxxx (a period followed by five characters).

The first character of a label must be a letter in the range A-Y. Labels starting with Z are reserved.

LEFT

Scrolls the display to the left in character and vertical formatted modes and to the previous record in formatted mode. In character and vertical formatted modes, the default is the value in the SCROLL field. Scroll values include CSR, DATA, HALF, and PAGE.

scroll-number

Specifies the number of characters to scroll to the left in character and vertical formatted modes, or the number of records to scroll back in formatted mode. Attempts to scroll left beyond column 1 or before the first (selected) record are treated as a maximum scroll.

M (maximum)

Scrolls the display to the first column of the file in character and vertical formatted modes, or to the first (selected) record of the file in formatted mode.

LEVEL

Sets the PDS modification level for a PDS member.

number

Specifies an integer between 1 and 99.

LISTALC

Displays the Current DDNAME Allocation List screen with a complete list of data sets allocated to you by File-AID.

ALL

Modifies the Current DDNAME Allocation List to include all data sets allocated to your user ID.

LOCATE

Displays a specified line, line type, or field.

Individual Line Syntax (Character and Vertical Formatted Modes):

line-label

Searches for a specific line label. If the line label is found, File-AID positions that line at the top of the display. The remainder of the screen is filled, depending on the current display mode. Valid entries are a user-defined label and the File-AID-defined labels SEQ, DUP, ERR, and NEW.

line-number

Searches for a specific line number. If found, File-AID positions that line at the top of the display. Specify the line number without a preceding period. Valid line-number entries may be as large as eight digits. Leading zeros are not required.

Entering a number that is larger than the largest line number causes File-AID to position the last record at the top of the display.

Line-Type Syntax (Character, Vertical Formatted, and Unformatted Modes):

NEXT, PREV, FIRST, LAST

Specifies the starting point and direction of a line search.

line-type

Searches for a specific type of line. If found, positions the line at the top of the display. This parameter is required.

Valid entries for line-type are: CHANGE (CHG), COMMAND (COM,CMD), DUPKEY (DUP), ERROR (ERR), EXCLUDED (X), LABEL (LAB), NEW, SEQERR (SEQ), and SPECIAL (SPE).

lrange

Confines the search to a specified range of lines (records). For the line range limits, use any combination of user-defined labels, system labels, or valid line numbers, prefixed by a period.

Field Syntax (Formatted and Vertical Formatted Mode):

field-name, field-number

Searches for the specified field name or a field number. If found, File-AID positions the field to the top of the display.

* (asterisk)

Used in place of the field-name or field-number parameter to reuse the field name or field number supplied from the previous LOCATE command.

NEXT, PREV, FIRST, LAST

Specifies the starting point and direction of a field search.

LR

Scrolls forward or backward to a specified record number, label, or any record with a label classification.

record-number

Specifies the record to which you want to scroll. You can enter a record number of up to 10 digits. If you enter a value that exceeds the number of records in the file, File-AID displays the last record in the file.

label

Specifies the label to which you want to scroll. In character and vertical formatted modes, assign a label by scrolling to any line and entering a label in the sequence number field. In formatted mode, assign a label by entering the label on the command line. The label is a period followed by up to five characters.

LABEL (LAB)

Locates an occurrence of a record having a user-specified label.

NEXT, PREV, FIRST, LAST

Use the NEXT, PREV, FIRST, or LAST values to locate the next, previous, first, or last occurrence of a labeled record.

MAP

Changes the display to formatted mode.

MERGE

Imports records from another data set and inserts them in the correct key order.

dataset

Specifies the name of the data set to use as a source of new records.

Entering the MERGE command while editing a nonkeyed data set produces the message COMMAND NOT SUPPORTED. The command is ignored.

MESSAGE

Controls the display of the mode prompt message line available at the bottom of the browse and edit screens.

NEXT

Relocates the display to the segment after the currently displayed segment in the same record.

n

Specifies the number of segments to advance the display. The default for the n parameter is 1 (advance one segment).

record-layout

Specifies that a segment matching the XREF criteria for the specified record layout is to be displayed. If the specified record layout does not match the name of a currently loaded record layout, the message RECORD LAYOUT NOT FOUND is displayed.

OCCURS

Controls the display of array declaration lines.

ON

Displays an array definition line for each subscripted item in a record layout.

OFF

Does not display an array definition line.

Selection Criteria Functionality

ANY, EVERY and ALL are only available in Formatted Selection Criteria.

ALL

Displays all occurrences separately with the subscript(s) and any criteria entered on a specific occurrence will only be applied to that occurrence.

ANY

Displays a single entry for the occurrences and any criteria entered for the ANY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if any of the occurrences meet the specified criteria. ANY is applied for initial display of Selection Criteria.

EVERY

Displays a single entry for the occurrences and any criteria entered for the EVERY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if all of the occurrences meet the specified criteria.

OFFSET

Use the SHOW OFFSET command to display the field offsets. Then use the OFFSET primary command to set the format for the display of field offset information.

COLUMNS (COL, C)

Lists the column in which each data field begins, starting in record column 1. Changes the field description heading to COLUMNS. The offset of the first field is displayed as 1, and the offsets of all fields that follow are also greater by 1 than the offsets displayed when the OFFSET option is set to REL(HEX).

HEX (H, X)

Displays the offset of each field from the beginning of the record in hexadecimal form. Changes the field description heading to REL(HEX).

RELATIVE (REL, R)

Displays the offset of each field from the beginning of the record. Changes the field description heading to RELATIVE. The offset of the first field is zero.

OPT

In Selection Criteria (Option 6), displays the Selection Criteria Options screen.

OVERLAY

Displays, sets, or modifies an overlay mask.

CLEAR (C)

Resets the overlay mask to all blanks.

col1 col2

Specifies a column range.

PAD

Changes the value of the pad character.

char

Specifies a new value for the pad character. If the new value is a blank or a comma, it must be enclosed in apostrophes (').

X'nn'

Sets the pad character to a nondisplayable value, where nn is two hexadecimal digits enclosed in apostrophes (').

PAIR

The PAIR command scrolls the top and bottom portions of the panel to the same associated field. Type PAIR in the COMMAND line and position the cursor on the associated field you want to locate, then press ENTER. Both the top and bottom portions of the panel position to the field where the cursor is positioned. The command is only available in the “Compare - Associate Field Names” panel in Formatted Compare mode.

PASTE

Copies the “CUT file” sequentially into the current File-AID Edit file. Specify the destination with the A (after), B (before), or H (here) line command or the AFTER <label> or BEFORE <label> parameter. When the Edit file is empty, you do not need to enter the destination.

AFTER/BEFORE label

Paste the cut file after or before a specific user-defined line label (.label).

PICTURE

Controls the display of the PICTURE or DISPLAY line for numeric data.

PRESERVE

ON (default) maintains trailing blanks (spaces) in variable length records. Valid only for Edit and Copy functions being performed on variable length records.

PREV

Displays the previous fixed-length segment in the current record.

PROFILE

Displays profile information lines. Use the RESET primary command to delete the profile information lines from the display.

line-count

Specifies the number of information lines to be displayed.

PROTECT

Sets the protection of key fields for the currently displayed segment or record to prevent the fields from being modified.

RBA

Locates a relative byte/block address (RBA) value in Browse and Edit functions for ESDS files. It positions the display to a specific record within a VSAM-ESDS file based on the record's RBA.

RCHANGE

Repeats execution of the previous CHANGE command.

REBUILD

Discards changes made in the current formatted record without exiting the edit session.

RECORD (REC)

Closes the Global Selection Criteria panel and returns to the Formatted Selection Criteria panel. Only valid on the Global Selection Criteria panel.

REDEFINES

Controls the display of data item redefinitions.

REFLNG

Controls the display of BIT/CHAR VARYING field length reference lines for PL/I data.

REMOVE

Deletes the currently displayed segment from the record.

REPEAT

Inserts one or more copies of a record immediately after the record.

n

Specifies the number of copies of the displayed record to insert immediately after the current record. This parameter is valid only in Formatted Edit.

REPEAT (Selection Criteria)

This command is available in the Selection Criteria function in Formatted and Unformatted mode.

The REPEAT command inserts a copy of the current selection criteria set after the current criteria. REPEAT by itself copies a whole set, including any subsets. REPEAT AND copies only the current subset.

AND

Inserts a copy of the current set or subset of selection criteria after the current set or subset as an ANDed subset. The criteria set number is NOT incremented but the subset number is (AND SET 3.3 of 4).

REPLACE

Overwrites the contents of an existing data set.

dataset

Specifies the name of the data set to which records are to be written.

dataset(member)

Specifies the PDS data set and member name to which records are to be written.

(member)

To overwrite a member in the same PDS as the member being edited, specify the member name enclosed in parentheses.

RESET

In character and vertical formatted edit, cancels information displays; displays excluded lines; removes line types from display. In character browse, RESET removes the COLS information line. In formatted mode, cancels profile information.

lrange

Confines the RESET command to a specified range of lines (records). The line range may be specified using one or two line labels or line numbers. For the line range limits, use any combination of user-defined labels, system labels, or line numbers (prefixed by a period).

line-type

Specifies types of information flags to be eliminated from the display. Omitting the line-type parameter is equivalent to specifying all line types except LABEL. Valid line-type values are: CHANGE, COMMAND, ERROR, EXCLUDED, HIDE, HOLD, LABEL, NEW, and SPECIAL.

RETURN

Returns to the Primary Option Menu.

RFIND

Repeats execution of the previous FIND command.

RIGHT

Scrolls the display to the right in character and vertical formatted modes, and to the next record in formatted mode. In character and vertical formatted modes, the default is the value in the SCROLL field. Scroll values include CSR, DATA, HALF, and PAGE.

scroll-number

Specifies the number of characters to scroll to the right in character and vertical formatted modes, or the number of records to scroll forward in formatted mode.

M (maximum)

Scrolls the display to the right-most character in character and vertical formatted modes, or to the last (selected) record of the file in formatted mode.

RLOC

Repeats execution of the previous LOCATE command.

SAVE

Writes the edit buffer to the data set being edited.

SAMEGEN

Only valid in V2 PDSE members. It causes the edit buffer to be written to the generation selected; no other generations are affected.

SELECT (SEL)

Closes the Data Replace Criteria panel and returns to the Global Selection Criteria panel. Only valid on the Data Replace Criteria panel.

SETUNDO

Enables/disables the use of the UNDO command (change recording). Initial setting is on.

SHOW

Displays LEVEL, NUMBER, FORMAT, OFFSET, or PICTURE information for a record.

Field Name Syntax (Formatted Mode only):

LEVEL (L)

Displays the record’s hierarchical level number at the left of each data item name, and changes the heading of the Field Name area to FIELD LEVEL/NAME. File-AID indents each successive level two character positions to emphasize the record structure. When this parameter is used, the Field Name area closely resembles the original (source) record layout declaration.

NUMBER (N)

Displays the field numbers assigned by File-AID, and changes the heading of the Field Name area to FIELD NUMBER/NAME. Field numbers are assigned sequentially, beginning at the top of the record layout. Each elementary or group data item name is assigned a unique field number. Each occurrence of a data item that has multiple occurrences is assigned the same field number, since all occurrences share the same data name.

Field Description Syntax (Formatted and Vertical Formatted Modes):

FORMAT (F)

Displays field length and current field format, separated by a slash (/), and changes the heading of the Field Description area to FORMAT. The field length is expressed in bytes.

OFFSET (O)

Displays the offset of each field from the beginning of the record. The offset can be expressed in three ways: relative, hexadecimal, or columns. Specify the offset format with the OFFSET command.

PICTURE (P)

Displays a representation of the original data declaration for each elementary item, and changes the heading of the Field Description area to PICTURE.

Line/Record Number Syntax (ESDS files in Update-In-Place Edit of 64-bit memory mode only):

There is no difference between the operands LINE and RECORD. SHOW LINE works in FMT mode, SHOW RECORD works in CHAR mode.

LINE (LN)

Displays the LINE number in Character (CHAR) and Vertical Formatted (VFMT) modes. ON is default, applied when ON/OFF is omitted.

RECORD (R)

Displays the RECORD number in Formatted (FMT) and Unformatted (UNFMT) modes. ON is default, applied when ON/OFF is omitted.

SORT

Sorts specified records based on the contents of sort fields.

lrange

Confines the sorting operation to a specified line range (records). The line range is specified with two line labels. Use any combination of user-defined labels, system labels, or line numbers (prefixed by a period).

X, NX

Confines the scope of the SORT command to excluded (X) or non excluded (NX) lines. If the lrange parameter is also specified, only excluded or non excluded lines within the specified line range are sorted.

Lines are excluded using the EXCLUDE primary command or the X (exclude) line command. Excluding lines divides the edit data set into two subsets, either of which may be processed separately by the SORT command.

sort-field

Specifies from one to five sort fields. If no sort-field parameters are specified, the data within the edit bounds is used and the data is sorted in ascending sequence.

KEY: Used as one of the five sort fields when editing a keyed data set, RRDS or BDAM data set. Specifying KEY is equivalent to specifying the two-column numbers delimiting the record key. The letters A or D may not be used to define the sorting sequence with KEY because the sort is always in ascending sequence. RRDS and BDAM records are sorted in RRN (or RBN for BDAM) order.

If other sort-field parameters are specified along with KEY, they cannot overlap the key field. The remaining sort-field parameters may also be modified by the A or D parameters.

col1, col2: Specifies column numbers for each sort-field parameter. The two column numbers must be listed together; the second column number of each pair must be greater than or equal to the first column number.

If a specified sort field extends beyond the end of a variable-length record, that record is sorted as if the columns beyond the end of the record contained null characters (hex 00). If multiple sort-field parameters are specified, they must not overlap.

/field-name, /field-number: The /field-name parameter specifies the data name given to the field in the record layout. The /field-number parameter specifies the number generated by File-AID for each data name in the record layout.

A (default), D: Specifies ascending (A) or descending (D) order for the sort-field parameter. If an A or D parameter is specified with any sort-field parameter, all other sort-field parameters must be accompanied by one of the two letters. List the A or D before or after the corresponding column pair, not between col1 and col2.

STATS

Controls the generation of statistics when a PDS is edited.

SUBMIT

Submits the file you are browsing or editing as a batch job for background processing. SUBMIT is valid in Character mode only.

SYNC

Controls the display of the SYNC term for fields in a COBOL record layout.

TOP

Displays the base segment of the current record.

UNDO

Restores the data set to its condition prior to the last accepted change entry. Valid in the Edit function in all modes and the Field-to-Field Selection Criteria screen.

UNFMT

Invokes unformatted mode from character, formatted, and vertical formatted modes of Browse and Edit.

In Selection Criteria (Option 6), displays the Unformatted Selection Criteria screen.

UP

Scrolls the display up. Default is the value in the SCROLL field. Scroll values include CSR, DATA, HALF, and PAGE.

scroll-number

Number of lines to scroll up.

M

Scrolls up the maximum amount. The effect of this parameter varies by mode:

• 
  
  • Character and Vertical Formatted: Scrolls up to display the first (selected) record in the file.
  • Formatted: Scrolls up to display the first line of the current layout at the top of the screen.

USE

Formats a record or specifies another record layout for the current record.

offset

Specifies either a column (absolute) offset from the beginning of the record, or an offset relative to the currently displayed position in the record. You must preface a relative offset number with a plus or minus sign (+ or -). If you do not specify an offset, the position of the currently displayed record is used.

NEXT

Directs File-AID to use the offset of the position immediately after the current segment, that is, the end of the currently selected record layout.

PREV

Specifies that File-AID is to display the previous segment. Using this parameter is subject to the same restrictions as those for the PREV command.

record-layout

Specifies a currently loaded record layout. When an XREF is in use, only the 01 levels directly referenced may be specified. Any unique abbreviation of the record layout name can be specified.

* (asterisk)

Enter an asterisk (*) in place of the record-layout parameter to retain the currently selected record layout.

VERSION

Sets the PDS version number for a PDS member.

number

Specifies the PDS version number when a PDS member is edited.

VFMT

Invokes vertical formatted mode from character, formatted, and unformatted modes of Browse and Edit.

VIEW

In the Selection Criteria function (Option 6), VIEW displays a screen summarizing the specified options and all the sets of formatted and unformatted selection criteria in a scrollable display. In the XREF function (Option 7), VIEW is valid on the Define XREF screen and displays the entire XREF in a scrollable display.

In Option 3.5 (VSAM utility), the VIEW command displays IDCAMS messages generated by the IDCAMS utility.

VPRINT

Prints one or more records in vertical formatted mode, presenting the data according to a COBOL or PL/I record layout. Use the DISPLAY primary command or the FIELDS parameter to tailor the current display of fields.

TRUNC

It TRUNC processes the VPRINT request online and truncates each print line if the vertically formatted record exceeds the print width. The default is set in Option 0.3 with the “Truncate for VPRINT cmd” parameter. This is the standard form that has been part of the product prior to Release 9.0. Unless you have pre-allocated a print data set VPRINT TRUNC continues with the “Print Parameters Screen” Screen where you specify more output options.

NOTRUNC

It NOTRUNC processes the VPRINT request in batch and prints multiple pages if the vertically formatted record exceeds the print width. The default is set in Option 0.3 with the “Truncate for VPRINT cmd” parameter. VPRINT NOTRUNC continues with the “Vertical Format Print (VPRINT) JCL Specification” Screen where you specify more output options.

number

Specifies the number of records to print. The default is 0 or ALL. 0 (zero) prints the current and all subsequent records in the file.

ALL

Prints the current record and all subsequent records in the file.

number

For VPRINT TRUNC, specifies the number of records to print. The default is 0 or ALL. 0 (zero) prints the current and all subsequent records in the file.

For VPRINT NOTRUNC, specifies the number of records to print, starting with the first record in the file. The default is 0 or ALL. 0 (zero) prints the first and all subsequent records in the file.

ALL

For VPRINT TRUNC, prints the current record and all subsequent records in the file. Prior records are not printed.

For VPRINT NOTRUNC, prints all records in the file.

FIELDS field-list

Specifies any combination of field numbers and/or field number range. Separate each field number specification by a space or a comma. Specify a range with a hyphen between the starting and ending field numbers. You may specify up to nine field number specifications or 60 characters.

XMLGEN

Generates an XML formatted document into an existing, or new, data set using any number of subsequent records.

blank

The current record and all following records are used to generate the XML document.

n

Specify n as the number of records to use to generate the XML Document.

ALL

The current record and all following records are used to generate the XML document.

ZERO

Controls the display of leading zeros in numeric data fields.