Work with Alerts (WRKALR)

The Work with Alerts (WRKALR) command shows alerts that are created by your system or received from another system as part of alert focal point services.

Parameters

Keyword	Description	Choices	Notes
DSPOPT	Display option	ALL, RCV, LOCAL, HELD	Optional, Positional 1
PERIOD	Period	Element list	Optional
	Element 1: Start time and date	Element list
	Element 1: Start time	Time, *AVAIL
	Element 2: Start date	Date, BEGIN, CURRENT
	Element 2: End time and date	Element list
	Element 1: End time	Time, *AVAIL
	Element 2: End date	Date, *END
ALRTYPE	Alert type	Single values: ALL Other values (up to 5 repetitions): Character value, PERM, TEMP, PERF, PAFF, 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
OUTPUT	Output	, PRINT	Optional
DETAIL	Detail	BASIC, EXTENDED, *FULL	Optional

Top

Display option (DSPOPT)

Specifies whether alerts received from other systems or alerts created locally are shown. Alerts that cannot be sent to the system focal point and are marked as held are shown.

*ALL: All alerts that are received and locally created are shown.
*RCV: Only alerts received from other systems are shown.
*LOCAL: Only locally created alerts are shown.
*HELD: All alerts that cannot be sent to the system's focal point and are marked as held are shown.
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. DSPOPT(*HELD) shows only held alerts that could not be sent or forwarded by this system.

Period (PERIOD)

Specifies the period of time for which the logged alerts are shown.

Element 1: Start time and date

Element 1: Start time

One of the following is used to specify the starting time at which, or after which, the alert must have been logged. Any alerts logged before the specified time and date are not shown.

*AVAIL

The logged alerts that are available for the specified start date are shown.

time

Specify the start time for the specified start date to indicate which logged alerts are shown. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.

The time can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Element 2: Start date

One of the following is used to specify the start date on which, or after which, the alerts must have been logged. Any alerts logged before the specified date are not shown.

*BEGIN: The logged alerts from the beginning of the log are shown. If *BEGIN is specified, then any time value other than *AVAIL for start time is ignored.
*CURRENT: The logged alerts for the current day that occur between the specified start and end times (if specified) are shown.
date: Specify the start date for which logged alerts are shown. The date must be specified in the job-date format.

Element 2: End time and date

Element 1: End time

One of the following is used to specify the end time before which the alerts must have been logged:

*AVAIL

The logged alerts that are available for the specified end date are shown.

time

Specify the end time for the specified end date to indicate which logged alerts are shown. The time is entered as 4 or 6 digits (hhmm or hhmmss).

The time can be specified with or without a time separator:

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Element 2: End date

One of the following is used to specify the end date before which, or on which, the alerts must have been logged.

*END: The last day on which alerts were logged is the last day for which the logged alerts are shown. If *END is specified, any time value other than *AVAIL for end time is ignored.
date: Specify the end date for the last day for which logged alerts are shown. The date must be specified in the job-date format.

Alert type (ALRTYPE)

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

Single values

*ALL: All types of alerts are shown.

Other values (up to 5 repetitions)

*TEMP: All alerts that report a temporary problem are shown.
*PERM: All alerts that report a permanent problem are shown.
*PERF: All alerts that report a performance problem are shown.
*IMPEND: All alerts that report an impending problem are shown.
*UNKNOWN: All alerts that report a problem with an unknown severity are shown.
*PAFF: All alerts that report a problem with a permanently impaired resource are shown.
character-value: Specify the code point for the alert type. Code points are specified with two (2) hexadecimal digits.

Resource name (ALRRSC)

Specifies the name of resources that are reporting problems.

Single values

*ALL: Alerts associated with all failing resources are shown.

Other values (up to 50 repetitions)

name: Specify an alert resource name. Alerts that are reporting problems associated with that alert resource name are shown.

Alert resource type (ALRRSCTYPE)

Specifies the types of resources that are reporting problems. Each alert resource name has an alert resource type associated with that resource.

Single values

*ALL: Alerts for all alert resource types are shown.

Other values (up to 50 repetitions)

character-value: Specify an alert resource type. Alerts that are reporting problems associated with the assigned alert resource type are shown.

User assigned (ASNUSER)

Specifies the user to which the alerts being shown 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 shown.

Other values (up to 50 repetitions)

*NONE: The alerts not assigned to a user are shown.
character-value: Specify the name of the user to which the alerts being shown are assigned.

Group (GROUP)

Specifies the group to which the alerts being shown 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 shown.

Other values (up to 50 repetitions)

*DEFAULT: The alerts assigned to the default group are shown.
*NONE: The alerts not assigned to a group are shown.
name: Specify the name of the group to which the alerts being shown are assigned.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

Detail (DETAIL)

Specifies the level of detail for a printed listing, if *PRINT was specified on the Output prompt (OUTPUT parameter).

*BASIC: A list of the basic alert information is printed. This information includes the alert resource and type, the date and time of occurrence, the problem identification, the alert description, and the probable cause.
*EXTENDED: An extended list of alert information is printed. This information includes all of the information provided by the *BASIC value, plus all recommended actions and the main details of the alert.
*FULL: Full alert information is printed. This information includes all of the information provided by the *BASIC value, plus all recommended actions and all the details of the alert.

Examples

WRKALR   DSPOPT(*LOCAL)  ALRTYPE(*TEMP *PERM)  ALRRSCTYPE(DKT)

This command allows the user to work with all locally created alerts in the alert database that are both temporary and permanent. The alerts shown are reporting problems about diskettes.

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.