OpenFrame OSCシステム・ツール

以下は、OpenFrame OSC(以下、OSC)システムの運用をサポートするツールの一覧です。

excicblppは、外部CICSインターフェース(EXCI)をサポートするための前処理ツールです。バッチなどのOSC外部のCOBOLプログラムから特定のリージョンのプログラムをDPL方式で実行できるように前処理を行います。

以下は、excicblppツールの実行方法です。

以下は、SAMPLE00.cobファイルをVerboseモードで前処理して、excicblpp_SAMPLE00.cobファイルを作成する例です。

上記のコマンドを実行すると、以下のようなメッセージが表示され、前処理が行われます。

mscadjustは、マップのマイグレーションの際に発生する2バイト文字の変換エラーを修正するためのツールです。

EBCDICで作成されたホスト・マップ・ファイルに、1バイト文字以外に日本語のような2バイト・データが混用されていて、マップのフィールド定義にプログラム式シンボル(PS)項目が設定されている場合（例: PS=X’F8’）、dsmiginツールはPSのようなBMSマップ・マクロ構文が認識できないため、フィールドを2バイト文字に適切に変換することができません。

mscadjustを実行するには、EBCDICコードのマップ・ファイルのソースと、構文認識のために使用するマップ・ソースコードの2つのファイルを入力として与える必要があります。マップ・ソースコードは、ASCIIに変換された後、mscasmcツールで前処理します。

mscadjustは2つのファイルを使用して、dsmiginツールで正しく変換されていない可能性のあるフィールドを検索し、1バイト文字の変換結果と2バイト文字の変換結果をユーザーに表示します。ユーザーは当該フィールドを2バイト・コードまたは1バイト・コードに認識して変換するように選択することができます。

以下は、mscadjustツールの実行方法です。

以下は、mscadjustツールを使って、SAMPLE00というEBCDICのマップ・ソースコードのソースとmscasmcで前処理されたSAMPLE00.map.atmというASCIIマップ・ソースコードを修正して、SAMPLE00.adjというマップ・ソースコードを作成する例です。

mscasmcは、マップのダンプ用アセンブラー・マクロ命令を前処理するツールです。画面に影響を及ぼしマップを定義するマクロの他にダンプ用のマクロがありますが、このようなマクロ、例えばPRINT ON、NOGEN、TITLEなどのマクロを前処理します。

以下は、mscasmcツールの実行方法です。

以下は、SCSOW03.mapファイルのダンプ用のアセンブラー・マクロ命令を前処理する例です。

上記のコマンドを実行すると、以下のようなメッセージが表示され、コンパイルが行われます。

mscmapcは、マップ・ソースコードをコンパイルして、シンボリック・マップ・ファイルと物理マップ・ファイルを作成するツールです。

シンボリック・マップ・ファイルは、アプリケーションが使用するデータの構造が定義されているCOBOLコピーブック・ファイルであり、物理マップ・ファイルは、マップを構成する各フィールドの属性とデータ変換に必要な情報を保存しているバイナリ・ファイルです。

以下は、mscmapcツールの実行方法です。

以下は、CESN.mapファイルをコンパイルして、シンボリック・マップ・ファイルおよび物理マップ・ファイルを現在のディレクトリに作成する例です。

2つのファイルが正常に作成されたというメッセージが表示されたら、コンパイルに成功したことを意味します。

以下は、[-o]オプションを使用してCESN.mapファイルをコンパイルして、シンボリック・マップ・ファイルおよび物理マップ・ファイルを指定のディレクトリに作成する例です。

以下は、[-r]オプションを使用してCESN.mapファイルをコンパイルして、シンボリック・マップ・ファイルおよび物理マップ・ファイルをリージョン・ディレクトリに作成する例です。

mscmapupdateは、OSCリージョンが使用するマップ・セット情報を動的に管理するツールです。ユーザーがアプリケーションを実行中にマップ情報を変更して即時に反映したり、追加でロードしたりすることができます。また、現在メモリに保存されているマップ・セットの閲覧・削除機能も提供します。マルチクラスタリング環境でも動的に管理が可能です。

以下は、mscmapupdateツールの実行方法です。

