Editing your database in batch

The Batch Edit dialog (option 6 on the Utility menu) generates the JCL for a Batch Edit job. A Batch Edit job runs user-written REXX procedures that invoke built-in functions that allow you to read and update your IMS databases.

To generate the JCL for a Batch Edit job:

1. Select option 3 Utilities from the Primary Option Menu and then 6 Batch Edit from the Utility Menu. The Batch Edit Entry panel is displayed.
2. Notice that many of the fields on the Batch Edit Entry panel are also on the Browse Entry panel. To fill out the fields that are common to both panels, follow one of these sets of instructions according to which Region type and PSB type you want the Batch Edit to use:
   • Steps 2 to 9 in Accessing in BMP mode using a Static PSB.
   • Steps 2 to 8 in Accessing in BMP mode using a Dynamic PSB.
   • Steps 2 to 10 in Accessing in DLI mode using a Static PSB.
   • Steps 2 to 9 in Accessing in DLI mode using a Dynamic PSB.
3. If you selected Existing for the View usage and you want to edit the view before the Batch Edit uses it, enter / in the Edit view field.
4. If the REXX procedure that you want the Batch Edit to run, includes a VIEWIMS call with the TPLDD parameter, enter s in the Include template DD field. If you select this option, the generated JCL includes a TDDIN DD statement that specifies the Template data sets for the specified subsystem.
5. Press Enter to process the data you entered. According to what you entered on the panel, one or more of these panels may be displayed in the order they are listed:
   • Subsystem Selection panel
     • Displayed when you enter no subsystem name or a subsystem name pattern.
     • Displays a list of IMS subsystems defined by the FM/IMS administrator at installation time.
   • PSB Selection panel
     • Displayed when you enter no PSB name or a PSB name pattern and select "Static" for PSB type.
     • Displays a list of the PSBs in the PSB libraries for the specified subsystem.
     If the PSB libraries for the subsystem are not fixed, you specify the PSB libraries for the subsystem on the PSB and DBD Data Sets panel (option 0.6.7). If the PSB libraries for the subsystem are fixed, the FM/IMS administrator specifies the PSB libraries for the subsystem at installation time.
   • PCB Selection panel
     • Displayed when you select Static for the PSB type and one of the following is true:
       • you enter no database name and there is more than one database PCB in the specified PSB or
       • you enter a database name and there is more than one PCB for the database in the PSB or
       • you enter a database name pattern and the PSB has PCBs for databases with names that match the pattern
     • Displays a list of the PCBs in the specified PSB.
   • Database Selection panel
     • Displayed when you enter no database name or a database name pattern and select Dynamic for the PSB type.
     • Displays a list of the DBDs in the DBD libraries for the specified subsystem.
     If the DBD libraries for the subsystem are not fixed, you specify the DBD libraries for the subsystem on the PSB and DBD Data Sets panel (option 0.6.7). If the DBD libraries for the subsystem are fixed, the FM/IMS administrator specifies the DBD libraries for the subsystem at installation time.
   • AGN Selection panel
     • Displayed when all of these are true:
       • you select BMP for the Region type
       • the specified subsystem uses AGNs and has some of them listed in the FM/IMS installation options module
       • you enter no AGN name or an AGN name pattern.
     • Displays the AGNs for the subsystem that are listed in the FM/IMS installation options module.
   • View Data Set Selection panel
     • Displayed when you enter a View data set name pattern and select Existing for View usage.
     • Displays a list of the data sets whose names match the specified View data set name pattern.
   • View Member Selection panel
     • Displayed when the specified View data set is partitioned, you enter no View member name or a View member name pattern and you select Existing for View usage.
     • Displays a list of the members in the View data set.

   On each selection panel that is displayed, enter S in the Cmd field adjacent to the item you want to select and press Enter.

6. If you selected DLI for Region type and did not select the Skip DB data set panel option, either the Database Data Set Display or the Database Data Set Specification panel is displayed.
   • The Database Data Set Display panel is displayed when a database that is a HALDB or a subsystem that is defined as dynamic allocation only is selected on the Browse or Edit Entry panel. This panel displays the names of the database data sets that the Edit or Browse uses. Verify that the database data sets listed are the ones you want the function to use. To confirm usage of these data sets and to proceed to the next panel in the dialog, press Enter.
   • The Database Data Set Specification panel is displayed when a database that is not a HALDB and a subsystem that is not defined as dynamic allocation only is selected on the Browse or Edit Entry panel. If you selected "User profile" for the Fetch DB dsnames from option, it displays the data set names saved in your user profile. If you selected DFSMDA members for the Fetch DB dsnames from option, it displays the data set names specified in the DFSMDA dynamic allocation members for the subsystem.
     The Database Data Set Specification panel is displayed when the Skip DB data set panel option is not selected, but it is also displayed when the Skip DB data set panel option is selected and one of the following conditions is true:

     • FM/IMS fails to obtain all the required data set names from either your user profile or the DFSMDA members.
     • One or more of the database data sets does not exist or has an invalid data set organization.

   If the displayed data set names are not the ones you want the function to use or no data set names are displayed, enter the data set names that you want the function to use and press Enter. To confirm usage of the displayed data set names and to proceed to the next panel in the dialog, press Enter once more.

7. On the Batch Edit Options panel, specify whether the REXX procedure to be run is to be created instream by yourself or run from a dataset (or member) you previously created.
   To create the REXX Procedure instream:

   • Select the Instream field. You must edit the generated JCL to specify the REXX that is to be run.
   To run REXX from an existing data set (or member):

   • In the REXX Procedure fields specify the data set (must be a PDS) and member containing the REXX that is to be run.
   • Ensure the Instream Field has not been specified.
   • You can maintain the REXX by selecting the Edit Rexx field. This will take you into an ISPF edit session to maintain the REXX procedure.
8. Press Enter. FM/IMS uses the data you specified in the dialog to generate JCL for the Batch Edit job. You can edit the JCL before submitting the job.