WRKALR (Work with Alerts)

WRKALR Command syntax diagram

 

Purpose

The Work with Alerts (WRKALR) command allows the user to work with alerts that were created by the user's system or received from another system.

More information on alerts is in the Alerts Support book.

 

Optional Parameters

DSPOPT

Specifies whether alerts received from other systems and/or created locally are shown. Alerts that cannot be sent to the system focal point and are marked held can be 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 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

Specifies the period of time for which the logged data is shown. The following values can be coded in this parameter, which contains two lists of two elements each. If PERIOD is not specified, the following values are assumed:

PERIOD((*AVAIL *BEGIN)
    (*AVAIL *END))

Element 1: Starting Time

One of the following is used to specify the time at or after which the data must have been logged to be shown. Any entries logged before the specified time and date are not shown.

*AVAIL: The logged data that is available for the specified starting date is shown.

start-time: Specify the starting time for the specified starting date that indicates the logged data that is shown. The time is specified in 24-hour format with or without a time separator as follows:

• With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue 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 fails.
• Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.

Element 2: Starting Date

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

*BEGIN: The logged data from the beginning of the log is shown.

Note:

If *BEGIN is specified, then any time value other than *AVAIL for start-time is ignored.

*CURRENT: The logged data for the current day and between the specified starting and ending times (if specified) is shown.

start-date: Specify the date for which logged data is shown. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.

Element 3: Ending Time

One of the following is used to specify the ending time before which the data must have been logged.

*AVAIL: The logged data that is available for the specified ending date is shown.

end-time: Specify the ending time for the specified ending date that determines the logged data that is shown. See the description of start-time for details about how time can be specified.

Element 4: Ending Date

One of the following is used to specify the ending date before which or on which the data must have been logged.

*END: The last day on which data was logged is shown. If PERIOD(*END) is specified, a time value other than *AVAIL for end-time is ignored.

end-date: Specify the ending date for which logged data is to be shown. The date must be entered in the format specified by the system values QDATFMT and, if separators are used, QDATSEP.

ALRTYPE

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

*ALL: All types of alerts are shown.

Up to five of the following types of alerts can be specified.

*TEMP: Alerts reporting a temporary problem are shown.

*PERM: Alerts reporting a permanent problem are shown.

*PERF: Alerts reporting a performance problem are shown.

*IMPEND: Alerts reporting an impending problem are shown.

*PAFF: Alerts reporting a problem about a permanently affected resource are shown. These alerts indicate that their originator has determined that the target resource is lost because of a persistent error in a resource other than the target.

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

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 resource name of alerts that are reporting problems. Up to 50 resource names can be specified.

*ALL: Alerts about failing resources are shown.

resource-name: Alerts that are reporting problems associated with the assigned resource name are shown.

ALRRSCTYPE

Specifies the resource types of alerts that are reporting problems. Up to 50 resource types can be specified. Each resource name has a resource type associated with that resource. Resource types are diskette (DKT) or tape (TAP), for example.

*ALL: Alerts for all resource types are shown.

resource-type: Alerts that are reporting problems associated with the assigned resource type are shown.

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.

*ALL: All alerts are shown.

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

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

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.

*ALL: All alerts are shown.

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

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

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

OUTPUT

Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

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

Specifies the level of detail contained in the printed listing. This parameter is valid only if OUTPUT(*PRINT) is specified.

*BASIC: The output is a list of the alert resource, alert type, date, time, problem ID, assigned user, group assigned, alert description, and probable cause. The information on this list is only for alerts that meet requirements set by the subsetting parameters.

*EXTENDED: The output is a spool file containing the WRKALR screen information, alert hierarchy, probable cause and recommended action, and details from the main detail panel. The spool file contains information only for the alerts that meet the user criteria.

*FULL: The output is a spool file containing the same data as the *EXTENDED value output, plus additional information from the detail menu screens. Only the panels that contain data are printed.

Example for WRKALR

WRKALR  DSPORT(*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 for WRKALR

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