Initialize Entry panel
The Initialize Entry panel is the first panel in the Initialize dialog.
It is displayed when you select option 2 (Initialize) from the Utility Menu panel.
Panel and field definitions
- IMS
- Subsystem Name
- The ID of the IMS subsystem that the database you want to
initialize is defined in.
FM/IMS searches the FM/IMS installation options module for the subsystem with the specified name.
If you enter either no subsystem name or a subsystem name pattern, the Subsystem Selection panel is displayed. You can select a subsystem from the list of subsystems displayed on that panel.
Note: When the specified IMS subsystem only allows the use of a static PSB or BMP batch processing then only a Fast Path or a HALDB database can be specified in the Database name field. This is because to initialize a full function database requires the use of a dynamic PSB running in a DL/I batch processing region. - Database Name
- The name of the database that you want to initialize. When the database is logically related to
other databases, the Initialize also initializes the logically related databases.
FM/IMS searches either an IMS catalog or DBD libraries for a DBD with the specified name. Which of these two sources is searched depends on whether or not the selected subsystem uses IMS-managed ACBs.
If the selected subsystem uses IMS-managed ACBs, then FM/IMS searches the IMS catalog that the subsystem uses.
Otherwise, FM/IMS searches user- or administrator-specified DBD libraries. The libraries that are searched depend on which subsystem you select, so they are called the DBD libraries for the selected subsystem.
The DBD libraries for the selected subsystem are displayed on the PSB and DBD Data Sets panel and may or may not be fixed by the FM/IMS administrator.
If the DBD libraries for the subsystem are fixed, the DBD Data set name fields on the PSB and DBD Data Sets panel are protected and you must use the DBD libraries that the administrator has specified. Otherwise, these fields are not protected and you are free to modify the list of DBD libraries that FM/IMS searches.
FM/IMS searches the DBD libraries in the order in which they are specified and uses the first DBD it finds with the specified name.
IMS requires the following DBDs to be in at least one of the specified DBD libraries:- The DBD for the database that you specify.
- The DBD for each database that is logically related to the database that you specify.
If you enter either no database name or a database name pattern, the Database Selection panel is displayed. You can select a database from the list of databases displayed on that panel.
- Image copy skeleton
- Data set name
- If you select the Submit image copy option,
specify the PDS(E) that contains the image copy skeletons that
you want the Initialize to use.
Note: This field is ignored when the Submit image copy option is not selected.
- Fetch DB dsnames from
- If you select a database that is not a HALDB and an
IMS subsystem that is not a dynamic allocation only
subsystem, specify either:
- 1. User profile
- The Initialize uses the database data sets whose names were saved in your user profile.
- 2. DFSMDA members
- The Initialize uses the database data sets specified in the DFSMDA dynamic allocation members.
Note: This field is ignored when you specify either:- A database that is a HALDB.
- An IMS subsystem that is defined as dynamic allocation only in the FM/IMS installation option module.
- Delete/Define DB data sets
- Select this option if you want the generated JCL to include job steps that delete and redefine the database data sets. When included, these job steps precede all other steps in the Initialize job.
- Submit image copy
- Select this option if you want the generated JCL to include a job step that uses GENJCL.IC commands to generate an image copy job. The generated image copy job is submitted to the internal reader.
- Skip DB data set panel
- When selected, FM/IMS does not display the Database Data Set Specification or the Database Data Set Display panel.