PROGRAM FUNCTION KEYS IN FILE-AID

     

 When you begin using File-AID,                         |-------------|---- --------|------------ -----|

 commonly used commands are assigned        | PF1/13   | PF2/14  | PF3/15        |

 to the PF keys as shown on the right.                |  HELP    |  SPLIT   |   END           |

                                                                                |                |               |                        |

 You can change these default assignments      |--------------|-------------|-----------------|

 in option 0.0.3 or via the KEYS command.       | PF4/16    | PF5/17  | PF6/18       |

                                                                                | RETURN |  RFIND  | RCHANGE |

                                                                                |                 |               |                       |

                                                                                |---------------|------------|------------------|

                                                                                | PF7/19     | PF8/20  | PF9/21        |

                                                                                |   UP         |  DOWN  |  SWAP        |

                                                                                |                 |                |                       |

                                                                                |---------------|-------------|-----------------|

                                                                                | PF10/22   | PF11/23 | PF12/24     |

                                                                                |  LEFT       |  RIGHT  | RETRIEVE |

                                                                                |                  |               |                    |

                                                                               |----------------|------------|-----------------| 

GENERAL INFORMATION PA KEYS IN FILE-AID

The two program access (PA) keys have special meaning in ISPF and File-AID.  They are not equated to ISPF or File-AID commands, and they may not be reassigned.                                 

Normally, you should not use PA1 while operating in File-AID full screen mode.  However, there are two exceptions.                                   

If you press PA1 after the keyboard has been unlocked by File-AID, it is treated like PA2 (RESHOW).  It does not cause exit from File-AID. However, if you press PA1 a second time without any intervening interaction, it causes the current processing to be terminated and the ISPF PRIMARY OPTION MENU is redisplayed.   

If you press PA1 after the keyboard has been manually unlocked (by pressing the RESET key), it usually causes the current processing to be terminated. The ISPF PRIMARY OPTION MENU is redisplayed.            

You can use PA2 to reshow the last full screen image displayed by File-AID.                                             

You may need to reshow the screen if you accidentally press the ERASE INPUT or CLEAR key, or if you have typed data on the screen that you want ignored and have not yet pressed ENTER or a PF key.

   

MISCELLANEOUS COMMANDS IN FILE-AID

Miscellaneous commands cover a variety of functions.  They are listed and briefly described below.                                                  

  KEY      Causes a specified key to be retrieved or the key specification screen to be displayed (applies to BDAM, ISAM, VSAM-KSDS, VSAM-RRDS, and IAM files only)    

  HEX    * Causes data to be displayed in either hexadecimal or character format 

  CAPS   * Causes alphabetic data entered from the terminal to be either translated to upper case or left as-is       

  RESET  * Causes a general resetting of intensified messages and incomplete line commands

  CHAR      Causes a switch from Formatted or Vertical editing modes to Character editing mode            

FORMAT    Causes a switch from Vertical or Character editing modes to Formatted editing mode (Aliases: FMT, MAP)

VFMT      Causes a switch from Formatted or Character editing modes to Vertical editing mode                     

SPLIT   * Causes split screen mode to be entered or changes the location of the split line                     

SWAP    * Moves the cursor to wherever it was previously positioned on the other logical screen of a split screen pair                   

TSO     * Allows a TSO command or CLIST to be entered from any screen

KEYS    * Causes an immediate display of a screen on which current PF key definitions are displayed and modifiable    

PANELID * Causes all subsequent screens to be displayed/not displayed with the panel identifier shown in the upper left corner of the screen

HELP    * Displays additional information about an error or switches to the on-line tutorial                                                 

CURSOR  * Moves the cursor to the first input field on line 2     

PRINT   * Causes a snapshot of the current screen to be recorded in the ISPF list file for subsequent printing                        

PRINT-HI* Same as PRINT except that high-intensity characters on the screen are printed with overstrikes to simulate the high-intensity display     

JCL       Causes the generated JCL to be displayed   

SESSION CONTROL COMMANDS IN FILE-AID

Session control commands have to do with terminating the current function or switching from one function to another.   

 The session control commands are:      

   CANCEL *  Causes editing to be terminated without saving the data    

   END    *  Terminates the current operation and returns to the next higher level screen (also used to indicate end of table input)

   RETURN *  Causes an immediate return to the primary option menu or to a specified option                                            

  Recursive commands:  File-AID has special commands like F1 (Browse), F2 (Edit), F33 (Copy) that let you suspend your current display  and start another function.  Upon end from the new function, the suspended display is resumed.        

   The following will be presented only if selected by number:             

           1 - Recursive Commands                                          

 

