Add Alert Action Entry (ADDALRACNE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Alert Action Entry (ADDALRACNE) command allows the user to add an action entry to the specified alert filter. This entry describes the actions that should be taken for an alert that has been assigned to the specified group. More information on alerts is in the Alerts Support book, SC41-5413.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FILTER | Filter | Qualified object name | Required, Positional 1 |
| Qualifier 1: Filter | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| GROUP | Group | Name | Required, Positional 2 |
| LOG | Log alert | *YES, *NO, *NETATR | Optional |
| ASNUSER | User assigned | Character value, *NONE | Optional |
| SEND | Send to system | Single values: *NONE 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 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 | *NO, *YES | Optional |
| Top |
Filter (FILTER)
Specifies the filter to which the action entry is to be added.
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 name to which the defined actions are to be applied. The group name is assigned from the selection criteria in the filter.
This is a required parameter.
- name
- Specify the group name.
| Top |
Log alert (LOG)
Specifies whether the alert is logged.
- *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 to be assigned to the alert.
- *NONE
- No user is specified.
- character-value
- Specify a user name.
| Top |
Send to system (SEND)
Specifies the destination to which the alert is to be sent. An alert cannot be sent to the local system. The system checks for this action when the alert is sent.
Single values
- *NONE
- The alert is not sent.
Other values (up to 5 repetitions)
Element 1: Network identifier
- *FOCALPT
- Sends the alert to the system focal point. The focal point system is determined at send time.
- *NETATR
- The LCLNETID value specified in the system network attributes is used.
- communications-name
- Specify the network ID of the destination node.
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 an alert notification record is placed. Keyed data queues are supported.
The data queue name can be qualified by one of the following library values:
Single values
- *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.
- *NO
- An SNMP trap is not generated from this alert.
- *YES
- An SNMP trap is generated from this alert.
| Top |
Examples
ADDALRACNE FILTER(MYLIB/MYFILTER) GROUP(CHICAGO)
LOG(*NETATR) ASNUSER(CHICAGOOPR)
SEND((*FOCALPT) (*NETATR.MILWKEE))
SNDDTAQ(*LIBL/ALERTDTAQ)
This command defines the following actions for group CHICAGO:
- Log the alert based on the ALRLOGSTS network attribute.
- 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.
- Place an alert notification on data queue ALERTDTAQ.
- Assign the alert to user CHICAGOOPR.
| Top |
Error messages
*ESCAPE Messages
- CPF2150
- Object information function failed.
- CPF2151
- Operation failed for &2 in &1 type *&3.
- CPF812F
- Filter damaged.
- CPF91DB
- Group &4 already exists.
- 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 |