|
|
Oracle Tuxedo Application Rehosting Workbench JCL TranslatorはKornシェル(ksh)構文およびOracle Tuxedo Application Runtime for Batchコンポーネントを使用して、完全なz/OS JCLファイル(メイン・ジョブ、PROC、INCLUDEなど)を完全なUnix/Linuxシェル・スクリプトに変換します。
このガイドは、Rehosting Workbenchを使用してz/OS JCLからUNIX/ Linux Kornシェル・スクリプトへ変換するユーザーを対象としています。
JCLを変換する場合、JCL、Z/OSユーティリティおよびUNIX/Linux Kornシェルの知識が必要です。
特に、ジョブ制御言語(JCL)がプログラム、ジョブおよびユーティリティを管理し、必要な機能を果たすのに必要なリソースを割り当てる方法についての知識です。
さらに、ターゲット・シェル・スクリプトの構成方法およびBatch Runtimeコンポーネントの使用方法についての知識は、より深くJCL変換を理解する手助けとなるでしょう。
JCLトランスレータを実行する前に、移行するアセットの一貫性をチェックし、構文またはアセットの一貫性(欠落または未使用コンポーネント)に関連するエラーを修正するために、カタログ化は必須です。
データ移行プロセスは、JCL変換が開始する前に実行する必要があります。この依存性は、ファイル移行ツールがJCLトランスレータにより読み取られる構成ファイルを生成することが原因です。データ変換からの構成ファイルはOracle Tuxedo Application Rehosting Workbenchリファレンス・ガイドに記載されています。
Rehosting Workbench JCLトランスレータ・プロセスへの入力は次のとおりです。
Oracle Tuxedo Application Rehosting Workbenchカタロガにより生成された変換するJCLのASTに加え、Rehosting Workbench JCL Translatorは次のような様々な変換の要素を指定するメイン構成ファイルを入力として取得します。
このファイルは容易に標準のテキスト・エディタを使用して作成または他の情報のソースから生成できます。次に、Rehosting Workbenchツールとともに提供されるSimple ApplicationのSTFILEORAで、JCLファイルを変換するために作成されたサンプルの構成ファイルにコメントします。
メイン構成ファイルは次のいずれかの個別のサブファイルも参照します。
Oracle Tuxedo Application Rehosting Workbenchは構成ファイルの例とともに提供されます。
JCL変換用のメイン構成ファイルは、このガイドではconfig-trad-JCL.descと呼ばれ、Simple Applicationアプリケーションとともに使用されます。
次の項では様々な構成パラメータと構成サブファイルについて説明し、この章の最後では完全なサンプルを提供します。
2つのオプションtop-skeletonおよびbottom-skeletonにより指定されたサブファイルは、それぞれ生成されたスクリプトのヘッダー・ファイルおよびフッター・ファイルを表します。これらのファイルはカスタマイズできます。
top-skeleton = "../param/top-ksh.txt"
bottom-skeleton = "../param/bottom-ksh.txt"
#@(#)-------------------------------------------------------------------
#@(#)- SCRIPT NAME == $[JOBNAME].ksh --- VERSION OF $[DATE]
#@(#)- AUTHOR ==
#@(#)- TREATMENT ==
#@(#)- OBSERVATIONS == MAINFRAME MIGRATION
#@(#)- …..
JOBNAME
DATE
ファイルがOracle表に変換されるとき、メイン構成ファイルは次のようなサブ構成ファイルを参照する必要があります。
file-list-in-table = "../param/dynamic-config/File-in-table.txt"
このサブファイルはOracle Tuxedo Application Rehosting Workbench File-To-Oracleコンバータにより生成されます。このファイルはJCLトランスレータにOracle表に変換されるファイルを示し、これらのファイルを含む手順を適切に変換できるようにします。例では、PJ01AAA.SS.VSAM.CUSTOMERが変換されるファイルです。
たとえば、JCLソースにOracle表に変換されるファイルが含まれている場合、対応するシェル・スクリプトはBatch Runtime機能m_ProgramExecを-bオプションを指定して使用し、COBOLプログラムを実行します。-bオプションはデータベースへの接続がプログラムの実行前に開いている必要があることを示します。例:
m_ProgramExec -b RSSABB01
一般オプションroot-skeleton、target-proc、label-end、FSNの管理などはOracle Tuxedo Application Runtime Workbenchリファレンス・ガイドのJCLトランスレータの項で説明しています。
% config.desc :
%
root-skeleton = "../trf-jcl/"
target-proc = "../trf-jcl/Master-Proc"
use-sort=mf-sort
%
var-dataroot = "${DATA}/"var-tmp = "${TMP}/"var-spool = "${SPOOL}/"% Ksh heading
%
top-skeleton = "../param/top-ksh.txt"
% KSH footer
%
bottom-skeleton = "../param/bottom-ksh.txt"
% Files passed in tables
file-list-in-table = "../param/dynamic-config/File-in-table.txt"
% Suffix of translated ksh du ksh traduit
suffix-skeleton = "ksh"
% Management of FSN to keep
set-no-delete-fsn = SORTIE ( ZIP390 ),
ENTREE ( ZIP390 ),
* ( DB2CMD,CSQUTIL ),
CFTIN ( CFTUTIL ),
SYSUT1 ( DUMMY ),
* ( ADRDSSU ).
% Management of FSN to delete
set-delete-fsn = SYSOUT ( IDCAMS ),
SYSEXEC ( CSCOLMVS ),
SYSTSIN ( * ),
SYSPUNCH ( * ),
TOOLIN ( * ),
SYSUDUMP ( * ),
SYSDBOUT ( * ),
SYSABOUT ( * ),
SYSTSPRT ( * ),
SORTLIB ( * ),
OPLIB ( * ),
STEPLIB ( * ),
JOBLIB ( * ).
このファイルは、プログラムが起動されるインスタンスを検出するためのソースJCLの解釈方法、およびこの起動操作の変換方法、つまりIKJEFT01、DLIBATCHおよびその他の標準ランチャの事前定義済の構成を記述しています。
global-options jclz-launcher-spec-file = "launchers"
LAUNCHER DFSRRC00
IndexProg : 2,
IndexPSB : 3
END
LAUNCHER DB2BATCH
IndexProg : 2,
IndexPSB : 3
END
LAUNCHER SWCP7110
IndexProg : 2,
IndexParm : 4,
Separator : ";"
一般オプションroot-skeleton、target-proc、label-endなどはOracle Tuxedo Application Rehosting Workbenchリファレンス・ガイドのJCLトランスレータの項で説明しています。
%
% config.desc :
%
%
root-skeleton = "../trf-jcl/"
target-proc = "../trf-jcl/Master-Proc"
use-sort=mf-sort
%
%
var-dataroot = "${DATA}/"var-tmp = "${TMP}/"var-spool = "${SPOOL}/"%
% Ksh heading
-------------------------------------------------------------------------
%
top-skeleton = "../param/top-ksh.txt"
% Ksh heading -------------------------------------------------------------------------
%
% KSH footer ------------------------------------------------------------------------
%
bottom-skeleton = "../param/bottom-ksh.txt"
%
% KSH footer --------------------------------------------------------------------------
%
% File passed in table
%
file-list-in-table = "../param/dynamic-config/File-in-table.txt"
% Suffix of translated ksh
suffix-skeleton = "ksh"
% Management of FSN to keep
set-no-delete-fsn = SYSIN ( DSNUTILB ),
OUTPUT ( ZIP390 ),
INPUT ( ZIP390 ),
* ( DB2CMD,CSQUTIL ),
CFTIN ( CFTUTIL ),
SYSUT1 ( DUMMY ),
* ( ADRDSSU ).
% Management of FSN to delete
set-delete-fsn = SYSOUT ( IDCAMS ),
SYSEXEC ( CSCOLMVS ),
SYSTSIN ( * ),
SYSIN ( IDCAMS,XMFSORT,ICEMAN,SPOOL,SORT ),
SYSPUNCH ( * ),
TOOLIN ( * ),
SYSUDUMP ( * ),
SYSDBOUT ( * ),
SYSABOUT ( * ),
SYSTSPRT ( * ),
SORTLIB ( * ),
OPLIB ( * ),
STEPLIB ( * ),
JOBLIB ( * ).
Oracle Tuxedo Application Rehosting Workbench JCL Translatorは移行プラットフォーム(Linux)で実行し、1つのジョブ・ファイル、一連のジョブ・ファイルまたはシステム・コンテンツ全体を自動的に変換できます。
次のコマンドを使用して変換を実行できます。ログ・ファイルは$LOGS/trad-jclに生成されます。
入力ファイルとして同じ名前(.ksh接尾辞を除く)のKornシェル・スクリプトを作成する場合。
cd $LOGS/trans-jcl
$REFINEDIR/refine jclz-unix -v version -s $PARAM/system.desc -c $PARAM/config-trad-JCL.desc JCL/defvcust.jcl
次のコマンドを起動するJCLファイルのリストを変換する場合。
cd $LOGS/trans-jcl
$REFINEDIR/refine jclz-unix -v version -s $PARAM/system.desc -c $PARAM/config-trad-JCL.desc -f jcl-files-list
次のコマンドを起動するすべてのJCLファイルを変換する場合。
cd $LOGS/trans-jcl
$REFINEDIR/refine jclz-unix -v version -s $PARAM/system.desc -c $PARAM/config-trad-JCL.desc
JCLポストトランスレーション手順
JCL変換の制限により、またはサイト固有の変換が必要な場合、反復的なポストトランスレーション・タスクを自動的に実行する場合があります。
ポストトランスレーションのメカニズムにより、別の内容で行の1ブロックを変更できます。
ポストトランスレーションの使用方法を示すために、次の例では、/prtvcust.ksh JCLスクリプト内のm_ProgramExec IEFBR14 ""を含む行の後にコメントを追加しています。
# by user John Doe on YY/MM/DD
regle add-comment-1
filtre [
+JCL/prtvcust.ksh
]
transform [
m_FileAssign -m R -a R -d SHR VKSDCUST ${DATA}/METAW00.VSAM.CUSTOMERm_ProgramExec PGMMB01 ""
]
into [
m_FileAssign -m R -a R -d SHR VKSDCUST ${DATA}/METAW00.VSAM.CUSTOMERm_ProgramExec PGMMB01 ""
# Added comment
$REFINEDIR/M2_L3_5/scripts/post-trans -c=\#META-RENOV\# -r=$PROJECT/param/renov-jcl.desc JCL/prtvcust.ksh < JCL/prtvcust.ksh > JCL/prtvcust.ksh.renov
grep -v "#META-RENOV#" JCL/prtvcust.ksh.renov > JCL/prtvcust.ksh
エラー・メッセージを確認します。JCLトランスレータは生成されたスクリプトの実行中に発生したエラー・メッセージを出力します。"UNDEFINED"、"NIL"、"UNTRANSLATED"をキーワードにして検索して、メッセージが存在するかどうかを確認します。エラー・メッセージとその説明の完全なリストは、『Oracle Tuxedo Application Rehosting Workbenchリファレンス・ガイド』にあります。
次のことができるようになるため、Rehosting Workbenchを使用する場合はmakefileの使用をお薦めします。
makefileはプロジェクトの初期化時に操作が実装されたソース・ディレクトリに置かれる必要があります。
「Oracle Tuxedo Application Rehosting Workbenchカタロガ」の「Make構成」を参照してください。
$SOURCEファイル・システムのすべてのJCLを変換する場合
make trad_jcl
  
|