This appendix provides sample environments showing how BEA Connect SNA can be configured for use with an Ethernet LAN and an APPN system 390. Considerations for token ring and subarea-style configurations are included. It is assumed that hardware and operating system installation have been completed.
An environment properly configured for BEA Connect SNA involves two general components, a local environment and remote environment.
A local environment is a UNIX-based machine running BEA Connect SNA 2.0. Connect SNA 2.0 is a fully bi-directional program, supporting the local system as either a client or server. This environment consists of the following components:
* Sync-level 2 not supported.
A remote environment is an IBM mainframe that may or may not be on the same local network. As in the local environment, BEA Connect SNA 2.0 is a fully bi-directional program, supporting the remote system as either a client or server. This environment consists of the following components:
Remote Environment
Samples of each environment are provided to illustrate a starting point when first configuring your system. These samples are not intended to be used without modifications. Any similarity between them and any actual system is coincidental.
The attributes of the sample environment machines are listed below for reference. The sample configurations refer to these attributes as required.
10BaseT carrying SNA/DLC (IEEE 802.3) and TCP/IP (DIX) traffic.
Sample Environments
Machine Attributes (LAN Descriptions)
| Name | Attribute |
|---|---|
|
OS |
Solaris 2.5.1 (SunOS 5.5.1) |
|
SNA |
Brixton/CNT 4.0.1.8 |
|
APP |
Tuxedo 6.4 |
|
MAC |
08:00:20:7C:47:50 |
|
IP |
206.189.43.14 |
|
NAME |
beasun2 |
| Name | Attribute |
|---|---|
|
OS |
Solaris 2.5.1 or 2.6 (SunOS 5.5.1) |
|
SNA |
SunLink 9.1 |
|
APP |
Tuxedo 6.4 |
|
MAC |
08:00:20:87:47:2d |
|
IP |
206.189.43.54 |
|
NAME |
dalsun4 |
| Name | Attribute |
|---|---|
|
OS |
HP-UX B.10.20 or 11.00 (patches:PHNE_9663,9761,9889) |
|
SNA |
HPSNAPlus2 5.1 or 6.0 |
|
APP |
Tuxedo 6.4 |
|
MAC |
08:00:09:30:24:77 |
|
IP |
206.189.43.13 |
|
NAME |
dalhp10 |
| Name | Attribute |
|---|---|
|
OS |
Solaris 2.5.1 (SunOS 5.5.1) |
|
SNA |
Brixton/CNT 4.0 |
|
APP |
Tuxedo 6.4 |
|
MAC |
08:00:20:7C:47:50 |
|
IP |
206.189.43.14 |
|
NAME |
beasun2 |
| Name | Attribute |
|---|---|
|
OS |
Solaris 2.5.1 (SunOS 5.5.1) |
|
SNA |
Brixton/CNT 4.0 |
|
APP |
Tuxedo 6.4 |
|
MAC |
08:00:20:7C:47:50 |
|
IP |
206.189.43.14 |
|
NAME |
beasun2 |
| Name | Attribute |
|---|---|
|
OS |
MVS 5.22 9510 |
|
SNA |
VTAM 4.3 |
|
APP |
CICS 4.1 / IMS DC 5.1 |
|
MAC |
10:00:5a:d4:3e:8e |
|
IP |
206.189.43.98 |
|
NAME |
beavs |
| Name | Attribute |
|---|---|
|
OS |
OS/390 1.2 |
|
SNA |
VTAM 4.3 |
|
APP |
CICS 4.1 |
|
MAC |
10:00:5a:d4:c1:e0 |
|
IP |
206.189.43.96 |
|
NAME |
dalvs2 |
(For future reference.) HPSNAPlus2 configurations are usually setup using the HP xSnapAdmin utility, resulting in the configuration text file You must involve your mainframe system support personnel early in the process. In a large shop there will most likely be separate individuals responsible for MVS, VTAM, and CICS. Make sure everyone is involved. Hopefully most of the configuration for your mainframe has already been done.
These samples are provided for illustration. Mainframe technical support is not trivial, and this is not intended to train you in all of the possible configurations. These samples represent one way a P390 can be configured to work in an APPN LAN environment.
The example below is the VTAM start list for the BEAVS P390 machine. It supports both the subarea and APPN environments.
This definition is set up for use with a 3172 (emulated) for connecting an APPN network node to another APPN node. Note that it is for an Ethernet LAN and the SAPADDR specified must be the same as the LSap specified for the local link station.
The three switched network definition examples in this section specify the VTAM PU, representing the local link stations that expect to connect with the host machine. The 10BLK and IDNUM definitions are provided to support 3270 traffic and must be unique, as well as match the values specified in the local link definition.
These examples represent the partner LU definitions to be accessed from the local environment. The APPL names must match those specified in the partner LU definitions on the local machine.
CICS connection and session definitions map the VTAM path definitions for the CICS application. Each connection represents one local LU definition in the local SNA configuration, therefore, the names must match.
CICS session definitions associate a VTAM mode with the LU specified in the connection. The mode names and session count characteristics must match those specified in the mode definitions for the local SNA configuration. Note that these definitions set AUTOCONNECT to "YES," allowing automatic session acquisition for a CICS client application.
Local Environment Configuration
/etc/opt/sna/sna_node.cfg. This file can be manually created and/or maintained using a text editor, however, using the HP xSnapAdmin utility is recommended. The example below is the sna_node.cfg file for the sample environment.
HPSNAPlus2 Configuration
[define_node_config_file]
major_version = 5
minor_version = 1
update_release = 1
revision_level = 116
[define_node]
node_name = dalhp10
description = snacrm development
node_type = END_NODE
fqcp_name = BEALAN.DALHP10
cp_alias = dalhp10
mode_to_cos_map_supp = NO
mds_supported = YES
node_id = <05ffffff>
max_locates = 100
dir_cache_size = 255
max_dir_entries = 0
locate_timeout = 60
reg_with_nn = YES
reg_with_cds = YES
mds_send_alert_q_size = 100
cos_cache_size = 24
tree_cache_size = 40
tree_cache_use_limit = 40
max_tdm_nodes = 0
max_tdm_tgs = 0
max_isr_sessions = 1000
isr_sessions_upper_threshold = 900
isr_sessions_lower_threshold = 800
isr_max_ru_size = 16384
isr_rcv_pac_window = 8
store_endpt_rscvs = NO
store_isr_rscvs = NO
store_dlur_rscvs = NO
dlur_support = YES
pu_conc_support = NO
nn_rar = 128
ptf_flags = NONE
[define_ethernet_dlc]
dlc_name = ETHER0
description = ""
neg_ls_supp = YES
initially_active = NO
adapter_number = 0
[define_ethernet_port]
port_name = ethl0
description = 1st ethernet adapter
dlc_name = ETHER0
port_type = PORT_SATF
port_number = 1
max_rcv_btu_size = 1033
tot_link_act_lim = 64
inb_link_act_lim = 0
out_link_act_lim = 0
ls_role = LS_NEG
act_xid_exchange_limit = 9
nonact_xid_exchange_limit = 5
ls_xmit_rcv_cap = LS_TWS
max_ifrm_rcvd = 7
target_pacing_count = 7
max_send_btu_size = 1033
mac_address = <000000000000>
lsap_address = 0x08
implicit_cp_cp_sess_support = NO
implicit_limited_resource = NO
implicit_deact_timer = 0
effect_cap = 3993600
connect_cost = 0
byte_cost = 0
security = SEC_NONSECURE
prop_delay = PROP_DELAY_LAN
user_def_parm_1 = 0
user_def_parm_2 = 0
user_def_parm_3 = 0
initially_active = YES
test_timeout = 5
test_retry_limit = 2
xid_timeout = 5
xid_retry_limit = 2
t1_timeout = 5
t1_retry_limit = 5
[define_ethernet_ls]
ls_name = P390HP10
description = P390 - beavs
port_name = ethl0
adj_cp_name = P390.USS3270
adj_cp_type = LEARN_NODE
mac_address = <0020af543176>
lsap_address = 0x08
auto_act_supp = NO
tg_number = 0
limited_resource = NO
solicit_sscp_sessions = NO
pu_name = <0000000000000000>
disable_remote_act = NO
default_nn_server = NO
dspu_services = NONE
dspu_name = <0000000000000000>
dlus_name = <0000000000000000000000000000000000>
bkup_dlus_name = <0000000000000000000000000000000000>
link_deact_timer = 0
use_default_tg_chars = YES
ls_attributes = SNA
adj_node_id = <00000000>
local_node_id = <00000000>
cp_cp_sess_support = YES
effect_cap = 3993600
connect_cost = 0
byte_cost = 0
security = SEC_NONSECURE
prop_delay = PROP_DELAY_LAN
user_def_parm_1 = 0
user_def_parm_2 = 0
user_def_parm_3 = 0
target_pacing_count = 7
max_send_btu_size = 1033
ls_role = USE_PORT_DEFAULTS
initially_active = NO
react_timer = 30
react_timer_retry = 65535
test_timeout = 5
test_retry_limit = 2
xid_timeout = 5
xid_retry_limit = 2
t1_timeout = 5
t1_retry_limit = 5[define_local_lu]
lu_name = LUHP10A
description = Test LU #1
lu_alias = LUHP10A
nau_address = 0
syncpt_support = YES
lu_session_limit = 0
default_pool = NO
pu_name = <0000000000000000>
sys_name = ""
timeout = -1
back_level = NO
[define_local_lu]
lu_name = LUHP10B
description = Test LU #2
lu_alias = LUHP10B
nau_address = 0
syncpt_support = YES
lu_session_limit = 0
default_pool = NO
pu_name = <0000000000000000>
sys_name = ""
timeout = -1
back_level = NO
[define_local_lu]
lu_name = LUHP10C
description = Test LU #3
lu_alias = LUHP10C
nau_address = 0
syncpt_support = YES
lu_session_limit = 0
default_pool = NO
pu_name = <0000000000000000>
sys_name = ""
timeout = -1
back_level = NO
[define_partner_lu]
description = APPC MVS LU for IMS
fqplu_name = P390.MVSLU01
plu_alias = MVSLU01
plu_un_name = MVSLU01
max_mc_ll_send_size = 32767
conv_security_ver = NO
parallel_sess_supp = YES[define_partner_lu]
description = backend cics #1
fqplu_name = P390.C410XB01
plu_alias = C410XB01
plu_un_name = C410XB01
max_mc_ll_send_size = 32767
conv_security_ver = NO
parallel_sess_supp = YES
[define_partner_lu]
description = Second backend cics
fqplu_name = P390.C410XB02
plu_alias = CICS2
plu_un_name = C410XB02
max_mc_ll_send_size = 32767
conv_security_ver = NO
parallel_sess_supp = YES
[define_mode]
mode_name = SMSNA100
description = Sessions: 10 -- 5,5
max_ru_size_upp = 1024
receive_pacing_win = 4
default_ru_size = YES
max_neg_sess_lim = 256
plu_mode_session_limit = 10
min_conwin_src = 5
cos_name = #CONNECT
cryptography = NONE
auto_act = 0 Remote Environment Configurations
ATCSTRxx VTAM Start List
* --------------------------
* VTAM START LIST FOR SYS1
* --------------------------
BN=YES, X
BNDYN=FULL, X
XNETALS=YES, X
SSCPID=06,NOPROMPT, X
CONFIG=00,MAXSUBA=31,SUPP=NOSUP, X
SSCPNAME=USS3270, X
NETID=P390, X
NODETYPE=NN, X
HOSTSA=6, X
CRPLBUF=(208,,15,,1,16), X
IOBUF=(100,512,19,,1,20), X
LFBUF=(104,,0,,1,1), X
LPBUF=(64,,0,,1,1), X
SFBUF=(163,,0,,1,1) XCA Major Node Defines the LAN Adapter for SYS1
******************************************************
* Emulated 3172 XCA MAJOR NODE FOR HOST beavs
*****************************************************
XETH2LP1 VBUILD TYPE=XCA ** EXTERNAL COMMUNICATION ADAPT**
PORTE2 PORT ADAPNO=1, ** 3172 RELATIVE ADAPTER NUMBER**
CUADDR=E22, ** CHANNEL UNIT ADDRESS **
MEDIUM=CSMACD, ** LAN TYPE=ETHERNET **
SAPADDR=8, ** SERVICE ACCESS POINT ADDRESS**
TIMER=120 ** CHANNEL ACTIVATE RESP TIME **
*
G1ETH2 GROUP DIAL=YES, ** YES required for putype 2 **
DYNPU=YES,
CALL=INOUT,
ANSWER=ON,
ISTATUS=ACTIVE
LETH20 LINE
PETH20 PU
LETHE3 LINE
PETHE3 PU
LETHF3 LINE
PETHF3 PU Switched Network (SWNET) Definitions
SWNET Major Node (DALHP10)
SWNETHHP VBUILD TYPE=SWNET,MAXNO=3,MAXGRP=3
P390HP10 PU ADDR=02,
IDBLK=05F,
IDNUM=FFFFF,
PUTYPE=2,
NETID=BEALAN,
CPNAME=DALHP10,
MAXPATH=3,
DWACT=YES,
CONNTYPE=APPN,
CPCP=YES,
DYNLU=YES
* -------------------------------------------------
* SNA SAP & HP10 MAC ADDRESS BIT REVERSED FOR TRFMT
* -------------------------------------------------
PATHHP PATH DIALNO=00041000900C24EE,
GRPNM=G1ETH2
LUHP10A LU LOCADDR=0
LUHP10B LU LOCADDR=0
LUHP10C LU LOCADDR=0 SWNET Major Node (SUN2)
SWNETH2 VBUILD TYPE=SWNET,MAXNO=3,MAXGRP=3
P390ETH2 PU ADDR=04,
IDBLK=019,
IDNUM=10092,
PUTYPE=2,
NETID=BEALAN,
CPNAME=SUN2,
MAXPATH=3,
DWACT=YES,
CONNTYPE=APPN,
CPCP=YES,
DYNLU=YES
* -------------------------------------------------
* SNA SAP & SUN2 MAC ADDRESS BIT REVERSED FOR TRFMT
* -------------------------------------------------
PATH01 PATH DIALNO=00081000043EE20A,
GRPNM=G1ETH2
LUSUN2A LU LOCADDR=0
LUSUN2B LU LOCADDR=0
LUSUN2C LU LOCADDR=0 SWNET Major Node ((SUN4)
SWNESUN4 VBUILD TYPE=SWNET,MAXNO=3,MAXGRP=3
P390ETH4 PU ADDR=03,
IDBLK=018,
IDNUM=10092,
PUTYPE=2,
NETID=BEALAN,
CPNAME=SUN4,
MAXPATH=3,
DWACT=YES,
CONNTYPE=APPN,
CPCP=YES,
DYNLU=YES
* -------------------------------------------------
* SNA SAP & SUN4 MAC ADDRESS BIT REVERSED FOR TRFMT
* -------------------------------------------------
PATHSL4 PATH DIALNO=0008100002E1E2B4,
GRPNM=G1ETH2
LUSUN4A LU LOCADDR=0
LUSUN4B LU LOCADDR=0
LUSUN4C LU LOCADDR=0 VTAM Application Major Nodes for CICS Regions
BEACICS VBUILD TYPE=APPL APPLICATION MAJOR NODE
* APPL DEFINITION STATEMENTS FOR CICS
* CICS 4.10 BACKEND REGION #1 SYSID=B41A
C410XB01 APPL EAS=64, ESTIMATED CONCURRENT SESSIONS
MODETAB=ISTINCLM, MAKE SURE DEFAULT MODETAB
PARSESS=YES,
AUTH=(ACQ,BLOCK,PASS) CICS CAN ACQUIRE & PASS TMLS
CICS CAN REQUEST BLOCKED INPUT
C410XB02 APPL EAS=64, ESTIMATED CONCURRENT SESSIONS
MODETAB=ISTINCLM, MAKE SURE DEFAULT MODETAB
PARSESS=YES,
AUTH=(ACQ,BLOCK,PASS) CICS CAN ACQUIRE & PASS TMLS
CICS CAN REQUEST BLOCKED INPUT
C410XB03 APPL EAS=64, ESTIMATED CONCURRENT SESSIONS
MODETAB=ISTINCLM, MAKE SURE DEFAULT MODETAB
PARSESS=YES,
AUTH=(ACQ,BLOCK,PASS) CICS CAN ACQUIRE & PASS TMLS
CICS CAN REQUEST BLOCKED INPUT
* #######################
* END OF BEACICS APPL DEF
* ####################### CICS Resource Definition Entries (RDO)
LIST GROUP(BEAHP10) OBJECTS
GROUP NAME: BEAHP10
----------
CONNECTIONS: FHPA FHPB FHPC
SESSION FHPA FHPB FHPC
CONNECTION(FHPA) GROUP(BEAHP10)
DESCRIPTION(1ST HP SNAP2+ CONNECTION)
CONNECTION-IDENTIFIERS
NETNAME(LUHP10A) INDSYS()
REMOTE-ATTRIBUTES
REMOTESYSTEM() REMOTENAME() REMOTESYSNET()
CONNECTION-PROPERTIES
ACCESSMETHOD(VTAM) PROTOCOL(APPC) CONNTYPE()
SINGLESESS(NO) DATASTREAM(USER) RECORDFORMAT(U)
QUEUELIMIT(NO) MAXQTIME(NO)
OPERATIONAL-PROPERTIES
AUTOCONNECT(NO) INSERVICE(YES)
SECURITY
SECURITYNAME() ATTACHSEC(LOCAL) BINDSECURITY(NO)
USEDFLTUSER(NO)
RECOVERY
PSRECOVERY(SYSDEFAULT)CONNECTION(FHPB) GROUP(BEAHP10)
DESCRIPTION(2ND HP SNA+ 2 CONNECTION)
CONNECTION-IDENTIFIERS
NETNAME(LUHP10B) INDSYS()
REMOTE-ATTRIBUTES
REMOTESYSTEM() REMOTENAME() REMOTESYSNET()
CONNECTION-PROPERTIES
ACCESSMETHOD(VTAM) PROTOCOL(APPC) CONNTYPE()
SINGLESESS(NO) DATASTREAM(USER) RECORDFORMAT(U)
QUEUELIMIT(NO) MAXQTIME(NO)
OPERATIONAL-PROPERTIES
AUTOCONNECT(YES) INSERVICE(YES)
SECURITY
SECURITYNAME() ATTACHSEC(LOCAL) BINDSECURITY(NO)
USEDFLTUSER(NO)
RECOVERY
PSRECOVERY(SYSDEFAULT)CONNECTION(FHPC) GROUP(BEAHP10)
DESCRIPTION(3RD HP SNA+ 2 CONNECTION)
CONNECTION-IDENTIFIERS
NETNAME(LUHP10C) INDSYS()
REMOTE-ATTRIBUTES
REMOTESYSTEM() REMOTENAME() REMOTESYSNET()
CONNECTION-PROPERTIES
ACCESSMETHOD(VTAM) PROTOCOL(APPC) CONNTYPE()
SINGLESESS(NO) DATASTREAM(USER) RECORDFORMAT(U)
QUEUELIMIT(NO) MAXQTIME(NO)
OPERATIONAL-PROPERTIES
AUTOCONNECT(NO) INSERVICE(YES)
SECURITY
SECURITYNAME() ATTACHSEC(LOCAL) BINDSECURITY(NO)
USEDFLTUSER(NO)
RECOVERY
PSRECOVERY(SYSDEFAULT) SESSIONS(FHPA) GROUP(BEAHP10)
DESCRIPTION(1ST HP SNAP2+ SESSION)
SESSION-IDENTIFIERS
CONNECTION(FHPA) SESSNAME() NETNAMEQ()
MODENAME(SMSNA100)
SESSION-PROPERTIES
PROTOCOL(APPC) MAXIMUM(32,16) RECEIVEPFX()
RECEIVECOUNT() SENDPFX() SENDCOUNT()
SENDSIZE(4096) RECEIVESIZE(4096) SESSPRIORITY(0)
PRESET-SECURITY
USERID()
OPERATIONAL-PROPERTIES
AUTOCONNECT(NO) BUILDCHAIN(YES) USERAREALEN(0)
IOAREALEN(0,0) RELREQ(NO) DISCREQ(NO)
NEPCLASS(0)
RECOVERY
RECOVOPTION(SYSDEFAULT)
SESSIONS(FHPB) GROUP(BEAHP10)
DESCRIPTION(2ND HP SNAP2+ SESSION)
SESSION-IDENTIFIERS
CONNECTION(FHPB) SESSNAME() NETNAMEQ()
MODENAME(SMSNA100)
SESSION-PROPERTIES
PROTOCOL(APPC) MAXIMUM(32,16) RECEIVEPFX()
RECEIVECOUNT() SENDPFX() SENDCOUNT()
SENDSIZE(4096) RECEIVESIZE(4096) SESSPRIORITY(0)
PRESET-SECURITY
USERID()
OPERATIONAL-PROPERTIES
AUTOCONNECT(YES) BUILDCHAIN(YES) USERAREALEN(0)
IOAREALEN(0,0) RELREQ(NO) DISCREQ(NO)
NEPCLASS(0)
RECOVERY
RECOVOPTION(SYSDEFAULT) SESSIONS(FHPC) GROUP(BEAHP10)
DESCRIPTION(3RD HPSNAP2+ SESSION)
SESSION-IDENTIFIERS
CONNECTION(FHPC) SESSNAME() NETNAMEQ()
MODENAME(SMSNA100)
SESSION-PROPERTIES
PROTOCOL(APPC) MAXIMUM(10,5) RECEIVEPFX()
RECEIVECOUNT() SENDPFX() SENDCOUNT()
SENDSIZE(4096) RECEIVESIZE(4096) SESSPRIORITY(0)
PRESET-SECURITY
USERID()
OPERATIONAL-PROPERTIES
AUTOCONNECT(YES) BUILDCHAIN(YES) USERAREALEN(0)
IOAREALEN(0,0) RELREQ(NO) DISCREQ(NO)
NEPCLASS(0)
RECOVERY
RECOVOPTION(SYSDEFAULT)