File-AID screen types


Screen formats are divided into five types:

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

             BMC AMI DevX File-AID/MVS V23.1 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

 File-AID ---------------- 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

 File-AID Member S/X - USERID9.FASAMP.JCL ------------------  ROW 1 TO 17 OF 17
 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:

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

File-AID Member Select - USERID9.FASAMP.JCL ---------------  ROW 1 TO 17 OF 17
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 (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

File-AID Member Hits - USERID9.FASAMP.JCL -----------------  ROW 1 TO 14 OF 14
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.

image2021-5-25_12-5-43.png

LOCATE

The LOCATE command scrolls to the specified string.

image2021-5-25_12-6-17.png

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.

image2021-5-25_12-6-40.png

SELECT

The SELECT command selects the specified member name for processing.

image2021-5-25_12-6-59.png

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.

Example

SORT NAME D

SORT CHANGED D SIZE D

SORT CHA A SIZE A

SORT CHA A,SIZE A

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).  

image2022-2-17_11-21-51.png

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

File-AID GENERATION LIST - USERID9.FASAMP.PDSE.V2(EMPLOYEE)    Row 1 to 3 of 3
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.

Important

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

USERID

The created/changed userid.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*