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.
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.
- DSIE
- Decision Server Insights Event format for consumption by the Decision Server Insights component of IBM Operational Decision Manager.
- 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.