CEMT INQUIRE EXCI

Retrieve information about jobs using the external CICS interface.

Description

INQUIRE EXCI identifies the names of batch jobs currently connected to CICS through the interregion communication (IRC) facility. These jobs are using the external CICS interface (EXCI) to link to a server program running in CICS.

Input

Press the Clear key to clear the screen. There are two ways of starting this transaction:

Type CEMT INQUIRE EXCI. You get a display that lists the current status.
Type CEMT INQUIRE EXCI followed by Task(number) to limit the scope of the inquiry.

Sample screen

Figure 1. CEMT INQUIRE EXCI screen

  INQ EXCI
  STATUS:  RESULTS
   Exc(HADBS1..CICSWK1 - MV29             ) Tas(0000121)
   Exc(AHCLN2..TRNSL 1 - MV29             ) Tas(0000125)
      Uri(B 67B1F77EB7D       21 1 1      )

Note: There are blank fields on the screen where a value does not apply or is ‘negative'; that is, the value begins with ‘No'. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You may find it more convenient to use the expanded format when setting one of these values, (negating is easier because you are overtyping a displayed field with its negative causing the result to become non-displayed).

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format as shown in Figure 2.

Figure 2. The expanded display of an individual entry

 INQ EXCI
 RESULT
     Exc(HADBS1..CICSWK1 - MV29            ) Tas(0000121)
     Task(0000121)

CEMT INQUIRE EXCI

Displayed fields

EXCI (value)

Indicates that this panel relates to an EXCI inquiry.

The value consists of:

  jobname.stepname.procname - mvsid

One or both of the stepname and procname might not be present, indicated by the periods (.) being adjacent to one another.

The mvsid identifies the MVS system on which the job is running. If XCF/MRO is in use, the job can reside on a different MVS image from that on which CICS is running.

TASK (value)

Displays the task number of the mirror transaction running on behalf of a specific batch job.

Information about jobs using the external CICS interface is available only after that job has issued at least one DPL request. A nonzero task number indicates that a DPL request is currently active. A zero task number indicates that an external CICS interface session is still open (connected) for that job, although no DPL request is currently active.

URID (value)

Displays, when the job is using RRMS to coordinate updates, and when there is an active DPL request for the session, a 32-character string containing the hexadecimal representation of the RRMS Unit of Recovery Identifier.