IBM CICS Transaction Server for OS/390 SC33-1686-02 User Manual

Page 78

Advertising
background image

CEMT INQUIRE CONNECTION


OBtaining (APPC only)

The connection is being acquired. The connection
remains in the OBTAINING state until all the
criteria for ACQUIRED have been met.

FReeing (APPC only)

The connection is being released.

AVailable (APPC only)

The connection is acquired but there are currently
no bound sessions because they were unbound
for limited resource reasons.

Connstatus can be reset with Acquired or Released.

| Cqp(

value)

|

displays the status of the connection quiesce protocol for

|

the connection. The values are:

|

NOTSupported

|

The connection quiesce protocol is not supported

|

for this connection.

|

Unattempted

|

CICS has not attempted to use the connection

|

quiesce protocol (because the connection has not

|

been released).

|

COMPlete

|

The connection quiesce protocol completed

|

succesfully when the connection was release. The

|

status reverts to UNATTEMPTED when the

|

connection is re-acquired.

|

FAiled

|

The connection quiesce protocol failed (for

|

instance, becasue a session failed while the

|

protocol was executing). The status reverts to

|

UNATTEMPTED when the connection is

|

re-acquired.

Grname(

value) (appc only)

displays (for an APPC connection to a generic resource
when this system is also a generic resource) the
8-character generic resource name of the connected
system. Otherwise this field is blank. CICS assumes that
the partner is a generic resource if the two NETNAMEs
sent with a BIND are different. Thus, information may
be displayed for a partner that is

not a generic resource

but which uses XRF.

Membername(

value)

displays (for an APPC connection to a generic resource
when this system is also a generic resource) the
8-character member name (applid) of the connected LU.
Otherwise this field is blank. CICS assumes that the
partner is a generic resource if the two NETNAMEs sent
with a BIND are different. Thus, information may be
displayed for a partner that is

not a generic resource but

which uses XRF.

NEtname(

value)

displays the 8-character name by which the remote
system is known to the network.

Pendstatus (

appc and mro only)

displays whether there are any pending units of work for
this connection. The values are:

NOTPending

There has been no mismatch of lognames with the
partner.

Note: MRO connections to pre-CICS Transaction

Server for OS/390 systems do not use
lognames. Therefore, for these
connections, PENDSTATUS is always
NOTPENDING.

PEnding

There is resynchronization work outstanding for
the connection but the partner system has
performed an initial start, preventing completion of
the resynchronization process. (If the partner is a
pre-CICS Transaction Server for OS/390 system,
its performing a cold start has the same effect.)
The units of work associated with the connection
may need to be individually investigated and
forced to commit or backout. Alternatively, the
units of work can be unilaterally committed or
backed out, according to their associated
transaction definitions, by using the SET
CONNECTION NOTPENDING command.

If this is an APPC connection, no new syncpoint
work (that is, work involving synclevel 2 protocols)
can be transmitted across it until a SET
CONNECTION NOTPENDING command has
been issued. This restriction does not apply to
MRO connections.

If you are not concerned by the loss of
synchronization caused by the initial (or cold) start
of the partner, you can cause the SET
CONNECTION NOTPENDING command to be
issued automatically by specifying
XLNACTION(FORCE) on the CONNECTION
definition.

Pendstatus can be reset with Notpending.

For further information about pending units of work, see
the

CICS Intercommunication Guide.

Protocol

displays the protocol in use if this is a VTAM or external
CICS interface connection. The values are:

APpc

The connection uses the VTAM LUTYPE6.2
protocol for intersystem communication, or is
remote.

EXci The connection uses the external CICS interface

for communication between CICS and a non-CICS
client program.

60

CICS Supplied Transactions

Advertising