はじめに

以前、z/OSのシステム管理系の情報をOSSであるELKスタックに取り込んで管理できるといいんじゃないかということで、スクリプト作ってSYSLOGを取り込んだりしてみました。
この辺↓

これは、なるべく追加の製品機能を使わずにz/OS上のログ系の情報をElasticsearchに情報を取り込んでみるという試みでした。

実は、z/OS上の管理情報を分析系のプラットフォームに流し込むのをサポートしてくれる、CDPz(Common Data Provider for System z)という有償製品があります。今回は、上の記事の発展形ということで、このCDPzなるものを使ってどういったことができるのかを試していこうと思います。

※色々試している最中にCDPzの新しいバージョン(V2.1)が出てしまったので、CDPz V2.1をインストールし直して記事も新しいエントリー作成し直しました。
CDPz V1.1レベルの古い記事はこちら => CDPzを利用したz/OS-ELK連携: セットアップ編 (CDPz V1.1)

関連記事

やりたいこと

z/OSのSYSLOGや、SMFの情報をElasticsearchに取り込んで、Kibanaで楽に可視化したい！
CDPzは、SYSLOGやJOBLOG, SMFのデータなどを、データ分析基盤(SplunkやELK)に連携する機能が提供されているらしいです！
ミドルウェアのパフォーマンステスト結果なんかを分析/レポーティングするのが楽になったらうれしいな。

全体像

(箱の下の数字は各コンポーネントがListenするポート番号)
※今回テストで使用する環境はHost=>ELKサーバー(Linux)へのTCPコネクションが張れない環境なので、テスト時に一時的にsshポートフォワードをする想定にしています。

CDPzは、上の全体像に図示した通り、主に4つのコンポーネントから成ります。
(1) Configuration Tool: 構成ツール
(2) Data Streamer: 収集したデータを別の分析基盤に送る
(3) Log Forwder: データ収集機能の1つ。主にSyslogやJobLogなどのデータを収集。
(4) System Data Engine: データ収集機能の1つ。SMSのデータを収集。

CDPz導入

CDPz V2.1を導入します。
参考: ProgramDirectory

FMID:
HHBO210 - Z Common Data Provider V2 Base
HHBO21L - Z Common Data Provider V2 Liberty

※CDPzではGUIのConfig Toolが提供されていますが、そのツールはz/OSMFのプラグインとして動作させるものと、Liberty上のアプリケーションとして動作させるものの、2パターン用意されているようです。"HHBO21L"というのは後者Liberty用のモジュールを提供するFMIDのようです。
今回はz/OSMFを使う想定なので、HHBO210の方をインストールすればよさそうです。

この辺の手順は基本的にSMP/Eを使う一般的な製品導入手順とあまり変わらないのですが一応ログを残しておきます。

下準備

使用するVolはZSPK01というボリュームを使用し、CDPZ02というHLQ以下に各種データセットを作成することにします。

UCAT作成

//DEFUCAT  JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//*-----------------------------------------------------
//STEP    EXEC PGM=IDCAMS
//SYSPRINT DD  SYSOUT=*
//SYSIN DD *
 DEFINE USERCATALOG (      +
              NAME(UCAT.CDPZ02)   +
              VOL(ZSPK01)         +
              BUFSP(8192)        +
              CYL(20 10)         +
              ICFCATALOG         +
              )
