Controlling I/O Exceptions

All I/O exceptions cause the TASKVALUE attribute to be set to 1; however, DUMPALL gives you an opportunity to react to these exceptions when it executes a LIST, COPY, CAT, or TEST command.

If DUMPALL is

  • In interactive mode, you can respond through the remote file that is open at the remote device.

  • Not in interactive mode, you can respond by using the AX system command.

Depending on the type of exception and the command being executed, DUMPALL displays an appropriate set of options.

When a response is required and DUMPALL is not in interactive mode, DUMPALL displays the nature of the error and waits for you to return AX input. The DUMPALL task appears in the waiting mix entry list as shown in the following example:

6757/7118 50 *SYSTEM/DUMPALL
ACCEPT:PLEASE ENTER SHOW, CONT, OR QUIT

The following is a valid response at the operator display terminal (ODT):

7118 AX CONT

Example 1

If the Y system command is used on the waiting entry, the RSVP message portion of the response contains the entire message. Example 1 shows an example input and response:

7118 Y
STATUS OF TASK 7118 AT 9:34:58
PRIORITY = 50
ORIGINATION: LSN 509
USERCODE: USER
STACK STATE: WAITING ON AN EVENT
PROGRAM NAME: *SYSTEM/DUMPALL
RSVP:ACCEPT:PLEASE ENTER SHOW, OR QUIT.
ERROR ON INPUT FILE: (USER)A/FILE ON MYPACK
PARITY ERROR (RECORD = 9675 BLOCK = 387 FILE #1)
SHOW WILL PRINT THE CONTENTS OF THE BUFFER AND CONTINUE.
CONT WILL SKIP THE RECORD AND CONTINUE.
QUIT WILL TERMINATE THE CURRENT COMMAND.

Example 2

If DUMPALL is executed from a data comm terminal, the same message as shown in Example 1 is displayed on the terminal. Example 2 shows this kind of message display:

7118 ACCEPT:PLEASE ENTER SHOW, CONT, OR QUIT
ERROR ON INPUT FILE: (USER)A/FILE ON MYPACK
PARITY ERROR (RECORD = 9675 BLOCK = 387 FILE #1)
SHOW WILL PRINT THE CONTENTS OF THE BUFFER AND CONTINUE.
CONT WILL SKIP THE RECORD AND CONTINUE.
QUIT WILL TERMINATE THE CURRENT COMMAND.

Example 3

Example 3 shows a valid response at the data comm terminal:

? AX CONT

Example 4

If DUMPALL is running in interactive mode, the system displays the same message as shown in Example 1 at the remote device. The task then waits for your response. The display and response are presented and received by means of the remote file as shown in Example 4:

PLEASE ENTER SHOW, CONT, OR QUIT
ERROR ON INPUT FILE: (USER)A/FILE ON MYPACK
PARITY ERROR (RECORD = 9675 BLOCK = 387 FILE #1)
SHOW WILL PRINT THE CONTENTS OF THE BUFFER AND CONTINUE.
CONT WILL SKIP THE RECORD AND CONTINUE.
QUIT WILL TERMINATE THE CURRENT COMMAND.

Example 5

Example 5 shows a valid response at the remote device:

CONT

Depending on the command, one or more of the following options are allowed:

Option

Purpose

SHOW

Prints the contents of the buffer. DUMPALL continues processing the command.

CONT

Skips this record and continues processing the command.

NEXT

Switches to the next reel and continues processing the command. This option is provided only on files whose KIND attribute has the value TAPE, where an END OF TAPE exception has occurred.

QUIT

Terminates the current command. If an output file is being created, it is saved. If DUMPALL is in interactive mode, the next command is requested. If it is not in interactive mode, DUMPALL terminates.

The following are recommendations regarding exceptions:

Exceptions

Recommendations

For LIST and TEST commands

PARITY, DATA ERROR, and END OF TAPE exceptions defer to you for response. If it is not in interactive mode, DUMPALL terminates. The available options for an END OF TAPE exception are HELP, NEXT, and QUIT. For PARITY and DATA ERROR exceptions, the options are HELP, SHOW, CONT, and QUIT. All other exceptions display an error message and terminate the current command.

For input files on CAT and COPY commands

PARITY, DATA ERROR and END OF TAPE exceptions defer to you for direction. If it is not in interactive mode, DUMPALL terminates. The available options for an END OF TAPE exception are HELP, NEXT, and QUIT. For PARITY and DATA ERROR exceptions, the options are HELP, CONT, and QUIT. All other exceptions except SHORTBLOCK display an error message, terminate the current command.

For input files on CAT, COPY, LIST, and TEST commands

A SHORTBLOCK exception occurs in certain cases when the size of a data block read from an input tape is less than the BLOCKSIZE of the file. The SHORTBLOCK exception displays an error message. You also see messages about the options you can take, such as SHOW, CONT, and QUIT.

For example, if you enter the command COPY UL E 95 380 to NEWFILE, and the tape file contains 378 characters per block, you receive a SHORTBLOCK error. This message occurs because 378 is 2 bytes less than the 380 specified in the command.

For output files on CAT and COPY commands

All exceptions defer to you. The available options for an END OF TAPE exception are HELP, NEXT, and QUIT. In all other cases, the options are HELP, CONT, and QUIT.