IBM TXSeries CICS8.2.2 For Linux 下 WLM配置说明文档-单机版

1 开始配置 TXSeries 的 WLM 前,需要先了解几个 WLM 的概念。
a) PLEX: Plex is a group of intercommunicating TXSeries Systems.
b) COR: COR is Client Owning Region. This region handles the incoming requests from the clients.
c) AOR: AOR is Application Owning Region. The business applications are deployed in an AOR.
d) ROUTING MONITOR: Applications that monitor the WLM plex.
e) WAP: WAP is WLM Application Program Cache. The WAP is the central control point of a CICS WLM configuration. The initial configuration information and updates to the
configuration are deposited in the WAP.
f) WCM: WCM is WLM cache manager located on each server on which a workload management routing decision occurs. The WAP cache transfers data to the local WCM
cache.
g) HMON : It is Health Monitor application that monitors health of the regions in WLM.
以下是 WLM 的目录结构:
目录 描述
/opt/ibm/cicssm Directory contains all the WLM runtime components, samples
/opt/ibm/cicssm/msg Directory contains language specific message catalogue files for WLM components
/opt/ibm/cicssm/lib Directory contains WLM runtime components
/opt/ibm/cicssm/bin Directory contains WLM runtime executables and setup scripts
/opt/ibm/cicssm/samples Makefile to setup WLM environment, sample client applications
/var/cicssm Directory contains all the WLM specific configuration, data and log files.
/var/cicssm/log Directory contains console messages from the WLM processes. Trace and debug messages are also created under this directory, if enabled.
/var/cicssm/repos Directory contains the WLM configuration file
2 TxseriesWLM Region 配置
此文档中, COR 为 CORSC、 AOR 为 AOR1SC、 AOR2SC
2.1 COR ( Client Owning Region ) 配置
2.1.1 创建 COR
执行命令:
cicscp –v create region CORSC DefaultFileServer=/.:/cics/sfs/rhel7SFS
2.1.2 更新 Region 定义
a ) RD 定义
#SysId 用于 wlm 的配置,也是 AOR CD 到 COR 的 CD 名称
#出口程序需要缓存在内存中,不退出,所以需要设置 ProgramCacheSize
cicsupdate -c rd -r CORSC LocalSysId=COR1
cicsupdate -c rd -r CORSC ProgramCacheSize=10//主要为了缓存 3 个出口程序
b) PD 定义
#以下三个 PD 是 wlm 的出口程序, COR 都需要配置上
cicsadd -c pd -r CORSC BHGDPL PathName=/opt/ibm/cicssm/bin/bhgdpl UserExitNumber=50 Resident=yes
cicsadd -c pd -r CORSC BHGDPLSP PathName=/opt/ibm/cicssm/bin/bhgdplsp UserExitNumber=51 Resident=yes
cicsadd -c pd -r CORSC BHGDTR PathName=/opt/ibm/cicssm/bin/bhgdtr UserExitNumber=25 Resident=yes
#测试用的 PD,此 PD 不需要写具体路径,只需要写 RemoteSysID,此 ID 为
#COR 到 AOR 的默认路由,也是 COR 里 CD 的名称之一
cicsadd -c pd -r CORSC IBMTRAN RemoteSysId=AOR1 RSLKey=public
c) LD 定义
#TCPService 的值需要在/etc/services 里面配置(CORSC,AOR1SC,AOR2SC的LD定义里的TCPService的值 在/etc/services的设置在文章最后附上)
cicsadd -c ld -r CORSC LD01 Protocol=TCP TCPAddress=rhel7 TCPService=tcpcor1sc
d) CD 定义
cicsadd -c cd -r CORSC AOR1 ConnectionType=cics_tcp RemoteLUName=AOR1SC ListenerName=LD01 RemoteTCPAddress=rhel7 RemoteTCPPort=29002
cicsadd -c cd -r CORSC AOR2 ConnectionType=cics_tcp RemoteLUName=AOR2SC ListenerName=LD01 RemoteTCPAddress=rhel7 RemoteTCPPort=29003
2.1.3 环境变量配置
保证 environment 中 LIBPATH 中包含/opt/ibm/cicssm/lib 部分,否则加载出
口程序无法加载成功, COR 无法在 WAP 中注册。
LIBPATH=/opt/ibm/cicssm/lib:/opt/ibm/cics/lib
2.2 AOR ( Application Owning Region ) 配置
2.2.1 创建 AOR
cicscp -v create region AOR1SC
cicscp -v create region AOR2SC
2.2.2 更新 Region 定义
a ) RD 定义
#SysId 用于 wlm 的配置,也是 COR CD 到 AOR 的 CD 名称
cicsupdate -c rd -r AOR1SC LocalSysId=AOR1
cicsupdate -c rd -r AOR2SC LocalSysId=AOR2
#以下配置是用于 AOR 与 WAP 的通讯,启动、停止的时候往 wlmlistener
发送相关数据消息通知 WAP AOR 启动、停止了。 If the AOR region is part of more
than one environment, you need to use the | symbol after the IP address and port
number, For example
#WLMListenerList=”{IP_address_01,Port_01}|{IP_address_02,Port_02}”.
cicsupdate –c rd –r AOR1SC WLMListenerList=”{rhel7,19124}”
cicsupdate –c rd –r AOR2SC WLMListenerList=”{rhel7,19124}”
b) PD 定义
#以下 PD 是 AOR 的实体测试程序
cicsadd -c pd -r AOR1SC IBMTRAN PathName=ibm_disptran_server RSLKey=public
cicsadd -c pd -r AOR2SC IBMTRAN PathName=ibm_disptran_server RSLKey=public
c) LD 定义
#TCPService 的值需要在/etc/services 里面配置(CORSC,AOR1SC,AOR2SC的LD定义里的TCPService的值 在/etc/services的设置在文章最后附上)
cicsadd -c ld -r AOR1SC LD01 Protocol=TCP TCPAddress=rhel7 TCPService=tcpaor1sc
cicsadd -c ld -r AOR2SC LD01 Protocol=TCP TCPAddress=rhel7 TCPService=tcpaor2sc
d) CD 定义
cicsadd -c cd -r AOR1SC COR1 ConnectionType=cics_tcp RemoteLUName=CORSC ListenerName=LD01 RemoteTCPAddress=rhel7 RemoteTCPPort=29001
cicsadd -c cd -r AOR2SC COR1 ConnectionType=cics_tcp RemoteLUName=CORSC ListenerName=LD01 RemoteTCPAddress=rhel7 RemoteTCPPort=29001
2.3 CTG 配置
配置 ctg.ini,将三个 region 都配置到其中,并要求 RegionName 和 ServerName 一
样,否则 WLM 组件将不能正确监控 Region 的运行状态。
配置如下所示:
SECTION SERVER = CORSC
Description = TCPIPServer
protocol = TCPIP
NetName = 192.168.179.18
port = 29001
ConnectTimeout = 15
TcpKeepAlive = Y
ENDSECTION