/*

Alias作成

//DEFALIAS JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//*-----------------------------------------------------
//STEP    EXEC PGM=IDCAMS
//SYSPRINT DD  SYSOUT=*
//SYSIN DD *
 DEF ALIAS(NAME(CDPZ02) RELATE(UCAT.CDPZ02))
/*

zFS準備

インストーラーそのものを配置したり、インストールの結果としてUSS上にファイルが作成されたりするので、その配置先としてのzFSを用意し、マウントしておきます。

参考: Installing Z Common Data Provider
上の情報によると、/usr/lpp/IBM/zcdp/v2r1m0/が使われるようなので、このディレクトリ下を別ファイルシステムとして作成し、マウントすることにします。

USS上に/usr/lpp/IBM/zcdp/v2r1m0/ディレクトリを作成します。

[CICS004@EPLEX1:/V1R11/usr/lpp/IBM/zcdp/v2r1m0] pwd
/V1R11/usr/lpp/IBM/zcdp/v2r1m0

CDPZ02.ZFSという名前で1200シリンダー(=18000トラック≒1GB)のzFSを作成し、マウント

//ZFSCRE   JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//*-----------------------------------------------------
//*********************************************************************
//ALLOCZ   EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD  *
   DEFINE CLUSTER(NAME(CDPZ02.ZFS) -
   LINEAR CYLINDERS(1200 120) SHAREOPTIONS(3) VOLUMES(ZSPK01))
//*********************************************************************
//*        CHECK FOR CONDITION CODE 0 - JOB ENDS IF RC IS NOT 0       *
//*********************************************************************
//RCCHCK   IF ALLOCZ.RC=0 THEN
//*********************************************************************
//* FORMAT THIS STEP FORMATS YOUR NEWLY CREATED ZFS DATA SET.         *
//*        THIS STEP SHOULD COMPLETE WITH A RETURN CODE OF 0.         *
//*********************************************************************
//FORMAT EXEC   PGM=IOEAGFMT,REGION=0M,
//       PARM=('-aggregate CDPZ02.ZFS -compat')
//*  STEPLIB  DD DSN=IOE.SIOELMOD,DISP=SHR
//SYSPRINT DD     SYSOUT=*
//*********************************************************************
//*  MOUNT THIS STEP MOUNTS YOUR NEWLY CREATED ZFS FILE SYSTEM        *
//*  USING THE AGGRGROW PARAMETER.                                    *
//*********************************************************************
//MOUNT    EXEC PGM=IKJEFT01
//SYSTSPRT DD   SYSOUT=*
//SYSPRINT DD   SYSOUT=*
//SYSTSIN  DD   *
  MOUNT FILESYSTEM('CDPZ02.ZFS') +
     TYPE(ZFS) MODE(RDWR) PARM('AGGRGROW') +
     MOUNTPOINT('/usr/lpp/IBM/zcdp/v2r1m0')
//RCCHCK   ENDIF

確認

[CICS004@EPLEX1:/u/cics004/JCL/CDPZ21] df | grep zcdp
/V1R11/usr/lpp/IBM/zcdp/v2r1m0 (CDPZ02.ZFS)              1710318/1728000 4294967292 Available

IPL後の自動マウント用に、BPXPRMxxにMOUNT定義を追加しておく。

BPXPRMFS

MOUNT FILESYSTEM('CDPZ02.ZFS')                
      MOUNTPOINT('/usr/lpp/IBM/zcdp/v2r1m0')  
      TYPE(ZFS) MODE(RDWR)

インストール作業

インストーラーはテープなどのメディアではなく圧縮形式のファイルをダウンロードする方式で入手している前提です(Windows PC上に入手している状態)。

FTP

インストーラーをファイルで入手しているので、それをUSS上にアップします。
USS上にインストーラーを配置するディレクトリ/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802を作成します(上で作成したzFS配下)。
※本来であれば、インストーラーを配置する先は製品が導入されるディレクトリとは分けて別zFSで用意するのがよいですが、テスト環境だしファイルシステム分けるのが面倒だったので、ここでは同じzFS上にのせちゃってます。あまりよろしくない構成ですので注意！

WindowsからFTPでターゲットとなるz/OSのUSSに各ファイルを転送します。

C:\y\Inst_Image\CDPz\CDPz21\CBPDO_Material>ftp eplexa
eplexa に接続しました。
220-FTP Server (user 'xxx')
220
500-Syntax error -- unknown command
500
ユーザー (eplexa:(none)): CICS004
331-Password:
331
パスワード:
230-220-FTPD1 IBM FTP CS V2R3 at EPLEX1, 02:42:26 on 2020-01-06.
230-CICS004 is logged on.  Working directory is "CICS004.".
230
ftp> cd /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802 is the current working directory
ftp> bin
200 Representation type is Image
ftp> prompt off
対話モード オフ。
ftp> mput *.*
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/GIMPAF.XML
250 Transfer completed successfully.
ftp: 16640 バイトが送信されました 0.01秒 1664.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/GIMPAF.XSL
250 Transfer completed successfully.
ftp: 5040 バイトが送信されました 0.00秒 5040000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/S0001.CSP.STP54802.DOCLIB.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.00秒 32256000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/S0002.CSP.STP54802.RIMLIB.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.00秒 32256000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/S0003.CSP.STP54802.PGMDIR.pax.Z
250 Transfer completed successfully.
ftp: 290304 バイトが送信されました 0.04秒 7257.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/S0004.CSP.CSP.README
250 Transfer completed successfully.
ftp: 11826 バイトが送信されました 0.00秒 11826000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/S0024.CSP.STP54802.GIMUNZIP
250 Transfer completed successfully.
ftp: 6399 バイトが送信されました 0.01秒 639.90KB/秒。
ローカル ファイル SMPHOLD を開けません。
ローカル ファイル SMPPTFIN を開けません。
ローカル ファイル SMPRELF を開けません。

ftp> mkdir SMPHOLD
257 "/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPHOLD" created.
ftp> cd SMPHOLD
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPHOLD is the current working directory
ftp> mput SMPHOLD\*.*
ローカル ファイル SMPHOLD\. を開けません。
ローカル ファイル SMPHOLD\.. を開けません。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPHOLD/S0005.CSP.STP54802.HOLDDATA.pax.Z
250 Transfer completed successfully.
ftp: 1419264 バイトが送信されました 0.12秒 11729.45KB/秒。

ftp> cd ..
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802 is the current working directory
ftp> mkdir SMPPTFIN
257 "/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN" created.
ftp> cd SMPPTFIN
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN is the current working directory
ftp> mput SMPPTFIN\*.*
ローカル ファイル SMPPTFIN\. を開けません。
ローカル ファイル SMPPTFIN\.. を開けません。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0006.CBCACHE.HHBO21L.SMPMCS.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 3225.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0007.CBCACHE.HHBO210.SMPMCS.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 3225.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0008.CBCACHE.HHBO210.PTF.UJ01103.pax.Z
250 Transfer completed successfully.
ftp: 20256768 バイトが送信されました 1.47秒 13770.75KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0009.CBCACHE.HHBO210.PTF.UJ01319.pax.Z
250 Transfer completed successfully.
ftp: 20224512 バイトが送信されました 1.47秒 13758.17KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0010.CBCACHE.HHBO210.PTF.UJ01485.pax.Z
250 Transfer completed successfully.
ftp: 26127360 バイトが送信されました 1.98秒 13195.64KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0011.CSP.STP54802.ASSIGNS.pax.Z
250 Transfer completed successfully.
ftp: 1322496 バイトが送信されました 0.10秒 13094.02KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPPTFIN/S0012.CSP.STP54802.PRODDATA.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 3225.60KB/秒。

ftp> cd ..
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802 is the current working directory
ftp> mkdir SMPRELF
257 "/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF" created.
ftp> cd SMPRELF
250 HFS directory /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF is the current working directory
ftp> mput SMPRELF\*.*
ローカル ファイル SMPRELF\. を開けません。
ローカル ファイル SMPRELF\.. を開けません。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F1.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 4032.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F2.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 3225.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F3.pax.Z
250 Transfer completed successfully.
ftp: 64512 バイトが送信されました 0.01秒 6451.20KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F4.pax.Z
250 Transfer completed successfully.
ftp: 741888 バイトが送信されました 0.07秒 10598.40KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F5.pax.Z
250 Transfer completed successfully.
ftp: 2161152 バイトが送信されました 0.18秒 12006.40KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F6.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.00秒 32256000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F7.pax.Z
250 Transfer completed successfully.
ftp: 419328 バイトが送信されました 0.03秒 13977.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F8.pax.Z
250 Transfer completed successfully.
ftp: 24353280 バイトが送信されました 2.00秒 12170.55KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO210.F9.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.00秒 32256000.00KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO21L.F1.pax.Z
250 Transfer completed successfully.
ftp: 32256 バイトが送信されました 0.01秒 3225.60KB/秒。
200 Port request OK.
125 Storing data set /usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/CBCACHE.IBM.HHBO21L.F2.pax.Z
250 Transfer completed successfully.
ftp: 293594112 バイトが送信されました 23.07秒 12724.02KB/秒。

DOCLIB, RIMLIB, PGMDIR 解凍

ダウンロードしたファイル群に含まれるS0004.CSP.CSP.READMEの記述を参考に...

S0024.CSP.STP54802.GIMUNZIPに提供されているUNZIPのサンプルJCLを編集して実行します。

//GIMUNZIP JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),
//             USER=IBMUSER,
//             PASSWORD=xxxxx
//*                                                           /*JCTRL*/
//*
//* 5751-CS3 COPYRIGHT IBM CORPORATION 1985, 2006
//*
//*
//********************************************************************
//*          DO NOT TURN CAPS ON.  THIS JOB CONTAINS CASE
//*                    SENSITIVE CONTROL CARDS.
//********************************************************************
//*
//* DOC: This job extracts CBPDO non-SMP/E files from archives
//*      created by the GIMZIP program
//*
//*       Change the JOB statement as required to match
//*       your installation's requirements.
//*
//* NOTE 1: Change the HASH value to YES if you require
//*         SHA-1 hash checking for the archive files.
//*
//* NOTE 2: If you are using SMP/E level 34.09 or higher,
//*         uncomment the SMPJHOME and SMPCPATH DD
//*         Statements.  If you are at SMP/E 3.4, it is
//*         recommended you be at least 34.09.
//*
//* NOTE 3: Change the directory name on the SMPDIR DD to
//*         to match your system's SMPNTS directory name.
//*         STP54802 is the subdirectory id
//*         assigned to your order during the RECEIVE
//*         FROMNETWORK (RFNJOB).
//*
//* NOTE 4: Replace volser on each volume control statement
//*         with a valid volume serial number.  Deleting this
//*         control statement will cause SYSALLDA to be used
//*         as the unit type.
//*
//* NOTE 5: Replace hlq on each newname control statement
//*         with a valid data set high level qualifer.
//*
//*
//*       Expect RC 00
//*
//*------------------------------------------------------------
//UNZIP    EXEC PGM=GIMUNZIP,REGION=0M,PARM='HASH=NO'   <=== NOTE 1
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//*SMPJHOME DD PATH='/usr/lpp/java/J1.4/'             <===NOTE 2
//*SMPCPATH DD PATH='/usr/lpp/smp/classes/'           <===NOTE 2
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATH='/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802',
//            PATHDISP=KEEP
//SYSIN    DD *
<GIMUNZIP>
<ARCHDEF
name="S0001.CSP.STP54802.DOCLIB.pax.Z"
volume="ZSPK01"
newname="CDPZ02.DOCLIB">
</ARCHDEF>
<ARCHDEF
name="S0002.CSP.STP54802.RIMLIB.pax.Z"
volume="ZSPK01"
newname="CDPZ02.RIMLIB">
</ARCHDEF>
<ARCHDEF
name="S0003.CSP.STP54802.PGMDIR.pax.Z"
volume="ZSPK01"
newname="CDPZ02.PGMDIR">
</ARCHDEF>
</GIMUNZIP>
/*

RELFILE 解凍

展開されたDPZ02.DOCLIB(MEMOEXT) の記述を参考に...

CDPZ02.RIMLIB(UNZIPJCL)に提供されるサンプルJCLを編集して、RELFILEを解凍します。

//UNZIPJCL JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),
//             USER=IBMUSER,
//             PASSWORD=xxxxx
//*
//*
//* 5751-CS3 COPYRIGHT IBM CORPORATION 1985, 2006
//*
//*
//*                                                           /*JCTRL*/
//**********************************************************
//*  DO NOT TURN CAPS ON AS PATH NAMES AND SMP/E PARAMETERS
//*  ARE CASE SENSITIVE.
//**********************************************************
//*
//* DOC: This job extracts a products relfile from archives
//*      created by the GIMZIP program
//*
//*       Change the JOB statement as required to match
//*       your installation's requirements.
//*
//* NOTE 1: Change the HASH value to YES if you require
//*         SHA-1 hash checking for the archive files
//*
//* NOTE 2: If you are using SMP/E level 34.09 or higher,
//*         uncomment the SMPJHOME and SMPCPATH DD
//*         Statements.  If you are at SMP/E 3.4, it is
//*         recommended you be at least 34.09.
//*
//* NOTE 3: Change the directory name on the SMPDIR DD to
//*         to match your system's SMPNTS directory name.
//*         STP54802 is the subdirectory id
//*         assigned to your order during the RECEIVE
//*         FROMNETWORK (RFNJOB).
//*
//* NOTE 4: Update parm with the name of the relfile you want
//*         to unload from the SMPRELF directory
//*
//* NOTE 5: Replace volser on the volume control statement
//*         with a valid volume serial number.  Deleting this
//*         control statement will cause SYSALLDA to be used
//*         as the unit type.
//*
//* NOTE 6: Replace hlq.sample.jobs on the newname control
//*         statement with a valid data set name.
//*
//*
//*       Expect RC 00
//*
//*------------------------------------------------------------
//UNZIP    EXEC PGM=GIMUNZIP,REGION=0M,PARM='HASH=NO'
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(10,10))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(15,5))
//*SMPJHOME DD PATH='/usr/lpp/java/J1.4/'           <===NOTE 2
//*SMPCPATH DD PATH='/usr/lpp/smp/classes/'         <===NOTE 2
//SMPOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR   DD PATH='/usr/lpp/IBM/zcdp/v2r1m0/inst/STP54802/SMPRELF/',
//            PATHDISP=KEEP
//SYSIN    DD *
<GIMUNZIP>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F1.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F1">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F2.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F2">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F3.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F3">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F4.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F4">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F5.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F5">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F6.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F6">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F7.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F7">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F8.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F8">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO210.F9.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO210.F9">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO21L.F1.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO21L.F1">
</ARCHDEF>
<ARCHDEF
name="CBCACHE.IBM.HHBO21L.F2.pax.Z"
volume="ZSPK01"
newname="CDPZ02.IBM.HHBO21L.F2">
</ARCHDEF>
</GIMUNZIP>
/*

結果確認。以下のような形で展開される。

DSLIST - Data Sets Matching CDPZ02                                 Row 1 of 17 
                                                                               
Command - Enter "/" to select action                  Message           Volume 
-------------------------------------------------------------------------------
         CDPZ02                                                         *ALIAS 
         CDPZ02.DOCLIB                                                  ZSPK01 
         CDPZ02.IBM.HHBO21L.F1                                          ZSPK01 
         CDPZ02.IBM.HHBO21L.F2                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F1                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F2                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F3                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F4                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F5                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F6                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F7                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F8                                          ZSPK01 
         CDPZ02.IBM.HHBO210.F9                                          ZSPK01 
         CDPZ02.PGMDIR                                                  ZSPK01 
         CDPZ02.RIMLIB                                                  ZSPK01 
         CDPZ02.ZFS                                                     *VSAM* 
         CDPZ02.ZFS.DATA                                                ZSPK01

CSIデータセット作成

ProgramDirectoryの記述を参考に...

CDPZ02.IBM.HHBO210.F2(HBO0SMPE) をコピーして編集し、Submit。

※提供されているサンプルをそのまま使ったのですが、後のRECEIVEを実行したときに、SMPPTSデータセットがパンクしました。以下のエラー。イケてない...。 IEC032I E37-04,IFG0554P,RCVPDO,SMPER1,SMPPTS,5187,ZSPK01,CDPZ02.SMPPTS ということで、SMPPTS部分は以下のようにサイズを変更して流しなおしました。

修正前

//SMPPTS   DD DSN=CDPZ02.SMPPTS,DISP=(NEW,CATLG),
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(12000,200,300),,,ROUND)

修正後

//SMPPTS   DD DSN=CDPZ02.SMPPTS,DISP=(NEW,CATLG),
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(18000,300,300),,,ROUND)

JCL全体はこちら。

//HBO0SMPE JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//*
//**************************************************************/
//* JOB NAME: HBO0SMPE                                         */
//*                                                            */
//*     LICENSED MATERIALS - PROPERTY OF IBM                   */
//*     5698-ABN                                               */
//*     COPYRIGHT IBM CORP 2019  ALL RIGHTS RESERVED.          */
//*                                                            */
//*     US GOVERNMENT USERS RESTRICTED RIGHTS -                */
//*     USE, DUPLICATION OR DISCLOSURE RESTRICTED              */
//*     BY GSA ADP SCHEDULE CONTRACT WITH IBM CORP.            */
//*                                                            */
//* DESCRIPTION: THIS JCL ALLOCATES SMP/E DATA SETS,           */
//*              DEFINES NECESSARY ZONES TO YOUR SYSTEM, AND   */
//*              DEFINES DDDEF ENTRIES TO PROVIDE SMP/E        */
//*              WITH INFORMATION IT NEEDS TO ALLOCATE         */
//*              PERMANENT, TEMPORARY, SYSOUT, AND WORK        */
//*              DATA SETS FOR                                 */
//*              IBM  Z COMMON DATA PROVIDER V2.1.0            */
//*                                                            */
//*              FUTURE JOBS WILL USE THE VALUES YOU SET HERE  */
//*              SO IF YOU USE THIS JOB KEEP IT FOR REFERENCE. */
//*                                                            */
//*                                                            */
//* CAUTION:     THIS JOB REQUIRES UPDATES BEFORE SUBMITTING.  */
//*                                                            */
//*                                                            */
//* NOTES:                                                     */
//*  1) CHANGE THE JOB CARD TO MEET YOUR SYSTEM'S REQUIREMENTS.*/
//*                                                            */
//*  2) YOU MUST CHANGE CDPZ02 TO YOUR SMPE HLQ.  THE       */
//*     SAFEST WAY TO DO THIS IS DOING A GLOBAL CHANGE         */
//*     ON THE COMMAND LINE:                                   */
//*                                                            */
//*            "C CDPZ02 MYPREFIX ALL"                      */
//*                                                            */
//*     THIS "CHANGE ALL" WILL TAKE CARE OF ALL OF THE         */
//*     SMP/E HLQ INSTANCES WITH ONE COMMAND.                  */
//*                                                            */
//*  3) YOU WILL NEED TO CHANGE THE ZSPK01 TO THE VOLUME     */
//*     ON WHICH YOU WISH TO CREATE THE SMP/E DATASETS         */
//*     DO A CHANGE ON THE COMMAND LINE:                       */
//*                                                            */
//*            "C ZSPK01 MYVOLUME ALL"                       */
//*                                                            */
//*     THIS "CHANGE ALL" WILL TAKE CARE OF ALL THE            */
//*     VOLUME INSTANCES WITH ONE COMMAND.                     */
//*                                                            */
//*  4) YOU WILL NEED TO CHANGE THE SYSALLDA TO THE UNIT TYPE    */
//*     ON WHICH YOU WISH TO CREATE THE SMP/E DATASETS         */
//*     DO A CHANGE ON THE COMMAND LINE:                       */
//*                                                            */
//*            "C SYSALLDA MYUNITTYPE ALL"                       */
//*                                                            */
//*     THIS "CHANGE ALL" WILL TAKE CARE OF ALL THE            */
//*     UNIT INSTANCES WITH ONE COMMAND.                       */
//*                                                            */
//**************************************************************/
//*
//**************************************************************/
//*               DEFINE THE CSI DATA SET                      */
//**************************************************************/
//*
//DEFINE   EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//CSIVOL   DD UNIT=SYSALLDA,
//            VOL=SER=ZSPK01,
//            DISP=SHR
//SYSIN    DD *
      DEFINE CLUSTER                       -
             (NAME(CDPZ02.GLOBAL.CSI)    -
              FREESPACE(10,5)              -
              KEYS(24 0)                   -
              RECORDSIZE(24 143)           -
              SHAREOPTIONS(2 3)            -
              UNIQUE                       -
              VOLUMES(ZSPK01)              -
             )                             -
          DATA                             -
             (NAME(CDPZ02.GLOBAL.CSI.DATA) -
              CONTROLINTERVALSIZE(8192)    -
              CYLINDERS(50 5)              -
             )                             -
          INDEX                            -
             (NAME(CDPZ02.GLOBAL.CSI.INDEX) -
              CONTROLINTERVALSIZE(4096)    -
              CYLINDERS(20 2)              -
              IMBED                        -
             )
/*
//*
//**************************************************************/
//*                    PRIME CSI DATA SET                      */
//**************************************************************/
//*
//PRIMEIT  EXEC PGM=IDCAMS,COND=(9,LT)
//SYSPRINT DD SYSOUT=*
//SMPCSI   DD DSN=CDPZ02.GLOBAL.CSI,
//            DISP=OLD
//ZPOOL    DD DSN=SYS1.MACLIB(GIMZPOOL),
//            DISP=SHR
//SYSIN    DD *
      REPRO OUTFILE(SMPCSI) INFILE(ZPOOL)
