#cicsadd –c ld -r regionA LSNA Protocol=TCP TCPAddress=192.168.220.130 TCPService=”DPL_1436″

#cicsadd –c cd -r regionA RGNB ConnectionType=cics_tcp RemoteLUName=”regionB”

RemoteTCPAddress=192.168.220.129 RemoteTCPPort=1437 ListenerName=”LSNA”

regionB配置

#cicsadd –c pd -r regionB progB PathName=programB RSLKey=public

#vi /etc/services

添加：DPL_1437 1437/tcp

#cicsadd –c ld -r regionB LSNB Protocol=TCP TCPAddress=192.168.220.129 TCPService=”DPL_1437″

源代碼

請查看/Unit 5/Exercise 2目錄下的源代碼。

（3）通過FS實現regionA中的programA讀取regionB中的遠程文件。

環境

regionA地址：192.168.220.130 port:1436

regionB地址：192.168.220.129 port:1437 SFS server:/.:/cics/sfs/linux-42r7

regionA配置

#cicsadd -cpd -r regionA FunShip PathName=functionshipping RSLKey=public

#cicsadd -ctd -r regionA FSAB ProgName=FunShip

#vi /etc/services

添加：DPL_1436 1436/tcp

#cicsadd -cld -r regionA LSNA Protocol=TCP TCPAddress=192.168.220.130 TCPService=”DPL_1436″

#cicsadd -ccd -r regionA RGNB ConnectionType=cics_tcp RemoteLUName=”regionB”

RemoteTCPAddress=192.168.220.129 RemoteTCPPort=1437 ListenerName=”LSNA”

regionB配置

#vi /etc/services

添加：DPL_1437 1437/tcp

#cicsadd -cld -r regionB LSNB Protocol=TCP TCPAddress=192.168.220.129 TCPService=”DPL_1437″

測試文件

#cicsadd -c fd -r regionB rFile RSLKey=public BaseName=remotefile IndexName=id

FileServer=”/.:/cics/sfs/linux-42r7″

#cicssdt -s /.:/cics/sfs/linux-42r7 -c create remotefile

#cicssdt -s /.:/cics/sfs/linux-42r7 -c write remotefile

測試數據

源代碼

請查看/Unit 5/Exercise 3目錄下的源代碼。

TXSeries入門系列文章–單元六
監控和統計

六單元 監控和統計

關於本單元

為了確保region處於正常狀態，可以通過監控和統計幫助管理員獲得交易和資源的詳細信息，根據這些信息採取進一步的行動。本單元將介紹監控和統計工具的概念以及基本用法。用戶可以通過參閱部分的鏈接自學一些高級用法。

1. 監控

（1）監控是什麼

CICS監控工具（CICS Monitoring Facility，CMF）會在事件監控點（event-monitoring points，EMP）收集所有用戶交易和CICS系統交易在線處理期間的性能數據，用於後續的離線分析。

EMP是應用程序源代碼中CICS用於收集不同資源信息的點，信息會被寫入TDQ。對於系統定義的EMP，在任務結束時會記錄CPU時間、消耗時間、等待I/O時間等信息；對於用戶定義的EMP，需要編寫程序處理在EMP處的計數器、時間間隔、字元串等多個域的信息。

（2）使用CICS默認監控

CICS默認監控使用CICS提供的處理程序收集系統定義的EMP處的交易信息。用戶可以按照下列步驟配置和使用默認監控。

a.設置監控選項

為了使用監控工具，需要根據實際需求設置監控定義（MD）中的一些選項。用戶只能使用cicsupdate命令設置這些參數，因為MD是類型中只存在一個的特殊定義。所以沒有必要去指定MD，cicsadd命令也不能使用。

語法

cicsupdate -c md -r <regionName> MonitorStatus=<yes/no> TDQ=”<TD entry name>” Exclude=”<fields not reported>” Include=”<fields reported>”

選項

MonitorStatus：指定CICS是否進行監控。這個參數也可以通過“CEMT SET MONITOR    ON/OFF”進行設置。

TDQ：             extrapartition TDQ的名稱（隨後會進行定義）

Exclude：            不需要監控的域或者組的序號。默認情況下，會監控所有性能監控域。

Include：          需要監控的域或者組的序號。

注意Exclude和Include選項，它們可以指定一個或多個組名稱，或者數字標識符，通過逗號分隔，例如”1，3，6“。CICS 總是在Include之前處理Exclude。所以如果只需要監控一些域，可以首先使用ALL設置Exclude，然後在Include中設置組名稱或數字標識符。通過下列參閱給出的鏈接查看域和組的列表。修改MD後冷啟動region。

參閱：

關於MD：

http://www-01.ibm.com/support/knowledgecenter/SSAL2T_8.1.0/com.ibm.cics.tx.doc/reference/r_montrg_defns.html?lang=en

關於域和組：

http://www-01.ibm.com/support/knowledgecenter/SSAL2T_8.1.0/com.ibm.cics.tx.doc/reference/r_perf_montrg_flds_grps.html%23r_perf_montrg_flds_grps?lang=en

b.創建TDD

需要為region添加變長extrapartition TDQ來記錄監控信息。如果只指定文件名稱和後綴“.cmf”，則默認目標路徑是region的data目錄。關於extrapartition TDQ的信息，請參閱四單元二部分或者下列鏈接。

參閱：

http://www-01.ibm.com/support/knowledgecenter/SSAL2T_8.1.0/com.ibm.cics.tx.doc/reference/r_transnt_data_defns.html?lang=en

c.格式化監控數據

在步驟b後，若region是激活狀態並且監控狀態是yes，會生成一個後綴為”cmf“的文件。但是這個文件不能被VI之類的編輯器讀取。需要首先使用監控格式化工具”cicsmfmt“將文件格式化輸出到終端或類似txt的可讀文件。

語法

cicsmfmt <filename.cmf> [> <filename.txt>]

選項

filename.cmf：  CICS監控生成的原始文件

filename.txt：    指定的重定向可讀文件。如果不指定，則格式化結果輸出到終端

“cicsmfmt”命令的源代碼是“/opt/ibm/cics/samples/mfmt/cicsmfmt.c”，用戶可以修改文件內容並編譯生成定製化的格式化工具。

參閱：

http://www-01.ibm.com/support/knowledgecenter/SSAL2T_8.1.0/com.ibm.cics.tx.doc/reference/r_cicsmfmt.html?lang=en

（3）用戶定義監控

用戶可以通過EXEC CICS ENTER命令在自己應用程序的任何位置設置EMP，然後使用用戶定義的監控來收集多種用戶域（計數器、時間間隔、字元串等）的監控數據。用戶還需提供UserMonitorModule參數定義的程序來收集和處理性能信息。系統提供的默認的用戶性能監控源程序cics_emp.c位於”/opt/ibm/cics/samples/emp“目錄。

/Unit 6/reference目錄下提供了一些用戶監控的示例源程序。

2. 統計

（1）統計是什麼

統計提供了用於管理類似文件、隊列、journal和交易等資源的信息。它能顯示一段時間內運行了多少工作，例如一個特定文件被更新的頻率，運行中交易的數量，DPL請求的數量。很明顯統計功能可以幫助識別出現性能問題的原因。

（2）對比四種類型的統計

下表中總結和對比了CICS中的四種統計類型。

以下文章點擊率最高