CEMT INQUIRE VTAM

Inquire on the state of the connection between CICS® and the z/OS® Communications Server.

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

Description

The INQUIRE VTAM command inquires on the state of the connection between CICS and the Communications Server, the generic resource name, the type of Communications Server persistent sessions support, and the persistent session delay interval.

VTAM® is now known as the z/OS Communications Server.

Input

Press the Clear key and type CEMT INQUIRE VTAM (or suitable abbreviations for the keywords). The resulting display is similar to the following example.

You can change various attributes in the following ways:

Overtype your changes on the INQUIRE screen after tabbing to the appropriate field. See Overtyping a display.
Use the CEMT SET VTAM command.

Sample screen

Figure 1. CEMT INQUIRE VTAM screen

 IN VT
 RESULT - OVERTYPE TO MODIFY
   Vtam
   Openstatus( Open )
   Pstype(SNPS)
   Psdinterval( 000000 )
   Grstatus()
   Grname()

CEMT INQUIRE VTAM

Displayed fields

GRNAME(value)

Displays the 8-character generic resource name under which this CICS region is registered to the Communications Server.

GRSTATUS(value)

Displays the status of generic resource registration. The values are as follows:

REGISTERED: CICS registered successfully as a member of the Communications Server generic resource named by the GRNAME option.
DEREGISTERED: CICS was registered as a member of the generic resource named by the GRNAME and has deregistered successfully.
UNREGISTERED: A generic resource name (GRNAME) was specified, but CICS has not made any attempt to register.
UNAVAILABLE: A generic resource name (GRNAME) was specified, but the version of the Communications Server to which CICS is connected does not support generic resources.

If CICS makes an unsuccessful attempt to register, the status is shown as UNREGISTERED, and the words REGISTER ERROR appear alongside.

If CICS makes as unsuccessful attempt to deregister, the status is shown as REGISTERED, and the words DEREGISTER ERROR appear alongside.

OPENSTATUS(value)

Displays the status of the connection between CICS and the Communications Server. The values are as follows:

OPEN: A connection exists between CICS and the Communications Server.
CLOSED: The connection between CICS and the Communications Server has stopped.

You can reset this value by overtyping it with a different value or with one of the following:

IMMCLOSE: The connection between CICS and the Communications Server is in the process of closing following an EXEC CICS SET VTAM IMMCLOSE or CEMT SET VTAM IMMCLOSE command.
FORCECLOSE: The connection between CICS and the Communications Server is in the process of closing following an EXEC CICS SET VTAM FORCECLOSE or CEMT SET VTAM FORCECLOSE command.

PSDINTERVAL(value)

Displays the persistent session delay interval, expressed in the form hhmmss. It specifies if and for how long Communications Server sessions are held in recovery-pending state if a failure occurs. You can reset this value by typing over it with a different value. The permitted range is 000000 to 235959 inclusive.

000000: If a failure occurs, sessions are ended. This value is the default, and means that persistent sessions support is not exploited. If Pstype is shown as NOPS, the persistent session delay interval must be zero.
HHMMSS: If a failure occurs, sessions are held in recovery-pending state by the Communications Server for up to the interval specified.

PSTYPE(value)

Displays the type of Communications Server persistent sessions support for the CICS region. The values are as follows:

SNPS: Single-node persistent sessions. Communications Server sessions can be recovered after a CICS failure and restart.
MNPS: Multinode persistent sessions. Communications Server sessions can also be recovered after a Communications Server or z/OS failure in a sysplex.
NOPS: Communications Server persistent sessions support is not used for this CICS region.

VTAM

Indicates that this panel relates to a Communications Server inquiry.