Change Alert Action Entry (CHGALRACNE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Alert Action Entry (CHGALRACNE) command allows the user to change an action entry in the specified alert filter. More information on alerts is in the Alerts Support book, SC41-5413.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FILTER | Filter | Qualified object name | Required, Key, Positional 1 |
| Qualifier 1: Filter | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| GROUP | Group | Name, *DEFAULT | Required, Key, Positional 2 |
| LOG | Log alert | *YES, *NO, *NETATR, *SAME | Optional |
| ASNUSER | User assigned | Character value, *NONE, *SAME | Optional |
| SEND | Send to system | Single values: *NONE, *SAME Other values (up to 5 repetitions): Element list |
Optional |
| Element 1: Network identifier | Communications name, *NETATR, *FOCALPT | ||
| Element 2: Control point | Communications name | ||
| SNDDTAQ | Send to data queue | Single values: *NONE, *SAME Other values (up to 5 repetitions): Element list |
Optional |
| Element 1: Data queue | Qualified object name | ||
| Qualifier 1: Data queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| Element 2: Data queue key | Character value, *NONE, X'' | ||
| GENTRAP | Generate SNMP trap | *SAME, *NO, *YES | Optional |
| Top |
Filter (FILTER)
Specifies the filter which contains the action entry being changed.
This is a required parameter.
Qualifier 1: Filter
- name
- Specify the name of the filter.
Qualifier 2: Library
- *LIBL
- All libraries in the job's library list are searched until the first match is found.
- *CURLIB
- The current library for the job is used to locate the filter. If no library is specified as the current library for the job, the QGPL library is used.
- name
- Specify the name of the library where the filter is located.
| Top |
Group (GROUP)
Specifies the group of actions being changed.
- *DEFAULT
- The default action entry that was automatically added when the filter was created is changed.
- name
- Specify the name of the group to which the defined actions are to be applied.
| Top |
Log alert (LOG)
Specifies whether to log the alert.
- *SAME
- The LOG action is not changed.
- *NETATR
- The ALRLOGSTS network attribute controls the logging of this alert.
- *YES
- The alert is logged.
- *NO
- The alert is not logged.
| Top |
User assigned (ASNUSER)
Specifies the user assigned to the alert.
- *SAME
- The ASNUSER action is not changed.
- *NONE
- No user is assigned to the alert.
- character-value
- Specify a user name.
| Top |
Send to system (SEND)
Specifies the destination to which the alert is sent.
Single values
- *SAME
- The destination does not change.
- *NONE
- The alert is not sent.
Other values (up to 5 repetitions)
Element 1: Network identifier
- *NETATR
- The network attribute for the local network ID is used.
- *FOCALPT
- The alert is sent to the system focal point. The focal point system is determined at send time.
- communications-name
- Specify the network ID of the destination system.
Element 2: Control point
- communications-name
- Specify the control point name of the destination system.
| Top |
Send to data queue (SNDDTAQ)
Specifies the data queue in which the alert notification record is placed. Keyed data queues are supported.
Single values
- *SAME
- The data queue does not change.
- *NONE
- No data queue is used.
Other values (up to 5 repetitions)
Element 1: Data queue
Qualifier 1: Data queue
- name
- Specify the name of the data queue.
Qualifier 2: Library
- *LIBL
- All libraries in the job's library list are searched until the first match is found.
- *CURLIB
- The current library for the job is used to locate the data queue. If no library is specified as the current library for the job, the QGPL library is used.
- name
- Specify the name of the library where the data queue is located.
Element 2: Data queue key
- *NONE
- No key is used on the data queue.
- character-value
- Specify the data queue key.
| Top |
Generate SNMP trap (GENTRAP)
Specifies whether the alert generates an SNMP trap.
- *SAME
- The GENTRAP action is not changed.
- *NO
- An SNMP trap is not generated from this alert.
- *YES
- An SNMP trap is generated from this alert.
| Top |
Examples
CHGALRACNE FILTER(MYLIB/MYFILTER) GROUP(CHICAGO)
LOG(*SAME) ASNUSER(CHICAGOOPR)
SEND((*FOCALPT) (*NETATR.MILWKEE)) SNDDTAQ(*SAME)
This command changes actions for group CHICAGO to the following:
- Use the same LOG action.
- Send the alert to this system's focal point.
- Send the alert to the system with control point name MILWKEE and a network id based on the LCLNETID value specified in the system network attributes.
- Use the same SNDDTAQ action.
- Assign the alert to user CHICAGOOPR.
| Top |
Error messages
*ESCAPE Messages
- CPF812F
- Filter damaged.
- CPF91DD
- Action entry for group &4 not found.
- CPF91DE
- Filter &1/&2 at maximum size.
- CPF91EB
- Filter type &3 not correct for this operation.
- CPF91EC
- Internal processing error occurred.
- CPF91E8
- Internal processing error occurred.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9803
- Cannot allocate object &2 in library &3.
- CPF9807
- One or more libraries in library list deleted.
- CPF9808
- Cannot allocate one or more libraries on library list.
- CPF9830
- Cannot assign library &1.
| Top |