リファレンス・ガイド

Oracle Tuxedo Application Runtime for Batchの関数

バッチ・ランタイム・コマンドの概要

この章の内容は次のとおりです。

z/OS JCLのロジックとアーキテクチャのエミュレート

Oracle Tuxedo Application Runtime for Batchには、Kornシェル・スクリプトのスクリプト構文を単純化して、読みやすく、簡単に保守できる一連の上位レベル関数があります。

これらの関数を使用すると、サービスの整合性が保証されます。組み合せて使用すると、関数を、先行する関数のリターン・コードの値に基づいて実行することができます。

関数は、通常、JCL変換の結果として生じるKornシェル・スクリプトから直接呼び出されます。

Oracle Tuxedo Application Runtime for Batchは、ジョブの異なる実行フェーズが明確に識別されるスクリプト・モデルを提案することによって、Kornシェル・スクリプトを正規化します。

EJRの構文

概要

EJR [-v] [-s sysoutDir] [-L LogDir] [-H] [-R StepName] [-d regexp] [-f EnvFile] [-t file] [-V n] [-l] [-J] Job

TuxJesモードの場合:

EJR (-i|-c|-e|-k) -j JOBID -r JES2ROOT [-l] [-J] Job

引数

-c

-d regexp

-e

-f

-H

-i

-j

-J

-k

-l

-L

-r

-R

-s

-t file

-v

-V n

Job

JOBID

JES2ROOT

ジョブの実行を管理するためのツール

ログ・ファイルの管理

EJRを使用してスクリプトを起動する場合、ログ・ファイルが生成されます。TuxJESを使用しない場合、ログ・ファイルの名前は次のとおりです。

JobName_YYYYMMDDHHMMSS_Jobid.log.

ログ・ファイルは、MT_LOG環境変数で指定されたディレクトリに作成されます。プロダクション・チームは、このファイルの内容から、ジョブの実行に関する詳細な情報を取得します。

TuxJESを使用する場合、関連のドキュメントを参照してください。

リターン・コードの管理

Oracle Tuxedo Application Runtime for Batchは、いくつかのリターン・コード変数を使用して、関数実行の結果とジョブ実行の結果を管理します。

COBOLランタイム

COBOLランタイムrunbは、ユーザーCOBOLプログラムを実行するために呼び出す前に、その実行コンテキストを初期化するために用意されています。このランタイムは、標準のCOBOLランタイムのかわりに使用されます。

Oracle Tuxedo Application Runtime for Batchの目的

データベースの対話管理

Oracle Tuxedo Application Runtime for Batchは、データベース・コンテキストの使用を管理します。

ジョブ制限

Oracle Tuxedo Application Runtime for Batchでは、JCLごとに複数のジョブはサポートされません。

スクリプトの妥当性のテスト(非実行モード)

-t引数を使用することで、内部関数を実行せずにKSHスクリプトを実行できます。-t引数を使用すると、スクリプトのチェック(新しく開発されたスクリプトなど)や、異なるフェーズのチェーンの検証が可能になります。

Oracle Tuxedo Application Runtime for Batchの関数

ネーミング・ルール

バッチ・ランタイム関数の名前は、次の書式に従います。

prefix_ObjectAction

説明:

prefix_

Object

Action

次に例を示します。

リファレンス・ページ・コマンドの構文

特に指定がないかぎり、リファレンス・ページの「概要」の項で説明されているコマンドは、下記の構文に従ってオプションや引数を受け付け、次に説明するように解釈されます。

name [ -option . . . ] [cmdarg . . . ]

noargletter

optarg

cmdarg

-

--

[ ]

{ }

「OR」引数

. . .

参照

『Oracle Tuxedo Application Runtime for Batchリファレンス・ガイド』は、バッチ・ランタイム・ソフトウェアで供給されるシェル・レベルの関数を、アルファベット順に説明しています。

次の関数が説明されています。

概要

関数はシェル・スクリプトとバッチ・ランタイム実行可能ファイルの間のインタフェース(API)に対応します。m_JclibSetなど、一部のスクリプトは、変換段階だけに使用され、実行で利用できる拡張スクリプトには存在しません。

m_CondElse

名前

m_CondElse - Else条件。

概要

m_CondElse

説明

この関数は、m_CondIf関数の代替部分を示します。

オプション

パラメータなし。

m_CondEndif

名前

m_CondEndif - 条件の終了

概要

m_CondEndif

説明

この関数は、直前のIF条件を終了します。

オプション

パラメータなし。

m_CondExec

名前

m_CondExec - 条件付実行(プログラムまたはプロシージャ)。

概要

