Accessing the SYSLINK view

To display information about the links that exist between CICS® systems in the CICSplex:

Issue the command:
   SYSLINK [primary [secondary]]
where:
primary
Is the specific or generic name of a CICS system or * (asterisk) for all CICS systems.
secondary
Is the specific or generic name of a CICS system to which the specified primary CICS system is linked.

If no parameters are specified, the view includes information about all system links defined in the current context, as illustrated in Figure 137.

Select:
SYSLINK from the ADMBAS menu.
Figure 137. The SYSLINK view
  27FEB2005 11:30:30 --------- INFORMATION DISPLAY -----------------------
 COMMAND  ===>                                            SCROLL ===> PAGE
 CURR WIN ===> 1         ALT WIN ===>
  W1 =SYSLINK==========EYUPLX01=EYUPLX01=27FEB2005==11:30:30=CPSM======4==
 CMD Primary   Secondary  ConnDef  Ver  SessDef  Ver
 --- --------  ---------  -------- ---  -------- ---
     EYUMAS1A  EYUMAS2A   C002       1  S0002      1
     EYUMAS1A  EYUMAS3A   C002       1  S0002      1
     EYUMAS1B  EYUMAS2A   C002       1  S0002      1
     EYUMAS4A  EYUMAS1B   C002       1  S0002      1
 
 

The terms Primary and Secondary are used in the SYSLINK view to identify two CICS systems to be connected by a corresponding link. The Primary system has the values defined in the installed CONNDEF and SESSDEF definitions. For the Secondary system, some of the values are altered by the install process. In the Secondary CICS system for an MRO connection, the Receive count is swapped with the Send count, and the Receive size is swapped with the Send size. In the Secondary system for an APPC connection, the Receive size field is swapped with the Send size and the 'Maximum number of sessions supported as contention winners 'is recalculated by subtracting the 'Maximum number of sessions supported as contention winners' from the 'Maximum number of sessions in the group' in the Primary system. For example, if Maximum(90, 10) is specified, this value is installed in the Primary system, and Maximum(90, 80) is installed in the Secondary system. This creates a communications link, with the corresponding values, between the CICS systems.

A system link is identified in the data repository by both CICS system names. A given CICS system name may be in the Primary position of some system link definitions and in the Secondary position of others, depending on how the definition was created. Any definition that names that system, regardless of its position, is a valid link for the system. However, because the same system name can appear in either the Primary or Secondary field, the SYSLINK view has certain limitations:

The APPLID and SYSID values used in the connections that are defined between the primary and secondary systems are dependant on when the systems were started and and whether or not the APPLID and SYSIDNT values used in the CICSSYS definition match the values in use by CICS.

When a system link is installed connection and sessions definitions for the partner system are created:

If the APPLID or SYSIDNT of a MAS is changed, you should update the CICSSYS definition:

Related concepts
SYSLINK (system links) view
Links between CICS systems
Related tasks
Accessing BAS administration views using the EUI
Accessing the SYSLINK view
Working with the SYSLINK view
Creating a CICS system link
Removing a CICS system link
Related reference
System link attribute descriptions
[[ Contents Previous Page | Next Page Index ]]