Load Entry panel

Panel and field definitions

 Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 FM/IMS                         Load Entry Panel

 IMS:
    Subsystem name  . . IF52          PSB name  . . . LA19D     (If static PSB
    Database name . . . DJ1E          AGN name  . . .           (If BMP)

 Processing Options:
    PSB type            Region type         Fetch DB dsnames from (if DLI)
    1  1. Dynamic       1  1. DLI           1  1. User profile
       2. Static           2. BMP              2. DFSMDA members

    Load type                               Enter "/" to select option
       1. No replace                           Skip DB data set panel (if DLI)
       2. Replace                              Do not override insert rules
       3. Initial       




 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel

IMS

Subsystem name

The ID of the IMS subsystem that the databases you want to load are 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.

PSB name

If you select "Static" for PSB type, specify the name of the PSB that you want the Load to use. The PSB that you specify must have a PCB for all the databases you want to load.

FM/IMS searches either an IMS catalog or PSB libraries for a PSB 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 PSB libraries. The libraries that are searched depend on which subsystem you select, so they are called the PSB libraries for the selected subsystem.

The PSB 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 PSB libraries for the subsystem are fixed, the PSB Data set name fields on the PSB and DBD Data Sets panel are protected and you must use the PSB libraries that the administrator has specified. Otherwise, these fields are not protected and you are free to modify the list of PSB libraries that FM/IMS searches.

FM/IMS searches the PSB libraries in the order in which they are specified and uses the first PSB it finds with the specified name.

If you do not enter a PSB name or if you enter a PSB name pattern, the PSB Selection panel is displayed. You can select a PSB from the list of PSBs displayed on that panel.

Note: If you select "Dynamic" for PSB type, this field is ignored.

Database name

The name of the primary database of the Load.

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.

The following applies to when you select "Dynamic" for PSB type:

• 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.
• If the selected subsystem does not use IMS-managed ACBs, then IMS requires these DBDs to be in at least one of the specified DBD libraries:
  • The DBD for the primary database of the Load.
  • The DBD for each database that is logically related to the primary database of the Load.

The following applies to when you select "Static" for PSB type:

• The PCB Selection panel is displayed when any one of these is true:
  • You enter no database name and there is more than one database PCB in the specified PSB.
  • You enter a database name and there is more than one PCB for the database in the PSB.
  • You enter a database name pattern and the PSB has PCBs for databases with names that match the pattern.

  You can select a PCB from the list of database PCBs that is displayed on the PCB Selection panel.

• If the subsystem does not use IMS-managed ACBs, then IMS requires these DBDs to be in at least one of the specified DBD libraries:
  • The DBD for each database that is specified in the PSB.
  • The DBD for each database that is logically related to a database specified in the PSB.

AGN name

The Application Group Name (AGN) identifies a group of IMS resources. The name you specify is passed to the IMS region controller when you select BMP for the Region type.

If you select a subsystem that does not use AGNs, no AGN name should be entered.

If you select a subsystem that uses AGNs, specify an AGN that provides you with the access the Load requires and that you have authority to use. (The BMP region that FM/IMS starts is only authorized to use the IMS resources that are associated with the specified AGN.)

The AGN Selection panel is displayed when all these conditions are true:

• A BMP region type is selected.
• The selected subsystem uses AGNs.
• AGNs for the selected subsystem are listed in the FM/IMS installation options module.
• Either no AGN name is entered or an AGN name pattern is entered and there are AGNs for the selected subsystem in the FM/IMS installation options module that match the pattern.

You can select an AGN from the list of AGNs that is displayed on the AGN Selection panel. If AGNs for the selected subsystem are not listed in the FM/IMS installation options module, you must specify the full name of the AGN.

Note: This field is ignored when you select DLI for the Region type.

PSB type

The type of PSB that the Load uses to access the databases:

1. Dynamic

The Load uses a temporary PSB that it generates at the start of the batch job.

2. Static

The Load uses an existing PSB you specify in the PSB name field.

Region type

The type of region that you want the Load to run in:

1. DLI

For a DL/I batch processing region. You can use a DL/I batch processing region when the database is offline or there is data sharing support.

2. BMP

For a BMP region. You can use a BMP region when the database is online.

Fetch DB dsnames from (if DLI)

If you select "DLI" for Region type, a database that is not a HALDB, and an IMS subsystem that is not a dynamic allocation only subsystem:

1. User profile

Load uses the database data sets whose names are saved in your user profile.

2. DFSMDA members

Load uses the database data sets specified in the DFSMDA dynamic allocation members.

Note: This field is ignored when you specify any one of these:

• "BMP" for Region type.
• A database that is a HALDB.
• An IMS subsystem that is defined as dynamic allocation only in the FM/IMS installation option module.

Load type

1. No replace

The Load does not replace existing segments in the database. If you select this option, the Load only attempts to insert the segment. If the Insert call receives an II status code, the Load does not replace the existing segment in the database with the load segment.

2. Replace

The Load replaces existing segments in the database. If you select this option, the Load attempts to insert the segment as it does when option 1 is selected. However, if the Insert call receives an II status code, the Load replaces the existing segment in the database with the load segment.

Note: If a segment has a non-unique key or no key, existing segments in the database are not replaced. The load segments will be inserted even when there is an existing segment in the database with the same key.

3. Initial

Segments are loaded into a database using a load PSB (PROCOPT=L). Use this option for an initial load of a database. This option is only available when you select "Dynamic" for PSB type and "DLI" for Region type.

Skip DB data set panel (if DLI)

Select this option if you do not want FM/IMS to display the Database Data Set Specification or the Database Data Set Display panel.

If this option is not selected and you select "DLI" for Region type, the Database Data Set Specification or the Database Data Set Display panel is displayed.

Note: This field is ignored when you select "BMP" for Region type.

Do not override insert rules

Select this option if some of the segments you are loading have an insert rule of FIRST or HERE and you do not want the Load to override these insert rules. If you select this option, segments with no key or a non unique key are inserted according to the insert rule for the segment type.

If this option is not selected, segments with no key or a non unique key are inserted as the last occurrence - this is irrespective of the insert rule for the segment type.

Note: If you are using the Extract (IXB) and Load (ILB) to extract data from one database and load it into another, and you want the twin segments in the loaded database to be in the same sequence as they were in the extracted database, then do not select this option.