Setting up LU 6.2 links

You must use an LU 6.2 link for all the facilities described in Overview of CICS System/390-non-System/390 intercommunication. Depending on the intercommunication functions being used, create resource definitions similar to those required on a link between two System/390® CICS systems.

All communication with CICS non-System/390 systems

Define the following:

No CONNECTION or SESSIONS definitions are necessary for single-session links, which can be completely defined by TERMINAL and TYPETERM definitions. The terminal name (for example, PSO2 on page Remote system TERMINAL definition (single session)) serves as the connection name.

If you require parallel-session links, omit the TERMINAL and TYPETERM definitions. The CONNECTION and SESSIONS definitions support both types of link.

If you are using CICS internal security (CICS/VSE Version 2 only), and you want IDENTIFY or VERIFY attach-time security, use the DFHSNT resource definition macro to create an SNT entry for each non-System/390 user who accesses CICS/VSE resources. If you are using an external security manager (ESM), such as RACF®, define user profiles to your ESM instead. See CICS internal security.

Function shipping and DPL from CICS non-System/390 systems

Define the following:

(The above three items are defined in the supplied group DFHISC.)

An incoming START command can use the TERMID option to specify a terminal that is to be associated with the started transaction. Unless you can rely on a definition of this terminal being shipped from the non-System/390 system, you should create a remote definition of it to CICS on System/390.

Function shipping and DPL to CICS non-System/390 systems

For function shipping, define the remote resource (file, temporary storage queue, or transient data queue).

For function shipping of a START command, define the remote transaction, unless the LINK or START command includes the SYSID option.

Transaction routing from CICS non-System/390 systems

Create remote terminal definitions for those terminals whose definitions cannot be shipped from the non-System/390 system. Examples of such terminals are 3270 terminals or printers defined with the attribute SHIPPABLE(NO).

Transaction routing to CICS non-System/390 systems

Define the remote transaction. Unless you are using dynamic transaction routing, specify the REMOTESYSTEM value as the name of the connection to the transaction-owning system.

Defining remote resources

The following pages give examples of the definitions required to support intercommunication connections and functions at the system level. When defining a remote resource for a specific application (program, transaction, file, queue, or terminal), the REMOTESYSTEM value is the name of the connection to the resource-owning system. For an example of a remote resource definition, see Remote terminal TERMINAL definition.

CICS on System/390 mirror transaction definition

Most of the values below must be entered as shown.

The profile name shown is that of an IBM-supplied profile. If you create your own profile, change this name. In your own profile, specify INBFMH (All), which is required for function shipping and distributed transaction processing.

DEFINE TRANSACTION(CPMI) GROUP(CICSWIN)
OVERTYPE TO MODIFY
 CEDA DEFine
  TRansaction    : CPMI
  Group          : CICSWIN
  PROGram      ==> DFHMIRS
  TWasize      ==> 00000              0-32767
  PROFile      ==> DFHCICSA
  PArtitionset ==>
  STatus       ==> Enabled            Enabled|Disabled
  PRIMedsize   ==> 00000              0-65520
 SCHEDULING
  PRIOrity     ==> 001                0-255
  TClass       ==> No                 No|1-10
 ALIASES

If you use the TRANSID option of the EXEC CICS LINK command to specify a different mirror transaction, you need to copy this definition, change the TRANSACTION name and, possibly, change the values of TWASIZE, PRIMEDSIZE, PRIORITY, and TCLASS.

CICS on System/390 mirror program definition

Enter all values as shown.

For CICS/VSE Version 2 systems that use CICS internal security, the RSL value of PUBLIC means that no CICS security restrictions are placed on the use of this program. If you wish to restrict its use, enter a number in the range 1 through 24. A value of 0 denies use of this program to any transaction defined with RSLC(YES). For details of the RSL and RSLC attributes, refer to the CICS/VSE Version 2 Release 3 Resource Definition Guide .