SECTION SERVER = AOR2SC
Description = TCPIPServer
protocol = TCPIP
NetName = 192.168.179.18
port = 29003
ConnectTimeout = 15
TcpKeepAlive = Y
ENDSECTION

SECTION SERVER = AOR1SC
Description = TCPIPServer
protocol = TCPIP
NetName = 192.168.179.18
port = 29002
ConnectTimeout = 15
TcpKeepAlive = Y
ENDSECTION
3 Txseries WLM 配置
3.1 操作系统环境检查
检查该文件/etc/services,确认下面两行没有被注释
echo 7/tcp # Echo
echo 7/udp # Echo
RedhatLinux7默认没有安装inetd,所以 在/etc下找不到inetd.conf文件,需要用yum 安装xinetd。安装完后,就在/etc找到xinetd.conf文件, 查看xinetd.conf文件,可以看到,这个文件最后调用/etc/xinetd.d下的文件,从这个文件夹看到,有两个文件:echo-dgram,echo-stream ,编辑这两个文件,将disable = yes 改成 disable = no
3.2 WLM 初始化
a ) 初始化文件指定 WAP 的位置。使用 cicssm 用户编辑
/var/cicssm/repos/cicssm.config 文件:
wap wap1 rhel7 9123
b) 使用 cicssm 用户执行命令: (该命令在/var/cicssm/repos 下创建 wap.wap1 文件)
cicswlm configure wlm wap1
//cicswlm configure wlm -h rhel7 -w wap1 -p 9123
c) 修改 wlmlsnr.cfg 配置文件,用于指定 CICS WLM LISTENER
wap1 19124
c) 在/opt/ibm/cicssm/bin/setwlmenv.sh 设置以下环境变量:
export BHG_WAP_WAP_NAME=”rhel7 9123″
export BHG_WAP_MESSAGE_CATALOGUE=cicssm.cat
export BHG_WCM_WAP_NAME=”rhel7 9123″
export BHG_WCM_MESSAGE_CATALOGUE=cicssm.cat
export BHG_HMON_WAP_NAME=”rhel7 9123″
export BHG_HMON_MESSAGE_CATALOGUE=cicssm.cat
export BHG_WLMLOAD_MESSAGE_CATALOGUE=cicssm.cat
#如果 plex name 不是默认的 cpx1,下面三个变量必须设置
#这个 group 的名称和 plex 里面的 group 没关系
export BHG_WCL_GROUP_NAME=grp1
#这个 plex name 就是配置中的 plex name
export BHG_WCL_grp1_CICSPLEX_NAME=cpx1
export BHG_WCL_MESSAGE_CATALOGUE=cicssm.cat
export LIBPATH=/opt/ibm/cicssm/lib:/usr/lib:/opt/ibm/cics/lib
export CICS_HOSTS=rhel7
3.3 创建 plexdb
#plexdb 是存储 CICS 整个 WLM 的信息的配置文件,命令运行后将生成文件
/var/cicssm/repos/wlm.cfg
#执行以下命令进行创建:
cicswlmcfg create plexdb wlm
3.4 创建 plex
#创建一个名为 cpx1 的 plex
cicswlmcfg create plex cpx1 -d wlm
3.5 创建 wlm 中的 group
#group 是 wlm 中的分组, 这里 group1 和 group2 分别给 cor 和 aor
cicswlmcfg create group GROUP1 -p cpx1 -d wlm
cicswlmcfg create group GROUP2 -p cpx1 -d wlm
3.6 添加 group 的成员
#将 CORSC 加入 group1, AOR1SC 和 AOR2SC 加入 group2
cicswlmcfg add region CORSC -g GROUP1 -h rhel7 -p cpx1 -d wlm
cicswlmcfg add region AOR1SC -g GROUP2 -h rhel7 -p cpx1 -d wlm
cicswlmcfg add region AOR2SC -g GROUP2 -h rhel7 -p cpx1 -d wlm
3.7 为 COR 添加到 AOR 的连接
#AOR1、 AOR2 是 CORSC 中的 CD 名称, COR1 是各 AOR 反向的 CD 名称。
cicswlmcfg add connection AOR1 -r CORSC -R AOR1SC -S COR1 -p cpx1 -d wlm inService=1
cicswlmcfg add connection AOR2 -r CORSC -R AOR2SC -S COR1 -p cpx1 -d wlm inService=1
3.8 添加 PD 到 AOR 所在的 group
#添加 PD 到 AOR 所在的 group,让 PD 成为可以转发的程序
cicswlmcfg add program IBMTRAN -g GROUP2 -p cpx1 -d wlm
4 Txseries WLM 启动与停止
4.1 WLM 的启动
使用 cicssm 用户(root 用户都无法执行)执行以下命令,依次启动组件 wap、 wcm、
wlmlsnr 和 hmon
. /opt/ibm/cicssm/bin/setwlmenv.sh
cicswlm start wap wap1
cicswlm start wcm wap1
cicswlm verify wlm.cfg
cicswlm load wlm.cfg wap1
wlmlsnr -s start -p cpx1 -d wlm -w wap1
// cpx1 is the Plex Name / wap1 is the Wap Name/ wlm is the Config_filename
cicswlm start hmon wap1
4.2 WLM 的停止
使用 cicssm 用户执行以下命令
. /opt/ibm/cicssm/bin/setwlmenv.sh
cicswlm stop all
cicswlm clean wlm
5 Txseries WLM 监控
加载环境变量. /opt/ibm/cicssm/bin/setwlmenv.sh
运行命令 cicswlmstat, 有如下输出

CORSC,AOR1SC,AOR2SC的LD定义里的TCPService的值 在/etc/services的设置如下所示,就是增加tcpcor1sc,tcpaor1sc,tcpaor2sc的值,分别对应端口:29001,29002,29003.

vi /etc/service 增加如下:
tcpcor1sc 29001/tcp
tcpaor1sc 29002/tcp
tcpaor2sc 29003/tcp

常用的WLM性能监控与命令:
检查WLM状态
cicswlmstat
检查WLM进程
ps -eaf|grep bhg
ps -ef | grep wlmlsnr
netstat -an | grep 19124
netstat -an | grep 9123

以下文章点击率最高

Loading…

发表评论