Screen types

Screen formats are divided into five types:

Selection Menus: See Selection Menus.
Function Entry Screens: See Function Entry Screens.
Member Selection Lists: See Member Selection Lists.
Information Displays: See Information-displays.
Data Displays: See Data-displays.
File Processing Status: See File-processing-status-display.

On each screen type except selection menus, the first three lines generally contain the same type of information:

Line 1: Function or screen title, file name, and a short message such as a processing indicator or the number of rows in a table.

Line 2: OPTION or COMMAND input field, and SCROLL amount when applicable.

Line 3: Long message or help information when applicable.

The next three sections describe the selection menu, function entry screen, and member selection list screen types and give an example of each. Informational and data displays are described in Browse-and-edit-1-and-2.

Selection Menus

Selection menus are used to select a function or option of the product. An example is the File-AID Primary Option Menu shown in the following figure. The only valid inputs to these displays are the codes listed on the menu.

Example Selection Menu: Primary Option Menu

Function Entry Screens

Function entry screens are displayed by File-AID after a function is selected from a menu. An example is the File-AID Edit Dataset Specification screen shown in the following figure.

Example Function Entry Screen: Edit - Dataset Specification

The entry screens contain the fields used to specify the data set components on which the function is to operate.

Member Selection Lists

File-AID displays member selection lists in the following instances:

Member S/X list processing is provided as part of the function for Copy, Print, Library utility, and Search/Update options B and U.
Member Select list processing is provided when the member is a required field on a function entry screen for a partitioned data set, record layout, selection criteria, XREF, reformat, or compare data set.
Member Hits list is the product (end result) of a selection function in the process of selecting members to display for Browse and Edit.

Member S/X List

The Member S/X List screen, shown in the following figure, allows you to select or exclude the displayed members from further processing.

Member S/X List Screen

This member list screen is displayed when you enter a Y in the Display Member List field on the PDS Processing Options screen in Copy (F.3.3) Search/Update (F.3.6) options B and U, or Print (F.5).

Use the S/X field to specify the following line commands:

S	Select this member for processing.
SS	Specify the beginning or end of a block of members to select.
X	Exclude this member from processing.
XX	Specify the beginning or end of a block of members to exclude.

Use the END command (PF3) to continue processing from this screen.

Member Select List

The Member Select list screen displays the members of the data set specified on the function entry screen. The member is a required field for a partitioned, record layout, selection criteria, XREF, reformat, or compare data set. The Member Select list screen, as shown in Member Select List Screen, is displayed for a partitioned data set.

For an XREF or selection criteria data set, File-AID displays a similar list screen that adds a 30-byte description of the XREF or selection criteria member. The XREF Select member list screen is shown in XREF Select Member List Screen. The SELCRIT Select member list screen is shown in SELCRIT Select Member List Screen.

On any of the select member list screens, you select one member at a time. Enter the S (select) line command in the field next to the member name. You can also select members by entering the SELECT member (S member) primary command. For example:

COMMAND ===> SELECT PRINT

Selects the member PRINT for processing.

Scrolling, LOCATE, and SORT commands are also available on member selection lists.

Member Select List Screen

Member Hits List

The Member Hits list screen, shown in Member Hits List Screen, displays the members that match the values specified on the PDS processing options and selection criteria screens. This screen is displayed after member and record selection criteria is applied for Browse (F.1), and Edit (F.2).

The Hits field shows you the number of times within each member that the selection criteria was met. If no members match the criteria, File-AID displays the message: NO MEMBERS SELECTED at the top of the originating function screen.

You can scroll up and down the Member Hits List screen, use the LOCATE primary command to scroll the list and find a particular member. Select one or more members at a time.

To select members, enter the S (select) line command in the field next to the member name. Optionally, you can select members by entering the SELECT member (S member) primary command.

Use the G (Generation) line command in the field next to the member name to display the Member Generation list (Member Generation Selection List) for the selected member. The G line command is only valid for Version 2 PDSE and is only available if no selection criteria or I/O exit name was specified.

Use the END command (PF3) to exit the member and process the next selected member. When all members have been processed, use the END command (PF3) to return to the original function screen.

Member Hits List Screen

Member List Field Descriptions

This section provides the information about following member lists:

Name

Member name, up to eight characters.

VV.MM

Version and modification level.

Created

Date the member was created.

Changed

Date and time member last updated and saved.

Size

Current number of records in member.

Init

Initial number of records in member.

Mod

Number of modifications to member.

ID

Identification of user who made last changes to member.

Member List Primary Commands

Scrolling and the following primary commands are available on member selection lists:

CANCEL

The CANCEL command cancels current member selection and returns to the previous display.

LOCATE

The LOCATE command scrolls to the specified string.

RESET

The RESET command reconstructs the current display with the entire member list, negating any processing or selection options, condense operations, and exclude line commands that have been specified.

SELECT

The SELECT command selects the specified member name for processing.

SORT

The SORT command sorts the member list. Any column header on the member list display is a valid keyword parameter for SORT. In the Library utility, the SORT command is valid for non-load libraries.

Only SELECT and LOCATE are available with concatenated layout member lists. SORT is not available.

PDSE Member Generation Selection List

The following figure displays the generations of the member that you selected with the G line command in the Member Hits List Screen.

Member Generation Selection List

Select (S) the current member (zero) or the generation you wish to browse/edit. Processing will then continue with the selected current member or generation. You may scroll through the list via the SCROLL KEYS.

MAXIMUM TO LIST

This displays the maximum number of generations to be listed. The limit was specified in the Maximum number of generations to list field in the PDS processing options panel (PDS Processing Options Screen).

AVAILABLE GENERATIONS

The current number of generations that exist for this member. This number does not include the current member (zero) as this is not considered a generation.

RELATIVE GENERATION

The relative generation number, always a negative number, shows the generation relative to the current (zero) member. When the current member is saved it becomes the new current member, the old current member becomes the -1, the old -2 becomes the -3 and so on.

ABSOLUTE GENERATION

The absolute generation number, always a positive number, shows the absolute number of the generation. The absolute number always remains the same. When creating a new generation its absolute number is the highest number increased by 1, for example, when the highest absolute number for the member is 4, then the new generation’s absolute number becomes 5.

GENERATION CREATED

The date/time this generation was created. The generation created timestamp is unavailable until IBM APAR OA45450 is applied.

GENERATION CHANGED

The date/time this generation was updated.

Important

The GENERATION CHANGED date will vary depending on how the member generation was created/changed.

USERID

The created/changed userid.