DEFINE PROGRAM(DFHMIRS) GROUP(CICSWIN)
OVERTYPE TO MODIFY
 CEDA DEFine
  PROGram      ==> DFHMIRS
  Group        ==> CICSWIN
  Language     ==> Assembler          Cobol|Assembler|Le370|C|Pli|Rpg
  RELoad       ==> No                 No|Yes
  RESident     ==> No                 No|Yes
  RSl          ==> Public             0-24|Public
  Status       ==> Enabled            Enabled|Disabled

The following notes apply to all program definition screens.

Notes:
  1. The RSL option relates to CICS internal security, and does not apply to CICS TS for z/OS®, CICS TS for OS/390®, or CICS Transaction Server for VSE/ESA. For compatibility with earlier releases, it appears on a CEDA display, but is set to 00 and cannot be changed.
  2. The RPG language is supported by CICS/VSE Version 2 only.

Data conversion program definition

Enter all values as shown.

DEFINE PROGRAM(DFHCCNV)
OVERTYPE TO MODIFY
 CEDA DEFine
  PROGram      ==> DFHCCNV
  Group        ==> CICSWIN
  Language     ==> Assembler          Cobol|Assembler|Le370|C|Pli|Rpg
  RELoad       ==> No                 No|Yes
  RESident     ==> No                 No|Yes
  RSl          ==> 00                 0-24|Public
  Status       ==> Enabled            Enabled|Disabled

Data conversion table definition

Enter all values as shown.

DEFINE PROGRAM (DFHCNV)
OVERTYPE TO MODIFY
 CEDA DEFine
  PROGram      ==> DFHCNV
  Group        ==> CICSWIN
  Language     ==> Assembler          Cobol|Assembler|Le370|C|Pli|Rpg
  RELoad       ==> No                 No|Yes
  RESident     ==> No                 No|Yes
  RSl          ==> 00                 0-24|Public
  Status       ==> Enabled            Enabled|Disabled

User-replaceable conversion program definition

Enter all values as shown.

DEFINE PROGRAM (DFHUCNV)
OVERTYPE TO MODIFY
 CEDA DEFine
  PROGram      ==> DFHUCNV
  Group        ==> CICSWIN
  Language     ==> Assembler          Cobol|Assembler|Le370|C|Pli|Rpg
  RELoad       ==> No                 No|Yes
  RESident     ==> No                 No|Yes
  RSl          ==> 00                 0-24|Public
  Status       ==> Enabled            Enabled|Disabled

For all program definition screens, see the notes on program definition screens.

Remote system TERMINAL definition (single session)

For a single-session link, a terminal definition can serve as the CICS on System/390 definition of the LU 6.2 connection to CICS Transaction Server for Windows, CICS/400, or CICS on Open Systems. This example is a definition of an LU 6.2 connection to CICS Transaction Server for Windows.

No remote attributes are necessary because the non-System/390 system appears to CICS on System/390 as a locally-attached terminal. (In other words, CICS on System/390 owns the connection.)

NETNAME must be the name by which the remote system is known to VTAM®.

Most of the values should be entered as shown. There are no constraints on the terminal name or operator defaults. For an example accompanying TYPETERM definition, see Remote system TYPETERM definition.

DEFINE TERMINAL(PSO2) GROUP(CICSWIN)
OVERTYPE TO MODIFY
 CEDA  DEFine
  TErminal      ==> PSO2
  Group         ==> CICSWIN
  AUTOINSTModel ==> No                 No|Yes|Only
  AUTOINSTName  ==>
 TERMINAL IDENTIFIERS
  TYpeterm      ==> APPC
  Netname       ==> T1112821
  CONSOle       ==> No                 No|0-99
  REMOTESystem  ==>
  REMOTESYsnet  ==>
  REMOTEName    ==>
  Modename      ==> SIGMA
 ASSOCIATED PRINTERS
  PRINTER       ==>
  PRINTERCopy   ==> No                 No|Yes
  ALTPRINTEr    ==>
  ALTPRINTERCopy==> No                 No|Yes
 PIPELINE PROPERTIES
  POol          ==>
  TAsklimit     ==> No                 No|Yes
 OPERATOR DEFAULTS
  OPERID        ==>
  OPERPriority  ==> 000                0-255
  OPERRsl       ==> 0                  0-24,...
  OPERSecurity  ==> 1                  1-64,...
