File-AID screen types
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
OPTION ===>
0 PARAMETERS - Specify ISPF and File-AID parameters USERID - USERID9
1 BROWSE - Display file contents DATE - 23/01/17
2 EDIT - Create or change file contents TIME - 09:19
3 UTILITIES - File-AID/SPF extended utilities TERMINAL - 3278
5 PRINT - Print file contents CCSID - 00037
6 SELECTION - Create or change selection criteria
7 XREF - Create or change layout cross reference
8 VIEW - View interpreted record layout
9 REFORMAT - Convert file from one format to another
10 COMPARE - Compare file contents
T TUTORIAL - Display information about File-AID
X EXIT - Terminate File-AID and return to ISPF
Use END to terminate File-AID
(c) Copyright 1982-2023 BMC Software, Inc.
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
COMMAND ===>
Edit Mode ===> C (F=Fmt; C=Char; V=Vfmt; U=Unfmt)
Specify Edit Information:
Dataset name or zFS path ===> ’USERID9.FASAMP.EMPMAST’
Member name ===> (Blank or pattern for member list)
Volume serial ===> (If dataset is not cataloged)
Disposition ===> OLD (OLD or SHR)
Create audit trail ===> N (Y = Yes; N = No)
Specify Record Layout and XREF Information:
Record layout usage ===> N (S = Single; X = XREF; N = None)
Record layout dataset ===>
Member name ===> (Blank or pattern for member list)
XREF dataset name ===>
Member name ===> (Blank or pattern for member list)
Specify Selection Criteria Information: (E = Existing; T = Temporary;
Selection criteria usage ===> N M = Modify; Q = Quick; N = None)
Selection dataset name ===>'
Member name ===> (Blank or pattern for member list)
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
COMMAND ===> SCROLL ===> CSR
S/X NAME VV.MM CREATED CHANGED SIZE INIT MOD ID
BATVTOC 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
COPY 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT6XMAP SELECTED 01.00 95/02/03 95/02/03 15:44 37 37 0 USERID9
CVT70SEL SELECTED 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT70XRF SELECTED 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
DROP 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
DUMP 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
JCLCNVRT SELECTED 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
LIST 01.00 95/02/03 95/02/03 15:44 17 17 0 USERID9
PRINT 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
SAMPLE01 01.00 95/02/03 95/02/03 15:44 14 14 0 USERID9
SAMPLE02 01.00 95/02/03 95/02/03 15:44 17 17 0 USERID9
SKELETON 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
SPACE 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
TALLY 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
UPDATE 01.00 95/02/03 95/02/03 15:44 27 27 0 USERID9
USER 01.00 95/02/03 95/02/03 15:44 31 31 0 USERID9
******************************* BOTTOM OF DATA ********************************
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:
Selects the member PRINT for processing.
Scrolling, LOCATE, and SORT commands are also available on member selection lists.
Member select list screen
COMMAND ===> SCROLL ===> CSR
S NAME VV.MM CREATED CHANGED SIZE INIT MOD ID
BATVTOC 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
COPY 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT6XMAP 01.00 95/02/03 95/02/03 15:44 37 37 0 USERID9
CVT70SEL 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT70XRF 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
DROP 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
DUMP 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
JCLCNVRT 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
LIST 01.00 95/02/03 95/02/03 15:44 17 17 0 USERID9
PRINT 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
SAMPLE01 01.00 95/02/03 95/02/03 15:44 14 14 0 USERID9
SAMPLE02 01.00 95/02/03 95/02/03 15:44 17 17 0 USERID9
SKELETON 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
SPACE 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
TALLY 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
UPDATE 01.00 95/02/03 95/02/03 15:44 27 27 0 USERID9
USER 01.00 95/02/03 95/02/03 15:44 31 31 0 USERID9
******************************* BOTTOM OF DATA *******************************
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
COMMAND ===> SCROLL ===> CSR
S NAME HITS VV.MM CREATED CHANGED SIZE INIT MOD ID
BATVTOC 1 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
COPY 2 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT6XMAP 2 01.00 95/02/03 95/02/03 15:44 37 37 0 USERID9
CVT70SEL 2 01.00 95/02/03 95/02/03 15:44 22 22 0 USERID9
CVT70XRF 2 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
DROP 2 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
DUMP 2 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
JCLCNVRT 1 01.00 95/02/03 95/02/03 15:44 23 23 0 USERID9
LIST 2 01.00 95/02/03 95/02/03 15:44 17 17 0 USERID9
PRINT 2 01.00 95/02/03 95/02/03 15:44 18 18 0 USERID9
SPACE 2 01.00 95/02/03 95/02/03 15:44 20 20 0 USERID9
TALLY 2 01.00 95/02/03 95/02/03 15:44 21 21 0 USERID9
UPDATE 2 01.00 95/02/03 95/02/03 15:44 27 27 0 USERID9
USER 2 01.00 95/02/03 95/02/03 15:44 31 31 0 USERID9
******************************* BOTTOM OF DATA ********************************
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. Add an A or D suffix to the SORT command to rearrange in ascending or descending order.
You can separate sort columns by a blank or comma. You can sort up to eight columns.
The following columns can be abbreviated: CHANGED/CHA, CREATED/CRE, LEVEL/LVL (Panvalet), and DESCRIPTION/DESC.
The following columns have a default sort order of Ascending: NAME, ID, PROGRAMMER, VV/VVMM, LANG, STAT, TYPE, SUBS, DESC, and USER.
The following columns have a default sort order of Descending: SIZE, CHANGED, CREATED, INIT, MOD, and LEVEL (Panvalet).
Only SELECT, LOCATE, and PRINT commands 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
COMMAND ===> SCROLL ===> PAGE
MAXIMUM TO LIST: 10 AVAILABLE GENERATIONS: 2
RELATIVE ABSOLUTE GENERATION GENERATION
S GENERATION GENERATION CREATED CHANGED USERID
- ---------- ---------- -------------- -------------- --------
0 0 Unavailable 14/07/10 15:17 USERID9
-1 2 Unavailable 14/07/09 14:10 USERID9
-2 1 Unavailable 14/07/09 14:06 USERID9
******************************* Bottom of data ********************************
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.
USERID
The created/changed userid.