RECORD MANIPULATION COMMANDS IN FILE-AID

Record manipulation commands allow you to update file contents and to find and change occurrences of a string in a file.

 The record manipulation commands are:  

 INSERT    Causes "n" records to be inserted after the current record (not supported for BDAM files)                                   

 DELETE    Causes "n" records to be deleted beginning with current record (not supported for BDAM files)                                   

 REPEAT    Causes a record to be repeated "n" times (not supported for BDAM files)                                   

 FIND      Causes one or all occurrences of a string to be found    

 RFIND *   In Edit or Browse, causes the previous FIND command to be repeated

CHANGE    Causes one or all occurrences of a string to be changed          

 RCHANGE * In Edit, causes the previous CHANGE command to be repeated    

 SAVE    * Causes the data to be stored back into the edit dataset  

 UNDO      Causes the last applied change to data to be reversed       

 When using an XREF to work with "segmented" records the following are valid:

 ADD       Insert a segment at a point in the record.                       

 NEXT      Display NEXT segment of record using correct layout              

 REMOVE    Remove a segment at a point in the record.                       

 TOP       Return to start of record and display base                        

 USE       Display layouts and allow manual selection and relocation     

GENERAL INFORMATION COMMANDS IN FILE-AID

File-AID primary commands are divided into four categories listed below.  Commands designated with an asterisk (*) have the same syntax and function as in ISPF.

In many File-AID functions, the information to be displayed exceeds the screen size.  Scroll commands allow you to move the screen "window" in as many as three dimensions across the information: up/down, left/right, and forward/back.  For a more detailed description of scrolling, see the SCROLLING section within GENERAL INFORMATION.  

The scroll commands are:            

  UP     *  Causes scrolling toward the top of a record, file, record layout, or member list.              

  DOWN   *  Causes scrolling toward the end of a record, file, record layout, or member list.

  LEFT   *  Causes scrolling toward the left margin of the data or causes backward scrolling towards the beginning of a file.   

  RIGHT  *  Causes scrolling toward the right margin of the data or causes forward scrolling towards the end of a file.          

FORWARD      Causes record scrolling toward the bottom of the file.    

BACK         Causes scrolling toward the top of the file.

LOCATE       Causes up or down scrolling to the specified line number, label, or member name.                                    

LOCATE       Causes up or down scrolling to the record with a label (dataname) or exclude classification.  Also causes scrolling to a data-name that contains, in part or full, the data name(occ) string.

LR           Causes forward or backward scrolling to a specified record number, label, or any record with a label classification.  

GENERAL INFORMATION COMMAND ENTRY in FILE-AID

File-AID provides commands for commonly used functions. You may enter commands in one of two ways:     

   1)  By typing the command in the command/option field (line 2 of the screen) and then pressing the ENTER key, or   

   2)  By pressing a program function (PF) key to which you have assigned the desired command. 

 You can assign commands to PF keys using option 0.0.3 or the KEYS command. When you press the PF key, the processing is the same as if you typed the command in the command field and pressed ENTER.                

Before you press a PF key, you can enter information in the command field. The PF key definition is concatenated ahead of the contents of the command field.  For example, suppose you assign the DOWN command to the PF8 key. If you type "6" in the command field and press PF8, the results are the same as if you had typed "DOWN 6" in the command field and pressed ENTER.   

 You can stack multiple commands for execution in one interaction by entering a special delimiter between the commands.  The default delimiter is a semicolon (;).  You can change the delimiter using option 0.0.1.  For example:                                                                     

  COMMAND ===> DOWN 10;LEFT              

 In this example the DOWN and LEFT commands have been stacked. 

GENERAL INFORMATION MEMBER SELECTION SCREENS in FILE-AID

A member selection screen is an alphabetic list of the members of a partitioned dataset.  It is displayed when requested from any of the File-AID functions 1-10.     

In most functions it is possible to obtain multiple member lists prior to entering the function.                                                    

                                                 |************************************************

The example at the right           | File-AID ---- EDIT - PROJECT.TEST.DATA --------

shows the selection of              | COMMAND ===>                                  

member TESTFIL3 from the       |     NAME           VER.MOD    CREATED    LAST M

partitioned dataset                   |   TEST1             01.04     08/17/93   09/23/

PROJECT.TEST.DATA             |   TEST2             01.02     06/12/93   09/13/

                                                | S TESTFIL3          01.13     07/29/93   09/20/

                                                |   TESTFIL4          01.07     08/01/93   08/29/

                                                |   TESTFIL5          01.11     07/01/93   09/01/