以下は、OSC00001リージョンに登録されているマップ・セット情報を表示する例です。

以下は、OSC00001リージョンのOIVPMS1マップ・セットを更新する例です。マップ・セットを削除する場合は、[-r]オプションを使用して同じように記述します。

以下は、OSC00001リージョンが起動しているすべてのノードのOIVPMS1マップ・セットを更新する例です。マップ・セットを削除する場合は、[-r]オプションを使用して同じように記述します。

oscadminは、OSCリージョンを管理するツールです。

以下は、oscadminツールの実行方法です。

以下は、OSC00001リージョンのログ・レベルを「I」に指定する例です。

oscappbuildは、OSCアプリケーションを自動作成するツールです。現在はPL/I言語のみサポートしています。

以下は、oscappbuildツールの実行方法です。

以下は、PL/I言語で作成されたpg00.pliというプログラム・ソースを基に、OSCアプリケーションを作成する例です。実行結果、pg00.soというプログラム・バイナリが作成されます。

oscbootは、OpenFrameシステム全体、OSCシステム全体、または特定のリージョンを起動するツールです。

システムの起動前後に、ユーザーが必要な処理を行えるように、oscboot.pre、oscboot.postスクリプトを実行します。

oscboot.pre、oscboot.postスクリプトは、TmaxおよびOpenFrameシステム・サーバーの起動に関連するオプション([-N]、[-T]、[-b]、[-C]、[-B])に対してのみ動作し、[-r]オプションのようにリージョンを起動するオプションに対しては動作しません。

以下は、oscbootツールの実行方法です。オプションを指定しない場合、上記で説明した一般的な手順に沿ってOSCシステム・サーバーおよびOSCリージョンを起動します。

以下は、OpenFrameシステム・サーバーとOSCシステム・サーバーは起動せずに、Tmaxシステム・プロセスのみを起動する例です。

以下は、ofsys.seqファイルに設定されているOpenFrameシステム・サーバーとTmaxを起動する例です。

以下は、OSCシステム・サーバーとofosc.seqファイルに設定されているOSCユーザー・サーバーを起動した後、OSC00001リージョンを起動する例です。

oscbuildは、OSCアプリケーション・サーバーの自動作成ツールです。オペレーティング・システムやデータベースに合わせてアプリケーション・サーバーを作成することができます。

以下は、oscbuildツールの実行方法です。

以下は、Linux 64ビット環境でデータベースを使用しないOSC00001という名前のOSCアプリケーション・サーバー・プログラムを作成する例です。（次のコマンドを1行に作成して実行します。）

osccblppは、OSCで使用されるCOBOLアプリケーションのプログラム・ソースに存在するEXEC CICSコマンドを前処理するツールです。特に指定しない場合は、結果ファイル名に「osccblpp_」という接頭辞が付きます。

以下は、osccblppツールの実行方法です。

以下は、SAMPLE00.cobファイルを前処理して、osccblpp_SAMPLE00.cobファイルを作成する例です。

osccheckは、OSCリージョンの設定ファイルやOSCリージョンが共有メモリに保存している設定情報を閲覧し、エラーや抜けている設定項目がないかを確認するツールです。また、共有メモリが間違ったアドレス・アクセスなどにより破損してはいないかチェックするために、共有メモリのバイナリ・イメージをダンプする機能も提供します。

osccheckツールを使って、必須項目の漏れや設定値の形式エラーおよび範囲エラーなど、問題になり得る設定情報をチェックしたり、実際にサーバーで使われる設定値を確認することができます。

osccheckツールが提供する情報を表示するメッセージのレベルをオプションを使って指定できます。サーバーが起動しない設定エラー・レベル、起動中に問題を起こし得る警告レベル、特定システムでのみ問題になり得る情報レベル、そしてすべての設定情報を表示するメッセージ・レベルの4つのレベルがあります。

以下は、osccheckツールの実行方法です。

以下は、OSC00001サーバーの設定をチェックしてWARNINGレベルまでメッセージを出力するように設定する例です。

