gtpo1m1cOperations

ZASER-Alter System Error Options

Use this command to change the system error options and the SNAP dump options. These options control the amount and type of data written to the system console and the dump device when a system error dump (SERRC) or SNAP dump (SNAPC) occurs. These options also control the amount and type of data passed to the dump data user exit.

Requirements and Restrictions

None.

Format




Snap
indicates that the specified options are SNAP dump options. If you do not specify the SNAP parameter, the specified options are assumed to be system error options.

option
is one or more of the following system error or SNAP dump options:
Option System Error SNAP Dump
CONSALL
Causes the SNAP routines to write a message and as many as 1024 bytes of SNAP data to the system console whenever a SNAP error is generated. (SNAP data is the data identified by one or more LISTC macro calls associated with the SNAPC macro.)
CONSDMP Causes the system error routine to log a message to the system console whenever a dump is generated. NODUMP messages are suppressed.
CONSMSG
Causes the SNAP routines to log a message to the system console whenever a SNAP error is generated.
CONSOFF Causes the system error routine to stop logging all error information to the system console. Causes the SNAP routines to stop logging all error information to the system console.
CONSON Causes the system error routine to log a message to the system console whenever an error occurs.
DATAX Causes the system error routine to pass SNAPC and SERRC dump data to the dump data user exit.
DUMPMSG
Causes SNAP messages to be written to the dump device.
DUMPOFF Causes the system error routine to stop logging all error information to the dump device. NODUMP is substituted in place of the system dump number in the console message. No system error information is passed to the dump data user exit. Manual dumps are not affected. Causes the SNAP routines to stop logging all error information to the dump device. No SNAPC data is passed to the dump data user exit.
DUMPON Causes system error dumps to be written to the dump device. System error information is passed to the dump data user exit if the DATAX option is specified. Causes SNAP dumps to be written to the dump device. SNAPC data is passed to the dump data user exit if the DATAX option is specified.
DUPL If an ECB-controlled program generates the same system error more than once, each occurrence of the error generates an OPR dump. If the same SNAP error is generated more than once, each occurrence of the error generates a SNAP dump.
LOG Causes the system error routine to log a message to the real-time dump tape whenever an error occurs.
LONG Includes the information contained in SHORT and MEDIUM dumps in OPR dumps. Permanent storage is also included in dumps following the ECB working storage.
MEDIUM Includes information contained in SHORT dumps as well as the following information in OPR dumps:
  • Collated macro trace
  • Collated I/O trace
  • Branch trace
  • Information about other instruction streams
  • Storage areas around the registers
  • Failing instructions.

NODATAX Causes the system error routine to stop passing dump data to the dump data user exit.
NODUPL If an ECB-controlled program generates the same system error more than once on the same subsystem, only the first occurrence of the error generates an OPR dump. Subsequent dumps are not generated and only the message is passed to the dump data user exit. NODUMP is substituted in place of the system dump number in the console message.
Note:
This option applies only to OPR dumps. System (CTL) and manual dumps are generated regardless of the setting of this option.
If the same SNAP error is generated more than once, only the first occurrence of the error generates a SNAP dump. Subsequent dumps are not generated.
NOLOG Causes the system error routine to stop logging messages to the real-time dump tape.
PRT Causes all system error dumps to be written to the real-time printer when the in-core dump formatter (ICDF) is loaded to the TPF system. Causes the SNAP dumps to be written to the real-time printer when ICDF is loaded to the TPF system.
PRT ECB CNTRLD Causes OPR dumps to be written to the real-time printer when ICDF is loaded to the TPF system. System (CTL) dumps are still written to the real-time dump tape.
SHORT Includes only the ECB, the working storage associated with the ECB, and the prefix of the failing instruction stream in OPR dumps.
TAPE Causes system error dumps to be written to the real-time dump tape. Causes the SNAP dumps to be written to the real-time dump tape.
THEAPON Includes the heap storage of the entire process if the ECB is running in a threaded environment.
THEAPOFF Does not include any ECB heap storage if the ECB is running in a threaded environment.

Additional Information

Examples

In the following example, a request is made to log system error messages to tape, to the operator console, and to route OPR dumps to the real-time processor.

+--------------------------------------------------------------------------------+
|User:   ZASER LOG CONSON PRT ECB CNTRLD                                         |
|                                                                                |
|System: ASER0000I 15.28.54 - OK                                                 |
+--------------------------------------------------------------------------------+

In the following example, a request is made to suppress duplicate dumps and to write SNAP messages and dump data to the operator console.

+--------------------------------------------------------------------------------+
|User:   ZASER SNAP NODUPL CONSALL                                               |
|                                                                                |
|System: ASER0000I 15.28.54 - OK                                                 |
+--------------------------------------------------------------------------------+

Related Information

See TPF General Macros for more information about system error dumps (SERRC) and SNAP dumps (SNAPC).