INQUIRE EVENTBINDING

Description

The INQUIRE EVENTBINDING command returns information about a specific event binding.

Browsing

You can browse through all the event bindings that are installed in your region by using the browse options (START, NEXT, and END) on INQUIRE EVENTBINDING commands.

See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

The resource signature

You can use this command to retrieve the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are BUNDLE, CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Options

CHANGEAGENT(cvda)

Returns a CVDA value that identifies the agent that made the last change to the resource definition. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DREPAPI: The resource definition was last changed by a CICSPlex SM BAS API command.

CHANGEAGREL(data-area)

Returns a 4-digit number of the CICS® release that was running when the resource definition was last changed.

CHANGETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.

CHANGEUSRID(data-area)

Returns the 8-character user ID that ran the change agent.

DEFINESOURCE(data-area)

Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.

DEFINETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was created.

ENABLESTATUS (cvda)

Returns a CVDA value indicating the status of this event binding. CVDA values are as follows:

ENABLED: The event binding is enabled.
DISABLED: The event binding is disabled.

EPADAPTER(data-area)

Returns the 32-character name of the EP adapter used by this event binding. If this option is not blank, the option of EPADAPTERSET will be blank. Or vice versa.

EPADAPTERRES (cvda)

Returns a CVDA value indicating whether events are emitted to one or multiple EP adapters. CVDA values are as follows:

EPADAPTER: Events captured by this event binding will be emitted to an EP adapter.
EPADAPTERSET: Events captured by this event binding will be emitted to all EP adapters in an EP adapter set.

EPADAPTERSET(data-area)

Returns the 32-character name of the EP adapter set used by this event binding. If this option is not blank, the option of EPADAPTER will be blank. Or vice versa.

EVENTBINDING(data-value)

Specifies the 32-character name of an event binding.

INSTALLAGENT(cvda)

Returns a CVDA value that identifies the agent that installed the resource. Only one value is possible:

BUNDLE: The resource was installed by a bundle deployment.

INSTALLTIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource was installed.

INSTALLUSRID(data-area)

Returns the 8-character user ID that installed the resource.

USERTAG (data-area)

Returns the 8-character user tag of the event binding.

Conditions

END

RESP2 values:

2: There are no more event bindings to browse.

ILLOGIC

RESP2 values:

1: You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.
101: The user associated with the issuing task is not authorized to read the event binding.

NOTFND

RESP2 values:

3: The specified event binding cannot be found.