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.
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.
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.
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.
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).
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.
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.
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.
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.
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
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
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.
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.
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
For details, see the relevant Intercommunication Guide.
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
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
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:
For CICS/VSE Version 2, if there is no direct connection to the terminal-owning system, REMOTESYSTEM must specify the name of an indirect connection. For details of indirect connections, when they are required and how to define them, see the Intercommunication Guide for your CICS on System/390 product.
For CICS TS for OS/390, CICS TS for z/OS, and CICS Transaction Server for VSE/ESA, if there is no direct connection to the terminal-owning system, REMOTESYSTEM must specify the name of the first connection in the path to it. REMOTESYSNET must specify the network name by which the terminal-owning system is known to VTAM. See the Intercommunication Guide.
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.
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