Terminating File-AID for IMS/ISPF
File-AID for IMS/ISPF can be terminated in any of the following ways:
- Enter the END command on the Primary Option Menu.
- Enter Option X on the Primary Option Menu.
- Enter the =X jump command on most product screens.
ISPF/PDF termination is described in ISPF/PDF Program Reference.
File-AID for IMS/ISPF can terminate abnormally in any of the following situations:
- When File-AID for IMS detects an unrecoverable error
- When File-AID for IMS itself terminates abnormally
- When the IMS control program abends
When File-AID for IMS detects an unrecoverable error, the Error Display screen shown in the following figure is displayed. The error message is shown at the bottom of the screen.
Error Display Screen - Unrecoverable Error
COMMAND ===>
**********************************************************************
* *
* *
* File-AID for IMS/ISPF HAS TERMINATED ABNORMALLY FOR THE *
* *
* REASON SHOWN BELOW. THE NEXT KEYBOARD INTERACTION WILL *
* *
* RESULT IN A RETURN TO ISPF. *
* *
* *
**********************************************************************
ERROR MSG ID = F305 UNABLE TO ESTABLISH ESTAE DURING DATASET OPEN PROCESSING
When File-AID for IMS itself abnormally terminates, the Error Display screen shown in the following figure is displayed. The system abend code and user code are displayed along with the name and address of the active load module and the contents of the general registers at the time of the abend. This information is useful in diagnosing the cause of the abend.
Error Display Screen - Abnormal Termination
COMMAND ===>
**********************************************************************
* Version: 23.01.00 *
* *
* File-AID for IMS HAS TERMINATED ABNORMALLY DUE TO AN O/S *
* *
* ABEND. PRESS ENTER TO RETURN TO ISPF. *
* *
* *
**********************************************************************
SYSTEM COMPLETION CODE = SOC1 USER CODE = U000
PSW AT TIME OF ERROR 478D0000 00174B4A
ACTIVE LOAD MODULE ADDRESS = 0016F008 OFFSET = 00005B42
NAME = XIXEDITS
R0 000AC928 R1 000AC908 R2 4016F114 R3 00172C18
R4 000B5140 R5 00000000 R6 000B4E58 R7 000B4988
R8 000AC7DE R9 000B5140 R10 000B4988 R11 FF000000
R12 000AA010 R13 000ABC30 R14 4016FA32 R15 00174B48
In both situations, pressing the ENTER key will cause the ISPF abnormal termination screen to be displayed. This screen indicates one of the following abend codes:
2040, 2041, 2042, 2043, 2044 | An error occurred while handling an abend. |
2045, 2047 | An error occurred while establishing or canceling the File-AID for IMS ESTAE environment. |
When the IMS control program abends, the Error Display screen shown in the following figure is displayed. The information displayed is similar to that shown in Error Display Screen - Abnormal Termination. In addition to basic system diagnostics, information concerning the status of IMS may also be displayed.
Error Display Screen - Control Program Abend
COMMAND ===> DATE 12/03/14
TIME 10:35
************************* Version 23.01.00 ***************************
* File-AID for IMS HAS TERMINATED ABNORMALLY DUE TO AN O/S ABEND. *
* PRESS ENTER TO RETURN TO THE FIRST BROWSE/EDIT SCREEN. *
**********************************************************************
PSW AT TIME OF ERROR 478D0000 001F92D8
ACTIVE LOAD MODULE ADDRESS = 00191004 OFFSET = 000682D4
NAME = XIXEDITL
R0 FF2B7D70 R1 002B7C48 R2 401F224C R3 001F48E0
R4 00180AD0 R5 00000000 R6 002AF010 R7 002AF3DC
R8 0017FAD0 R9 00000120 R10 00000000 R11 00000015
R12 002A5010 R13 002B7B60 R14 401F2744 R15 001F9290
SYSTEM ABEND CODE = 0C1 IMS USERCODE = 0000
CHECKPOINT ID = IX000001
While IMS is active, the following types of abends cause this screen to be displayed:
- A system abend
- An IMS user code
- A File-AID for IMS user code
If IMS returns a non-zero user code, the Error Display screen will appear as it does in the following figure. All system diagnostics pertaining to the active load module will be zeros or blanks. Only the user code, status code, checkpoint ID and system message will contain useful information.
Error Display Screen - Control Program Abend
COMMAND ===> DATE 12/03/14
TIME 10:35
************************* Version 23.01.00 ***************************
* File-AID for IMS HAS TERMINATED ABNORMALLY DUE TO AN O/S ABEND. *
* PRESS ENTER TO RETURN TO THE FIRST BROWSE/EDIT SCREEN. *
**********************************************************************
PSW AT TIME OF ERROR 00000000 00000000
ACTIVE LOAD MODULE ADDRESS = 00000000 OFFSET = 00000000
NAME =
R0 00000000 R1 00000000 R2 00000000 R3 00000000
R4 00000000 R5 00000000 R6 00000000 R7 00000000
R8 00000000 R9 00000000 R10 00000000 R11 00000000
R12 00000000 R13 00000000 R14 00000000 R15 00000000
SYSTEM ABEND CODE = 000 USERCODE = 2047
CHECKPOINT ID = IX000000 STATUS CODE = AI
E901 AI - DATA MANAGEMENT ERROR - IMS COULD NOT OPEN YOUR DATA BASE
See OS/VS Message Library: VS2 System Codes Manual for system abend codes. The checkpoint ID displayed identifies the last checkpoint taken before the abend occurred. This sync point may or may not include the latest updates to the database.
Three of the most commonly encountered system abend codes are 106, 80A, and 878. All occur when the amount of remaining storage in your TSO address space is insufficient for File-AID for IMS or IMS to continue processing. When you receive one of these abend codes, terminate your current TSO session and log on with a larger region size.
For File-AID for IMS and IMS user codes, a message that describes the error is displayed at the bottom of the screen. The last checkpoint ID is also shown. If the checkpoint ID is IX000000, a checkpoint was not taken.
See to IBM’s IMS Messages and Codes Reference Manual for IMS user codes. The checkpoint ID identifies the last checkpoint taken before the abend occurred and may or may not include the latest updates to the database.
The File-AID for IMS user code is always 2047, which means File-AID for IMS intercepted the abend. If applicable, an IMS status code is displayed and File-AID for IMS issues a checkpoint prior to termination. In this situation, because the checkpoint was the last action taken before the abend occurred, all your updates are reflected in the database.
Related topics