osccobprepは、OSCで使用されるCOBOLプログラムの中でメインフレーム環境の特徴のためUNIXのCOBOLコンパイラーによって正常に処理できない構文を前処理し、OSCシステムに合わせてコマンドを追加し、デバッグなどの用途で前処理するツールです。現在は、BLL、BMSMAPBR、EDFの前処理機能があります。

前処理の結果ファイルは、結果ファイル名または接頭辞をオプションで指定しない場合、ファイル名に「osccobprep_」という接頭辞が付きます。

以下は、osccobprepツールの実行方法です。

以下は、osccobprepツールを使用してTCOB.cobプログラムのソースコードを前処理して、osccobprep_TESTCOB.cobファイルを作成する例です。プログラムで使用するコピーブックの拡張子は「.cob」、コピーブックのディレクトリ・パスは「$OPENFRAME_HOME/ osc/Copybook」に設定しています。

osccprepは、OSCで使用されるCプログラムの中でUNIXのCコンパイラーによって正常に処理できない構文を前処理し、OSCシステムに合わせてコマンドを追加する前処理ツールです。

前処理の結果ファイル名や接頭辞をオプションで指定しない場合、ファイル名に「osccprep_」という接頭辞が付きます。[-o]オプションを指定していない場合、拡張子は「.c」になります。

前処理プロセスでは、OSCが提供するdfheiptr.hヘッダー・ファイルを追加し、EXEC CICSで始まるコマンドをOSCが提供する関数に変更します。

以下は、osccprepツールの実行方法です。

以下は、osccprepツールを使用してTEST.ccsプログラムのソースコードを前処理して、osccprep_TEST.cファイルを作成する例です。

以下は、osccprepツールを使用してTEST.ccsプログラムのソースコードを前処理して、TEST.cファイルを作成する例です。

oscdct2rdは、CICSで使用していたDCTマクロをOSCシステムで使用できる形式のTDQUEUE定義マクロ・ファイルに変換するツールです。

以下は、oscdct2rdツールの実行方法です。

以下は、oscdct2rdを使用してDCT.datというDCTマクロ・ファイルに定義されているTDQUEUEがOSCGROUPというグループ名を使用するように設定し、DCTマクロ・ファイルをTDQUEUE.datというTDQUEUE定義ファイルに変換する例です。

oscdownは、OpenFrameシステム全体、OSCシステム全体、または特定のリージョンを終了するツールです。

システムの終了前後に、ユーザーが必要な処理を行えるように、oscdown.pre、oscdown.postスクリプトを実行します。

oscdown.pre、oscdown.postスクリプトは、TmaxおよびOpenFrameシステム・サーバーの終了に関連するオプション([-N]、[-i]、[-C])に対してのみ動作し、[-r]オプションのようにリージョンを終了するオプションに対しては動作しません。

以下は、oscdownツールの実行方法です。

以下は、OSC00001リージョンの終了時に、PLTSDのために「S1」という接尾辞を指定する例です。

以下は、OSCシステム全体を強制終了する例です。

oscinitは、OSC製品をインストールまたはアンインストールする際に、システム・テーブルとログ・テーブルを作成または削除するツールです。

以下は、oscinitツールの実行方法です。

以下は、システム・テーブルはOFM_REPOSITORY表領域に、ログ・テーブルはOFM_LOG表領域にそれぞれ作成・削除する例です。

oscjct2rdは、旧バージョンのCICSで使用していたJCT(Journal Control Table)を、OSCのJOURNALMODELリソース定義に変換するツールです。JCTにはJOURNALMODELリソース定義のGROUP項目に該当する項目がないため、[–g]オプションを使用して作成する必要があります。

以下は、oscjct2rdツールの実行方法です。

以下は、JCT.datファイルを変換してJOURNALMODEL.datファイルを作成する例です。

osclogrptは、OSCのトランザクション・ログをRDBに保存するように指定した場合に、その統計情報を表示するツールです。基本的には、時間帯ごとにトランザクション数、トランザクションの平均実行時間および平均CPU実行時間を表示します。

以下は、osclogrptツールの実行方法です。

以下は、OSC00001リージョンの全ノードの2019年5月27日の時間帯別統計情報を表示する例です。