/*
//*
//**************************************************************/
//*               INITIALIZE CSI DATA SET                      */
//**************************************************************/
//*
//GZONEINI EXEC PGM=GIMSMP,REGION=0M
//SYSPRINT  DD SYSOUT=*
//SMPCSI    DD DSN=CDPZ02.GLOBAL.CSI,
//             DISP=OLD
//SMPLIST   DD SYSOUT=*
//*
//**************************************************************/
//*                   SMP DATA SETS                            */
//**************************************************************/
//*
//SMPLOG   DD DSN=CDPZ02.SMPLOG,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=VB,LRECL=510,BLKSIZE=0),
//            SPACE=(3200,(6000,3000),,,ROUND)
//SMPLOGA  DD DSN=CDPZ02.SMPLOGA,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=VB,LRECL=510,BLKSIZE=0),
//            SPACE=(3200,(6000,3000),,,ROUND)
//SMPMTS   DD DSN=CDPZ02.SMPMTS,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(60,20,60),,,ROUND)
//SMPPTS   DD DSN=CDPZ02.SMPPTS,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(18000,300,300),,,ROUND)
//SMPSCDS  DD DSN=CDPZ02.SMPSCDS,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(400,100,300),,,ROUND)
//SMPSTS   DD DSN=CDPZ02.SMPSTS,DISP=(NEW,CATLG),
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
//            SPACE=(3120,(400,100,150),,,ROUND)
//SMPLTS   DD DSN=CDPZ02.SMPLTS,DISP=(NEW,CATLG),
//            DSNTYPE=LIBRARY,
//            UNIT=SYSALLDA,VOL=SER=ZSPK01,
//            DCB=(RECFM=U,LRECL=0,BLKSIZE=32760),
//            SPACE=(6144,(850,250,150),,,ROUND)
//SMPWRK1  DD UNIT=SYSALLDA,SPACE=(CYL,(200,10,100)),DCB=BLKSIZE=6160
//SMPWRK2  DD UNIT=SYSALLDA,SPACE=(CYL,(200,10,100)),DCB=BLKSIZE=6160
//SMPWRK3  DD UNIT=SYSALLDA,SPACE=(CYL,(200,10,100)),DCB=BLKSIZE=3200
//SMPWRK4  DD UNIT=SYSALLDA,SPACE=(CYL,(200,10,100)),DCB=BLKSIZE=3200
//SMPWRK6  DD UNIT=SYSALLDA,SPACE=(CYL,(200,10,100)),DCB=BLKSIZE=3200
//SYSUT1   DD UNIT=SYSALLDA,SPACE=(CYL,(2,1))
//SYSUT2   DD UNIT=SYSALLDA,SPACE=(CYL,(2,1))
//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(2,1))
//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(2,1))
//*
//**************************************************************/
//*              ALLOCATION AND INITIALIZATION                 */
//**************************************************************/
//*
//SMPCNTL  DD *
  SET BDY(GLOBAL).
   UCLIN .
    ADD OPTIONS(ZCDPOPT)
               DSPREFIX(CDPZ02)
               DSSPACE(7500,500,200) .
    ADD GLOBALZONE
            SREL(Z038)
            OPTIONS(ZCDPOPT) .
    ENDUCL.
    SET BDY(GLOBAL).
    UCLIN.
       ADD GZONE
           ZONEINDEX(
              (TZONE,CDPZ02.GLOBAL.CSI,TARGET)
                    )   .
       ADD GZONE
           ZONEINDEX(
              (DZONE,CDPZ02.GLOBAL.CSI,DLIB)
                    )   .
   ENDUCL.
  SET BDY(TZONE).
   UCLIN.
    ADD TARGETZONE(TZONE)
        OPTIONS(ZCDPOPT)
        SREL(Z038)
        RELATED(DZONE).
   ENDUCL.
  SET BDY(DZONE).
   UCLIN.
    ADD DLIBZONE(DZONE)
        ACCJCLIN
        OPTIONS(ZCDPOPT)
        SREL(Z038)
        RELATED(TZONE).
   ENDUCL.
  LIST ALLZONES.
/*

以下のデータセットが作成されたことを確認。

CDPZ02.GLOBAL.CSI                                              *VSAM* 
CDPZ02.GLOBAL.CSI.DATA                                         ZSPK01 
CDPZ02.GLOBAL.CSI.INDEX                                        ZSPK01 
...
CDPZ02.SMPLOG                                                  ZSPK01 
CDPZ02.SMPLOGA                                                 ZSPK01 
CDPZ02.SMPLTS                                                  ZSPK01 
CDPZ02.SMPMTS                                                  ZSPK01 
CDPZ02.SMPPTS                                                  ZSPK01 
CDPZ02.SMPSCDS                                                 ZSPK01 
CDPZ02.SMPSTS                                                  ZSPK01

Target/Distributionライブラリの作成

CDPZ02.IBM.HHBO210.F2(HBO1ALLO)をコピーして編集し、Submit。

//HBO1ALLO JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//**************************************************************/
//* JOB NAME: HBO1ALLO                                         */
//*                                                            */
//*     LICENSED MATERIALS - PROPERTY OF IBM                   */
//*     5698-ABN                                               */
//*     COPYRIGHT IBM CORP 2019  ALL RIGHTS RESERVED.          */
//*                                                            */
//*     US GOVERNMENT USERS RESTRICTED RIGHTS -                */
//*     USE, DUPLICATION OR DISCLOSURE RESTRICTED              */
//*     BY GSA ADP SCHEDULE CONTRACT WITH IBM CORP.            */
//*                                                            */
//* DESCRIPTION: THIS JCL WILL ALLOCATE TARGET AND             */
//*              DISTRIBUTION LIBRARIES FOR                    */
//*              IBM Z COMMON DATA PROVIDER V2.1.0             */
//*                                                            */
//* CAUTION:     THIS JOB REQUIRES UPDATES BEFORE SUBMITTING.  */
//*                                                            */
//* NOTES:                                                     */
//* 1) CHANGE THE JOB CARD TO MEET YOUR SYSTEM'S REQUIREMENTS. */
//*                                                            */
//* 2) IF A UNIT VALUE OF SYSALLDA DOES NOT WORK WITHIN YOUR   */
//*    LOCAL DEFINITIONS CHANGE IT IN MARKED LOCATION (2)      */
//*                                                            */
//*                                                            */
//*  IF YOU SPECIFY A VOLUME FOR ANY DATA SET IN THIS JOB, YOU */
//*  MUST ALSO SPECIFY THE SAME VOLUME IN THE CORRESPONDING    */
//*  DDDEF ENTRY IN THE DDDEF JOB, HBO4DDDF.                   */
//*                                                            */
//* 3) CHANGE ZSPK01 TO THE VOLUME ON WHICH YOU WISH TO     */
//*    ALLOCATE THE TARGET LIBRARIES.                          */
//*                                                            */
//* 4) CHANGE ZSPK01 TO THE VOLUME ON WHICH YOU WISH TO     */
//*    ALLOCATE THE DISTRIBUTION LIBRARIES.                    */
//*                                                            */
//* 5) CHANGE CDPZ02 TO THE HIGH LEVEL QUALIFIER YOU WOULD     */
//*    LIKE TO USE FOR THE TARGET LIBRARIES.                   */
//*                                                            */
//* 6) CHANGE V2R1M0 TO THE SECOND LEVEL QUALIFIER YOU WOULD   */
//*    LIKE TO USE FOR THE TARGET LIBRARIES.                   */
//*                                                            */
//* 7) CHANGE CDPZ02 TO THE HIGH LEVEL QUALIFIER YOU WOULD     */
//*    LIKE TO USE FOR THE DISTRIBUTION LIBRARIES.             */
//*                                                            */
//* 8) CHANGE V2R1M0 TO THE SECOND LEVEL QUALIFIER YOU WOULD   */
//*    LIKE TO USE FOR THE DISTRIBUTION LIBRARIES.             */
//*                                                            */
//*                                                            */
//**************************************************************/
//*   Allocate Libraries                                       */
//**************************************************************/
//*
//HBOALLOC PROC UNIT=SYSALLDA,         /* <==(2)
//            TARGVOL=ZSPK01,       /* <==(3)
//            DLIBVOL=ZSPK01,       /* <==(4)
//            TLHLQ=CDPZ02,            /* <==(5)
//            TLSLQ=V2R1M0,            /* <==(6)
//            DLHLQ=CDPZ02,            /* <==(7)
//            DLSLQ=V2R1M0             /* <==(8)
//*
//IEFBR14  EXEC PGM=IEFBR14
//*
//**************************************************************/
//*   Allocate Target Libraries                                */
//**************************************************************/
//*
//SHBOINST DD DSN=&TLHLQ..&TLSLQ..SHBOINST,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=FB,LRECL=80,BLKSIZE=0,
//         SPACE=(TRK,(5,2,5)),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL
//*
//SHBOCLST DD DSN=&TLHLQ..&TLSLQ..SHBOCLST,
//         DISP=(NEW,CATLG,DELETE),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL,
//         SPACE=(TRK,(2,1,2)),
//         DCB=(LRECL=80,RECFM=FB,BLKSIZE=0)
//*
//SHBODEFS DD DSN=&TLHLQ..&TLSLQ..SHBODEFS,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=VB,LRECL=255,BLKSIZE=0,
//         SPACE=(TRK,(300,25,30)),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL
//*
//SHBOLOAD DD DSN=&TLHLQ..&TLSLQ..SHBOLOAD,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=U,LRECL=0,BLKSIZE=32760,
//         SPACE=(TRK,(70,10,30)),
//         DSNTYPE=LIBRARY,
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL
//*
//SHBOLLST DD DSN=&TLHLQ..&TLSLQ..SHBOLLST,
//         DISP=(NEW,CATLG,DELETE),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL,
//         SPACE=(TRK,(3,1,2)),
//         DCB=(LRECL=0,RECFM=U,BLKSIZE=32760)
//*
//SHBOLPA  DD DSN=&TLHLQ..&TLSLQ..SHBOLPA,
//         DISP=(NEW,CATLG,DELETE),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL,
//         SPACE=(TRK,(3,1,2)),
//         DCB=(LRECL=0,RECFM=U,BLKSIZE=32760)
//*
//SHBOSAMP DD DSN=&TLHLQ..&TLSLQ..SHBOSAMP,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=FB,LRECL=80,BLKSIZE=0,
//         SPACE=(TRK,(15,2,5)),
//         UNIT=&UNIT,
//         VOL=SER=&TARGVOL
//*
//**************************************************************/
//*   Allocate Distribution Libraries                          */
//**************************************************************/
//*
//AHBOCLST DD DSN=&DLHLQ..&DLSLQ..AHBOCLST,
//         DISP=(NEW,CATLG,DELETE),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL,
//         SPACE=(TRK,(2,1,2)),
//         DCB=(LRECL=80,RECFM=FB,BLKSIZE=0)
//*
//AHBODEFS DD DSN=&DLHLQ..&DLSLQ..AHBODEFS,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=VB,LRECL=255,BLKSIZE=0,
//         SPACE=(TRK,(300,5,25)),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL
//*
//AHBOHFS  DD DSN=&DLHLQ..&DLSLQ..AHBOHFS,
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL,
//         SPACE=(TRK,(15,5,2)),
//         DCB=(LRECL=1028,RECFM=VB,BLKSIZE=0),
//         DISP=(NEW,CATLG)
//*
//AHBOHFS2 DD DSN=&DLHLQ..&DLSLQ..AHBOHFS2,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=VB,LRECL=27920,BLKSIZE=0,
//         SPACE=(TRK,(500,30,2)),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL
//*
//AHBOINST DD DSN=&DLHLQ..&DLSLQ..AHBOINST,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=FB,LRECL=80,BLKSIZE=0,
//         SPACE=(TRK,(2,2,2)),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL
//*
//AHBOLINK DD DSN=&DLHLQ..&DLSLQ..AHBOLINK,
//         DISP=(NEW,CATLG,DELETE),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL,
//         SPACE=(TRK,(2,1,2)),
//         DCB=(LRECL=0,RECFM=U,BLKSIZE=32760)
//*
//AHBOLOAD DD DSN=&DLHLQ..&DLSLQ..AHBOLOAD,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=U,LRECL=0,BLKSIZE=32760,
//         SPACE=(TRK,(75,1,65)),
//         DSNTYPE=LIBRARY,
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL
//*
//AHBOSAMP DD DSN=&DLHLQ..&DLSLQ..AHBOSAMP,
//         DISP=(NEW,CATLG,DELETE),
//         RECFM=FB,LRECL=80,BLKSIZE=0,
//         SPACE=(TRK,(10,2,2)),
//         UNIT=&UNIT,
//         VOL=SER=&DLIBVOL
//*
//HBOALLOC PEND
//ALLOCATE EXEC HBOALLOC
//*
//