PRESET SECURITY
  Userid        ==>
 TERMINAL USAGES
  TRansaction   ==>
  TErmpriority  ==> 000                0-255
  Inservice     ==> Yes                Yes|No
 SESSION SECURITY
  Securityname  ==>
  ATtachsec     ==> Local              Local|Identify|Verify|
                                       Persistent|Mixidpe
  BINDPassword  ==>                    PASSWORD NOT SPECIFIED
  BINDSecurity  ==> No                 No|Yes

The following notes apply to all terminal definition screens.

Notes:
  1. The OPERID, OPERPRIORITY, OPERRSL, and OPERSECURITY options are obsolete in CICS TS for z/OS, CICS TS for OS/390, and CICS Transaction Server for VSE/ESA, but are retained for compatibility with earlier releases.
  2. The REMOTESYSNET option does not apply to CICS/VSE Version 2.
  3. The ATTACHSEC, BINDPASSWORD, and BINDSECURITY options apply only to APPC (LUTYPE6.2) links. BINDSECURITY is not applicable to CICS/VSE Version 2. BINDPASSWORD is not applicable to CICS Transaction Server for z/OS, CICS Transaction Server for OS/390 or CICS Transaction Server for VSE/ESA.

Remote system TYPETERM definition

This definition relates to the Remote system TERMINAL definition (single session).

Most of the values below must be entered as shown.

DEFINE TYPETERM(APPC) GROUP(CICSWIN)
OVERTYPE TO MODIFY
 CEDA DEFine
  TYpeterm       : APPC
  Group          : CICSWIN
 RESOURCE TYPE
  DEVice       ==> APPC
  TERmmodel    ==>
  SESsiontype  ==>
  LDclist      ==>
  SHippable    ==> No                 No|Yes
 MAPPING PROPERTIES
  PAGesize     ==> 000 , 000          0-999
  ALTPage      ==> 000 , 000          0-999
  ALTSUffix    ==>
  FMhparm      ==> No                 No|Yes
  OBOperid     ==> No                 No|Yes
 PAGING PROPERTIES
  AUTOPage     ==> No                 No|Yes
 DEVICE PROPERTIES
  SOsi         ==> No                 No|Yes
  BAcktrans    ==> No                 No|Yes
  CGosgid      ==> 00000 , 00000      0-65535
 SESSION PROPERTIES
  AScii        ==> No                 No|7|8
  SENdsize     ==> 00256              0-30720
  RECEivesize  ==> 00256              0-30720
  BRacket      ==> Yes                Yes|No
  LOGMode      ==>
 DIAGNOSTIC DISPLAY
  ERRLastline  ==> No                 No|Yes
  ERRIntensity ==> No                 No|Yes
  ERRColor     ==> No                 No|Blue|Red|Green
                                      |Turquoise|Yellow|NEutral
  ERRHilight   ==> No                 No|Blink|Reverse|Underline
 OPERATIONAL PROPERTIES
  AUTOConnect  ==> Yes                No|Yes|All
 RECOVERY
  RECOVOption  ==> Sysdefault         Sysdefault|Clearconv|
                                      Releasesess|Uncondrel|None
  RECOVNotify  ==> None               None|Message|Transaction
Note:
In CICS TS for OS/390, CICS TS for z/OS, and CICS Transaction Server for VSE/ESA, it is possible to:

For details, see the relevant Intercommunication Guide.

