Selection Criteria - Dataset Specification screen

The Selection Criteria - Dataset Specification screen is the first screen displayed when you invoke Option 6. This screen is not displayed when you edit temporary selection criteria from within the Extract function.

Selection Criteria - Dataset Specification screen

Selection Criteria Dataset

Enter the selection criteria dataset you want to edit. The data set must conform to the characteristics of a valid selection criteria dataset as described in Selection Criteria Dataset Concatenation.

Member

Enter the name of the member in the selection criteria dataset. If the field is left blank or a pattern is specified, a member list is displayed. Select a member from the list.

DBDLIB Dataset 1 and Dataset 2

Enter one or two DBD load library data set names. If you enter one DBD load library name, you can enter it on either of the data set name lines. If you enter two DBD load library names and their block sizes are different, you must enter the library with the larger block size on the first data set name line.

Member

Enter the DBD member that describes the database that you want to create selection criteria for. If two DBD libraries are entered, File-AID for IMS searches the first before the second to locate the DBD member.

When you create a new selection criteria dataset or member, it will contain the DBD member name you specify in this section of the screen. When you edit the selection criteria at a later time, the DBD Member field on the screen is ignored and the one contained in the selection criteria is used.

Use Application Relationships

Indicate whether you want to define the selection criteria with an application relationship.

Appl Relationship Dataset

You must enter the application relationship dataset name when using an application relationship. Either the DBD member name specified on the screen for a new selection criteria file or the DBD name in an existing selection criteria file is used as the member name for the application relationship dataset.

Use Layouts

Indicate whether segment layouts are to be used to define the selection criteria. For more information, see Segment/Layout XREF Dataset Concatenation.

If you intend to create or edit formatted field selection criteria, you must enter Y in this field.

If your installation has both the COBOL and PL/I language support options of File-AID for IMS installed, ensure that your current language mode is compatible with the segment layout and segment/layout XREF dataset information you specify. Your current language mode is indicated by the word COBOL or PL/I preceding the Use Layouts and the Layout Dataset fields. To change language mode, enter the COBOL or PLI primary command on the COMMAND line.

File-AID for IMS/ISPF maintains separate concatenations of COBOL and PL/I layouts and cross-reference datasets. These concatenations automatically toggle between the COBOL and PL/I sets when you enter the COBOL or PLI command. Layouts and cross-reference datasets that you have entered for use with COBOL are kept separate from those you have entered for PL/I

Segment/Layout XREF Dataset and Member

When you create a new selection criteria dataset or member that contains formatted field selection criteria, it is assigned a single record type status or multi-record type status based on the information contained in the segment/layout XREF member. The segment/layout XREF member, created and maintained using Option 7, is described in detail on here.

When you edit the selection criteria at a later time, the segment/layout XREF information must result in the same record type (single or multiple) as originally specified when the selection criteria were created. If the segment/layout XREF information you enter results in a type different from the original, the message RECORD TYPE CONFLICT is displayed, and you cannot edit the selection criteria.

When you create a new selection criteria dataset or member that does not contain formatted field selection criteria, it is not assigned a record type status. You can later edit the selection criteria regardless of the Use Layouts indicator you specify at the time.

If your installation has both COBOL and PL/I language support options of File-AID for IMS installed, when you create a new selection criteria dataset or member that contains formatted field selection criteria, it is assigned a language status of COBOL or PL/I based on your current language mode. When you edit the selection criteria at a later time, you must be in the same language mode that the selection criteria were originally created. If your language mode is different than the selection criteria’s language status, the message SLCTN CRIT/LANG CONFLICT is displayed, and you cannot edit the selection criteria.

A language status is not assigned to selection criteria datasets that do not contain formatted field selection criteria. You can later edit the selection criteria regardless of your language mode at the time.

Layout Dataset 1 and Dataset 2

Enter the data set names where the layouts specified by the segment/layout XREF reside.

If you enter one segment layout data set name, you can enter it on either line. If you enter two segment layout data set names, they can appear in any order. Each library can be any of the valid segment layout library organization types. For more information, see Segment Layout Dataset Concatenation.

Terminating the Screen

Do one of the following to terminate the Selection Criteria - Dataset Specification screen:

• Press ENTER to proceed to the next screen. Depending on the information entered, you can receive up to three member list screens:
  • One for the selection criteria dataset.
  • One for the DBD load library data set.
  • One for the segment/layout XREF dataset.
• Enter the END, RETURN, or jump command to leave the selection criteria option.

Error Summary

If you are editing selection criteria that you previously created in Option 6, after you press ENTER on the Selection Criteria - Dataset Specification screen, File-AID for IMS reads the selection criteria dataset and matches it with the segment/layout XREF information. If errors are found in the matching process, the Selection Criteria Error Summary screen is displayed, as shown in the following figure.

Selection Criteria Error Summary Screen

Error Messages

Errors can occur in the matching process for any of the following reasons:

• 
  
  • Incorrect segment layout or segment/layout XREF information was entered on the Selection Criteria - Dataset Specification screen.
  • The segment layouts used to create the formatted field selection criteria has changed.
  • The segment/layout XREF used to create the formatted field selection criteria has changed.
  • The application relationships applied to the selection criteria have changed.
  • The selection criteria have been modified outside Option 6 (for example, in ISPF/PDF Option 2).

Following is the text and description of each message:

Selection Criteria - Validation Errors

Datasets Used When Last Save Was Made

Displays information about the DBDLIB, application relationship, segment/layout XREF, and layout data sets that were used the last time the file was saved.

Terminating the Screen

Do one of the following to terminate the Selection Criteria Error Summary screen:

• Enter the END command to terminate the editing of the selection criteria and return to the Selection Criteria - Dataset Specification screen.
• Press ENTER to proceed with editing the selection criteria despite the errors. The Selection Criteria - Menu screen is displayed.

Selection Criteria Menu

If there are no errors in the selection criteria or if there are errors and you press ENTER on the Selection Criteria Error Summary screen, the Selection Criteria - Menu screen is displayed as shown in the following figure. This is the first screen displayed when you create temporary selection criteria from within the Extract function.

Selection Criteria - Menu Screen

Data Base Access

Indicates whether primary database root segments are accessed directly or sequentially during the extract process. For more information, see Direct Access Processing on database access.

Select Option

Enter one of the following options or commands:

Use secondary indexing

Indicate whether you want to access the primary DBD through a secondary index.

Index DBD

Specify the secondary index DBD name when using secondary indexing. If left blank File-AID for IMS displays the the Secondary Index Database List screen. For more information, see Secondary Indexing.

Short Descr

Enter a short 30-byte description for the selection criteria member. This description is displayed on the Member List screen for the selection criteria dataset. This field is valid only for existing selection criteria and is not displayed when editing temporary selection criteria.

Extended Description

Enter two lines (62 bytes each) of extended description for both temporary and existing selection criteria.

Specify Prompting Level Desired

Specify whether you are a new or experienced user of File-AID for IMS. If you specify N, the informational screens associated with the Segment Criteria and Field Criteria options are displayed. Specify E to skip the informational screens. Examples of the informational screens can be found in Segment Criteria and Field Criteria.

Common Primary Commands

Following is a list of selection criteria primary commands. Commands that are specific to Segment, Field, or Relationship criteria are described under those sections. Scroll commands (UP, DOWN, LOCATE) apply only to scrollable lists and are described in Scrolling. See Primary Commands for an explanation of these and other File-AID for IMS/ISPF primary commands.