Dynamic PSB
The following figure displays the Data Base Specification Screen for Dynamic PSB.
If your IMS environment definition includes support for COPE Managed Databases, the Data Base Specification Screen displays as shown in Edit - Data Base Specification Screen (Dynamic PSB - COPE Managed Database).
Edit - Data Base Specification Screen (Dynamic PSB)
COMMAND ===>
ENV: TEST - IMS ENVIRONMENT
Region type . . DLI (DLI or BMP)
+ DBDLIB dataset 1 . . ‘CW.FISAMP.DBDLIB
Dataset 2 . .
Member . . (Blank or pattern for member list)
Use secondary indexing . . N (Y = Yes; N = No)
Exclude segments . . N (Y = Yes; N = No; DLI and BMP only)
-------------------------------------------------------------------------------
Use COBOL layouts . . Y (Y = Yes; N = No; I = IMS Fields)
+ Segment/Layout XREF dataset . ‘CW.FISAMP.XREFC
Member . . (Blank or pattern for member list)
+ COBOL layout dataset 1 . .
Dataset 2 . .
-------------------------------------------------------------------------------
Create audit trail . . N (Y = Yes; N = No)
For DLI processing specify the following:
IMS log dataset usage . . N (AK = Allocate; keep after edit
AD = Allocate; delete after edit
N = Do not use log dataset)
Current Environment
The top of the screen displays the environment definition name with its description that is in effect for the current session.
Region type
Enter one of the following:
DLI | Accesses and processes offline databases in a batch environment created within TSO. The databases must be either offline from IMS DC and CICS regions or available under IMS data sharing. |
BMP | Accesses and processes online databases in a BMP environment created within TSO. The databases must be online to an IMS DC region or a DBCTL region. Region type must be BMP to access FAST PATH databases. If a DEDB database has multiple areas and some areas are down, File-AID for IMS skips over the down areas and continues processing. |
DBDLIB dataset 1 and dataset 2
Enter one or two DBD load library data set names. If you enter two, File-AID for IMS searches the first before the second to locate the DBD member.
Member
Enter the DBD member that describes the database you want to edit. If you enter a pattern or leave this field blank, a list is displayed from which you can select a member.
Use secondary indexing
Indicate whether you want to access the primary DBD through a secondary index. See here for details.
Exclude segments
Indicate whether you want to exclude segments from processing for DL/I and BMP region types. If you enter Y, the Exclude Segment Specification screen (here) is displayed before you proceed to the Data Base Dataset Specification screen. If you enter N, you proceed directly to the Data Base Dataset Specification screen with all segment types in the DBD included for processing.
Use COBOL (or PL/I) Layouts
Indicate one of the following:
Y | Uses segment layouts as templates over the data you want to edit. If you specify Y, you must also enter the segment/layout cross-reference library name, a member within that library, and at least one segment layout library name. |
N | Does not use layouts. If you specify N, all other input fields in this section are ignored. This action allows you to use the unformatted and/or character editing modes with a database that does not require segment layouts or a segment/layout XREF. |
I | Uses IMS metadata coded in the DBD as templates for the data you want to edit. If you specify I, you do not need to enter the name of a segment/layout cross-reference library or member or any layout data sets. Only valid for DBDs defined with IMS metadata. For more information, see Formatted Edit and Browse Using IMS Metadata. |
Segment/layout XREF dataset
Enter the segment/layout cross-reference library name if you specified Y in the Use COBOL (or PL/I) layouts field.
Member
Enter the member in the Segment/Layout XREF library that associates a segment layout with each segment type in the DBD. File-AID for IMS uses the appropriate segment layout when editing a segment in formatted mode.
The segment layouts specified in the Segment/Layout XREF Member must reside in the segment layout library concatenation defined for the product.
The Segment/Layout XREF member is created and maintained with the use of Option 7, XREF, described in detail in Segment/Layout Cross-Reference.
If you enter a pattern or leave this field blank, a list is displayed from which you can select a member.
COBOL (or PL/I) layout dataset 1 and dataset 2
If you enter only one segment layout library name, you can enter it on either data set name line. If you enter two, they can appear in any order. Each library can be any of the valid segment layout library organization types. The presence of a highlighted plus (+) or minus (-) sign indicates data set concatenations. For more information, see Data set Concatenation Support.
When searching for a segment layout, File-AID for IMS searches the Dataset 1 library before the Dataset 2 library, and then searches all the data sets listed in the first layout concatenation before searching the second layout concatenation. See Segment Layout Data set Concatenation for details.
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 data sets. These concatenations automatically toggle between the COBOL and PL/I sets when you enter the COBOL or PLI command. Layouts and cross-reference data sets that you have entered for use with COBOL are kept separate from those you have entered for PL/I.
Create Audit Trail
This field is displayed only if you are in edit mode. Indicate whether you want an audit trail of your edit session created. For more information, see Audit Trail Feature.
IMS log dataset usage
This field is displayed only if you are in edit mode. If you specified a DL/I region type, you must enter one of the following values:
AK | Writes a detailed record of your database updates to an IMS log data set. A log data set is allocated, cataloged, and retained when you terminate the edit session. |
AD | Allocates a cataloged log data set. The data set is deleted when you terminate the edit session. |
N | Does not allocate a log data set. |
For additional information about the IMS log data set and its usage, See IEFRDER DD.
Terminating the Screen
Do one of the following to terminate the Data Base Specification (Dynamic) screen:
Press Enter. Depending on the information you entered, up to two member lists are displayed in the following sequence:
- A DBD library member list. If two or more DBD libraries are concatenated, the member list is a sorted and merged list of all members in all libraries.
- A segment/layout XREF member list. If two or more XREF libraries are concatenated, the member list is a sorted and merged list of all members in all libraries.
If you enter the END command from either member list screen, you are returned to the Data Base Specification screen. Additional information on how to use the member lists is provided in the following examples (See to the screen shown in Edit - Data Base Specification Screen (Dynamic PSB):
On the Data Base Specification screen, leave both the DBD Member and the Segment/Layout XREF Member fields blank. Select a DBD from the DBD member list and a segment/layout XREF member from the XREF member list.
After editing your database, decide whether to select another DBD for processing. Enter END on the Data Base Location screen to return directly to the DBD member list. The segment/layout XREF member list is not displayed when moving backward in the conversation. After selecting a new DBD member and new segment/layout XREF member, you can again proceed to the editing screens.
On the Data Base Specification screen, leave the DBD Member field blank but specify a segment/layout XREF member. Select a DBD that corresponds to the segment/layout XREF member you specified and proceed to the editing screens.
Enter END on the Data Base Location screen to return to the DBD member list, and select another DBD for processing. An error occurs because the original segment/layout XREF member you specified does not correspond to the newly selected DBD. You have to return to the Data Base Specification screen to specify the correct segment/layout XREF member.
It is also possible to progress through one or both of the member list screens, reach an error condition before you enter the editing screens, and have File-AID for IMS return you to the Data Base Specification screen. When this happens, members selected up to the point of the error are filled in on the Data Base Specification screen.
- Enter END or RETURN to return to the Primary Option Menu.
Member List Processing
If you did one of the following on the Data Base Specification screen, a member list as shown in Member List Screen is displayed when partitioned datasets are specified:
- Left the Member field blank. A list of the members in the partitioned dataset is displayed.
Entered a pattern as the member name. A pattern is a partial member name followed by an asterisk. The pattern, including the asterisk, cannot contain more than eight characters. For example, the pattern PROGRAM* might display the following list:
PROGRAM1
PROGRAM2
PROGRAM3
Member List Screen
COMMAND ===> SCROLL ===> PAGE
NAME CONCAT DESCRIPTION CREATED LAST MODIFIED ID
DCLT2 3 02/04/27 02/06/01 10:44 TSOID01
DCLT3 4 02/04/27 02/06/05 12:47 TSOID01
IXHCUST 2 02/09/12 02/09/12 15:32 TSOID01
LIBRTST 1
LIXPORDR 4 02/03/12 02/03/12 08:56 TSOID01
LLORDR 4 LOGICAL ORDER DBD 02/07/27 02/07/27 12:32 TSOID01
LORDR 1
LPCUST 4 PHYSICAL CUSTOMER DBD 02/07/27 02/09/18 14:57 TSOID01
LPORDR 4 PHYSICAL ORDER DBD 02/07/27 02/07/10 15:00 TSOID01
LPPART 4 PHYSICAL PART DBD 02/07/27 02/05/11 09:06 TSOID01
PCUST 1
PORDR 1
PPART 1
RLORDR 3 LOGICAL ORDER DBD 02/07/27 02/07/27 12:32 TSOID01
RPCUST 3 PHYSICAL CUSTOMER DBD 02/07/27 02/09/18 14:57 TSOID01
RPORDR 3 PHYSICAL ORDER DBD 02/07/27 02/07/10 15:00 TSOID01
RPPART 3 PHYSICAL PART DBD 02/07/27 02/05/11 09:06 TSOID01
RXPORDR 3 02/03/12 02/03/12 08:56 TSOID01
VARIABLE 5 02/02/25 02/03/10 09:23 TSOID01
*END*
On certain dataset specification screens, you can specify multiple partitioned datasets. Therefore, it is possible for you to receive multiple member list screens (one for each partitioned dataset specified without a member) before proceeding to the next screen in the function. The member lists are displayed in the sequence that the data sets appear on the Dataset Specification screen.
You can scroll through the list using the UP/DOWN and RIGHT/LEFT commands. The RIGHT/LEFT commands toggle between alternate presentations of member list information. The fields on the two displays vary depending on the type of library for which the member list is being displayed. In many cases, the member list is displayed again with an automatic scroll to the member just processed when you terminate a function where a member list is invoked. You can then select another member or enter the END command to return to the next higher level screen. When the member list is displayed, it does not include new members created by another user or, in split screen mode, on the other logical screen. To display an up-to-date list, return to the Primary Option Menu and select the function again.
You can enter a LOCATE command on any member list screen. This command causes a direct scroll to the specified member name (that is, the entry for the specified name appears as the first line following the header lines). If the specified name is not found, scrolling is to the member name that, in the standard collating sequence, immediately precedes the specified name.
You can select a member from the list in one of the following ways:
- Move the cursor down the left side of the screen, and enter S next to the desired member name.
- Enter SELECT in the Command field.
The LOCATE command also allows you to select a member that is not in the list. In many File-AID for IMS/ISPF functions, selection of a non-existent member causes a new member to be created.
Related topics