CONNECTION definition for parallel sessions

This sample CONNECTION definition for parallel sessions accompanies the SESSIONS definition that follows. NETNAME (IYA79270 in this example) must be the name by which the remote system is known to VTAM.

The connection name (ISCA in this example) is the REMOTESYSTEM value in remote definitions of resources (files, terminals, and transactions) owned by the non-System/390 CICS system linked by this connection.

DEFINE CONNECTION(ISCA) GROUP(ISCAA)
OVERTYPE TO MODIFY
 CEDA DEFine
  Connection   ==> ISCA
  Group        ==> ISCAA
 CONNECTION IDENTIFIERS
  Netname      ==> IYA79270
  INDsys       ==>
 CONNECTION PROPERTIES
  ACcessmethod ==> VTAM               Vtam|IRc|INdirect|Xm
  PRotocol     ==> APPC               Appc|Lu61
  SInglesess   ==> No                 No|Yes
  DAtastream   ==> User               User|3270|SCs|STrfield|Lms
  RECordformat ==> U                  U|Vb
  Queuelimit   ==> No                 No|0-9999
  Maxqtime     ==> No                 No|0-9999
 OPERATIONAL PROPERTIES
  AUtoconnect  ==> Yes                Yes|No
  INService    ==> Yes                Yes|No
 SECURITY
  SEcurityname ==>
  ATtachsec    ==> Local              Local|Identify|Verify|
                                      Persistent|Mixidpe
  BINDPassword ==>                    PASSWORD NOT SPECIFIED
  BINDSecurity ==> No                 No|Yes
 RECOVERY
  Psrecovery   ==> Sysdefault         Sysdefault|None

Notes:
  1. QUEUELIMIT and MAXQTIME do not apply to CICS/VSE Version 2. These options enable you to control the queuing of requests for free sessions on the connection. See your Intercommunication Guide for more details.
  2. PSRECOVERY does not apply to CICS/VSE Version 2. With the RECOVOPTION attribute of DEFINE SESSIONS, it enables you to use VTAM persistent sessions on LU 6.2 links. See your Intercommunication Guide for more details.
  3. BINDSECURITY is not applicable to CICS/VSE Version 2. BINDPASSWORD is not applicable to CICS Transaction Server for z/OS, CICS Transaction Server for OS/390, or CICS Transaction Server for VSE/ESA.

SESSIONS definition for parallel sessions

This sample SESSIONS definition for parallel sessions accompanies the preceding CONNECTION definition.

DEFINE SESSIONS(ISCA) GROUP(ISCAA)
OVERTYPE TO MODIFY
 CEDA DEFine
 SESSION IDENTIFIERS
  Sessions     ==> ISCA
  Group        ==> ISCAA
  Connection   ==> ISCA
  MOdename     ==> CICSISC0
 SESSION PROPERTIES
  Protocol     ==> APPC               Appc|Lu61
  MAximum      ==> 5,2
  SENDSize     ==> 4096               1-30720
  RECEIVESize  ==> 1024               1-30720
  SESSPriority ==> 000                0-255
 OPERATIONAL PROPERTIES
  Autoconnect  ==> YES                Yes|No
  INservice    ==> Yes                Yes|No
  Buildchain   ==> Yes                Yes|No
  IOarealen    ==> 0,0                0-32767
  RELreq       ==> Yes                Yes|No
  DIscreq      ==> Yes                Yes|No
  NEPclass     ==> 000                0-255
 RECOVERY
  RECOVoption  ==> Sysdefault         Sysdefault|Clearconv|
                                      Releasesess|Uncondrel|No
  RECOVNotify  ==> None               None|Message|Transaction
Note:
In CICS TS for OS/390, CICS TS for z/OS, and CICS Transaction Server for VSE/ESA, you can autoinstall parallel-session LU 6.2 links that are initiated by BIND requests. For details, see the relevant Intercommunication Guide.

