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:

  1. Log the alert based on the ALRLOGSTS network attribute.
  2. Send the alert to this system's focal point.
  3. 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.
  4. Place an alert notification on data queue ALERTDTAQ.
  5. 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