Change Alert Action Entry (CHGALRACNE)

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.