Remote terminal TERMINAL definition

CICS systems cannot ship definitions of:

If an incoming transaction routing request (or an automatic transaction initiation (ATI) request) is associated with a non-shippable terminal, CICS on System/390 must have a remote terminal definition that meets the following requirements:

An example definition follows.

DEFINE TERMINAL(R123) GROUP(CICSWIN)
OVERTYPE TO MODIFY
 CEDA DEFine
  TErminal     ==> R123
  Group        ==> CICSWIN
  AUTINSTModel ==> No                 No|Yes|Only
 TERMINAL IDENTIFIERS
  TYpeterm     ==> LU62TR
  NEtname      ==>
  CONSOle      ==> No                 No|0-99
  REMOTESystem ==> ISCA
  REMOTESYsnet ==>
  REMOTEName   ==> V123
 ASSOCIATED PRINTERS
  PRINTERCopy  ==> No                 No|Yes
  ALTPRINTCopy ==> No                 No|Yes
 PIPELINE PROPERTIES
  TAsklimit    ==> No                 No|1-32767
 OPERATOR DEFAULTS
  OPERPID      ==>
  OPERPriority ==> 000                0-255
  OPERRsl      ==> 0                  0-24,...
  OPERSecurity ==> 1                  1-64,...
 PRESET SECURITY
  Userid       ==>
 TERMINAL USAGES
  TErmpriority ==> 000                0-255
  Inservice    ==> Yes                Yes|No
 SESSION SECURITY
  ATtachsec    ==> Local              Local|Identify|Verify|
                                      Persistent|Mixidpe
  BINDPassword  ==>                   PASSWORD NOT SPECIFIED
  BINDSecurity  ==> No                No|Yes

For all terminal definitions, see the Notes on terminal definition screens.

Remote terminal TYPETERM definition

Here is an example of a TYPETERM definition to accompany the preceding TERMINAL definition.

DEFINE TYPETERM(LU62TR) GROUP(CICSWIN)
OVERTYPE TO MODIFY
CEDA DEFINE
  TYpeterm     ==> LU62TR
  Group        ==> CICSWIN
 RESOURCE TYPE
  DEVice       ==> 3270
  TERmmodel    ==> 2
  SESsiontype  ==>
  LDclist      ==>
  SHippable    ==> No                 No|Yes
 MAPPING PROPERTIES
  PAGesize     ==> 024 , 080          0-999
  ALTPage      ==> 024 , 080          0-999
  ALTSUffix    ==>
  FMhparm      ==> No                 No|Yes
  OBOperid     ==> No                 No|Yes
 PAGING PROPERTIES
  AUTOPage     ==> No                 No|Yes
 DEVICE PROPERTIES
  SOsi         ==> No                 No|Yes
  BAcktrans    ==> No                 No|Yes
  CGcsgid      ==> 00000 , 00000      0-65535
 SESSION PROPERTIES
  AScii        ==> No                 No|7|8
  SENdsize     ==> 00000              0-30720
  RECEivesize  ==> 01920              0-30720
  BRacket      ==> Yes                Yes|No
  LOGMode      ==>
 DIAGNOSTIC DISPLAY
  ERRLastline  ==> Yes                No|Yes
  ERRIntensify ==> Yes                No|Yes
  ERRColor     ==> No                 NO|Blue|Red|Pink|Green|
                                      Turquoise|Yellow|NEutral
  ERRHilight   ==> No                 No|Blink|Reverse|Underline
 OPERATIONAL PROPERTIES
  AUTOConnect  ==> Yes                No|Yes|All
  ATi          ==> Yes                No|Yes
 RECOVERY
  RECOVOption  ==> Sysdefault         Sysdefault|Clearconv|
                                      Releasesess|Uncondrel|None
  RECOVNotify  ==> None               None|Message|Transaction

Related tasks
System generation and initialization
[[ Contents Previous Page | Next Page Index ]]