以下は、上記例の表示項目についての説明です。

以下は、OSC00001リージョンの2019年5月27日の統計情報を表示する例です。

以下は、上記例の表示項目についての説明です。

以下は、OSC00001リージョンの2019年5月27日の全体トランザクション情報を表示する例です。

以下は、上記例の表示項目についての説明です。

oscplippは、OSC PLIアプリケーションのプログラム・ソース内に存在するEXEC CICSコマンドを前処理するツールです。特に指定しない場合は、結果ファイル名に「oscplipp_」という接頭辞が付きます。

以下は、oscplippツールの実行方法です。

以下は、sample00.pliファイルを前処理して、oscplipp_sample00.pliファイルを作成する例です。

oscpltcは、DFHPLTマクロをコンパイルするツールです。

以下は、oscpltcツールの実行方法です。

以下は、PLT.datファイルに含まれているPLTマクロ定義を読み込んで、OSC00001リージョンにデプロイする例です。

oscrespは、OSCアプリケーション・サーバーでユーザー・アプリケーションを実行中に、アプリケーションで使用しているEXEC CICS文の実行結果として設定されるRESP、RESP2の値の説明を確認する機能を提供するツールです。

oscrespにEIBFN、RESP、RESP2の値を入力すると、エラーの原因についての詳細説明を確認することができます。また、特定のEIBFNに対応するEXEC CICSコマンドを検索したり、EIBFN、RESPの値を入力して対応するRESP2値を検索したりすることができます。

以下は、oscrespツールの実行方法です。

以下は、EXEC CICS RECEIVE MAP (EIBFN=1802)で、RESP=10、RESP2=00が設定された場合、このエラーの説明を確認する例です。

oscrtsddumpは、RTSDに保存されているリソース定義情報をマクロ形式のファイルとして保存するツールです。指定したOSCリージョンのリソース定義情報をエクスポートすることができ、生成されたマクロ・ファイルは再びoscrtsdupdateツールの入力ファイルとして使用することができます。

以下は、oscrtsddumpツールの実行方法です。

以下は、OSC00001リージョンのRTSDに保存されているリソース定義を読み込んで、マクロ形式のresource.datファイルに保存する例です。

oscrtsdupdateは、リソース定義が定義されているマクロ・ファイルを読み込んで、運用中のOSCリージョンのRTSDに更新するツールです。マクロ・ファイルに定義されているリソース定義がOSCリージョンのRTSDにすでに存在する場合にのみ更新します。更新するリソース定義を確認するには、ツールを詳細モードで実行する必要があります。ただし、oscrtsdupdateツールにより変更が可能なリソースには制限があります。

以下は、変更可能なリソースおよびオプションです。

以下は、oscrtsdupdateツールの実行方法です。

以下は、resource.datファイルに保存されているリソース定義を読み込んで、OSC00001リージョンのRTSDに更新する例です。

以下は、oscrtsdupdateツールを詳細モードで実行する例です。

oscruntranは、特定のリージョンのトランザクションをユーザーが直接実行できるツールです。

以下は、oscruntranツールの実行方法です。

以下は、oscruntranツールを使用してOSC00001リージョンのOIVPトランザクションを実行する例です。

oscscviewは、START、DELAYコマンドまたはTDQ ATI機能によりOSCシステムでスケジューリングされている要求を表示するツールです。確認できる要求は以下のとおりです。

以下は、oscscviewツールの実行方法です。

以下は、oscscviewツールを使用してスケジューリングされている要求を確認する例です。OSC00001リージョンで実行されたトランザクションOIBRがスケジューリング待ちであることが分かります。

oscsddumpは、OSC SDテーブルのOSCリソース定義をマクロ形式のファイルとして保存するツールです。指定したOSCリージョンで使用するSDテーブルに定義されているリソース定義をすべて、あるいは特定の種類のリソース定義を選択してエクスポートすることができます。作成されたマクロ・ファイルは、oscsdgenツールの入力ファイルとして使用することができます。

以下は、oscsddumpツールの実行方法です。

以下は、OSC00001リージョンで使用するSDテーブルに定義されているリソース定義を読み込んで、resource.datファイルにマクロ形式で保存する例です。

