Work with Alerts (WRKALR)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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 | 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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
- The output is printed with the job's spooled output.
| Top |
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.
| Top |
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.
| 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 |