Browse Entry panel

The Browse Entry Panel is the first panel in the Browse dialog. It is displayed when you select option 1 (Browse) on the Primary Option Menu panel.

Panel and field definitions

Figure 1. Browse Entry Panel
 Process   Options   Help
───────────────────────────────────────────────────────────────────────────────
 FM/IMS                        Browse Entry Panel

 IMS:
    Subsystem name  . . IF52          PSB name  . . .           (If static PSB)
    Database name . . . DJ1E          AGN name  . . .           (If BMP)
 View:
    Data set name . . .                                               
    Member  . . . . . .         

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

    View usage                              Enter "/" to select option
    3  1. New                                  Secondary index (if dynamic PSB)
       2. Existing                             Skip DB data set panel (if DLI)
       3. None

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 database you want to browse 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.
PSB name
If you select "Static" for PSB type, specify the name of the PSB that you want the Browse to use. The PSB that you specify must have a PCB for the database you want to browse.

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 database that you want to browse.

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 database you want to browse.
    • The DBD for each database that is logically related to the database you want to browse.

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 Browse 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.
View
Data set name
If you select "Existing" for the View usage, this is the name of the data set that contains the view that you want the Browse to use.
Note: If you select "New" or "None" for View usage, this field is ignored.
Member
If you select "Existing" for View usage, then:
  • If the view that you want the Browse to use is in a PDS(E), specify the view member name in this field.
  • If the view that you want the Browse to use is in a sequential data set, blank out this field.
Note: If you select "New" or "None" for View usage, this field is ignored.
PSB type
The type of PSB that the Browse uses to access the database:
1. Dynamic
The Browse uses a temporary PSB that it generates at the start of the dialog.
2. Static
The Browse uses an existing PSB you specify in the PSB name field.
Region type
The type of region that you want the Browse 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
Browse uses the database data sets whose names are saved in your user profile.
2. DFSMDA members
Browse 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.
View usage
Determines whether the Browse uses a new view, an existing view, or no view:
1. New
Select this option when you want Browse to use a new view.

The Browse creates a temporary view from a template for the specified database.

FM/IMS searches user or administrator-specified template libraries for the template. The template libraries that FM/IMS searches depends on which subsystem you select:
  • If the template libraries for the specified subsystem are not fixed, FM/IMS searches the template libraries specified on the Template Data Sets panel.
  • If the template libraries for the subsystem are fixed, FM/IMS searches the default template libraries for the subsystem (specified in the FM/IMS installation options module).

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

2. Existing
Select this option when you want Browse to use an existing view. Browse uses the view specified in the View Data set name and Member fields.
3. None
Select this option when you do not want Browse to use a view.
Secondary index (if dynamic PSB)
Select this option if you have selected "Dynamic" for PSB type and you want to access the database by means of a secondary index.

If you select this option and the database has more than one secondary index, the Secondary Index Selection panel is displayed. You can select a secondary index from the list of secondary indexes displayed on that panel.

Note: This field is ignored when you select "Static" for PSB 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.

Parent panels

Child panels

Related topics and examples