oscsdgenは、マクロ・リソース定義が定義されているテキスト・ファイルを読み込んで、指定したOSCリージョンで使用するデータベース・テーブルに保存するツールです。

リソース定義マクロ・ファイルに重複する定義が存在したり、SDテーブルに同じリソースの定義がすでに存在する場合は上書きされます。また、指定したリソース定義を削除する機能もあります。oscsdgenツールの実行時にはTACFによる認証を行いますが、TACFユーザーのSDアクセス権限はチェックしません。

トランザクションのリソースを追加または変更する場合、OSCはChange User ID、Change Time、Define Timeを保存します。これらの情報はoscsddumpツールでは確認できず、OpenFrame Managerで確認することができます。

以下は、oscsdgenツールの実行方法です。

以下は、resource.datファイルのリソース定義マクロを読み込んで、SDテーブルにリージョン名「OSC00001」をキーにして保存する例です。

以下は、すでに登録されているリソースを、OSC00001リージョンで使用するデータベース・テーブルから削除する例です。

以下は、oscsdgenツールの実行時にTACFユーザーがログインしていない場合に、TACFユーザー・ログインを行う例です。

osctdlinitは、OSCリージョンごとにTDL(Tmax Dynamic Library)共有メモリと動的モジュールを初期化するツールです。このツールはOSCを起動する前に実行します。リージョンを複数指定して一度に初期化することもできます。

以下は、osctdlinitツールの実行方法です。

以下は、OSC00001およびOSC00002の2つのリージョンのTDL共有メモリおよび動的モジュールを初期化する例です。

osctdlrmは、TDL共有メモリを完全に削除するためのツールです。このツールを実行した後に、osctdlinitツールを再実行しなかった場合は、登録したモジュールを使用できないので注意してください。リージョンを複数指定して一度に削除することもできます。

以下は、osctdlrmツールの実行方法です。

以下は、OSC00001およびOSC00002の2つのリージョンのTDL共有メモリを削除する例です。

osctdlupdateは、指定した動的モジュールをOSCリージョンに更新するツールです。すでに登録されているモジュールは更新し、登録されていないモジュールは新規追加します。複数のモジュールを指定して一度に更新することもできます。

以下は、osctdlupdateツールの実行方法です。

以下は、OSC00001リージョンにOIVPMAINおよびOIVPINFOの2つのモジュールを更新する例です。

osctsqcheckは、TSQメモリ領域内部で使用されているロック情報を監視し、異常な状態のロックを解除する機能を提供するツールです。TSQメモリ領域のサイズとデータ長を確認することもできます。

TSQで使用されるロックには、TSQキー情報を保存するハッシュ構造のインデックスに設定されるインデックス・ロックと、各々のTSQ領域に設定されるアイテム・ロックの2種類があります。

osctsqcheckツールは、ツールの実行時にすでに使用されているロックに対して一定の時間間隔と回数でロック情報を監視した後、監視を終了時に解除されていないロック情報を報告します。ツールを最初に実行時に使用されているロックが1つもなかったり、監視中に使用中のロックがすべて解除されたら、ツールは監視を中断し、監視するロックがないことを報告してから終了します。

以下は、osctsqcheckツールの実行方法です。

以下は、OSC00001リージョンで使用するTSQに設定されているロックを1秒間隔で10回監視する例です。

以下は、OSC00001リージョンで3852番インデックスのロックを解除する例です。

以下は、OSC00001リージョンで使用するTSQ00001というTSQのロックを解除する例です。

以下は、OSC00001リージョンで使用するすべてのTSQメモリ領域の情報を表示する例です。

osctxadmは、現在リージョンで実行されているトランザクションの状態を表示するツールです。

以下は、osctxadmツールの実行方法です。

以下は、OSC00001リージョンで実行中のトランザクション情報を表示する例です。

oscxltcは、DFHXLTマクロをコンパイルするツールです。

以下は、oscxltcツールの実行方法です。

以下は、XLT.datファイルに含まれているXLTマクロ定義を読み込んで、OSC00001リージョンにデプロイする例です。