|
|
|
|
|
|
Sample VTAM Configurations
This section provides sample environments showing how BEA eLink Adapter for Mainframe (eAM) software 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.
This section discusses the following topics:
Overview of the eAM Environment
An environment properly configured for the BEA eLink Adapter for Mainframe system involves two general components, a local environment and a remote environment.
Local Environment
A local environment is a UNIX-based machine running eAM software. BEA eLink Adapter for Mainframe is a fully bi-directional program, supporting the local system as either a client or server. This environment consists of the following components:
A remote environment is an IBM mainframe that may or may not be on the same local network. As in the local environment, BEA eLink Adapter for Mainframe is a fully bi-directional program, supporting the remote system as either a client or server. This environment consists of the following components:
Sample Environments
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.
Machine Attributes (LAN Descriptions)
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.
|
Name |
Attribute |
|---|---|
|
OS |
Solaris 2.5.1 or 2.6 |
|
SNA |
Brixton/CNT 4.1 |
|
APP |
Tuxedo 6.5 |
|
MAC |
08:00:20:7C:47:50 |
|
IP |
206.189.43.14 |
|
NAME |
beasun2 |
|
Name |
Attribute |
|---|---|
|
OS |
Solaris 7 or Solaris 8 |
|
SNA |
SunLink 9.1 |
|
APP |
Tuxedo 6.5 |
|
MAC |
08:00:20:87:47:2d |
|
IP |
206.189.43.54 |
|
NAME |
dalsun4 |
|
Name |
Attribute |
|---|---|
|
OS |
HP-US B 11.00 |
|
SNA |
HP SNAPlus 6.0 |
|
APP |
Tuxedo 6.5 |
|
MAC |
08:00:09:30:24:77 |
|
IP |
206.189.43.13 |
|
NAME |
dalhp10 |
|
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 |
|
Name |
Attribute |
|---|---|
|
OS |
Windows NT Server 4.0, SP2 |
|
SNA |
IBM Comm Server 6.0 |
|
APP |
CICS 4.1 |
|
MAC |
10:00:5a:d4:c1:e0 |
|
IP |
206.189.43.99 |
|
NAME |
dalnt |
Local Environment Configuration
HPSNAPlus2 configurations are usually set up using the HP xSnapAdmin utility, resulting in the configuration text file /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 = #eLink
cryptography = NONE
auto_act = 0
Microsoft SNA Cross-Platform Definitions
Be sure to communicate with the administrator of the CICS/ESA remote domain to obtain key parameters in the VTAM definition that must be included in the Microsoft SNA Server configuration, as well as in other configuration files in the eAM local domain.
Before installing eAM software, please examine the following general procedure for configuring the Microsoft SNA Server. Use the Microsoft SNA Server Manager GUI. Sample values are shown in parenthesis. Consult with the VTAM system administrator to obtain the proper values.
Server: MVSNT1
Subdomain: MVSNT1
Server Role: Primary
Network Transports: TCP/IP
In the link service Properties, define DLC 802.2 Link Service Configuration:
Title: DLC 802.2 Link Service #1
Adapter: <your ethernet adapter>
Local Service Access Point (SAP): 0x4
Use Fixed SAP
In the MVSNT1 Properties, define:
General
Name: MVSNT1
Link Service: SnaDlc1
Remote End: Peer System
Allowed Directions: Both Directions
Activation: On Server Startup
Supports Dynamic Remote APPC LU Definition
Address
Remote Network Address: <host MAC address>
Remote SAP Address: <host SAP address>
System Identification
Local Node Name
Network Name: <mynetwork>
Control Point Name: MVSNT1
Local Node ID: <xxx nnnn> XID Type: Format 3
Remote Node Name
Network Name: <hostnetwork>
Control Point Name: <vtamcpname>
Remote Node ID: Peer DLC Role: Negotiable
Compression Type: None
802.2 DLC
Take Defaults
General
LU Alias: LUNT1A
Network Name: <mynetwork>
LU Name: LUNT1A
Advanced
Take Defaults
General
Connection: MVSNT1
LU Alias: CICS1
Network Name: <hostnetwork>
LU Name: CICS1
Uninterpreted Name: CICS1
Options
Take Defaults
General
Mode Name: SMSNA100
Limits
Parallel Session Limit: <max sessions>
Minimum Winner Contention Limit: <min winners>
Partner Min Winner Contention Limit: <max sessions - min winners>
Automatic Activation Limit: 0
Characteristics
Take Defaults
Partners
Add partnership for Server Name: MVSNT1 between Local LU: LUNT1A and Partner LU: CICS1
Compression
Take Defaults
VTAM Application Program Major Node
The APPLID definition shown in the following listing defines the local stack configuration to run under OS/390 using VTAM.
Listing 3-1 Applid definition (OS/390)
BEAVTAM VBUILD TYPE=APPL
BEAAPPL1 APPL ACBNAME=BEAAPPL1,
AUTH=(ACQ,PASS),
APPC=YES,
SYNCLVL=SYNCPT,
PARSESS=YES
Remote Environment Configurations
You must involve your mainframe system support personnel early in the process. Make sure everyone is involved. Most of the configuration for your mainframe should have already been done.
These samples are provided for illustration. Mainframe technical support is important. This documentation is not intended demonstate all of the possible configurations. These samples represent one way a P390 can be configured to work in an APPN LAN environment.
ATCSTRxx VTAM Start List
The example below is the VTAM start list for the BEAVS P390 machine. It supports both the subarea and APPN environments.
* --------------------------*
* VTAM START LIST FOR SYS1 *
* --------------------------*
BN=YES,
BNDYN=FULL,
XNETALS=YES,
SSCPID=06,NOPROMPT,
CONFIG=00,MAXSUBA=31,SUPP=NOSUP,
SSCPNAME=USS3270,
NETID=P390,
NODETYPE=NN,
HOSTSA=6,
CRPLBUF=(208,,15,,1,16),
IOBUF=(100,512,19,,1,20),
LFBUF=(104,,0,,1,1),
LPBUF=(64,,0,,1,1),
SFBUF=(163,,0,,1,1)
XCA Major Node Defines the LAN Adapter for SYS1
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.
******************************************************
* 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
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.
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
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.
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)
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.
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)
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|