DFHTEPT TYPE=PERMCODE|ERRCODE–defining error status elements
DFHTEPT TYPE={PERMCODE|ERRCODE}
,CODE={errcode|BUCKET}
[,COUNT=number]
[,TIME=(number[,SEC|,MIN|,HRS])]
- TYPE={PERMCODE|ERRCODE}
- identifies whether the error code specified in the macro is to
have a permanently reserved or a dynamically assigned ESE. These
macros are required only if permanently reserved ESEs are to be defined,
or if the sample DFHTEP default threshold constants are to be overridden.
These are listed in Table 1.
- PERMCODE
- Identifies the error code specified as having a permanently reserved ESE. Each permanently reserved ESE must be identified by a separate DFHTEPT TYPE=PERMCODE macro. All DFHTEPT TYPE=PERMCODE macros must precede all DFHTEPT TYPE=ERRCODE macros.
- ERRCODE
- Indicates that the error code specified does not require a permanently reserved ESE, but that the sample DFHTEP default threshold constants are to be changed. Each error code requiring a threshold constant change, other than those defined as permanently reserved, must be identified by a separate DFHTEPT TYPE=ERRCODE macro. All DFHTEPT TYPE=ERRCODE macros must follow all DFHTEPT TYPE=PERMCODE macros.
- CODE={errcode|BUCKET}
- identifies the error code referred to by the TYPE=PERMCODE|ERRCODE parameter. These codes are listed in Figure 1. CODE=BUCKET is only applicable to the DFHTEPT TYPE=ERRCODE macro. It is used to override the default threshold constants established for the common error bucket.
- COUNT=number
- can be used in either the DFHTEPT TYPE=PERMCODE or TYPE=ERRCODE macro to override the sample DFHTEP default count threshold (see Table 1). When the number of occurrences of the error type specified reaches the threshold, an error processor normally takes a logic path that causes DFHTACP default actions to be taken. If the number of occurrences is less than the threshold, the error processor normally takes a logic path that overrides the DFHTACP default actions. The updating and testing of the current threshold counts are normally performed by a DFHTEP subroutine that sets a condition code that the error processor can test to determine whether the limit has been reached. If you specify 0 as the number in the COUNT operand, you are not told when the threshold is reached.
- TIME=(number[,SEC|,MIN|,HRS])
- can be used in either the DFHTEPT TYPE=PERMCODE
or TYPE=ERRCODE macros to override the sample DFHTEP default time
threshold (see Table 1). This
operand is only applicable when OPTIONS=TIME is specified on both
the DFHTEPM and DFHTEPT TYPE=INITIAL macros. When the number of occurrences
reaches the threshold specified on the COUNT operand (as already mentioned)
within the interval specified on this parameter, an error processor
normally takes a logic path that causes DFHTACP default actions to
be taken. If the number of occurrences within the interval is less
than the threshold, the error processor normally takes a logic path
that overrides the DFHTACP default actions. If the time interval
has expired, the sample DFHTEP subroutine that normally updates and
tests the current threshold count resets the occurrence counts, and
establishes a new expiration time. In this case, the condition code
set by the subroutine indicates that the thresholds had not been reached.
Time control in the sample DFHTEP starts with the first occurrence of an error type. Subsequent occurrences of the same error type do not establish new starting times, but are accounted for as having occurred within the interval started by the first occurrence. This continues until an error count reaches the threshold within the interval started by the first occurrence, or until the interval has expired. In the latter case, the error being processed becomes a first occurrence, and a new interval is started. A time interval of 0 means that the number of occurrences is to be accounted for and controlled without regard to a time interval. Zero is the implied time interval if the value of the COUNT operand is 0 or 1. It is also the implied time interval if the time options are not generated.
The time interval can be expressed in any one of four units; hours, minutes, seconds, or hundredths of a second. The maximum interval must be the equivalent of less than 24 hours. A practical minimum would be 1 to 2 minutes. This allows for access method retries and the time required to create the task to service each error. The four methods of expressing the threshold time interval are:
- number
- The interval in units of one hundredth of a second. Parentheses are not required if this method is used. The maximum number must be less than 8,640,000 (24 hours).
- (number,SEC)
- The interval in whole seconds, which must be enclosed in parentheses. The maximum number must be less than 86,400 (24 hours).
- (number,MIN)
- The interval in whole minutes, which must be enclosed in parentheses. The maximum number must be less than 1,440 (24 hours).
- (number,HRS)
- The interval in whole hours, which must be enclosed in parentheses. The maximum number must be less than 24.
Table 1 illustrates the default thresholds of the sample terminal error program, referred to in the TYPE, COUNT, and TIME operands of the DFHTEPT TYPE=PERMCODE|ERRCODE macro.
| CODE= | COUNT= | TIME= |
|---|---|---|
| 81 | 3 | (7,MIN) |
| 84 | 1 | 0 |
| 85 | 1 | 0 |
| 87 | 50 (Note 2) | 0 |
| 88 | 1 | 0 |
| 8C | 1 | 0 |
| 8D | 1 | 0 |
| 8E | 1 | 0 |
| 8F | 1 | 0 |
| 90 | 0 | 0 |
| 91 | 0 | 0 |
| 94 | 7 | (10,MIN) |
| 95 (Note 1) | 0 | 0 |
| 96 | 2 | (1,MIN) |
| 97 (Note 1) | 0 | 0 |
| 99 | 1 | 0 |
| 9F (Note 1) | 0 | 0 |
| BUCKET | 5 | (5,MIN) |
- The error processor maintains an error count only. DFHTACP default actions are always taken regardless of the thresholds.
- The error processor uses a threshold "weight" instead of a threshold count (see the source code of the sample DFHTEP).