SYSLINK Resource Table

A CICSPlex® SM topology definition that describes the endpoints of a communications link between two CICS systems being managed by CICSPlex SM. A SYSLINK record is created when connection and sessions definitions (CONNDEF and SESSDEF) or IPIC and TCP/IP definitions (IPCONDEF and TCPDEF) are installed in one of the CICS systems. That information is used to create a link to the other CICS® system.

The Primary key field for this resource class is FROMCSYS.

The Secondary key field for this resource class is TOCSYS.

The Tertiary key field for this resource class is CONNDEF.

The Fourth key field for this resource class is CONNDEFVER.

The Fifth key field for this resource class is SESSDEF.

The Sixth key field for this resource class is SESSDEFVER.

The Seventh key field for this resource class is LINKTYPE.

The following actions are supported:
INSTALL
Install a System Link.
The parameter data for the INSTALL action is: 
   PARM('[NOTIFY(notify)]
         [STATECHK(statechk)]
         [FORCEINS(forceins)].')

     where:

     notify    = Type of checking to be performed before install.
     statechk  = Whether the existence and operational state of
                 each resource should be checked before install.
     forceins  = Whether definitions should be installed even
                 if CICSPlex SM believes they do not need to be.

External resource name
CICSSystemLink
Length
80
Usage
API or Batch Utility or WUI or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICSPlex SM Definition
Copybook identifier
EYUt4610
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
CREATE   None N/A
REMOVE   None N/A
PERFORM SET INSTALL FORCEINS(YES, NO) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    STATECHK(YES, NO) No
Table 2. SYSLINK FEEDBACK error codes
Value Code Description
1 SYSLINK_INV_DATA Attribute data invalid
2 SYSLINK_REC_NOT_FOUND Requested resource not found
4 SYSLINK_REC_EXISTS Resource already exists
6 SYSLINK_INV_RESTYPE Invalid resource type
7 SYSLINK_INV_VER Invalid resource version
11 SYSLINK_NON_MP Maintenance point CMAS not available
12 SYSLINK_INV_CONTEXT Context not found
21 SYSLINK_INV_RECADDR Invalid record address
22 SYSLINK_INV_RECLEN Invalid record length
23 SYSLINK_INV_ACTION Invalid action
24 SYSLINK_LOGICAL_DUP Logical duplicate
25 SYSLINK_INV_MAJNAME Invalid major name
26 SYSLINK_INV_MINNAME Invalid minor name
27 SYSLINK_INV_QUALNAME Invalid qualifier name
28 SYSLINK_INV_FORTHNME Invalid session definition name
29 SYSLINK_NOTIFY Notify
30 SYSLINK_PARTIAL_INSTALL Partial install
31 SYSLINK_NOTHING_INSTALLED Nothing installed
32 SYSLINK_NO_ACTIVE_SYSTEMS No active systems
33 SYSLINK_INV_NAMELIST Invalid name list
34 SYSLINK_INV_NOTIFY Invalid notify
35 SYSLINK_INV_FORCEINS Invalid force install
36 SYSLINK_INV_STATECHK Invalid state check
37 SYSLINK_INV_LINKTYPE Invalid link type
Table 3. SYSLINK resource table attributes
Name Datatype Source Len Req Sum Description Default Attr ID
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent   15
CHANGEAGENT Input/output valid values DREPAPI
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release   18
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification   1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID   17
 CONNDEF-3  CHAR CPSM 8 Yes DIFF Primary Connection definition name   9
 CONNDEFVER-4  BINARY CPSM 1 Yes AVG Primary connection definition version   11
CREATETIME DATETIME CPSM 8 Yes MAX Time created   16
 FROMCSYS-1  CHAR CPSM 8 Yes DIFF Primary CICS system name   5
 LINKTYPE-7  EYUDA CPSM 4 Yes LIKE Connection resource type SNA 14
LINKTYPE-7
Input/output valid values		 SNA, IPIC
 SESSDEF-5  CHAR CPSM 8 Yes DIFF Secondary connection definition name   10
 SESSDEFVER-6  BINARY CPSM 1 Yes AVG Secondary connection definition version   12
 TOCSYS-2  CHAR CPSM 8 Yes DIFF Secondary CICS system name   7