m_CondExec condexp [condexp...]

説明

条件付実行。条件がtrueの場合、現在の手順の残りのコマンドは無視されます。各条件式は、EVEN、ONLYまたはvalue, operator[,step]条件のいずれかが含まれます。m_CondExec文には複数の条件式が含まれることがあり、この関連付けは、様々な条件の論理ORを指定します。

オプション

Condexp [condexp]

サンプル

m_CondExec EVEN

手順を参照する方法は次のとおりです。

m_CondExec 4,LT,STEPEC01 8,LT,STEPEC02 ONLY

プロシージャで手順のリターン・コードを参照する方法は次のとおりです。

m_CondExec 4,LT,STEP_PROCNAME_NUM ONLY

ここでPROCNAMEはプロシージャ名、NUMはプロシージャ・コールの順序番号です。

m_CondIf

名前

m_CondIf - 条件付実行

概要

m_CondIf "condexp [condexp…]"

説明

「condexp」パラメータに含まれる条件を実行します。if条件レベルのネストが許可されます。

オプション

"Condexp [condexp]"

サンプル

m_CondIf " RC,EQ,3"

m_DBTableLoad

名前

m_DBTableLoad: 入力ファイルの内容をデータベース表に読み込みます。

概要

m_DBTableLoad -t -i [-e] [-d] [-D]

説明

この関数は、ddnameがMT_CTLのファイル内に保存されたコマンドを実行します。

このコマンドは、ターゲット・データベースに従い、Oracle用のSQLLDRコマンドまたはDB2LUW用のDB2 LOADコマンドのいずれかになります。

オプション

-t <table name>

-i <input flat file>

Oracleのオプション

-e <error file>

-d <discard file>

-D <discard file>

DB2LUWのオプション

-e <error file>

-d <discard file>

-D <discard file>

