Screen format overview
The heading, which is the first three lines of each display is formatted as follows:
TITLE | SHORT MESSAGE | |
COMMAND/OPTION | SCROLL | |
LONG MESSAGE | ||
Title | Identifies the function that is being performed and, where appropriate, library or data set information. |
Short Message | Indicates current line or column positions, successful completion of a processing function, or error conditions (accompanied by audible alarm). |
Command/Option | Used to enter commands or option selections. |
Scroll | Contains the current scroll amount on screens where scrolling applies. |
Long Message | Displays an expanded explanation of error conditions upon request (this line is normally blank or contains display-only fields). Long messages also appear in pop-up windows. |
Types of Screens
File-AID for IMS displays the following screen types:
- Option Selection
- Data set Specification
- Member List
- Scrollable Data Display
- Unscrollable Data Display
Option Selection Screen
An option selection screen enables you to select an option from a list. The Primary Option Menu, shown in Primary Option Menu, is an example of this type of screen.
Dataset Specification Screen
A dataset specification screen enables you to enter data set names, member names, and other parameters. Many of the fields are pre-formatted with the last value entered. The presence of a highlighted plus (+) or minus (-) sign preceding a dataset input field indicates data set concatenations. For more information, see Dataset concatenation support. The EDIT–Data Base Specification screen, shown in the following figure, is an example of this type of screen.
EDIT - Data Base Specification Screen
COMMAND ===>
ENV: TEST - IMS ENVIRONMENT
Region type . . DLI (DLI or BMP)
+ DBDLIB dataset 1 . . ‘XXXXXXXX.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)
+ Segment/Layout XREF dataset . ‘XXXXXXXX.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)
Member List Screen
A member list screen displays a list of members in a partitioned dataset. Up/down and left/right scrolling is available. The left/right display varies depending upon the type of library for which the member list is displayed. Enter S next to the desired member name to select it. The Segment/Layout XREF Member List screen, shown in the following figure, is an example of this type of screen.
Segment/Layout XREF Member List Screen
COMMAND ===> SCROLL ===> CSR
NAME CONCAT DESCRIPTION CREATED LAST MODIFIED ID
BADDBD 2 02/05/15 02/05/15 14:34 USERID0
BI@DSNDB 4 99/06/10 99/06/10 06:28 USERID0
CUSTPAN 4 02/11/15 02/11/15 14:54 USERID0
DBDBRKDB 2 02/01/25 02/01/25 11:09 USERID0
DBDUNI01 2 TEST CASE 01/12/18 03/01/22 12:01 USERID1
DBDUNI04 2 01/12/18 01/12/18 13:00 USERID1
DBSEGDSN 4 99/06/10 02/06/21 14:47 USERID2
G 2 EMPTY XREF 00/09/25 02/06/18 13:31 USERID2
GREGG 2 02/05/15 02/06/21 09:27 USERID4
HPORDR 4 03/01/13 03/01/13 15:16 USERID4
HPPART 4 03/01/13 03/01/13 15:15 USERID3
HSMVSDB 2 01/12/18 01/12/18 13:01 USERID3
IXDCLT 4 99/04/27 02/06/17 11:10 USERID1
IXDFEMPL 4 EMPLOYEE DATABASE DEDB 99/06/16 99/06/16 15:31 USERID1
IXDFIORD 4 ORDER DEDB 99/06/16 01/08/31 14:15 USERID0
IXDLTM 2 01/03/23 01/03/23 14:32 USERID8
IXHCUST 3 01/02/05 01/02/05 22:39 USERID8
IXHORDR 3 01/02/05 01/02/05 22:41 USERID7
IXHPART 3 01/02/05 01/02/05 22:41 USERID7
IXLCUST 4 99/06/11 02/06/17 10:13 USERID7
IXPCLT 4 99/04/27 99/04/27 09:22 USERID3
Scrollable Data Display
A scrollable data display screen shows database contents or segment layouts. Up/down and, in some cases, left/right scrolling is available. The EDIT - Formatted screen shown in the following figure is an example of this type of screen.
EDIT - Formatted Screen
COMMAND ===> SCROLL ===> PAGE
PARENT ORDR010
SEGMENT ORDR040 CONCATENATED KEY: AA2222,01C7477A
--------LEVEL NUMBER/DATA-NAME--------- -FORMAT- ---------FIELD VALUE----------
01 SCRAP-DATA
05 SCRAP-KEY
07 PROCESS-INDICATOR C 2 K 01
07 PART-NUMBER C 6 K C7477A
05 MATERIAL-TYPE-INDICATOR C 2 RM
05 SCRAP-QTY PS 5 2 2.00
05 REASON-CODE C 2 BS
05 DESCRIPTION C 15 BURNT MATERIAL
05 REWORK-INDICATOR C 1 Y
05 SCRAP-DATE Z 8 19880912
*** END OF LAYOUT. LENGTH = 40 ***
ENTER UNFMT TO SWITCH TO UNFORMATTED MODE, CHAR TO SWITCH TO CHARACTER MODE
Un-scrollable Data Display
An un-scrollable data display screen shows non-repeating information that fits on a single screen. The EDIT XREF–Logical Child screen shown in the following figure is an example of this type of screen.
EDIT XREF - Logical Child Screen
COMMAND ===>
DATA BASE: PORDR SEGMENT: ORDRCUST
Specify COBOL information for Logical Child segment:
----------------- Destination Parent Concatenated Key (DPCK) ------------------
DPCK included in the first COBOL MBR below ===> N (Y = Yes; N = No)
If no, specify the length of the DPCK ===> 8
------------------- COBOL Member - Defines LCHILD Segment Data ----------------
Specify COBOL MBR ===> ORDR050 (Blank if LCHILD is KEY-ONLY)
Starting Data-name ===> (Blank for entire mbr)
Note - There are 2 portions to a Concatenated segment:
1. Destination Parent Concatenated Key (Total DPCK Key Length = 8)
2. Logical Child Data DBD: PORDR Segment: ORDR050
Enter END command to return to the Segment/Layout XREF Segment List screen
Scrolling
In many File-AID for IMS/ISPF functions, the information displayed exceeds the screen size. The scrolling commands enable you to move the information up or down, right or left to view all the displayable data. In addition, the LOCATE command can be used on some screens to scroll to a specified line number or data-name.
Scrolling Commands
Command | Scrolling Function |
|---|---|
UP | Scrolls toward the top of a segment, database, segment layout, or member list by the specified scroll amount. |
DOWN | Scrolls toward the end of a segment, database, segment layout, or member list by the specified scroll amount. |
LEFT | Scrolls toward the left margin of the displayed segments. Left scrolling is available on the Browse/Edit Character screen only. |
RIGHT | Scrolls toward the right margin of the displayed segments. Right scrolling is available on the Browse/Edit Character screen only. |
LOCATE | Scrolls directly to a specified line number, segment layout data-name, or member name. |
A scroll amount is displayed on line two of screens that allow scrolling. The value indicates the number of lines or columns to scroll when you enter one of the four page scrolling commands. You can change the scroll amount by simply typing over the scroll amount.
Following are the valid scroll amounts:
A number from 1 to 9999
The number of lines/columns to scroll.
PAGE | Scroll by one logical page. |
DATA | Scroll by one logical page less one line. |
HALF | Scroll by half of a logical page. |
MAX | Scroll to the top, bottom, or left/right margin, depending on which scrolling command is used. |
CUR | Scroll based on the current position of the cursor. The scrolling command that is used will make the line or column where the cursor is positioned to be moved to the top, bottom, left, or right of the screen. If the cursor is not in the body of the data or if it is already positioned at the top, bottom, or left/right margin, a full page scroll occurs. |
For scrolling purposes, a page is defined as the amount of information that is currently visible on the logical screen. In split screen mode, for example, the edit Character display might have 12 lines by 60 columns of scrollable data. In this case, a scroll amount of HALF would move the window up or down by 6 lines, or right or left by 30 columns.
The current scroll amount is saved in the user profile. When you type over the scroll amount, the new value remains in effect until you change it again.
You can enter a scroll amount in the Command field and use a scroll command or PF key to override the current scroll amount on a given interaction. For example, you can enter:
COMMAND ===> DOWN 5
and press Enter, or
COMMAND ===> 5
and press the DOWN PF key.
Either format results in a temporary, one-time override of the scroll amount.
To reduce keystrokes, change the scroll amount by typing over the first character in the scroll amount field.
To change the scroll amount to PAGE, DATA, HALF, MAX, or CUR, type over the first character with P, D, H, M, or C, respectively.
To change the scroll amount to a number of lines or columns, type a number over the first character.
Split Screen
You can enter split screen mode and use the SWAP primary command in File-AID for IMS/ISPF exactly as you do in ISPF/PDF. These features are described in the ISPF/PDF Program Reference.
File-AID for IMS/ISPF allows only one active browse or edit database conversation per user. If you are in split screen mode and browsing or editing a database on one logical screen, you cannot enter Option 1 or 2 on the other logical screen. When you are in Option 1 or 2 on one logical screen, you can enter another File-AID for IMS/ISPF option (other than Option 1 or 2) or an ISPF option on the other logical screen.
Help Function
The Help function enables you to obtain additional information about a message displayed in the upper right corner of the screen or to enter the tutorial.
If you enter the HELP command immediately after a message is displayed, a one-line explanation is displayed on line three of the screen. If this explanation is not sufficient, you can obtain further information by entering the HELP command again to invoke the appropriate section of the tutorial (See Using-File-AID-for-IMS-ISPF-tutorial). If you enter the HELP command when a message is not displayed, you will enter the appropriate section of the tutorial.
Once in the tutorial, enter the END command to return to the screen that was displayed when you originally requested help.