以下のデータセットが作成されたことを確認。

CDPZ02.V2R1M0.AHBOCLST                                         ZSPK01
CDPZ02.V2R1M0.AHBODEFS                                         ZSPK01
CDPZ02.V2R1M0.AHBOHFS                                          ZSPK01
CDPZ02.V2R1M0.AHBOHFS2                                         ZSPK01
CDPZ02.V2R1M0.AHBOINST                                         ZSPK01
CDPZ02.V2R1M0.AHBOLINK                                         ZSPK01
CDPZ02.V2R1M0.AHBOLOAD                                         ZSPK01
CDPZ02.V2R1M0.AHBOSAMP                                         ZSPK01
CDPZ02.V2R1M0.SHBOCLST                                         ZSPK01
CDPZ02.V2R1M0.SHBODEFS                                         ZSPK01
CDPZ02.V2R1M0.SHBOINST                                         ZSPK01
CDPZ02.V2R1M0.SHBOLLST                                         ZSPK01
CDPZ02.V2R1M0.SHBOLOAD                                         ZSPK01
CDPZ02.V2R1M0.SHBOLPA                                          ZSPK01
CDPZ02.V2R1M0.SHBOSAMP                                         ZSPK01

USS上のディレクトリ作成

CDPZ02.IBM.HHBO210.F2(HBO3RMKD) をコピーして編集し、Submit。

//HBO3RMKD JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//**************************************************************/
//* JOB NAME = HBO3RMKD                                        */
//*                                                            */
//*     LICENSED MATERIALS - PROPERTY OF IBM                   */
//*     5698-ABN                                               */
//*     COPYRIGHT IBM CORP 2019  ALL RIGHTS RESERVED.          */
//*                                                            */
//*     US GOVERNMENT USERS RESTRICTED RIGHTS -                */
//*     USE, DUPLICATION OR DISCLOSURE RESTRICTED              */
//*     BY GSA ADP SCHEDULE CONTRACT WITH IBM CORP.            */
//*                                                            */
//**************************************************************/
//*                                                            */
//* DESCRIPTION: THIS JCL WILL EXECUTE THE HBOMKDIR EXEC TO    */
//*              CREATE THE NECESSARY DIRECTORIES USED BY      */
//*              IBM Z COMMON DATA PROVIDER V2.1.0             */
//*                                                            */
//* CAUTION:     THIS JOB REQUIRES UPDATES BEFORE SUBMITTING.  */
//*                                                            */
//*  1) ADD A JOB CARD TO MEET YOUR SYSTEM REQUIREMENTS        */
//*                                                            */
//*  2) IF YOU ARE APPLYING THIS FUNCTION FOR THE FIRST TIME,  */
//*     THE HBOMKDIR EXEC WILL RESIDE IN AN SMP/E TEMPORARY    */
//*     LIBRARY SO USE THE FIRST //SYSEXEC STATEMENT BELOW.    */
//*     CHANGE -dsprefix- TO MATCH THE QUALIFIER(S) FOR THE     */
//*     OF THE TEMPORARY DATASET.  (RELFILE)                   */
//*                                                            */
//*     IF YOU ARE RUNNING THIS JOB TO INSTALL SERVICE ON A    */
//*     FUNCTION THAT HAS ALREADY BEEN APPLYED, THE MKDIR EXEC */
//*     WILL RESIDE IN A TARGET LIBRARY, SO UNCOMMENT THE      */
//*     SECOND SYSEXEC STATEMENT BELOW AND COMMENT             */
//*     OUT THE FIRST.  CHANGE -hlqual- TO THE AOORIORUATE      */
//*     HIGH-LEVEL QUALIFIER THAT COMPLIES WITH YOUR SITE'S    */
//*     NAMING STANDARDS.                                      */
//*                                                            */
//*  3) CHANGE THE STRING   -PathPrefix-  TO THE APPROPRIATE   */
//*     high-level directory name. For users installing in the */
//*     ROOT, THIS WOULD BE "/".  FOR OTHERS, THE HIGH-LEVEL   */
//*     DIRECTORY MAY BE SOMETHING LIKE "/SERVICE" OR A MORE   */
//*     MEANINGFUL NAME. PLEASE NOTE THE REPLACEMENT STRING IS */
//*     CASE SENSITIVE. ENSURE THE -Pathprefix- IS AN ABSOLUTE */
//*     PATH NAME WHICH BEGINS AND ENDS WITH A SLASH (/).      */
//*                                                            */
//*     HINT:  THIS WOULD BE THE SAME AS THE -PathPrefix-      */
//*            YOU USED IN HBO2AZFS                            */
//*                                                            */
//*                                                            */
//*  4) ENSURE THE HIGH-LEVEL DIRECTORY NAME SPECIFIED EXISTS  */
//*     PRIOR TO RUNNING THIS JOB.                             */
//*                                                            */
//*  5) ENSURE YOU EXECUTE THIS JOB FROM A USERID THAT IS      */
//*     UID=0 OR IS THE OWNER OF THE HIGH-LEVEL DIRECTORY NAME */
//*     SPECIFIED.                                             */
//*                                                            */
//*  6) THIS JOB SHOULD END WITH RC=0. IF NOT THEN, PLEASE     */
//*     CHECK Z/OS UNIX SYSTEM SERVICES MESSAGES AND CODES     */
//*     BOOK TO CORRECT THE PROBLEM AND RESUBMIT THIS JOB.     */
//*                                                            */
//**************************************************************/
//IKJEFT01 EXEC PGM=IKJEFT01
//SYSEXEC DD DSN=CDPZ02.IBM.HHBO210.F2,
//*SYSEXEC DD DSN=-hlqual-.SHBOINST,
//      DISP=SHR
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
PROF MSGID
HBOMKDIR  /
/*
//

以下のようなディレクトリが作成されていることを確認。

[CICS004@EPLEX1:/V1R11/usr/lpp/IBM/zcdp/v2r1m0] ls -la
total 96
drwxr-xr-x   8 0        CICS        8192 Jan  6 15:13 .
drwxr-xr-x   3 0        OMVSGRP     8192 Jan  6 11:04 ..
drwxr-xr-x   2 0        CICS           0 Jan  6 15:13 DEPS
drwxr-xr-x   4 0        CICS        8192 Jan  6 15:13 DS
drwxr-xr-x   2 0        CICS           0 Jan  6 15:13 IBM
drwxr-xr-x   4 0        CICS        8192 Jan  6 15:13 LF
drwxr-xr-x   4 0        CICS        8192 Jan  6 15:13 UI
drwxrwxrwx   3 0        CICS        8192 Jan  6 11:32 inst

DDDEF

CDPZ02.IBM.HHBO210.F2(HBO4DDDF) をコピーして編集し、Submit。

//HBO4DDDF JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//**************************************************************/
//* JOB NAME: HBO4DDDF                                         */
//*                                                            */
//*     LICENSED MATERIALS - PROPERTY OF IBM                   */
//*     5698-ABN                                               */
//*     COPYRIGHT IBM CORP 2019  ALL RIGHTS RESERVED.          */
//*                                                            */
//*     US GOVERNMENT USERS RESTRICTED RIGHTS -                */
//*     USE, DUPLICATION OR DISCLOSURE RESTRICTED              */
//*     BY GSA ADP SCHEDULE CONTRACT WITH IBM CORP.            */
//*                                                            */
//* DESCRIPTION: THIS JCL WILL CREATE DDDEF ENTRIES AND        */
//*              CREATE AN ALLZONES REPORT FOR                 */
//*              IBM Z COMMON DATA PROVIDER V2.1.0             */
//*                                                            */
//* CAUTION:     THIS JOB REQUIRES UPDATES BEFORE SUBMITTING.  */
//*                                                            */
//* NOTES:                                                     */
//*                                                            */
//* 1) IF YOU USED HBO0SMPE THE QUALIFIERS AND ZONE NAMES      */
//*    WILL BE AVAILABLE IN THAT JOB.                          */
//*                                                            */
//* 2) CHANGE THE JOB CARD TO MEET YOUR SYSTEM'S REQUIREMENTS. */
//*                                                            */
//*                                                            */
//*    IT IS OK TO USE A CHANGE ALL COMMANDS TO SHORTEN        */
//*    THE WORK OF TASKS 3,4,5 and 6                           */
//*                                                            */
//*       SOMETHING LIKE:                                      */
//*                                                            */
//*          C CDPZ02.V2R1M0   my.tlib.qualifiers ALL        */
//*                                                            */
//*                and                                         */
//*                                                            */
//*          C CDPZ02.V2R1M0   my.dlib.qualifiers ALL        */
//*                                                            */
//* 3) CHANGE CDPZ02 TO THE TARGET LIB HIGH-LEVEL QUALIFIER   */
//*    THAT COMPLIES WITH YOUR SITE'S NAMING STANDARDS.        */
//*                                                            */
//* 4) CHANGE V2R1M0 TO THE TARGET LIB SECOND-LEVEL QUALIFIER */
//*    THAT COMPLIES WITH YOUR SITE'S NAMING STANDARDS.        */
//*                                                            */
//* 5) CHANGE CDPZ02 TO THE DISTRIBUTION LIB HIGH-LEVEL       */
//*    THAT COMPLIES WITH YOUR SITE'S NAMING STANDARDS.        */
//*                                                            */
//* 6) CHANGE V2R1M0 TO THE DISTRIBUTION LIB SECOND-LEVEL     */
//*    THAT COMPLIES WITH YOUR SITE'S NAMING STANDARDS.        */
//*                                                            */
//* 7) YOU MUST CHANGE CDPZ02 TO YOUR SMPE HLQ.  THE        */
//*     SAFEST WAY TO DO THIS IS DOING A GLOBAL CHANGE         */
//*     ON THE COMMAND LINE:                                   */
//*                                                            */
//*            "C CDPZ02 MYPREFIX ALL"                      */
//*                                                            */
//* 8) CHANGE TZONE TO THE NAME OF YOUR TARGET ZONE.         */
//*                                                            */
//* 9) CHANGE DZONE TO THE NAME OF YOUR DISTRIBUTION ZONE.   */
//*                                                            */
//* 10) IF YOU REQUIRE THE VOLUME PARAMETER FOR TARGET LIBRARY */
//*    DATA SETS THAT ARE NOT YET CATALOGED, UNCOMMENT THE     */
//*    VOLUME(ZSPK01) STATEMENTS AND CHANGE ZSPK01 TO    */
//*    THE VOLUME FOR THE TARGET LIBRARIES.                    */
//*                                                            */
//* 11) IF YOU REQUIRE THE VOLUME PARAMETER FOR DISTRIBUTION   */
//*    LIBRARY DATA SETS THAT ARE NOT YET CATALOGED, UNCOMMENT */
//*    THE VOLUME(ZSPK01) STATEMENTS AND CHANGE ZSPK01   */
//*    TO THE VOLUME FOR THE DISTRIBUTION LIBRARIES.           */
//*                                                            */
//*   IF YOU SPECIFY A VOLUME FOR ANY DATASET IN THIS JOB, YOU */
//*   MUST ALSO SPECIFY THE SAME VOLUME IN THE CORRESPONDING   */
//*   DATASET ALLOCATION JOB, HBO1ALLO.                        */
//*                                                            */
//* 12) A STEP IS PROVIDED TO ALLOW YOU TO CHANGE THE HIGH     */
//*    LEVEL PATH USED TO INSTALL Z COMMON DATA PROVIDER.      */
//*    LEVEL PATH USED TO INSTALL Z COMMON DATA PROVIDER.      */
//*    TO ADD A HIGH LEVEL PATH CHANGE <PathPrefix> TO THE     */
//*    DESIRED PATH HIGH LEVEL.  IF YOU WANT TO USE THE        */
//*    DEFAULT PATH JUST DELETE <PathPrefix>.                  */
//*    DEFAULT PATH JUST DELETE <PathPrefix>.                  */
//*    IF YOU USED A -PathPrefix- IN THE HBO2AZFS JOB THAT     */
//*    SAME PREFIX SHOULD BE USED HERE.                        */
//*                                                            */
//*    NOTE:  UNLKE THE HBO2AZFS JOB, HERE DO NOT INCLUDE      */
//*    THE LAST "/" IN YOUR PREFIX SO INSTEAD OF USING         */
//*    /my/path/prefix/ USE /my/path/prefix                    */
//*                                                            */
//*  GENERAL NOTES:                                            */
//* 1) THIS JOB SHOULD COMPLETE WITH A RETURN CODE 0.          */
//*    HOWEVER, IF SOME OR ALL OF THESE DDDEF ENTRIES ALREADY  */
//*    EXIST, THEN THE JOB WILL COMPLETE WITH A RETURN CODE 8. */
//*    YOU WILL HAVE TO EXAMINE THE OUTPUT AND DETERMINE       */
//*    WHETHER OR NOT THE EXISTING ENTRIES SHOULD BE REPLACED. */
//*    YOU CAN CHANGE THE 'ADD' TO 'REP' IN THIS JOB TO        */
//*    REPLACE EXISTING ENTRIES.                               */
//*                                                            */
//**************************************************************/
//*
//DDDEFD   EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD  DSN=CDPZ02.GLOBAL.CSI,             /* <==(7) */
//             DISP=SHR
//SMPCNTL  DD *
  SET BDY(DZONE).                                  /* <==(9) */
   UCLIN.
    ADD DDDEF(AHBOCLST)
        DATASET(CDPZ02.V2R1M0.AHBOCLST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBODEFS)
        DATASET(CDPZ02.V2R1M0.AHBODEFS)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOHFS)
        DATASET(CDPZ02.V2R1M0.AHBOHFS)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOHFS2)
        DATASET(CDPZ02.V2R1M0.AHBOHFS2)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOINST)
        DATASET(CDPZ02.V2R1M0.AHBOINST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOLINK)
        DATASET(CDPZ02.V2R1M0.AHBOLINK)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOLOAD)
        DATASET(CDPZ02.V2R1M0.AHBOLOAD)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOSAMP)
        DATASET(CDPZ02.V2R1M0.AHBOSAMP)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
   ENDUCL.
