INQUIRE EPADAPTERSET
Retrieve information about a specified event processing adapter set.
Description
The INQUIRE EPADAPTERSET command returns information about an EP adapter set.
Browsing
You can browse through all the event processing adapters that are installed in your region by using the browse options (START, NEXT, and END) on INQUIRE EPADAPTERSET 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 EP adapter set. The CVDA values are
as follows:
- ENABLED
- The EP adapter set is enabled.
- DISABLED
- The EP adapter set is disabled.
- EPADAPTERNUM(data-area)
- Returns the number of EP adapter names specified in this EP adapter set.
- EPADAPTERSET(data-area)
- Specifies the name (1-32 characters) of an EP adapter set. You must specify this option to retrieve details of a particular EP adapter set by name. On the browse form of this command, you must provide a 32-character data area to receive the name of the EP adapter set.
- 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.
Conditions
- END
- RESP2
values:
- 2
- There are no more EP adapter sets 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 issue the INQUIRE EPADAPTERSET command.
- 101
- The user associated with the issuing task is not authorized to read the EP adapter set.
- NOTFND
-
RESP2 values:
- 3
- The specified EP adapter set cannot be found.