CEMT INQUIRE EPADAPTER

Retrieve information about an EP adapter.

In the CICS Explorer, the EP adapater operations view provides a functional equivalent to this command.

The resource signature

You can use this command to display 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 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.

Input

Press the Clear key to clear the screen and enter CEMT INQUIRE EPADAPTER to obtain information about the EP adapter.

CEMT INQUIRE EPADAPTER

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE EPADAPTER ALL( value)ENABLEDDISABLEDWMQHTTPTRANSTARTTSQUEUECUSTOMCBECBERCCECFEDSIEWBEUSERSYNCHRONOUSASYNCHRONOUSTRANSNONTRANSATTACHLINKPROGRAM( value)TRANSACTION( value)CONTEXTDEFAULTREGIONUSERIDAUTHUSERID( value)HIGHNORMALCONFIGDATA1( value)INSTALLTIME( date time)INSTALLUSRID( value)BUNDLEDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPICHANGEAGREL( value)

Displayed fields

ADAPTERTYPE
Displays the type of this EP adapter. The possible values are as follows:
CUSTOM
A user-written EP adapter that emits events in any format that you require, to any destination.
HTTP
The HTTP EP adapter that emits events to an HTTP server for consumption by products such as IBM® Operational Decision Manager and IBM Business Monitor.
TRANSTART
The Transaction Start EP adapter that emits events to a named CICS® transaction.
TSQUEUE
The TSQ EP adapter that emits events to a named CICS temporary storage queue.
WMQ
The WebSphere® MQ EP adapter that emits events to IBM MQ for consumption by products such as IBM Operational Decision Manager and IBM Business Monitor.
AUTHORITY
Displays the authority of the EP adapter. The possible values are as follows:
CONTEXT
The EP adapter runs using the user ID of the task that caused the event to be captured. This is always the case when EMITMODE is SYNCHRONOUS or when Use Context user ID is specified in the advanced section of the Adapter tab for the EP adapter.
Default
The EP adapter runs using the CICS default user ID.
REGION
The EP adapter runs using the CICS region user ID.
USERID
The EP adapter is attached using the identifier specified in the EP adapter user ID and returned in the AUTHUSERID attribute.
AUTHUSERID
Displays the 8-character identifier that is used to attach the EP adapter transaction. This attribute is only set if AUTHORITY is USERID.
CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. 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(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
CONFIGDATA1
Displays a 64-character data area containing the primary configuration data item for the EP adapter. If the primary configuration data item is less than 64 bytes, the field is padded with blanks. The data item displayed is dependent upon ADAPTERTYPE, as follows:
CUSTOM
Displays the first 64 bytes of custom EP adapter configuration data.
HTTP
Displays the 8-character name of the URIMAP definition to be used by an HTTP EP adapter to locate the HTTP server.
TRANSTART
Displays the 4-character name of the event consumer transaction that is started by a Transaction Start EP adapter.
TSQUEUE
Displays the 16-character name of the temporary storage queue for the event emitted by a TSQ EP adapter.
WMQ
Displays the 48-character name of the WebSphere MQ queue for event messages emitted by this WebSphere MQ EP adapter. This data is in the code page defined by the LOCALCCSID system initialization parameter.
DATAFORMAT
Displays a CVDA value indicating the format of events emitted by this EP adapter. The possible values are as follows:
CBE
Common Base Event format for consumption by products such as IBM Business Monitor.
CBER
Common Base Event REST format for the IBM Business Monitor REST HTTP server.
CCE
CICS Container Event format.
CFE
CICS Flattened Event format.
Start of changeDSIEEnd of change
Start of change Decision Server Insights Event format for consumption by the Decision Server Insights component of IBM Operational Decision Manager.End of change
USER
The format is user-defined.
WBE
WebSphere Business Events (XML) format for consumption by the Decision Server Events component of IBM Operational Decision Manager.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
EMITMODE(emitmodevalue)
Displays the event emission mode of the event binding:
ASYNCHRONOUS
Event emission is asynchronous of the capturing transaction.
SYNCHRONOUS
Event emission is synchronous with the capturing transaction.
ENABLESTATUS
Displays the status of the EP adapter:
DISABLED
The EP adapter is disabled.
ENABLED
The EP adapter is enabled.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. Only one value is possible:
BUNDLE
The resource was installed by a bundle deployment.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
INVOKETYPE
Displays a CVDA value indicating how the EP adapter is started. The CVDA values are as follows:
ATTACH
The EP adapter program is attached as a separate task.
LINK
The EP adapter program is linked to.
PRIORITY
Displays a CVDA value indicating the dispatching priority of event emission for this EP adapter. This attribute is ignored when EMITMODE is SYNCHRONOUS. The CVDA values are as follows:
HIGH
Events emitted for this EP adapter are high priority.
NORMAL
Events emitted for this EP adapter are normal priority.
PROGRAM
Displays the 8-character name of the EP adapter program. If the ADAPTERTYPE is CUSTOM, this attribute is only applicable if INVOKETYPE is LINK.
TRANSACTION
Displays the 4-character name of the transaction definition that is used if the EP adapter transaction is attached. The TRANSACTION attribute is only applicable if INVOKETYPE is ATTACH.
TRANSMODE(transmodevalue)
Displays the event transactional mode of the event binding:
NONTRANS
Events are not transactional.
TRANS
Events are transactional.