//DDDEFT   EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD  DSN=CDPZ02.GLOBAL.CSI,              /* <==(7) */
    ADD DDDEF(AHBOCLST)
        DATASET(CDPZ02.V2R1M0.AHBOCLST)
  SET BDY(TZONE).                                   /* <==(8) */
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBODEFS)
        DATASET(CDPZ02.V2R1M0.AHBODEFS)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOHFS)
        DATASET(CDPZ02.V2R1M0.AHBOHFS)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOHFS2)
        DATASET(CDPZ02.V2R1M0.AHBOHFS2)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOINST)
        DATASET(CDPZ02.V2R1M0.AHBOINST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOLOAD)
        DATASET(CDPZ02.V2R1M0.AHBOLOAD)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(AHBOSAMP)
        DATASET(CDPZ02.V2R1M0.AHBOSAMP)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
       .
    ADD DDDEF(SHBOCLST)
        DATASET(CDPZ02.V2R1M0.SHBOCLST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
    ADD DDDEF(SHBOCLST)
        DATASET(CDPZ02.V2R1M0.SHBOCLST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
    ADD DDDEF(SHBODEFS)
        DATASET(CDPZ02.V2R1M0.SHBODEFS)
        .
    ADD DDDEF(SHBOINST)
        DATASET(CDPZ02.V2R1M0.SHBOINST)
        UNIT(SYSALLDA)
        .
    ADD DDDEF(SHBOINST)
        DATASET(CDPZ02.V2R1M0.SHBOINST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
    ADD DDDEF(SHBOLOAD)
        DATASET(CDPZ02.V2R1M0.SHBOLOAD)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
    ADD DDDEF(SHBOLLST)
        DATASET(CDPZ02.V2R1M0.SHBOLLST)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
    ADD DDDEF(SHBOLPA)
        DATASET(CDPZ02.V2R1M0.SHBOLPA)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
    ADD DDDEF(SHBOSAMP)
        DATASET(CDPZ02.V2R1M0.SHBOSAMP)
        UNIT(SYSALLDA)
        VOLUME(ZSPK01)
        WAITFORDSN
        SHR
        .
   /* DO NOT UPPER CASE ANY OF THE PATH VALUES SPECIFIED BELOW */
   ADD DDDEF(SHBOFS00)
       PATH('/usr/lpp/IBM/zcdp/v2r1m0/IBM/').
   ADD DDDEF(SHBOFS01)
       PATH('/usr/lpp/IBM/zcdp/v2r1m0/LF/samples/IBM/').
   ADD DDDEF(SHBOFS02)
       PATH('/usr/lpp/IBM/zcdp/v2r1m0/LF/lib/IBM/').
   ADD DDDEF(SHBOFS03)
       PATH('/usr/lpp/IBM/zcdp/v2r1m0/LF/lib/jni64/IBM/').
   ENDUCL.
/*
//*
//DDDEFP   EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD  DSN=CDPZ02.GLOBAL.CSI,                /* <==(7) */
//             DISP=SHR
//SMPCNTL  DD *
  SET BDY(TZONE)                                     /* <==(8)  */
  .
  ZONEEDIT DDDEF.
   CHANGE PATH('/usr/lpp/IBM/zcdp/v2r1m0'*,
     '/usr/lpp/IBM/zcdp/v2r1m0'*).                     /* <==(12) */
  ENDZONEEDIT.
/*
//REPORT   EXEC PGM=GIMSMP,REGION=0M,COND=(8,LT)
//SMPCSI   DD  DSN=CDPZ02.GLOBAL.CSI,               /* <==(7) */
//             DISP=SHR
//SMPCNTL  DD *
  SET BDY(GLOBAL).
   LIST ALLZONES.
/*
//

RECEIVE

CDPZ02.RIMLIB(RCVPDO) をコピーして編集し、Submit。

※WorkのVOLUMEがパンクして以下のようなエラーが発生してしまったので、明示的に特定のVOLUMEを使用するよう、SYSUTxのDDを追加しました。 IEC030I B37-04,IFG0554A,RCVPDO,SMPER1,SYSUT4,5226,ZR21W2,SYS20006.T182105.RA000.RCVPDO.R0112225

//RCVPDO   JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),
//             USER=IBMUSER,                                  /*RACF*/
//             PASSWORD=xxxxx                                 /*RACF*/
//*                                                           /*JCTRL*/
//*
//* 5751-CS3 COPYRIGHT IBM CORPORATION 1985, 2006
//*
//*
//********************************************************************
//*          DO NOT TURN CAPS ON.  THIS JOB CONTAINS CASE
//*                    SENSITIVE CONTROL CARDS.
//********************************************************************
//*
//* LIB: USERID.PDO.RIMLIB(RCVPDO)
//* GDE: CBPDO MEMO EXTENSION
//* DOC: THIS JOB WILL RECEIVE PRODUCTS, SERVICE, AND HOLDDATA
//*      FROM THE SMP/E NETWORK TEMPORARY STORE (SMPNTS).
//*
//*      CHANGE THE JOB STATEMENT AS REQUIRED TO MATCH
//*      YOUR INSTALLATION'S REQUIREMENTS.
//*
//*      SMP/E ZONE-RELATED FILES ARE ASSUMED TO BE DEFINED IN YOUR
//*      GLOBAL CSI.  SEE THE SMP/E COMMANDS MANUAL FOR A LIST OF
//*      THE REQUIRED DDDEF ENTRIES.
//*
//*
//* NOTE 1: CHANGE THE SMPCSI DD STATEMENT TO THE SMP/E
//*         GLOBAL CSI INTO WHICH YOU WANT TO RECEIVE THE
//*         PACKAGE.
//*
//* NOTE 2: CHANGE THE SMPNTS DD STATEMENT TO POINT TO THE
//*         PATH NAME IN YOUR FILE SYSTEM WHERE THE NETWORK
//*         RECEIVED PACKAGE(S) ARE BEING STORED.  THIS IS
//*         THE PACKAGE DIRECTORY.
//*
//* NOTE 3: VERIFY/UPDATE THE PACKAGE-ID VALUE ON THE RECEIVE
//*         FROMNTS COMMAND.  THE PACKAGE-ID VALUE IS THE
//*         IDENTIFIER (SUBDIRECTORY) FOR THIS PARTICULAR
//*         PACKAGE IN THE PACKAGE DIRECTORY - SMPNTS.
//*
//* NOTE 4: UNCOMMENT THE DELETEPKG OPERAND ON THE RECEIVE
//*         COMMAND IF YOU WANT TO DELETE THE PACKAGE AND
//*         PACKAGE SUBDIRECTORY FROM YOUR FILE SYSTEM AFTER
//*         THE RECEIVE COMMAND COMPLETES.
//*
//SMPER1  EXEC PGM=GIMSMP,REGION=0M,
//             PARM='PROCESS=WAIT',
//             DYNAMNBR=120
//SMPCSI   DD  DISP=SHR,DSN=CDPZ02.GLOBAL.CSI         <=== NOTE 1
//SMPNTS   DD  PATHDISP=KEEP,
//             PATH='/usr/lpp/IBM/zcdp/v2r1m0/inst/'
//SMPOUT   DD  SYSOUT=*
//SMPRPT   DD  SYSOUT=*
//SMPLIST  DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*
//SYSUT1   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT2   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT3   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT4   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(100,100)),
//             DISP=(,DELETE)
//**************************************************************
//* AS SHIPPED BY IBM, RCVPDO IS SET UP TO RECEIVE
//* THE FMIDS, PTFS AND HOLDDATA
//**************************************************************
//SMPCNTL  DD  *
  SET      BOUNDARY (GLOBAL) .
  RECEIVE
   FROMNTS(STP54802)                                /* <=== NOTE 3 */
  /*    DELETEPKG                                  /* <=== NOTE 4 */
      .
/*

APPLY

CDPZ02.IBM.HHBO210.F2(HBO6APLY) をコピーして編集し、Submit。

//HBO6APLY JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),
//             USER=IBMUSER,PASSWORD=xxxxxx
//*
//SMP      EXEC PGM=GIMSMP,PARM='DATE=U',REGION=0M
//SMPCSI   DD DSN=CDPZ02.GLOBAL.CSI,DISP=SHR     /* <==(2)  */
//SMPHOLD  DD DUMMY
//SMPCNTL  DD *
  SET BDY(TZONE).                /*   <==(3) SET TARGET ZONE */
   APPLY
    SELECT(
            HHBO210
          )
    CHECK                        /* <==(4) COMMMENT TO APPLY */
    .
/*
//

OKだったら、CHECKを外して実際のAPPLYを実行！
必要に応じてACCEPT実行。

PTF APPLY

PTFをAPPLYするの忘れてたので、後からAPPLYしました。こちらもワークのボリュームが足りなかったりしたので、SMPWRKxなどを適宜追加してAPPLY

//HBO6APLY JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),
//             USER=IBMUSER,PASSWORD=xxxxx
//SMP      EXEC PGM=GIMSMP,PARM='DATE=U',REGION=0M
//SMPCSI   DD DSN=CDPZ02.GLOBAL.CSI,DISP=SHR     /* <==(2)  */
//SMPHOLD  DD DUMMY
//SMPWRK1  DD UNIT=3390,SPACE=(CYL,(2,1,5)),DISP=(,DELETE),
//            DCB=BLKSIZE=6160,VOL=SER=ZSPK01
//SMPWRK2  DD UNIT=3390,SPACE=(CYL,(2,1,5)),DISP=(,DELETE),
//            DCB=BLKSIZE=6160,VOL=SER=ZSPK01
//SMPWRK3  DD DSN=CDPZ02.TEMP3.SMPWRK3,
//            UNIT=3390,SPACE=(CYL,(100,10,100)),DISP=(,CATLG),
//            DCB=BLKSIZE=3120
//SMPWRK4  DD UNIT=SYSDA,SPACE=(CYL,(2,1,5)),DISP=(,DELETE),
//            DCB=BLKSIZE=3120,VOL=SER=ZSPK01
//SMPWRK6  DD UNIT=SYSDA,SPACE=(CYL,(100,1,100)),DISP=(,DELETE),
//            DCB=BLKSIZE=6160,VOL=SER=ZSPK01
//SYSUT1   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT2   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT3   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(10,1)),
//             DISP=(,DELETE)
//SYSUT4   DD  UNIT=3390,VOL=SER=ZSPK01,SPACE=(CYL,(100,100)),
//             DISP=(,DELETE)
//SMPCNTL  DD *
  SET BDY(TZONE).                /*   <==(3) SET TARGET ZONE */
   APPLY
    BYPASS(HOLDSYS)
    SELECT(
            UJ01103
            UJ01319
            UJ01485
          )
    CHECK                        /* <==(4) COMMMENT TO APPLY */
    .
/*
//

PTF提供後は、Config Toolのインストールし直し。

CDPzのセットアップ

導入が済んだら各コンポーネントの初期セットアップをしていきます。

(1) Configuration Tool

参考: Getting started with the Configuration Tool on z/OSMF
WebのUIを持つ構成ツールが提供されていて、z/OSMFに組み込んで利用できるようです。まずはこのツールを使うための構成を行います。

ユーザー作成

構成用のユーザーを作成します。

UID=0でユーザー"CDP201"を作成します。

//ADDUSER  JOB CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1)
//****************************************************************
//STEP1   EXEC PGM=IKJEFT01,DYNAMNBR=20,REGION=0M
//SYSTSPRT DD  SYSOUT=*
//SYSUADS  DD  DSN=SYS1.UADS,DISP=SHR
//SYSTSIN  DD  *
 ADDUSER (CDP201) OWNER(SYS1) DFLTGRP(SYS1) SPECIAL OPERATIONS -
   PASSWORD(PSWD) NAME (CDP201)                               -
   TSO(ACCTNUM(ACCT#) MSGCLASS(H) PROC(IKJACCNT) SIZE(6072) -
       MAXSIZE(2096128) UNIT(SYSALLDA) USERDATA(0000) ) -
   OMVS(UID(0) HOME(/u/CDP201) PROGRAM(/bin/sh))
/*
//STEP2    EXEC PGM=IKJEFT01
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD *
  PERMIT ACCT#    ACCESS(READ) CLASS(ACCTNUM) ID(CDP201)
  PERMIT IKJACCNT ACCESS(READ) CLASS(TSOPROC) ID(CDP201)
  PERMIT ACCT     ACCESS(READ) CLASS(TSOAUTH) ID(CDP201)
  PERMIT JCL      ACCESS(READ) CLASS(TSOAUTH) ID(CDP201)
  PERMIT MOUNT    ACCESS(READ) CLASS(TSOAUTH) ID(CDP201)
  PERMIT OPER     ACCESS(READ) CLASS(TSOAUTH) ID(CDP201)
  PERMIT RECOVER  ACCESS(READ) CLASS(TSOAUTH) ID(CDP201)
  SETROPTS RACLIST(ACCTNUM) REFRESH
  SETROPTS RACLIST(TSOPROC) REFRESH
  SETROPTS RACLIST(TSOAUTH) REFRESH
/*
//STEP3   EXEC PGM=IDCAMS
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *
 DEF   ALIAS(NAME(CDP201) REL(CATALOG.ZPLEX.USERS) )-
     CATALOG(CATALOG.Z23.MASTER)
/*
//

ホームディレクトリを作成します。

[CICS004@EPLEX1:/u] pwd
/u
[CICS004@EPLEX1:/u] mkdir CDP201

TSOでログインできることを確認。

z/OSMFの管理グループ(IZUADMIN)権限付与します(TSOコマンドCONNECT CDP201 GROUP(IZUADMIN))。

z/OSMFのWebUIからCDP201ユーザーでログインできることを確認。

作業ディレクトリの設定

参考: Setting up a working directory for the Configuration Tool
ここで、savingpolicy.shを流すように記載されているので、それに従って実行。

実行例

[CDP201@EPLEX1:/u/CDP201] sh /usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/savingpolicy.sh
If you are deploying the Configuration tool on z/OSMF, please input '1'.
If you are deploying the Configuration tool directly in Liberty server, please input '2'.
1

You may enter a blank value to accept the default values in parentheses.

The Configuration Tool will be deployed in z/OSMF
Before running this script, ensure you are in the z/OSMF Administrator
group (IZUADMIN by default for z/OSMF).
The Configuration Tool requires a workspace where it can output
completed policy files. Please enter the full path of the directory you
would like to create.

Policy file directory (default: /u/error for uid: 0/cdpConfig): /u/CDP201/cdpConfig
User ID to own the policy file directory (default: Error for uid: 0): CDP201
Group containing administrators (default: IZUADMIN):
*** Important: the default value for the next parameter represents absolute
directory. If the default directory will become invalid after the next IPL,
provide a directory path that does not change between IPLs. Otherwise accept
the default value.
The Configuration Tool Source Script Directory (default: /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB):
The Configuration Tool has been successfully implemented.

You may now import the following file in the z/OSMF Import Manager:
/u/CDP201/cdpConfig/HBOCDEUI/v2r1m0/LIB/cdpConfig.properties

上のスクリプト実行の中で、Policy File Directoryとして/u/CDP201/cdpConfigを指定していますので、そのディレクトリが作成されています。

[CDP201@EPLEX1:/u/CDP201] pwd
/u/CDP201
[CDP201@EPLEX1:/u/CDP201] ls
cdpConfig

/u/CDP201/cdpConfig/HBOCDEUI/v2r1m0/LIB/ には以下のようなファイルが作成されます。

[CDP201@EPLEX1:/u/CDP201/cdpConfig/HBOCDEUI/v2r1m0/LIB] ls -la
total 40
drwxrwx---   2 0        IZUADMIN    8192 Jan  7 09:16 .
drwxrwx---   4 0        IZUADMIN    8192 Jan  7 09:15 ..
lrwxrwxrwx   1 0        STC           53 Jan  7 09:16 CDPUIServer.war -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/CDPUIServer.war
lrwxrwxrwx   1 0        STC           67 Jan  7 09:16 cdp-starter-sets.streams.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdp-starter-sets.streams.json
lrwxrwxrwx   1 0        STC           56 Jan  7 09:16 cdp.protocols.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdp.protocols.json
lrwxrwxrwx   1 0        STC           57 Jan  7 09:16 cdp.transforms.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdp.transforms.json
-rw-rw----   1 0        IZUADMIN      91 Jan  7 09:16 cdpConfig.json
lrwxrwxrwx   1 0        STC           58 Jan  7 09:16 cdpConfig.properties -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdpConfig.properties
lrwxrwxrwx   1 0        STC           65 Jan  7 09:16 cdpConfig.remove.properties -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdpConfig.remove.properties
lrwxrwxrwx   1 0        STC           58 Jan  7 09:16 cdpConfigVersion.txt -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdpConfigVersion.txt
lrwxrwxrwx   1 0        STC           54 Jan  7 09:16 cdpui.properties -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/cdpui.properties
lrwxrwxrwx   1 0        STC           49 Jan  7 09:16 defracf.cmd -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/defracf.cmd
lrwxrwxrwx   1 0        STC           50 Jan  7 09:16 en.i18n.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/en.i18n.json
lrwxrwxrwx   1 0        STC           54 Jan  7 09:16 ims.streams.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/ims.streams.json
lrwxrwxrwx   1 0        STC           48 Jan  7 09:16 index.html -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/index.html
lrwxrwxrwx   1 0        STC           64 Jan  7 09:16 log-forwarder.streams.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/log-forwarder.streams.json
lrwxrwxrwx   1 0        STC           52 Jan  7 09:16 main.bundle.js -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/main.bundle.js
lrwxrwxrwx   1 0        STC           57 Jan  7 09:16 polyfills.bundle.js -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/polyfills.bundle.js
lrwxrwxrwx   1 0        STC           54 Jan  7 09:16 sde.streams.json -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/sde.streams.json
lrwxrwxrwx   1 0        STC           48 Jan  7 09:16 server.xml -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/server.xml
lrwxrwxrwx   1 0        STC           54 Jan  7 09:16 vendor.bundle.js -> /V1R11/usr/lpp/IBM/zcdp/v2r1m0/UI/LIB/vendor.bundle.js

/u/CDP201/cdpConfig/HBOCDEUI/v2r1m0/LIB/cdpConfig.properties

importType=plugin

izu.externalapp.file.version=v2r1m0
izu.externalapp.local.context.root=cdp
izu.externalapp.code.root=.

pluginId=com.ibm.zos.cdp
pluginDefaultName=IBM Z Common Data Provider
pluginDescription=Configuration tool for IBM Z Common Data Provider
aboutPanelPath=cdpConfigVersion.txt

taskId1=CONFIGURE
taskVersion1=1.0
taskCategoryId1=4
taskDispName1=IBM Z Common Data Provider
taskDispDesc1=Interface for configuring IBM Z Common Data Provider
taskSAFResourceName1=ZOSMF.IBM_CDP.CONFIG.CDPConfiguration
taskMultiSysplexScope1=false
taskHandlerEligible1=false
taskAuthenticatedGuestEligible1=true
taskNavigationURL1=/index.html
taskBundleUrl1=/
taskBundleFileName1=/main.bundle.js
taskMinZOS1=03.23.00
taskMinZOSMF1=03.23.00

Installing the Configuration Tool

参考: Installing the Configuration Tool

ブラウザから、上で作成したCDP201ユーザーでz/OSMFにログインし、z/OSMF管理 - インポート・マネージャーを選択

プロパティーファイルとして、上で作成した/u/CDP201/cdpConfig/HBOCDEUI/v2r1m0/LIB/cdpConfig.propertiesを指定して「表示」

中身を確認したら「インポート」

z/OSMFの画面をリフレッシュすると、左側のメニューの"構成"以下に"IBM Z Common Data Provider"という項目が追加されます。

※CDPz V1.1をインストール済の環境で、V2.1のプラグインを入れたら、V1.1で作られていたメニューが消えて、上の"IBM Z Common Data Provider"に置き換わってしまったので、複数バージョンの共存はできなさそうです。

以下のTSOコマンド実行(V1.1導入時に実施済み)

[CICS004@EPLEX1:/] tsocmd "RDEFINE ZMFAPLA IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration UACC(NONE)"
RDEFINE ZMFAPLA IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration UACC(NONE)
ICH10006I RACLISTED PROFILES FOR ZMFAPLA WILL NOT REFLECT THE ADDITION(S) UNTIL A SETROPTS REFRESH IS ISSUED.

[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH RACLIST(ZMFAPLA)"
SETROPTS REFRESH RACLIST(ZMFAPLA)

[CICS004@EPLEX1:/] tsocmd "PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUADMIN) ACCESS(CONTROL)"
PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUADMIN) ACCESS(CONTROL)
ICH06011I RACLISTED PROFILES FOR ZMFAPLA  WILL NOT REFLECT THE UPDATE(S) UNTIL A SETROPTS REFRESH IS ISSUED

[CICS004@EPLEX1:/] tsocmd "PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUUSER) ACCESS(READ)"
PERMIT IZUDFLT.ZOSMF.IBM_CDP.CONFIG.CDPConfiguration CLASS(ZMFAPLA) ID(IZUUSER) ACCESS(READ)
ICH06011I RACLISTED PROFILES FOR ZMFAPLA  WILL NOT REFLECT THE UPDATE(S) UNTIL A SETROPTS REFRESH IS ISSUED

[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH RACLIST(ZMFAPLA)"
SETROPTS REFRESH RACLIST(ZMFAPLA)

以下のTechNoteにあるCEA.CEA... というプロファイルが無かったので定義を追加し、IZUADMIN, IZUUSERグループにUPDATE権限を付与。追加で、エラーが出ていたCEA.CEATSO.TSOREQUESTプロファイルにも同様にUPDATE権限付与。(V1.1導入時に実施済み)
https://www.ibm.com/support/pages/receive-hbo6501w-error-web-browser-when-attempting-open-cdp-zosmf-configuration

TSOコマンド例

RDEFINE SERVAUTH CEA.CEADOCMD UACC(NONE)
PERMIT CEA.CEADOCMD CLASS(SERVAUTH) ID(IZUADMIN) ACCESS(UPDATE)
PERMIT CEA.CEADOCMD CLASS(SERVAUTH) ID(IZUUSER) ACCESS(UPDATE)
...
SETROPTS REFRESH RACLIST(SERVAUTH)

z/OSMFのメニューから"構成"-"IBM Z Common Data Provider"を選択して、以下の管理画面が表示されることを確認。

これで構成ツールが使えそうなところまで確認できました。

(2) Data Streamer

参考: Configuring the Data Streamer

CDPZ02.V2R1M0.SHBOSAMP(HBODSPRO)に提供されるプロシージャーのサンプルを自環境の適当なPROCLIBにコピーして編集。

//HBODSPRO  PROC
//*
//ZLOGOUT EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT
//*
//* Output and error data sets
//*
//STDOUT  DD   SYSOUT=*
//STDERR  DD   SYSOUT=*
//*
//* Parameter data
//*
//STDPARM  DD *
PGM /bin/sh
/usr/lpp/IBM/zcdp/v2r1m0/DS/LIB/startup.sh
/etc/cdpConfig/myPolicy.policy
50401 start=w trace=n
//*
//* Environment data
//*
//STDENV DD *
JAVA_HOME=/usr/lpp/java/J8.0_64
CDP_HOME=/usr/lpp/IBM/zcdp/v2r1m0/cdp_work
TZ=JST-9
#DEFAULT_HEAP=4g
#MAXIMUM_HEAP=4g
#RESOLVER_CONFIG=//'USER.TCPIP(TCPDATA)'
#_BPXK_SETIBMOPT_TRANSPORT=TCPIPOE
//*
//      PEND
//*********************************************************************

Data StreamerがListenするポートは50401とする。
また、CDP_HOMEとして /usr/lpp/IBM/zcdp/v2r1m0/cdp_work を指定したので、それに合わせてUSS上にこのディレクトリを作成しておく。
Sample.policyは後でポリシー作成後に置き換えるので、一旦はこのまま。
TZ=JST-9に変更

Data StreamerをSTARTED TASKとして実行する際のユーザーとしてCDP201を指定しておく。

RACF設定例

[CICS004@EPLEX1:/] tsocmd "RDEFINE STARTED HBODSPRO.* STDATA(USER(CDP201))"
RDEFINE STARTED HBODSPRO.* STDATA(USER(CDP201))
ICH10006I RACLISTED PROFILES FOR STARTED WILL NOT REFLECT THE ADDITION(S) UNTIL A SETROPTS REFRESH IS ISSUED.

[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)"
SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)

(3) Log Forwarder

参考: Configuring the Log Forwarder

OPERLOG設定有無によってセットアップ手順が異なります。ここでは、OPERLOG設定なしの想定とします。
ガイドにあるポリシーの作成(Configuration Toolの利用)は後回しにします。

CDPZ02.V2R1M0.SHBOSAMP(HBOPROC)に提供されるプロシージャーのサンプルを自環境の適当なPROCLIBにコピーして編集。

HBOPROC

//HBOPROC  PROC OPT=''
//* The ENVDIR is defaulted to /usr/lpp/IBM/zscala/V3R1/samples in the
//* startup.sh script.
//*
//* Set HBOBASE to the directory where the startup.sh script resides.
//* The default directory for startup.sh is listed below.
// SET HBOBASE='/usr/lpp/IBM/zcdp/v2r1m0/LF/samples'
//*
//* Uncomment and set ENVDIR to the directory where the zlf.conf
//* environment file resides (do not remove the -e at the beginning of
//* the variable). If not uncommented, startup.sh will use the default
//* directory value, listed below.
//* SET ENVDIR='-e /usr/lpp/IBM/zscala/V3R1/samples'
// SET ENVDIR='-e /u/CDP201/cdpConfig'
//*
//***** HBOPROC PROC *************************************************
//*
//ZLOGOUT EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,
// PARM=('PGM /bin/sh &HBOBASE./startup.sh &OPT &ENVDIR')
//* Output data sets
//STDOUT  DD   SYSOUT=*
//STDERR  DD   SYSOUT=*
//*
//      PEND
//*********************************************************************

ENVDIRとして、/u/CDP201/cdpConfigを指定(ポリシーファイルがここに作成される想定)。

HBOBASEは、startup.shのディレクトリを指定してますが、V2.1インストールディレクトリパスに変更。
HBOBASE='/usr/lpp/IBM/zcdp/v2r1m0/LF/samples'

Log ForwarderをSTARTED TASKとして実行する際のユーザーとしてCDP201を指定しておく。さらに、マニュアル記述の通り、FACILITYクラスの BPX.CONSOLEプロファイルにREAD権限付与する。

RACF設定例

[CICS004@EPLEX1:/] tsocmd "RDEFINE STARTED HBOPROC.* STDATA(USER(CDP201))"
RDEFINE STARTED HBOPROC.* STDATA(USER(CDP201))
ICH10006I RACLISTED PROFILES FOR STARTED WILL NOT REFLECT THE ADDITION(S) UNTIL A SETROPTS REFRESH IS ISSUED.
[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)"
SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)

[CICS004@EPLEX1:/] tsocmd "PERMIT BPX.CONSOLE CLASS(FACILITY) ID(CDP201) ACCESS(READ)"
PERMIT BPX.CONSOLE CLASS(FACILITY) ID(CDP201) ACCESS(READ)
ICH06011I RACLISTED PROFILES FOR FACILITY WILL NOT REFLECT THE UPDATE(S) UNTIL A SETROPTS REFRESH IS ISSUED
[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH RACLIST(FACILITY)"
SETROPTS REFRESH RACLIST(FACILITY)

SYSLOGデータ取得用User Exitを追加します。
OPERLOGなし、JES3利用なし、の環境なのでHBOSYSGというユーザーExitを追加します。

LPALSTxxにSHBOLPAを登録し、PROGxxにてEXITを登録する。以下IPL時に有効化される静的定義の例。

SYS0.PARMLIB(LPALST01)

...
CDPZ02.V2R1M0.SHBOLPA(ZSPK01),
...

SYS0.PARMLIB(PROG02)

...
EXIT ADD EXITNAME(CNZ_MSGTOSYSLOG) MODNAME(HBOSYSG)                            
...

必要に応じて動的設定もしくはIPL実施。

(4) System Data Engine

参考: Configuring the System Data Engine

SMFを取り込む際に、対象とするデータソースの形式によりセットアップ方法が異なります。ここでは、LogstreamではなくSYS1.MANxデータセットを取り込む想定とします。
ガイドにあるポリシーの作成(Configuration Toolの利用)は後回しにします。

PROGxxにAPF登録をします。

SYS0.PARMLIB(PROG02)

...
 APF ADD                                                                   
     DSNAME(CDPZ02.V2R1M0.SHBOLOAD)                       VOLUME(ZSPK01)    
 APF ADD                                                                 
     DSNAME(CDPZ02.V2R1M0.SHBOLLST)                       VOLUME(ZSPK01)                        
...

CDPZ02.V2R1M0.SHBOSAMP(HBOSMF)に提供されるプロシージャーのサンプルを自環境の適当なPROCLIBにコピーして編集。

HBOSMF

//HBOSMFCL EXEC PGM=HBOPDE,REGION=0M,TIME=1440,
//         PARM='SHOWINPUT=NO,ZIIPOFFLOAD=NO'
//STEPLIB  DD DISP=SHR,DSN=CDPZ02.V2R1M0.SHBOLOAD
//*
//* CONTROL STATEMENTS
//* The control statement file must be customised to match
//* the target of the Common Data Provider configuration utility.
//*
//HBOIN    DD *
SET IBM_SDE_INTERVAL = '1 MINUTES';
SET IBM_UPDATE_TARGET = 'PORT 50401';
SET IBM_FILE_FORMAT = 'CSV';
SET IBM_RESOURCE = 'EXIT';
//         DD  PATH='/etc/cdpConfig/hboin.sde',
//         PATHDISP=(KEEP),RECFM=V,LRECL=255,FILEDATA=RECORD
//*
//* Sample COLLECT statement for processing real-time SMF data
//*
//         DD *
COLLECT SMF FROM &IBM_RESOURCE
  EVERY &IBM_SDE_INTERVAL;
/*
//HBOOUT   DD SYSOUT=*
//HBODUMP  DD SYSOUT=*
//HBODEBUG DD SYSOUT=*

//STEPLIB DD DISP=SHR,DSN=CDPZ02.V2R1M0.SHBOLOAD => データセット名変更
SET IBM_UPDATE_TARGET = 'PORT 50401'; => Data Streamerのポート番号指定
SET IBM_RESOURCE = 'EXIT'; => MANxデータセットをEXITにて取得する想定なので、"EXIT"で固定
// DD PATH='/etc/cdpConfig/hboin.sde' => ポリシーファイル名は後で変更

System Data EngineをSTARTED TASKとして実行する際のユーザーとしてCDP201を指定しておく。

RACF設定例

[CICS004@EPLEX1:/] tsocmd "RDEFINE STARTED HBOSMF.* STDATA(USER(CDP201))"
RDEFINE STARTED HBOSMF.* STDATA(USER(CDP201))
ICH10006I RACLISTED PROFILES FOR STARTED WILL NOT REFLECT THE ADDITION(S) UNTIL A SETROPTS REFRESH IS ISSUED.

[CICS004@EPLEX1:/] tsocmd "SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)"
SETROPTS REFRESH GENERIC(STARTED) RACLIST(STARTED)

LPALST登録

SYS0.PARMLIB(LPALST01)

...
CDPZ02.V2R1M0.SHBOLPA(ZSPK01),  
...

EXIT登録

SMFPRMxxのSUBSYS定義を確認

SYS0.PARMLIB(SMFPRMxx)

...
 SUBSYS(STC,EXITS(IEFU29,IEFU83,IEFU84,IEFUJP,IEFUSO,IEFACTRT),            
               INTERVAL(SMF,SYNC))                                         
...

SUBSYSで"STC"というのが定義されているので、EXITNAMEとして、SYSSTC.IEFUxxを定義する。

SYS0.PARMLIB(PROG02)

...
EXIT ADD EXITNAME(SYSSTC.IEFU83) MODNAME(HBOSMFEX)  
EXIT ADD EXITNAME(SYSSTC.IEFU84) MODNAME(HBOSMFEX)  
EXIT ADD EXITNAME(SYSSTC.IEFU85) MODNAME(HBOSMFEX)                              
...

必要に応じて動的設定もしくはIPL実施。

補足

各種コマンドの備忘録

APF動的登録

SETPROG APF,ADD,DSN=CDPZ02.V2R1M0.SHBOLOAD,VOLUME=ZSPK01
SETPROG APF,ADD,DSN=CDPZ02.V2R1M0.SHBOLLST,VOLUME=ZSPK01

APF確認

例

D PROG,APF
...
517  ZSPK01 CDPZ02.V2R1M0.SHBOLOAD 
518  ZSPK01 CDPZ02.V2R1M0.SHBOLLST 
...

EXIT動的削除

SETPROG EXIT,DELETE,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=GLASYSG
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU83,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU84,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU85,MODNAME=HBOSMFEX

LPA動的削除

SETPROG LPA,DELETE,MODNAME=HBOSMFEX,FORCE=YES

LPA動的登録

SETPROG LPA,ADD,MODNAME=HBOSMFEX,DSNAME=CDPZ02.V2R1M0.SHBOLPA       
IEF196I IEF237I 5187 ALLOCATED TO SYS00496                          
IEF196I IEF285I   CDPZ02.V2R1M0.SHBOLPA                        KEPT 
IEF196I IEF285I   VOL SER NOS= ZSPK01.                              
CSV551I 12.09.18 LPA ADD 383                                        
SUCCESSFUL: 1  UNSUCCESSFUL: 0  NOT PROCESSED: 0                    
MODULE    RESULT                                                    
HBOSMFEX  SUCCESSFUL

※SHBOLPA以下の他のモジュールも同様に実施

LPA確認

D PROG,LPA,MOD=HBOSMFEX                                  
CSV550I 12.11.13 LPA DISPLAY 385                         
FLAGS  MODULE    ENTRY PT  LOAD PT   LENGTH    DIAG      
 D P   HBOSMFEX  963290E8  16329000  00000ED0  038B7F10

EXIT動的追加

SETPROG EXIT,ADD,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=HBOSYSG        
CSV420I MODULE HBOSYSG HAS BEEN ADDED TO EXIT CNZ_MSGTOSYSLOG   

SETPROG EXIT,ADD,EXITNAME=SYSSTC.IEFU83,MODNAME=HBOSMFEX       
CSV420I MODULE HBOSMFEX HAS BEEN ADDED TO EXIT SYSSTC.IEFU83   
SETPROG EXIT,ADD,EXITNAME=SYSSTC.IEFU84,MODNAME=HBOSMFEX       
CSV420I MODULE HBOSMFEX HAS BEEN ADDED TO EXIT SYSSTC.IEFU84   
SETPROG EXIT,ADD,EXITNAME=SYSSTC.IEFU85,MODNAME=HBOSMFEX       
CSV420I MODULE HBOSMFEX HAS BEEN ADDED TO EXIT SYSSTC.IEFU85

EXIT確認

D PROG,EXIT,MODNAME=HBOSYSG            
CSV462I 12.35.34 PROG,EXIT DISPLAY 455 
MODULE  HBOSYSG                        
EXIT(S) CNZ_MSGTOSYSLOG          

D PROG,EXIT,MODNAME=HBOSMFEX                              
CSV462I 15.50.39 PROG,EXIT DISPLAY 658                    
MODULE  HBOSMFEX                                          
EXIT(S) SYSSTC.IEFU85    SYSSTC.IEFU84    SYSSTC.IEFU83

カスタマイズ用Dataset作成

参考: Creating a System Data Engine data stream definition

CDPZ02.V2R1M0.HBODEFSに提供されているSystem Data Engine定義ファイルをカスタマイズした場合に、その配置先となるデータセットを作成しておきます。
ここでは、CDPZ02.CUSTOM.HBODEFSという名前で作成しておきます(サイズ等はCDPZ02.V2R1.M0.HBODEFSと同じ)。

Data Set Name  . . . : CDPZ02.CUSTOM.SHBODEFS                                
                                                                             
General Data                          Current Allocation                     
 Volume serial . . . : ZSPK01          Allocated tracks  . : 300             
 Device type . . . . : 3390            Allocated extents . : 1               
 Organization  . . . : PO              Maximum dir. blocks : 30              
 Record format . . . : VB                                                    
 Record length . . . : 255                                                   
 Block size  . . . . : 27998          Current Utilization                    
 1st extent tracks . : 300             Used tracks . . . . : 1               
 Secondary tracks  . : 25              Used extents  . . . : 1               
                                       Used dir. blocks  . : 1               
                                       Number of members . : 0               
                                                                             
                                      Dates                                  
                                       Creation date . . . : 2020/01/16      
                                       Referenced date . . : ***None***      
                                       Expiration date . . : ***None***

ELK側の準備

参考: Preparing to send data to Elasticsearch
CDPz V2.1のマニュアルでは、サポートされるELKスタックのバージョンの記述が無くなっている！
とりあえず手元にあるRHEL上のELK V7.xを使うことにします。

ELKのインストールは割愛します。(rpmパッケージをダウンロードしてそれぞれインストール)
参考:
fluentd/Elasticsearch/kibanaを試す: (1)インストール
 Logstashメモ - (1)インストール/簡易操作

構成

最低限の構成

Elasticsearch

/etc/elasticsearch/elasticsearch.yml 編集

elasticsearch.yml抜粋

http.port: 9200
http.host: 0.0.0.0

Kibana

/etc/kibana/kibana.yml 編集

kibana.yml抜粋

server.port: 5601
server.host: "0.0.0.0"

Logstash

参考: Preparing to send data to Elasticsearch

Elasticsearchに取り込むためのLogstash構成ファイルが、USS上の/usr/lpp/IBM/zcdp/v2r1m0/DS/LIB/ibm_cdpz_ELK.tar.gzに提供されています。
これをバイナリーモードでLinux側にコピーして展開します。取り込むデータ毎に各種Logstash構成ファイルが含まれています。

デフォルトのlogstash構成確認ておきます。
systemdのlogstash.serviceを見てみると...

/etc/systemd/system/logstash.service

[Unit]
Description=logstash

[Service]
Type=simple
User=logstash
Group=logstash
# Load env vars from /etc/default/ and /etc/sysconfig/ if they exist.
# Prefixing the path with '-' makes it try to load, but if the file doesn't
# exist, it continues onward.
EnvironmentFile=-/etc/default/logstash
EnvironmentFile=-/etc/sysconfig/logstash
ExecStart=/usr/share/logstash/bin/logstash "--path.settings" "/etc/logstash"
Restart=always
WorkingDirectory=/
Nice=19
LimitNOFILE=16384

[Install]
WantedBy=multi-user.target

--path.settings として/etc/logstashディレクトリが指定されています。
Running Logstash from the Command Line

このディレクトリ下のlogstash.ymlが構成ファイルとして使われます。

/etc/logstash/logstash.yml

...
# Where to fetch the pipeline configuration for the main pipeline
#
# path.config: 
...

path.configはコメントアウト状態のままにしておきます。
同ディレクトリのpipelines.ymlを確認。

/etc/logstash/pipelines.yml

# This file is where you define your pipelines. You can define multiple.
# For more information on multiple pipelines, see the documentation:
#   https://www.elastic.co/guide/en/logstash/current/multiple-pipelines.html

- pipeline.id: main
  path.config: "/etc/logstash/conf.d/*.conf"

ここでは確認だけで、Logstashの構成は後回し...

firewalld

firewallを使用している場合、9200と5601ポートにアクセスできるよう穴をあける。

[root@Test08 /etc/firewalld/zones]# firewall-cmd --zone=public --add-port=9200/tcp --permanent
success

[root@Test08 /etc/firewalld/zones]# firewall-cmd --zone=public --add-port=5601/tcp --permanent
success

[root@Test08 /etc/firewalld/zones]# cat public.xml
<?xml version="1.0" encoding="utf-8"?>
<zone>
  <short>Public</short>
  <description>For use in public areas. You do not trust the other computers on networks to not harm your computer. Only selected incoming connections are accepted.</description>
  <service name="ssh"/>
  <service name="dhcpv6-client"/>
  <port protocol="tcp" port="9200"/>
  <port protocol="tcp" port="5601"/>
</zone>

[root@Test08 /etc/firewalld/zones]# firewall-cmd --reload
success

SSHポートフォワード

今回お試しで利用する環境は、z/OSのマシンと、ELKスタックを乗せるLinuxマシンが、別のネットワークセグメントにあり、z/OS側がよりセキュアなネットワークとなっています。そのため、z/OS側からLinuxマシンに対してTCPのコネクションを張ることが制限されています(Linuxからz/OSへのSSH接続は可)。これを回避するために、テストをする時だけ一時的にSSHポートフォワードの構成を行うことにします。

ポートフォワードを行うためにLinux上で発行するコマンド例
ssh -f -N -R 8081:localhost:8081 <user>@eplex1

公開鍵認証の設定をしておくか、上のコマンド実行時にパスワードを入力する必要があります。
これをテスト実行するときだけ有効にする想定です。

SSHやポートフォワードについては、以下の記事もご参照ください。
参考: マルチ・プラットフォームを扱うインフラ屋さんのための連携技術: SSH編

起動

[root@test08 ~]# systemctl start elasticsearch.service
[root@test08 ~]# systemctl status elasticsearch.service
● elasticsearch.service - Elasticsearch
   Loaded: loaded (/usr/lib/systemd/system/elasticsearch.service; disabled; vendor preset: disabled)
   Active: active (running) since 火 2020-01-07 13:22:20 JST; 1min 48s ago
     Docs: http://www.elastic.co
 Main PID: 7506 (java)
    Tasks: 83
   CGroup: /system.slice/elasticsearch.service
           tq7506 /usr/share/elasticsearch/jdk/bin/java -Xms2g -Xmx2g -XX:+UseConcMarkSweepGC -XX:CMSInitiatingOccupancyFraction=75 -XX:+UseCMSInitiatin...
           mq7672 /usr/share/elasticsearch/modules/x-pack-ml/platform/linux-x86_64/bin/controller

 1月 07 13:22:20 test08 systemd[1]: Started Elasticsearch.
 1月 07 13:22:20 test08 systemd[1]: Starting Elasticsearch...
 1月 07 13:22:47 test08 elasticsearch[7506]: OpenJDK 64-Bit Server VM warning: Option UseConcMarkSweepGC was deprecated in version 9.0 and will...release.
Hint: Some lines were ellipsized, use -l to show in full.


[root@test08 ~]# systemctl start kibana.service
[root@test08 ~]# systemctl status kibana.service
● kibana.service - Kibana
   Loaded: loaded (/etc/systemd/system/kibana.service; disabled; vendor preset: disabled)
   Active: active (running) since 火 2020-01-07 13:24:26 JST; 15s ago
 Main PID: 7999 (node)
    Tasks: 21
   CGroup: /system.slice/kibana.service
           mq7999 /usr/share/kibana/bin/../node/bin/node --no-warnings --max-http-header-size=65536 /usr/share/kibana/bin/../src/cli -c /etc/kibana/kiba...

 1月 07 13:24:26 test08 systemd[1]: Started Kibana.
 1月 07 13:24:26 test08 systemd[1]: Starting Kibana...

Elasticsearchにアクセスしてみる

[root@test08 ~]# curl -X GET http://localhost:9200
{
  "name" : "test08",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "cGII5hcKSQKyrQZnZ0JPZw",
  "version" : {
    "number" : "7.2.0",
    "build_flavor" : "default",
    "build_type" : "rpm",
    "build_hash" : "508c38a",
    "build_date" : "2019-06-20T15:54:18.811730Z",
    "build_snapshot" : false,
    "lucene_version" : "8.0.0",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

Kibanaにアクセスしてみる

とりあえず最低限の構成は出来上がりました。

データ取り込みのための構成(Overview)

さて、上の手順で基本的なセットアップは済んだので、ここから、実際にデータを取得するための構成をしていきます。
何のデータをどこに流し込むか、ということを色々カスタマイズできるようなのですが、バリエーションも豊富で仕組みも結構複雑なので、まず、ここでは全体像を押さえて、具体的なデータ取得は別の記事で取り上げることにします。連携先はタイトルにあるようにELKスタックを前提としていますが、一旦ここではELK側は置いておいて、CDPz側にフォーカスします。

ざっくり言うと、以下のステップを踏むことになります。
1.Config Toolで"ポリシー"と呼ばれる定義を作成します。"ポリシー"とは、何のデータをどのように取得して、それをどこにどうやって送るか、というような情報を保持するものです。
2.作成されたポリシーの情報を元にして、CDPzの各コンポーネントを稼働させます。

ホスト側コンポーネントおさらい

以降、以下の省略形を使う場合があります。
DS: Data Streamer
LF: Log Forwarder
SDE: System Data Engine

1.Config Toolによるポリシーの作成

z/OSMFのプラグインとして、CDPzの構成ツールをセットアップしましたので、まずはそれを使ってポリシーを作成します。
※製品が事前に用意しているメニューから取得したい情報を選択して定義を作成していきますが、全ての情報がメニューとして用意されている訳ではありません。用意されていない項目を取得したい場合、追加でカスタマイズが必要となりますが、ここでは一旦用意されているメニューを取得するイメージで記載します。

ポリシーエディター

Create New policyを選択すると、Policy Profile Editの画面となり、ここでGUIベースでポリシーを定義することができます。以下のようなイメージでポリシーを作成していきます。

図1:ポリシー編集画面

左側に縦に並んでいる青い箱は、何のデータを取得したいか、ということを表しています(LFもしくはSDE関連の情報)。SYSLOGやSMF Type110 Subtype1のデータなど、取得したいデータを選んでいきます。
※これら取得するデータの情報は"Data Stream"と呼ばれていますが、"Data Streamer"とは別物ですのでご注意ください！(まったくネーミングが紛らわしい！！！)
製品が用意しているメニューとしては、以下のようなものがあります。

図1の右側にある緑色の箱は、データをどこにどうやって送るかという情報を設定するもので(DS関連の情報)、Subscriberと呼ばれています。
※ネーミングに一貫性が無くて分かりにくい！！！

DataStreamとSubscriberはそれぞれ関連付けされて、どのデータをどこに送るかというのを定義していくことになります。

ポリシー編集画面で定義をしていく流れを図にするとこんな感じです。

上の図中の(1)-1, (1)-2で示されているLog Forwarder用の設定、System Data Engine用の設定はそれぞれ以下の通り。

(1)-1 LOG FORWARDER

(1)-2 SYSTEM DATA ENGINE

生成物

上のエディターでGUIベースでポリシーを作成して保存すると、定義内容が反映されたファイルがUSS上に作成されます。
出力先はConfig Toolセットアップ時に指定したPolicy file directoryです。ここでは/u/CDP201/cdpConfig/

ファイル	説明
<policyName>.policy	Data Streamer関連情報を管理(どのデータをどこに送付するか)。Data Streamer起動プロシージャーで、このファイル名を指定。
<policyName>.config.properties <policyName>.zlf.conf	Log Forwarder関連情報を管理(Log Fowarder関連ライブラリ、使用するData Streamerのポート番号など)。Log Forwader起動プロシージャーの”ENVDIR”で示されたディレクトリ下に適切な名前で配置する必要がある。
<policyName>.sde	System Data Engine関連情報を管理(取得するデータの情報)。実体は、ポリシーに追加したData Streamに紐づくSHBODEFSデータセットのメンバー(Data Streamとしての処理を独自言語で実装したもの)をコンカチしたもの。System Data Engine起動プロシージャー/バッチ実行用JCLで、このファイル名を指定。
<policyName>.layout	ポリシーエディターの画面レイアウト情報を保持

2.CDPz各コンポーネントの起動

上で生成されたファイルを使用して、CDPzの各コンポーネントを実行することになります。
そのため、起動プロシージャーを編集し、上で生成したファイルを参照するようにします。

Data Streamer: HBODSPRO => xxx.policyファイル
Log Forwarder: HBOPROC => xxx.config.properties, xxx.zlf.confファイルのディレクトリ
System Data Engine: HBOSMF => xxx.sdeファイル

補足: オブジェクト相関図

なかなか全体像を捉えるのが難しく、名前も混乱しやすいので、各オブジェクトの相関を整理してみました。

おわりに

ようやく全体のイメージがわかってきた気がします。
今後、SYSLOG, SMFデータをELKに取り込む方法を見ていきたいと思います。