INGEVENT

Purpose

The INGEVENT command sets or resets a particular event for all affected resources in a sysplex, or for specific resources. The event state is persistent across NetView recycles and IPLs. For information on request persistence, see Manager data persistence during a COLD or WARM start.

Syntax

Read syntax diagramSkip visual syntax diagramINGEVENTeventREQ=SETRESET|UNSETRESOURCE= */*/*RESOURCE= resourceTARGET=system_namedomain_IDsaplex_nameWAIT=YESWAIT=NOWAIT= nnn

Parameters

event
Specifies the name of the event.
REQ
Specifies the request to be performed. It can have the following values:
SET
Sets the event for all resources having the event defined.
RESET|UNSET
Resets or unsets the event for all resources having the event defined.

Note that RESET and UNSET are synonyms.

RESOURCE
Specifies the name of the resource where INGEVENT should be effective. It can be abbreviated to RES. The format is name/type[/system]
TARGET
For information on the TARGET parameter, see TARGET Parameter.
WAIT
Specifies whether or not to wait until the request is complete.

nnn is the number of seconds to wait before giving up and reporting that a timeout has occurred. The maximum time interval is 999 seconds.

Restrictions and Limitations

Standards wildcards are not supported neither for the event name nor for the resource. Instead, the '*' mentioned for the RESOURCE parameter are positional replacements for the entire component. Whilst it is not allowed to specify partial AM resources, the '*' can be used as a full replacement for either name, type, or system.

Examples of valid/invalid syntax

  1. Event name with unsupported wildcard:
    INGEVENT TEST* REQ=SET RES=*/*/*
--> AOF432I INVALID EVENT NAME
  2. Resource specification with unsupported wildcards:
    INGEVENT TESTEVT REQ=UNSET RES=DIP*/*/KEY7
INGEVENT TESTEVT REQ=UNSET RES=*/A*/KEY7
INGEVENT TESTEVT REQ=UNSET RES=*/*/KEY*
--> AOF478I WILDCARDS ARE NOT SUPPORTED.
  3. Resource specification with placeholders to denote ALL resources of either name, type, or system:
    INGEVENT TESTEVT REQ=SET RES=DIPTFXIT#2/*/KEY7
INGEVENT TESTEVT REQ=SET RES=DIPTFXIT#2/APL/*
INGEVENT TESTEVT REQ=SET RES=*/APL/KEY7

Usage

The INGEVENT command operates sysplexwide. For an overview see Overview of Commands that Operate Sysplexwide.

Examples

To set an event for all resources that are linked to that event, type the following: 
INGEVENT B000P100 REQ=SET
The command response is as follows: 
 IPUFA    AOF442I SET EVENT B000P100 DONE FOR RESOURCE */*/* ON AOCPLEX. -
          FROM=AOCA
 IPUFA    AOF099I FUNCTION COMPLETED