Scrollable data display screens show file contents or record layouts and allow up/down scrolling, and in some cases left/right scrolling.  On many scrollable data display screens, you can also update file contents by typing over fields on the screen.              

   The example below shows the edit formatted screen.  You can scroll using the UP and DOWN commands, and can update file contents by typing over the FIELD VALUE column.     

 File-AID ---- EDIT - PROJECT.TEST.DATA(TESTFL3) -------------------- LINE 00001

 COMMAND ===>                                                   SCROLL ===> PAGE

 RCD SEQ NO  1                                                                  

 --------LEVEL NUMBER/DATA-NAME--------- -OFFSET- ---------FIELD VALUE----------

 01  ORDER-LINE                                                                

   05  ITEM-NO                               1    PS/2 MOD50                   

   05  QTY-ORDERED                  11    100                          

   05  LIST-PRICE                         14    2400.00

GENERAL INFORMATION UNSCROLLABLE DATA DISPLAY SCREENS

  Unscrollable data display screens show "nonrepeating" information which fits on a single screen.  The Selection Criteria Options screen shown below is an example of this type of screen.                                 

********************************************************************************

 File-AID ---- Selection Criteria - Options ------------------------------------

 COMMAND ===>                                                                   

                                                                               

 Selection criteria options                                                    

                                      First, start at the following record KEY 

    Starting record key         ===>                                           

       - OR -                                   OR at the following RBA        

    Starting RBA                   ===>               (both blank for start of file

                                                                                

    Initial records to skip       ===> 0          then skip this many records       

GENERAL INFORMATION INVOKING FILE-AID

File-AID executes as a dialog under IBM's ISPF dialog manager facility. You can invoke it by selecting the File-AID option from a customized version of the ISPF primary option menu, or from a sub-menu panel your installation has set up.

 If the File-AID execution CLISTS have been installed, you may invoke File-AID from any ISPF screen.  For example, the command TSO FASTART suspends your current screen and displays the File-AID primary option menu.  Upon exit from File-AID your suspended screen is restored.     

   The following will be presented only if selected by number:         

           1 - File-AID execution CLISTS

GENERAL INFORMATION SUMMARY OF OPTIONS 0-C

The File-AID primary options are:                                    

OPTION 0 - SPECIFY ISPF AND File-AID PARAMETERS                        

    This option consists of the ISPF-provided parameter option screens and several screens to specify File-AID default parameters.        

  OPTION 1 - BROWSE FILE                                                 

   This option is used to display but not change the contents of files using any of three display modes - formatted, vertical, and character.

  OPTION 2 - EDIT FILE                                                    

     This option is used to create, display and change the contents of files using the formatted, vertical, and character display modes.

 OPTION 3 - UTILITIES/E                                                  

     This option accesses a menu of dataset management utilities. Included are:

3.1 Library (PDS directory management and CSECT info),

3.2 Dataset (Non-VSAM dataset allocation, information),

3.3 Copy (Selective record copying for all file types including PDS members),

3.4 Catalog (search catalog using pattern characters)

3.5 VSAM (Define VSAM clusters, indexes, and paths online or in batch),

3.6 Search/Update (Scan or perform global changes for any dataset),

3.7 VTOC (Search volumes for datasets using pattern characters, analyze space),

3.8 Interactive (run File-AID/Batch online),

3.9 Submit (create batch JCL).

OPTION 5 - PRINT FILE                                                     

    This option is used to print data file contents, the selection criteria and rcd/layout XREFs created in options 6 and 7 of File-AID, formatted record layouts, and audit trail datasets created while editing a data file in option 2 (Edit) or 3.6 (Update) of File-AID.    

OPTION 6 - EDIT SELECTION CRITERIA                                        

    This option is used to create and maintain selection criteria for use in the Browse, Edit, Copy, Print, and Compare functions.          

OPTION 7 - EDIT RCD/LAYOUT XREF                                           

    This option is used to create and maintain rcd/layout XREFs for use in other File-AID functions.                                              

  OPTION 8 - VIEW RECORD LAYOUT                                             

    This option is used to display the contents of COBOL or PL/I layouts as interpreted by File-AID.

OPTION 9 - REFORMAT FILE                                                   

    This option allows the records of an input file to be reformatted and written to an output file based on record layouts defining the input and output files.       

OPTION 10 - COMPARE                                                        

    This option is used to compare two files and report the differences between them.                                                                                                                                   

OPTION C - File-AID CHANGES                                                

    This option documents changes made in the various releases of File-AID.

 GENERAL INFORMATION SCREEN FORMATS

  File-AID uses the full screen for display and entry of data.            

 The first three lines of each display, called the heading lines, have a common format for all File-AID displays. The remainder of the screen may contain a list of options, input fields and prompts, or scrollable data.

The first three lines of each display are formatted as follows:         

             |----------------------------------------|-------------------------------|

   line 1: |  TITLE                                                |  SHORT MESSAGE |

             |--------------------------------------- |------|---------- --------------|

   line 2: |  COMMAND/OPTION                     |  SCROLL |

             |---------------------------------------------- --|----------------------|

   line 3: |  LONG MESSAGE                                                                  |

             |-----------------------------------------------------------------------|

 The TITLE area (line 1) identifies the function being performed and, where appropriate, library or dataset information.                      

 The SHORT MESSAGE area (line 1) is used to indicate:                     

    - Current line or column positions                                   

    - Successful completion of a processing function                     

- Error conditions (accompanied by audible alarm)

The COMMAND/OPTION area (line 2) is used to enter a command.  On an option selection menu, it may be used to enter either a command or an option. 

The SCROLL area (line 2) contains the current scroll amount whenever scrolling is applicable.  You may change it by overtyping.                  

The LONG MESSAGE area (line 3) is used to display an explanation of error conditions upon request (see HELP command).  This line will normally be blank or will contain heading (non data entry) information. Dataset specification screens allow you to enter information such as dataset names, member names, and other parameters.  The fields in which you may enter information are labeled and preceded with an arrow.  If  you fail to enter a required value or if you enter inconsistent values, you are prompted with a message.                                            

                                                                              

                         

 The example at the right     File-AID  -------------  Edit - Dataset Specifi

 shows the edit dataset        COMMAND ===>                                   

 specification screen.                                                          

                                               Edit Mode                   ===> C   (F=Format                                                 

                                               Specify Edit Information:                     

                                               Edit Dataset name        ===> FASAMP.*     

                                               Member name              ===>     (Blank or

                                               Volume serial            ===>     (If datas

                                               Disposition              ===> OLD (SHR or O

                                               Create audit trail       ===> N   (Y = Yes;

Several fields on dataset specification screens are pre-entered with values that you entered the last time on that screen or on a similar screen.  If the values are correct, simply press ENTER.  If the values are not correct, overtype the fields that need to be changed before pressing ENTER.         

The pre-entered information comes from your user profile, which File-AID automatically builds and maintains across sessions.  Information that is maintained in your user profile includes:                               

                                                                           

    - Dataset names and member names                                       

    - Job statement information                                            

    - SYSOUT class for printed output                                      

    - Parameters entered via Option 0 (Parameters)                         

- PF-Key defaults 

FILE_AID KEY FEATURES

                                                          

 o  Eliminates ISPF editing restrictions                                             

-            provides on-line editing of sequential, BDAM, PDS, ISAM, IAM, and VSAM files using

         formatted, full-screen displays                  

    -       eliminates record length restriction                              

eliminates file size restriction by using selection criteria to limit the number of records to be  edited                          

    -      supports files in compressed/encrypted format (with I/O exits)    

    -       provides optional audit trail of all records updated, inserted, and deleted while editing a data file

 o  Uses existing COBOL or PL/I record layouts directly                   

    -  the record layout is the sole definition of files thus eliminating the need to redefine the file/data in another language             

    -  superimposing the record layout over raw data brings meaning to that data                                                          

    -  files may be printed in a formatted manner using the record layout                                               

 o  Has powerful, easy to use, copying and reformatting capabilities      

    -  these capabilities exist in both batch and on-line modes           

    -  no language to learn and no programming required                   

    -  records may be selected for copying using selection criteria based on record counts and/or        specific values in individual fields .

    -  selection criteria can be used in the Browse, Edit, Copy, Print, or Compare functions .

o  Runs as a single dialog under ISPF                                

    -  uses menu-driven, full-screen, interactive ISPF-like displays  

    -  has user defined PF (program function) key support             

    -  can operate "split-screen" with ISPF/PDF                       

    -  easy to learn and use                                          

    -  a fully interactive product with batch capabilities            

    -  executes in storage available above the 16 megabyte line on systems running MVS/XA or MVS/ESA 

COPY cmd in FILE-AID

Copy dataset - one to one Code:

//STEPCOPY EXEC PGM=FILEAID

//DD01     DD DSN=G1SG00AT.INPUT1,DISP=SHR

//DD01O    DD DSN=G1SG00AT.OUTPUT1,DISP=OLD

//DD02     DD DSN=G1SG00AT.INPUT2,DISP=SHR

//DD02O    DD DSN=G1SG00AT.OUTPUT2,DISP=OLD

//SYSOUT   DD SYSOUT=*

//SYSPRINT DD SYSOUT=*

//SYSLIST  DD SYSOUT=*

//SYSTOTAL DD SYSOUT=*

//SYSIN    DD DUMMY      or code COPY as instream

Here by default SYSIN parameter is 'COPY'. Copy is done from DD01 to DD01O although DD02 and DD02O are coded.

Copy dataset - many to many Code:

//STEPCOPY EXEC PGM=FILEAID

//DD01     DD DSN=G1SG00AT.INPUT1,DISP=SHR

//DD01O    DD DSN=G1SG00AT.OUTPUT1,DISP=OLD

//DD02     DD DSN=G1SG00AT.INPUT2,DISP=SHR

//DD02O    DD DSN=G1SG00AT.OUTPUT2,DISP=OLD

//SYSOUT   DD SYSOUT=*

//SYSPRINT DD SYSOUT=*

//SYSLIST  DD SYSOUT=*

//SYSTOTAL DD SYSOUT=*

//SYSIN    DD *

$$DD01 COPY

$$DD02 COPY

/*

Here DD01 is copied to DD01O and DD02 is copied to DD02O 

VSAM FILE CREATION in FILE-AID

 Type 3, on Mainmenu of FILE-AID  

 The following screen will be displayed 

FILE-AID ------------------  EXTENDED UTILITIES  ------------------------------ OPTION ===>                                                                                                                                                       1  LIBRARY       - DISPLAY AND MODIFY DIRECTORY ENTRIES; DISPLAY LOAD                              MODULE CSECT MAPS; BROWSE, DELETE, RENAME PDS MEMBERS         2  DATASET       - DISPLAY DATASET INFORMATION; ALLOCATE NON-VSAM DATASETS                         AND GDGS; CATALOG, UNCATALOG, DELETE, OR RENAME DATASETS     3  COPY          - COPY ENTIRE DATASETS; COPY SELECTED RECORDS; COPY PDS                           MEMBERS BASED ON NAME, STATISTICS AND/OR CONTENT             4  CATALOG       - DISPLAY GENERIC CATALOG ENTRIES OR VSAM DATASETS ON A                           VOLUME IN LIST FORM AND DO DATASET LIST PROCESSING           5  VSAM          - ALLOCATE, DISPLAY, DELETE, MODIFY, OR RENAME VSAM CLUSTERS,                      ALTERNATE INDEXES, OR PATHS; MANAGE IAM FILES                6  SEARCH/UPDATE - FIND AND CHANGE ACROSS PDS MEMBERS.  SEARCH FOR AND/OR                          UPDATE DATA GLOBALLY IN ANY TYPE OF DATASET.                 7  VTOC          - DISPLAY AND PROCESS DATASETS ON A VOLUME(S)                                                                                                   8  INTERACTIVE   - EXECUTE FILE-AID/BATCH

 Use option 5 to ALLOCATE, DISPLAY, DELETE, MODIFY OR RENAME VSAM CLUSTERS 

 type 5 

 Followig screen will be displayed, 

   
  FILE-AID ---------------------  VSAM UTILITY  ---------------------------------
 OPTION ===> A                                                                  
                                                                                
    A     - ALLOCATE CLUSTER                   D  - DELETE                      
    S     - ALLOCATE DATASPACE                 DR - DELETE/DEFINE               
    X     - ALLOCATE ALTERNATE INDEX           T  - DELETE DATASPACE            
    B     - BUILD ALTERNATE INDEX              P  - ALLOCATE PATH               
    BLANK - DISPLAY DATASET INFORMATION        R  - RENAME COMPONENT            
                                               M  - MODIFY COMPONENT            
 SPECIFY DATASET INFORMATION:                                                   
    DATASET NAME           ===> 'SSEE.SETW47.XXXX.XXX.XXXXREAD'
    VOLUME SERIAL          ===>          (REQUIRED FOR OPTIONS S & T)           
                                                                                
 PROCESS ONLINE OR BATCH   ===> O       (O = ONLINE; B = BATCH)                
                                                                                
 SPECIFY MODEL DATASET INFORMATION:                                             
    DATASET NAME           ===>                                                
                                                                                
 SPECIFY CATALOG TO USE IF OTHER THAN DEFAULT SYSTEM CATALOG:                   
    CATALOG NAME           ===>                                                
    CATALOG PASSWORD       ===>          (IF CATALOG IS PASSWORD PROTECTED)     
 ---------------------------------------------------------------------------- 
  
  

 Using above screen, We can ALLOCATE, DELETE, MODIFY VSAM DATA SETS

 If you have any questions on FILE AID. You can post them on FILE AID forum. 

 Please send improvement suggestions on this document to srcsinc@yahoo.com