DLTALR (Delete Alert)

DLTALR Command syntax diagram

 

Purpose

The Delete Alert (DLTALR) command deletes one or more alerts from the alert data base.

 

Optional Parameters

DLTOPT

Specifies which alerts are being deleted.

*ALL: Alerts that meet the selection criteria specified by the remaining parameters are deleted.

*RCV: Only alerts received from other systems are deleted. Selection criteria for the alerts received can be further specified on the remaining parameters.

*LOCAL: Only locally created alerts are deleted. Selection criteria for the local alerts can be further specified on the remaining parameters.

*HELD: Alerts that cannot be sent to the system's focal point and that are marked HELD are deleted. Selection criteria for the held alerts can be further specified on the remaining parameters.

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 (alerts that are currently being held based on the ALRHLDCNT network attribute).

DAYS

Specifies that alerts older than this value are deleted. Any alert that is more recent than this value is not deleted.

30: Alerts over 30 days old are deleted.

number-of-days: Specify the number of days after which all alerts are deleted.

ALRTYPE

Specifies which types of alerts are deleted. The alert type indicates the severity of the alert.

*ALL: All types of alerts are deleted.

*TEMP: Alerts reporting a temporary problem are deleted.

*PERM: Alerts reporting a permanent problem are deleted.

*PERF: Alerts reporting a performance problem are deleted.

*IMPEND: Alerts reporting an impending problem are deleted.

*UNKNOWN: Alerts reporting a problem with unknown severity are deleted.

alert-type-code-point: Specify the code point for the alert type. The code point is specified by two (2) hexadecimal digits.

ALRRSC

Specifies the name of resources that are reporting problems.

*ALL: All resources are reporting problems.

resource-name: Specify the names of the resources reporting problems.

ALRRSCTYPE

Specifies the types of resources that are reporting problems. Each resource name has an associated resource type. For example, diskette (DKT) and tape (TAP) are resource types.

*ALL: All types of resources are reporting problems.

resource-type: Specify the resource type that is reporting problems.

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.

*ALL: All alerts are deleted.

*NONE: The alerts not assigned to a user are deleted.

user-name: Specify the name of the user to which the alerts being deleted are assigned.

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.

*ALL: All alerts are deleted.

*DEFAULT: The alerts assigned to the default group are deleted.

*NONE: The alerts not assigned to a group are deleted.

group-name: Specify the name of the group to which the alerts being deleted are assigned.

Examples for DLTALR

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.

Error messages for DLTALR

*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.