CEMT INQUIRE MODENAME

Retrieve information about connection sessions.

Description

INQUIRE MODENAME returns information about the named group of sessions that has been defined for a connection to a remote system, or to another CICS® region.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE MODENAME (or suitable abbreviations for the keywords). The resulting display lists the current status.
  • Type CEMT INQUIRE MODENAME (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i mod acq, the resulting display shows the details of all mode names that are acquired.
Mode names do not need to be unique. You cannot specify a list of names, but you can use the asterisk (*) and plus (+) symbols to specify a family of mode names. A mode name consisting of eight blanks is valid. To specify this name, enclose the string of blanks in single quotation marks, for example: 
MODENAME('   ')

You can then tab to the highlighted or blank fields and overtype them with the required values.

(value)
Specifies one or more names (1 - 8 characters) of a group of sessions.
ALL
The default.

Sample screen

Figure 1. CEMT INQUIRE MODENAME screen
  I MODE
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Mod(SNASVCMG) Con(C   ) Max(002) Ava( 000 ) Act(000)
   Mod(MODE1   ) Con(C   ) Max(001) Ava( 000 ) Act(000)
Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. 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 might find it more convenient to use the expanded format when setting one of these values.

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

Figure 2. The expanded display
  I MODE
  RESULT - OVERTYPE TO MODIFY
    Modename(MODE1)
    Connection( C    )
    Maximum(001)
    Available( 000 )
      Active(000)
      Acqstatus(              )

CEMT INQUIRE MODENAME

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE MODENAME ALL( value) CONNECTION( value)MAXIMUM( value)AVAILABLE( value)ACTIVE( value)ACQUIREDCLOSED

Displayed fields

ACQSTATUS (input only field)
Specifies the acquisition status of sessions. The values are as follows:
ACQUIRED
CICS acquires (or binds) all the negotiated contention-winner sessions in the group.
CLOSED
CICS releases all sessions in the group. The sessions are quiesced and unbound. No further sessions can be acquired by another CICS system. No further activity is possible on the sessions in the group until the group is reacquired by the same CICS system in which it has been closed.
ACTIVE (value)
Displays the number of sessions in the group (or mode name) that are currently in use (bound).
AVAILABLE (value)
Displays the currently negotiated number of sessions in the group that can be allocated for use at one time.

You can reset this value by overtyping it with a different value.

CONNECTION (value)
Displays the 4-character identifier of the remote system with which this group of IRC or ISC sessions is connected.
MAXIMUM (value)
Displays the maximum number of sessions that are supported at one time in this group of sessions, in the range 0 - 999.
MODENAME (value)
Indicates that this panel relates to a MODENAME inquiry and displays one or more names (1 - 8 characters) of a group of sessions.