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.
- Overtype your changes on the INQUIRE screen after tabbing to the appropriate field. See Overtyping a display.
- Use the CEMT SET VTAM command.
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.
- 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.