Delete Alert (DLTALR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DLTOPT | Delete option | *ALL, *RCV, *LOCAL, *HELD | Optional, Positional 1 |
| DAYS | Days | 0-999, 30 | Optional, Positional 2 |
| ALRTYPE | Alert type | Single values: *ALL Other values (up to 5 repetitions): Character value, *TEMP, *PERM, *PERF, *IMPEND, *UNKNOWN |
Optional |
| ALRRSC | Alert resource | Single values: *ALL Other values (up to 50 repetitions): Name |
Optional |
| ALRRSCTYPE | Alert resource type | Single values: *ALL Other values (up to 50 repetitions): Character value |
Optional |
| ASNUSER | User assigned | Single values: *ALL Other values (up to 50 repetitions): Character value, *NONE |
Optional |
| GROUP | Group | Single values: *ALL Other values (up to 50 repetitions): Name, *NONE, *DEFAULT |
Optional |
| Top |
Delete option (DLTOPT)
Specifies which alerts are to be deleted.
- *ALL
- All alerts that meet the selection criteria in the remaining keywords are deleted. If the remaining keywords are defaulted, all of the alerts over 30 days old are deleted.
- *RCV
- Only alerts received from other systems are deleted. Selection criteria for the received alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the received alerts over 30 days old are deleted.
- *LOCAL
- Only locally created alerts are deleted. Selection criteria for the local alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the locally created alerts over 30 days old are deleted.
- *HELD
- All alerts that cannot be sent to the system's focal point and are marked HELD are deleted. Selection criteria for the held alerts can be further specified in the remaining keywords. If the remaining keywords are defaulted, all of the held alerts over 30 days old are deleted.
Note: There is a distinction between held alerts that are sent or forwarded by this system, and held alerts that are received by another system. DLTOPT(*HELD) deletes only held alerts that could not be sent or forwarded by this system (or are currently being held based on the ALRHLDCNT network attribute).
| Top |
Days (DAYS)
Specifies that alerts older than this value are deleted. Alerts that are more recent than this value are not deleted. This value can be 0 or any number of days. Selection criteria can be further specified in the remaining keywords.
- 30
- All alerts over 30 days old are deleted.
- 0-999
- Specify the number of days.
| Top |
Alert type (ALRTYPE)
Specifies which types of alerts are deleted. The alert type indicates the severity of the alert.
Single values
- *ALL
- All types of alerts are deleted.
Other values (up to 5 repetitions)
- *TEMP
- All alerts reporting a temporary problem are deleted.
- *PERM
- All alerts reporting a permanent problem are deleted.
- *PERF
- All alerts reporting a performance problem are deleted.
- *IMPEND
- All alerts reporting an impending problem are deleted.
- *UNKNOWN
- All alerts reporting a problem with unknown severity are deleted.
- character-value
- Specify the code point for the alert type. The code point is specified by two (2) hexadecimal digits.
| Top |
Alert resource (ALRRSC)
Specifies the name of resources that are reporting problems. Up to 50 alert resource names can be specified.
Single values
- *ALL
- Alerts about all failing resources.
Other values (up to 50 repetitions)
- name
- Specify the name of resources that are reporting problems.
| Top |
Alert resource type (ALRRSCTYPE)
Specifies the type of resources that are reporting problems. A maximum of 50 resource types can be specified. Each resource name has a resource type associated with that resource. For example, resource types are diskette (DKT) or tape (TAP).
Single values
- *ALL
- Alerts for all resource types.
Other values (up to 50 repetitions)
- character-value
- Specify the resource type of alerts that are reporting problems associated with the assigned resource type.
| Top |
User assigned (ASNUSER)
Specifies the user to which the alerts being deleted are assigned. This value is taken from the value on the ASNUSER parameter in the Add Alert Action Entry (ADDALRACNE) command.
Single values
- *ALL
- All alerts are deleted.
Other values (up to 50 repetitions)
- *NONE
- The alerts not assigned to a user are deleted.
- character-value
- Specify the name of the user to which the alerts being deleted are assigned.
| Top |
Group (GROUP)
Specifies the group to which the alerts being deleted are assigned. This value is taken from the value on the GROUP parameter in the Add Alert Selection Entry (ADDALRSLTE) command.
Single values
- *ALL
- All alerts are deleted.
Other values (up to 50 repetitions)
- *DEFAULT
- The alerts assigned to the default group are deleted.
- *NONE
- The alerts not assigned to a group are deleted.
- name
- Specify the name of the group to which the alerts being deleted are assigned.
| Top |
Examples
Example 1: Deleting Temporary and Permanent Alert Types
DLTALR DLTOPT(*LOCAL) DAYS(10) ALRTYPE(*TEMP *PERM)
ALRRSCTYPE(DKT)
This command deletes temporary and permanent locally created alerts in the alert database. The alerts that are deleted are reporting problems about diskettes. Alerts more than 10 days old that match these criteria are deleted.
Example 2: Deleting Alerts Associated with Diskette Resources
DLTALR DLTOPT(*RCV) DAYS(0) ALRRSCTYPE(DKT)
This command deletes received alerts associated with diskette resources.
| Top |
Error messages
*ESCAPE Messages
- CPF9807
- One or more libraries in library list deleted.
- CPF9808
- Cannot allocate one or more libraries on library list.
- CPF9812
- File &1 in library &2 not found.
- CPF9822
- Not authorized to file &1 in library &2.
- CPF9845
- Error occurred while opening file &1.
- CPF9846
- Error while processing file &1 in library &2.
- CPF9847
- Error occurred while closing file &1 in library &2.
| Top |