サンプル

	m_FileAssign -d OLD DDIN ${DATA}/MYINPUTFILE

	m_FileAssign -d SHR MT_CTL ${MT_CTL_FILES}/MYLOADCTL

	m_FileAssign -d SHR SYSERR ${[DATA}/MYSYSERR

m_DBTableLoad -t MYTABLE -i DDIN

m_DBTableUnload

名前

m_DBTableUnload: データベース表の内容をフラット・ファイルにアンロードします。

概要

m_DBTableUnload -t -o

説明

この関数は、ddnameがMT_CTLのファイル内に保存されたコマンドを実行します。

このコマンドは、ターゲット・データベースに従い、Oracle用のSQLPLUSコマンドまたはDB2LUW用のDB2 EXPORTコマンドのいずれかになります。

オプション

-t <table name>

-o <出力フラット・ファイル>

サンプル

	m_FileAssign -d OLD DDOUT ${DATA}/MYOUTPUTFILE

	m_FileAssign -d SHR MT_CTL ${MT_CTL_FILES}/MYUNLOADCTL

	m_DBTableUnload -t MYTABLE -o DDOUT

m_DirCopy

名前

m_DirCopy – ディレクトリのメンバーをコピーします。

概要

m_DirCopy [-i] [-o] [-s] [-e]

説明

この関数は、ディレクトリのメンバーを別のディレクトリへコピーします。

オプション

-i [(]{input|(input,R)}[:...][)]

-o <出力ディレクトリ>

-s <member list>

-e <member list>

サンプル

ディレクトリPDS1からディレクトリSEQ1へのすべてのメンバーのコピー。

	m_DirCopy -i PDS1 -o SEQ1

ディレクトリPDS1からディレクトリSEQ1へのメンバーAからKのコピー。

	m_DirCopy -i PDS1 -s “(A,K)” -o SEQ1

ディレクトリPDS1からディレクトリSEQ1へのメンバーAを除くすべてのメンバーのコピー。

	m_DirCopy -i PDS1 -e A -o SEQ1

m_DirCreate

名前

m_DirCreate – ディレクトリを作成します。

概要

m_DirCreate [-v volume] DirName

説明

この関数は、ディレクトリを作成します。

オプション

-v volume

DirName

m_DirDelete

名前

m_DirDelete – ディレクトリを削除します。

概要

m_DirDelete [-v volume] DirName

説明

この関数は、ディレクトリを削除します。

オプション

-v volume

DirName

m_DirRename

名前

m_DirRename – ディレクトリの名前を変更します。

概要

m_DirRename [-v volume] OldDirName NewDirName

説明

この関数は、ディレクトリの名前を変更します。

オプション

-v volume

OldDirName

NewDirName

m_ExecSQL

名前

m_ExecSQL — SQLスクリプトを実行します。

概要

m_ExecSQL [-b RC0] [-f] [-o]

説明

この関数は、SQLスクリプトを実行します。

SQLディレクティブ(CREATE TABLE、CREATE INDEX、DELETE、SELECT …)は<inputfile>ファイル内にあります。結果は<outputfile>ファイル内に保存されます。

オプション

-b RC0

-f <inputfile>

SYSINはデフォルト値です。

-o <outputfile>

サンプル

最初のサンプルでは、SQLディレクティブはストリーム内SYSINファイルにあり、結果はSYSREC00ファイルに保存されます。

	m_FileAssign -d ,CATLG SYSREC00 ${DATA}/FBACKE.LST.CUMUL

	m_FileAssign -i SYSIN

SELECT * FROM PJ01DB2.TABTEST2;

_end

	m_ExecSQL -o SYSREC00

2番目のサンプルでは、SQLディレクティブはTOW132C.sysinファイルで、結果は出力されます。

	m_OutputAssign -c “*” SYSPRINT

	m_FileAssign -d SHR SYSIN ${SYSIN}/SYSIN/TOW132C.sysin

	m_ExecSQL

m_FileAssign

名前

m_FileAssign — ファイルを割り当てます。

概要

m_FileAssign -i [-C] [-D Delimiter]

m_FileAssign -d DISPMODE [-g [CUR|ALL [-+np][rang]]] [-C] [[-r RecSize -t Type [-k Key]]|-S ModeFile] [-v volume] [-w Reference] DDNAME DSNAME

説明

m_FileAssignは、ファイルを割り当てます。ファイル割当てによってファイル作成が起動される場合、割当てそのものより作成処理が先に実行されます。

個別の事例は次のとおりです。

オプション

2つのオプション「-i」および「-d」のいずれかを指定する必要があります。その他すべてのオプションはオプションです。

-C <concatenation>

-D <delimiter>

-d <DispOption>

-g <generationFile>

-i

-k <key position>+>key length>

-r [<record length-min>-]<record length-max>

-S <モデル・ファイル>

-t <file organization>

-v volume

-w referenced-file

ddname <InternalFileName>

dsname <ExternalFileName>

サンプル

共有ファイルを使用するサンプル:

	m_FileAssign -d SHR ENTREE ${DATA}/PJ01DDD.BT.QSAM.KBIEI001

Example with a sysin and a delimiter:

	m_FileAssign -i -D FF INPUT

data input 1

data input 2

FF

Example with a sysin and continuation:

	m_FileAssign -i SYSIN

data input 1

_end

#%OPC BEGIN ACTION=INCLUDE

	m_FileAssign -i -C

data input 2

_end

#%OPC END ACTION=INCLUDE

	m_FileAssign -i -C

data input 3

_end

新規ファイルを使用するサンプル:

	m_FileAssign -d NEW -r 188 -t SEQ ENTREE ${DATA}/PJ01DDD.BT.KBIEI001

The new file will be a sequential file with a fixed record length of 188 bytes.

「モデル」ファイルを使用するサンプル:

	m_FileAssign -d NEW -r 188 -S PJO1.MODEL ENTREE ${DATA}/PJ01.OUTPUT

The new file have the characteristics of the file PJ01.MODEL except for the record length given by the “-r” parameter.

m_FileBuild

名前

m_FileBuild – ファイルを作成します。

概要

m_FileBuild [-t][-r][-k][-K] [-S]<filename> [-v volume] dsname

説明

この関数は、ファイルを作成します。

オプション

-t <編成>

-r Length

-k Position+Length

-K Position+Length[d]

-S <モデル・ファイル>

-v volume

dsname

サンプル

m_FileBuild -t IDX -r 266 -k 1+6 ${DATA}/METAW00.VSAM.CUSTOMER

m_FileBuild -t IDX -r 266 -k 1+6  -K 20+7 ${DATA}/METAW00.VSAM.CUSTOMER

m_FileBuild -t IDX -r 266 -k 1+6 -K 20+7d ${DATA}/METAW.VSAM.CUSTOMER

m_FileClrData

名前

m_FileClrData - ファイルをクリアします。

概要

m_FileClrData [-v volume] FileName

説明

m_FileClrDataは、ファイルをクリアするために使用されます。GDGファイルはサポートされません。

オプション

-v volume

FileName

例

	m_FileClrData ${DATA}/PJ01DDD.BT.QSAM.KBSTO045

m_FileDelete

名前

m_FileDelete — ファイルを削除します。

概要

m_FileDelete [-v volume] FileName

説明

m_FileDeleteは、ファイルを削除するために使用されます。

オプション

-v volume

FileName

例

	m_FileDelete ${DATA}/PJ01DDD.BT.QSAM.KBSTO045

m_FileEmpty

名前

m_FileEmpty – ファイルが空かどうかをチェックします。

概要

m_FileEmpty – r ReturnVariable [-v volume] FileName 

説明

m_FileEmptyは、ファイルが空かどうかをチェックするために使用されます。

オプション

-r ReturnVariable

-v volume

FileName

例

	m_FileEmpty -r MY_VARIABLE ${DATA}/rextest2

	if [[ ${MY_VARIABLE} = true ]]; then

	 echo "file is empty"

	else

	 echo "file is not empty"

	fi

m_FileExist

名前

m_FileExist – ファイルがあるかどうかチェックします。

概要

m_FileExist – r ReturnVariable [-v volume] FileName 

説明

m_FileExistは、ファイルが存在するかどうかチェックするために使用されます。

オプション

-r ReturnVariable

-v volume

FileName

例

	m_fileExist -r MY_VARIABLE ${DATA}/rextest2

	if [[ ${MY_VARIABLE} = true ]]; then

	 echo "file exists"

	else

	 echo "file does not exist"

	fi

m_FileLoad

名前

m_FileLoad — ファイルをロードします。

概要

m_FileLoad [-C] [-S] [-v volume] Infile [Infile ...] Outfile

説明

この関数は、ファイルをロードします。

オプション

-C

-S

-v volume

例

m_FileLoad ${DD_SYSUT1} ${DD_SYSUT2}

m_FileOverride

名前

m_FileOverride — ファイルをオーバーライドします。

概要

m_FileOverride [-i][-d][-g][-r][-k][-S][-t] -s label ddname dsname

m_FileOverride -i [-D Delimiter] -s Labelproc DDNAME

m_FileOverride -d [[-r RecSize -t Type [-k key]]|-S ModelFile][-g [CUR|ALL [(-|+)np][rang]]] -s label DDNAME DSNAME

説明

m_FileOverrideはファイル割当てをオーバーライドし、この割当てが標準割当て(m_FileAssign)より優先されます。

オプション

「-s」と2つのオプション「-i」および「-d」のいずれかは、使用方法を指定するために必須です。その他すべてのオプションはオプションです。その他のオプションについては、m_FileAssignを参照してください。

-s <label>

例

	m_FileOverride -i -s PR3STEP1 SYSIN

	m_FileOverride -d OLD -s MYSORT CUSTOM

	${DATA}/BEAUSR2.QSAM.CUSTOM

m_FilePrint

名前

m_FilePrint — ファイルを出力します(IDCAMSコマンドのPRINT)。

概要

m_FilePrint [-v volume] {-i ddname|-I dsname} {-o ddname|-O dsname}[-t][-C] [-S]

説明

この関数は、ファイルを出力します。

オプション

-C

-S

-i infile|-I indataset

-o ddname|-O dsname

-t {CHAR|DUMP|HEX}

-v volume

例

	m_FilePrint -I ${DATA}/INPUT -C 1

	m_FilePrint -i INPUT -t CHAR -C 5

m_FileRepro

名前

m_FileRepro — ファイルをコピーします(IDCAMSコマンドのREPRO)。

概要

m_FileRepro [-v volume] {-i ddname|-I dsname} {-o ddname|-O dsname}[-C] [-S]

説明

この関数は、ファイルをコピーします。

オプション

-C

-S

-i infile|-I indataset

-o ddname|-O dsname

-v volume

例

	m_FileRepro -I ${DATA}/INPUT -C 1

	m_FileRepro -i INPUT -C 5

m_FileSort

名前

m_FileSort — ファイルをソートします。

概要

m_FileSort -s SortSpecificationFile -i Infile1[,Infile2 ...] -o [Outfile] 

説明

この関数は、ファイルをソートします。

オプション

-s SortSpecification File

-i Infile

-o Outfile

SyncSortコマンドによる例

	m_FileAssign -i TOOLIN

	/FIELDS FLD1 5 CH 5

	/COND ...

	/OMIT ...

_end

	m_FileSort -s TOOLIN -i SORTIN -o SORTOUT

m_FileRename

名前

m_FileRename – ファイルの名前を変更します。

概要

m_FileRename [-v volume] OldName NewName 

説明

m_FileRenameは、ファイルの名前を変更するために使用されます。

オプション

-v volume

新しいファイルのボリュームを指定します。このオプションは、バッチ・ランタイムでファイル・カタログが有効な場合のみ機能します。

NewName

OldName

m_Ftp

名前

m_Ftp — FTPプロセスを実行します。

概要

m_Ftp -i <inputfile> [-e <ExitReturnCode>] [-n NETRC]

説明

この関数は、z/OS機能であるEXEC PGM=FTPをエミュレートします。

この関数はftpプロセスを起動し、入力ファイル内に保存されるftpコマンドを実行します。

環境変数MT_FTP_TESTは、次の値(大文字または小文字)を使用して宣言および初期化する必要があります。

YまたはYES: テスト・モード。「open」、「user」、「quit」、または「bye」とは異なるftpコマンドが実行されます。

NまたはNO: リアル・モード。すべてのftpコマンドが実行されます。

オプション

-i <inputfile>

-e <ExitReturnCode>

-n NETRC

サンプル

	m_FileAssign -d ANY MT_LOC01 ${DATA}/ftp_file_loc1

	m_FileAssign -i SYSIN

open host

user user1 pw1

put MT_LOC01 DIR/file2

quit

_end

	m_Ftp -i INPUT

注意

「SYSIN」ファイル内の行に関する一部の注意事項です。

- 最初の行は「open」にする必要があります。

フォーマット: open <HOSTNAMEまたはADDRESS>

例: open 172.20.12.21

- 「-n NETRC」パラメータが設定されていない場合、2行目はユーザーIDとパスワードを設定する必要があります。

フォーマット: user <user> <password>

「-n NETRC」パラメータが存在するとき、「.netrc」ファイルが存在することを示します。このファイルは、使用するユーザーIDとパスワードを識別します。

- 次の行は、get、put、...などのftpのコマンド(1行に1つ)です。

- 最後の行は「quit」にする必要があります。

m_GenDefine

名前

m_GenDefine — GDGを定義します。

概要

m_GenDefine [-v volume] -s [-r] --nb_occurs <GDG base name>

説明

この関数は、GDGファイルを定義します。実行結果は、MT_GENERATION変数で定義されているGDG管理方法によって決まります。

オプション

-s

-r

-v volume

GDG base name

例

	m_GenDefine -s 31 ${DATA}/PJ01DDD.BT.GDG.KBIDU001

m_JclLibSet

名前

m_JclLibSet — 変換ステージの、プロシージャとインクルードのディレクトリを指定します。

概要

m_JclLibSet directory

説明

m_JclibSetは、変換フェーズでプロシージャとインクルードが格納されるディレクトリを指定します。

オプション

directory

例

	m_JclLibSet PJ01DDD.BT.INCLUDE.SRC

m_JobBegin

名前

m_JobBegin — ジョブを開始するために使用されます。

概要

m_JobBegin -j jobname [-C cond] [-c class] [-p priority] [-r restart] [-t typrun] -v version -s start_label

説明

JES2インタフェースで、z/OSジョブ・カード上で使用されるパラメータを示します。パラメータは、次のファイルに格納されます。

オプション

-j jobname

-C condition

-c class

-p priority

-r restart

-t typrun

-v version

-s start_label

例

	m_JobBegin -j PJ01DSTA -s START -v 1.0 -t SCAN

m_JobEnd

名前

m_JobEnd — ジョブを終了します。

概要

m_JobEnd

説明

この関数は、ジョブを終了するために使用されます。

オプション

None

m_JobLibSet

名前

m_JobLibSet — プログラムが格納される場所を指定します。

概要

m_JobLibSet directory [:directory[:directory…]]

説明

この関数は、プログラムが格納されるディレクトリをジョブ・レベルで指定します。

オプション

directory [:directory[:directory…]]

m_OutputAssign

名前

m_OutputAssign — パラメータCLASS、COPIES、DEST、FORMSおよびHOLDを伴うDD SYSOUT文を管理します。

概要

m_OutputAssign [-c class][-w writer][-n copies][-d dest][-f forms][-H][-o list of output][-D dsname] DDNAME

オプション

-c <class>

-w <writer>

-n <copies>

-d <dest>

-f <forms>

-H<Y/N>

-o <reference[,reference,…]>

-D <dsname>

ddname

サンプル

出力クラスAを使用したサンプル:

	m_OutputAssign -c A SYSOUT

Example with INTRDR:

In this case, the file which ddnmae is RDRCICO must contain a ksh script.

	m_OutputAssign -c R -w INTRDR RDRCICO

「OUTPUT」参照を使用したサンプル:

出力EDIが参照されます。

	m_OutputAssign -c A -o “*.EDI” SYSPRINT

m_OutputOverride

名前

m_OutputOverride — 出力ファイルをオーバーライドします。

概要

m_OutputOverride [-c class][-n copies][-d dest][-f forms][-H][-o list of output][-D dsname] -S Labelproc DDNAME

説明

この関数は、sysoutの割当てをオーバーライドします(m_OutputAssignを参照してください)。

オプション

「-S」のみ必須です。このオプションは割当てがオーバーライドされる手順を指定します。その他すべてのオプションはオプションです。他のオプションについてはm_OutputAssignを参照してください。

-S <label>

m_OutputSet

名前

m_OutputSet : CLASS、COPIES、DEFAULT、DEST、FORMS、PRIORITYおよびWRITERパラメータで「OUTPUT JCL」文を管理します。

参照を管理し、sysout管理に使用する関連処理オプションを指定します。

概要

m_OutputSet [-c][-n][-d][-f][-p][-w][-D] Reference

オプション

-c <class>

-n <copies>

-d <dest>

-f <forms>

-p <priority>

-w <external writer>

-D Y/N

参照

例

	m_OutputSet -d LOCAL -D N EDI

m_PhaseBegin

名前

m_PhaseBegin — スクリプト・フェーズの開始時に呼び出されます。

概要

m_PhaseBegin

説明

この関数は、スクリプト・フェーズの開始時に呼び出されます。

オプション

None.

m_PhaseEnd

名前

m_PhaseEnd — スクリプト・フェーズの終了時に呼び出されます。

概要

m_PhaseEnd

説明

この関数は、スクリプト・フェーズの終了時に呼び出されます。

オプション

None.

m_Pkzip

名前

m_Pkzip — zipプロセスを実行します。

概要

m_Pkzip [-f][-F] -a [-k][-n][-g][-d]

説明

この関数はファイル、ディレクトリ、またはアーカイブ内のディレクトリのメンバーを圧縮します。

メッセージはSYSPRINTファイル内で報告されます。

注意: オプション「-f」および「-F」は必須ではありませんが、1つ以上が存在する必要があります。

オプション

-f ‘<ddname1>[,<ddname2>[,<ddname3>]...]’

複数のddnameはカンマ(,)で区切る必要があります。

-f ‘<dirname>[;<member1>...]’

-F ‘<dsname1>[,<dsname2>[,<dsname3>]...]’

-a <archive>

mandatory.

-k <action>

-n ‘<zipped_name>’

-g <Y|N>

-d ‘<zipdir>’

サンプル

次のサンプルでは、2つのファイルが圧縮(ddnameのFICIN01およびFIC02)され、「-f」オプションによって名前が付けられます。DDARCH (アーカイブのddname)は「-a」オプションによって名前が付けられ、その際最初のファイルは名前が変更されます(「-n」オプションを参照)。

	m_FileAssign -d SHR FICIN01 ${DATA}/PKZIP_FICIN01

	m_FileAssign -d SHR FIC02 ${DATA}/FIC.FILE01

	m_FileAssign -d NEW,CATLG DDARCH ${DATA}/ARCH.FILE

	m_Pkzip -f ‘FICIN01,FIC02’ -a DDARCH -n ’NEW_FICIN01,’

次のサンプルは、オプション「-f」、「-F」および「-n」を同時に使用する方法を示します。

	-f ‘ddn1,ddn2,ddn3,pds;member1;member2’

	-F “dsn1,dsn2,dsn3’

	-n ‘,newddn2,newwddn3,newmb1,,newdsn1,newdsn2,’

The ddn1, member2 and dsn3 are not renamed (they are replaced by comma(,)).

m_Pkunzip

名前

m_Pkunzip— 解凍プロセスを実行します。

概要

m_Pkunzip [-f][-F] -a [-k][-n][-g][-d][-o][-w]

説明

この関数はファイル、ディレクトリ、またはアーカイブ内のディレクトリのメンバーを解凍します。

メッセージはSYSPRINTファイル内で報告されます。

注意: オプション「-f」および「-F」は必須ではありませんが、1つ以上が存在する必要があります。

オプション

-f ‘<ddname1>[,<ddname2>[,<ddname3>]...]’

複数のddnameはカンマ(,)で区切る必要があります。

-F ‘<dsname1>[,<dsname2>[,<dsname3>]...]’

-a <archive>

-o <outddname>

-k <action>

-n ‘<zipped_name>’

-g <Y|N>

-w <Y|N>

-d ‘<unzipdir>’

サンプル

	m_FileAssign -d NEW,CATLG DDARCHIV ${DATA}/PKZIP_ARCH

	m_Pkunzip -a DDARCHIV

	m_FileAssign -d NEW,CATLG DDARCHIV ${DATA}/PKZIP_ARCH

	m_FileAssign -d NEW,CATLG OUTFILE ${DATA}/UNZIPPED.FILE

	m_Pkunzip -a DDARCHIV -o OUTFILE

m_ProcBegin

名前

m_ProcBegin — ストリーム内プロシージャを開始します。

概要

m_ProcBegin ProcedureName

説明

ストリーム内プロシージャが、(変換時にOracle Tuxedo Application Runtime WorkBenchによって)kornシェル・スクリプトの末尾に追加され、m_ProcIncludeによって参照されます。

オプション

ProcedureName

例

	m_ProcBegin  KBPRB007

m_ProcEnd

名前

m_ProcEnd — ストリーム内プロシージャを終了します。

概要

m_ProcEnd

説明

kornシェル・スクリプトの末尾に追加されるストリーム内プロシージャは、m_ProcEndによって終了します。

オプション

なし

m_ProcInclude

名前

m_ProcInclude — 変換フェーズでスクリプトにインクルードされるプロシージャを呼び出します。

概要

m_ProcInclude ProcedureName [param1=value1,param2=value2,…,paramN=valueN]

説明

オプション

ProcedureName

例

m_ProcInclude BPRAP001

m_ProgramExec

名前

m_ProgramExec — プログラムを実行します。

概要

m_ProgramExec [-b] [-e exit_type:exit_name][-n] Program [arguments]

説明

この関数は、COBOLプログラムを実行します。

オプション

-b

-e exit_type:exit_name

-n

Program [arguments]

サンプル

m_ProgramExec BPRAB006 "08"

パラメータに「08」を指定してプログラムBPRA006を実行することを示します。

m_ProgramExec -b BDBAB001

プログラムBDBAB001がデータベースにアクセスすることを示します。

「"」(二重引用符)文字 は、パラメータの教会を示すために使用されます。

例:

z/OS上のPARM=MT5は、ターゲット上で "MT5"になります。

z/OS上のPARM=(MT5,MT6)は、ターゲット上で "MT5,MT6"になります。

z/OS上のPARM='S=MT5'は、ターゲット上で "S=MT5"になります。

z/OS上のPARM=('S=MT5','Q=MT6')は、ターゲット上で"S=MT5,Q=MT6"になります。

連続する2つの「'」(2つの一重引用符)は、1つの「'」に置換されます。

PARM='5 O''CLOCK'は"5 O'CLOCK"になります。

2つの連続する「&」(2つのアンパサンド)は、1つの「&」(1つのアンパサンド)文字に置換されます。

'&&TEMP'は"&TEMP"になります。

m_ProgramExec -e BEGIN:EX1 BPRAB006

「exitルーチン」RTEX-EX1-Beginを呼び出した後にプログラムBPRA006を実行することを示します。

ユーザーによって記述されたこの「exitルーチン」にはユーザー・アクション(「会計処理」に関するアクションなど)が含まれます。

m_RcSet

m_RcSet <ARGS> ReturnCode [Message]

名前

m_RcSet — リターン・コードを設定します。

概要

m_RcSet ReturnCode [Message]

説明

m_RcTestは、関数のリターン・コードを設定します。

オプション

ReturnCode

Message

サンプル

	m_RcSet ${MT_RC_ABORT:-S999} "Unknown label : ${CURRENT_LABEL}"

	m_RcSet 0

m_SendMail

名前

m_SendMail— 電子メールを送信します。

概要

m_SendMail -t [-f] [-s] [-m] [-a] [-n] [-c] [-b]

説明

この関数は電子メールを送信します。

オプション-fを省略するときは、環境変数MT_FROM_ADDRESS_MAILをユーザーのプロファイル内で宣言し、デフォルトで使用されるFrom Adressで初期化する必要があります。

次の2つの環境変数が使用されます(RTBatch.confファイルを参照してください)。

MT_SMTP_SERVER: SmtpServer (デフォルト値: “localhost”)

MT_SMTP_PORT: SmtpPort (デフォルト値: “25”)

オプション

-t ‘<To-Address1>[,<To-Adress2>...]’

-f ‘<To-Address>’

-s “<件名>”

-m <メッセージ・ファイル>

Optional.

-a <attach-file1>[,<attach-file2>...]

-n <filename1>[,<filename2>...]

-c <cc-Address1>[,<cc-Address2>...]

-b <bcc-Address1>[,<bcc-Address2>...]

例

この例では、

- メッセージのテキストはsysin MESSAGEに保存されます。

- 暗黙的な「From-Address」は、環境変数MT_FROM_ADDRESS_MAILに入ります。

- 「To-Address」は「BOB」<BOB.FOSTER@USA.COM>です。

- 添付ドキュメントは(ddnameファイルCR1と名前FILE2.CSVとともに)送信されます。

m_FileAssign -i MESSAGE

電子メールのテキスト

_end

m_FileAssign -d SHR CR1 ${DATA}/FPROD.FILE1

m_SendMail -t ‘”BOB” <BOB.FOSTER@USA.COM>’ -m MESSAGE -a CR1 -n ‘FILE1.CSV’

m_ShellInclude

名前

m_ShellInclude — スクリプトの一部を挿入します。

概要

m_ShellInclude script name

説明

この関数は、スクリプトの一部を挿入します。

オプション

script name

m_Smtp

名前

m_Smtp— SMTPプロトコルを使用して電子メールを送信します。

概要

m_Smtp -i

説明

この関数はSMTPプロトコルを使用して電子メールを送信します。

SMTPコマンドは入力ファイルに保存されます。

コマンドは、次のフォーマットを使用します。

telnet <SmtpServer> <SmtpPort>

次の2つの環境変数が使用されます。

MT_SMTP_SERVER: SmtpServer (デフォルト値: “localhost”)

MT_SMTP_PORT: SmtpPort (デフォルト値: “25”)

オプション

-i <InputFile>

例

m_StepLibSet

名前

m_StepLibSet — プログラムが格納される場所を指定します。

概要

m_StepLibSet directory [:directory[:directory…]]

説明

m_SteplibSetは、プログラムが格納される場所を手順レベルで指定します。この情報は、プログラムが実行されるときに解釈されます。

オプション

directory

m_SymbolDefault

名前

m_SymbolDefault — 記号に値を割り当てます。

概要

m_SymbolDefault var=value

説明

プロシージャの呼出しの前に、プロシージャ内の記号のデフォルト代用テキストを定義するために使用されます。

この関数は、変換フェーズで、解析されて考慮に入れられ、記号は、拡張されたスクリプト内で値に置換されます。

オプション

var

値

例

m_SymbolDefault VAR=45

m_SymbolSet

名前

m_SymbolSet — 記号を定義します。

概要

m_SymbolSet var=value

説明

記号を定義し、この記号を最初に使用する前に、値を割り当てます。

オプション

var

値

例

	m_SymbolSet VAR=45

	TVAL=$(date +%Y%m%d) (value of command)

	m_SymbolSet TVAR=$TVAL

m_UtilityExec

名前

m_UtilityExec — 保存コマンドを実行します。

概要

m_UtilityExec [sysin file]

説明

外部sysinの内容を実行します。この関数は、現在のシェルで「UtilityName」スクリプトを実行します。UtilityNameは、[sysin file]に以前に割り当てられた物理名です。

sysinに割り当てられたスクリプトには、RunTime Batch関数のシーケンスを含める必要があります。また、この関数はネイティブのKornシェル・スクリプトも起動できますが、そのスクリプトは使用せずにm_ProgramExecを使用することをお薦めします。つまり、割当ては必須ではありません。

オプション

sysinファイル:

起動する関数を格納するsysinファイルのddname。

例

	m_FileAssign -d NEW SYTSIN ${SYSIN}/SYSTIN/MUEX07.sysin

	m_UtilityExec SYTSIN

MUEX07.sysinファイルには次の内容が含まれます。

m_ProgramExec -b ZVDL101

m_SetJobExecLocation

名前

m_JobSetExecLocation - 現在のジョブが実行されるJES Tuxedoサーバー・グループを指定します。

概要

m_JobSetExecLocation   <SvrGrpName>

説明

現在のジョブが実行されるJES Tuxedoサーバー・グループを指定します。

このAPIはオプションです。使用する場合は、m_JobBeginの直後に指定する必要があります。

このAPIがジョブの中で呼び出されない場合、ジョブは任意のサーバー・グループでランダムに実行されます。一方、このAPIがジョブの中で呼び出される場合、ジョブは指定されたサーバー・グループで実行されます。指定されたサーバー・グループが存在しない場合またはそのサーバー・グループでARTJESINITIATORが開始していない場合、そのサーバー・グループでARTJESINITIATORが開始するまで、ジョブは待機キューに置かれます。

SvrGrpNameが指定されていない場合または""が指定されている場合、エラーはレポートされませんが、ジョブは任意のサーバー・グループでランダムに実行されます。

オプション

SvrGrpName

例

m_JobBegin -j SAMPLEJCL -s START -v 2.0 -c R

m_JobSetExecLocation "ATLANTA"

 while true ;

 do

        m_PhaseBegin

...

m_JobEnd

ジョブは任意のJESノードで送信できますが、実行できるのはJESのTuxedoサーバー・グループATLANTAに属するARTJESINITIATORのみです。