gtpo1m1c | Operations |
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
|
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:
|
|
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.
| 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
ZASER HELP
ZASER ?
ZASER SNAP HELP
ZASER SNAP ?
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).