CONNECT - ISC/MRO connections

The CONNECT view shows general information about ISC and MRO connections. Examples of how to use this view can be found in:

Availability

The CONNECT view is available for all managed CICS® systems.

Access

Issue command:
CONNECT [connection] [netname]

connection
is the specific or generic name of an ISC or MRO connection, or * for all connections. If you omit this parameter, the view includes information about all connections within the current scope.

netname
is the specific or generic name of a netname, or * for all netnames. Use this parameter to find out which connections are associated with which netnames.

Select:
CONNECT from the OPERATE menu, and CONNECT from the CONNECT submenu.

Figure 3 is an example of the CONNECT view.

Figure 3. The CONNECT view
 27FEB2005  18:20:19 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CONNECT===========EYUPLX01=EYUPLX01=27FEB2005==18:20:19=CPSM=========10===
 CMD Conn CICS     Conn Netname  Connect    Service    Pending
 --- ID-- System-- Type -------- Status---- Status---- Status----
     1A1B EYUMAS1A LU62 EYUMAS1B RELEASED   INSERVICE  NOTPENDING
     1A2A EYUMAS1A MRO  EYUMAS2A NOTAPPLIC  INSERVICE  NOTAPPLIC
     1A3A EYUMAS1A MRO  EYUMAS3A NOTAPPLIC  INSERVICE  NOTAPPLIC
     2A1A EYUMAS2A MRO  EYUMAS1A NOTAPPLIC  INSERVICE  NOTAPPLIC
     2A4A EYUMAS2A MRO  EYUMAS4A NOTAPPLIC  INSERVICE  NOTAPPLIC
     3A1A EYUMAS3A MRO  EYUMAS1A NOTAPPLIC  INSERVICE  NOTAPPLIC
     3A4A EYUMAS3A MRO  EYUMAS4A NOTAPPLIC  INSERVICE  NOTAPPLIC
     4A1B EYUMAS4A LU62 EYUMAS1B RELEASED   INSERVICE  NOTPENDING
     4A2A EYUMAS4A MRO  EYUMAS2A NOTAPPLIC  INSERVICE  NOTAPPLIC
     4A3A EYUMAS4A MRO  EYUMAS3A NOTAPPLIC  INSERVICE  NOTAPPLIC
 
 

Action commands

Table 11 shows the action commands you can issue from the CONNECT view. The overtype fields are shown in Table 12.

The action commands and overtype fields for the CONNECT view are available for all managed CICS systems for which CONNECT is valid, except as noted in Table 11.

Table 11. CONNECT view action commands
Primary command Line command Description
ACQuire
connection sysname
ACQ Acquires a connection (APPC only).
CANcel
connection sysname
CAN Cancels automatic initiation descriptor (AID) queuing for a connection.
DiSCard
connection sysname
DSC Discards a connection from the CICS system where it is installed. The connection must be out of service before it can be discarded.
EndAFfinity
connection sysname
EAF Ends a connection's affinity with a VTAM generic resource group. The connection must be out of service and, for APPC, in NORECOVDATA state. (APPC and LU6.1 connections only.)
FORceCANcel
connection sysname
FCN Cancels all automatic initiation descriptor (AID) queuing, including system AID queuing, for a connection.
FORcepurge
connection sysname
FOR Forces transactions associated with a connection to be immediately purged (VTAM® only).
INservice
connection sysname
IN Places a connection in service.
NORecovdata
connection sysname
NOR Forces all in-doubt units of work, forgets any outstanding resynchs, and erases the logname previously received from the partner system. This overrides the resynchronization process. (APPC connections only.)
NOTPending
connection sysname
NTP Forces all in-doubt units of work and forgets any outstanding resynchs created before the initial (or cold) start of the partner system. This overrides the resynchronization process. (APPC and CICS MRO connections only.)
OUTservice
connection sysname
OUT Takes a connection out of service.
PURge
connection sysname
PUR Purges normally the transactions associated with a connection (VTAM only). CICS terminates the transactions associated with this connection only if system and data integrity can be maintained.
Note:
A transaction is not purged if its definition specifies SPURGE=NO.
RELease
connection sysname
REL Releases a connection (APPC only).
n/a SET Sets a connection attribute according to the new value you specify in an overtype field (see Table 12).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
UOW
connection sysname
UOW Displays the Set action for Shunted UOWs for Failed Connection input panel (Figure 4), which lets you specify whether a unit of work shunted because of the failure of this connection should be backed out, committed, forced, or resynchronized.
Where:
connection
Is the specific or generic name of an ISC or MRO connection
sysname
Is the specific or generic name of a CICS system

When you issue the UOW action command from the CONNECT view, the Shunted UOWs for Failed Connection input panel appears, as shown in Figure 4.

Figure 4. The Shunted UOWs for Failed Connection input panel
 ------------------- Shunted UOWs for Failed Connection ------------------------
 COMMAND  ===>
 
  Connection Name   CMGJ
  Action         ==>           (BACKOUT, COMMIT, FORCE, RESYNC)
 
 Press Enter to process action.
 Type END or CANCEL to cancel action.

Specify the action to be taken for a unit of work shunted because of the failure of this connection:

BACKOUT
Specifies that these units of work should be backed out.
COMMIT
Specifies that these units of work should be committed.
FORCE
Specifies that these units of work should be FORCED to BACKOUT or COMMIT.
RESYNC
Specifies that these units of work should be retried (exchange lognames resynchronization for this connection should be attempted).

Table 12. CONNECT view overtype fields
Field name Values
Connect Status ACQUIRED | RELEASED (APPC only)
Service Status INSERVICE | OUTSERVICE

Hyperlinks

Table 13 shows the hyperlink field on the CONNECT view.

Table 13. CONNECT view hyperlink field
Hyperlink field View displayed Description
Conn ID CONNECTD Detailed view of the specified connection.
Note:
You can also display the CONNECTS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]