日本語DEC SNA リモート・ジョブ・エントリ for_DEC_OSF/1_______________________________________ ユーザーズ・ガイド /インストレーション・ガイド AA-QCZ3A-TE オペレーティング・システム: OSF/1 V3.0A ソフトウェア・バージョン: 日本語DEC SNAリモート・ ジョブ・エントリfor DEC OSF/1 V1.0 マニュアル・バージョン: V1.0 ________________________________________________________________ 1995年1月 本書の著作権は日本ディジタルイクイップメント株式会社(日本 DEC)が保有しており,本書中の解説および図,表は日本DECの文書 による許可なしに,その全体または一部を,いかなる場合にも再 版あるいは複製することを禁じます。 また,本書に記載されている内容は,予告なく変更されることが ありますので,あらかじめご承知おきください。万一,本書の記 述に誤りがあった場合でも,日本DECは一切その責任を負いかねま す。 本書で解説するソフトウェア(対象ソフトウェア)は,所定のライ センス契約が締結された場合に限り,その使用あるいは複製が許 可されます。 日本DECは,日本DECまたは日本DECの指定する会社から納入された 機器以外の機器で対象ソフトウェアを使用した場合,その性能あ るいは信頼性について一切責任を負いかねます。 (c) Digital Equipment Corporation Japan 1995. All Rights Reserved. Printed in Japan. 以下は米国Digital Equipment Corporationの商標です。 ACMS DECUS Rdb/ELN VAX CDD ALL-IN-1 DECwindows Rdb/VMS VAX FMS DATATRIEVE DECwriter ReGIS VAXstation DEC DIBOL RSTS VIDA DEC/CMS MASSBUS RSX VMS DEC/MMS PDP RT VT DECforms P/OS TDMS Work Processor DECintact ProfessionaULTRIX DECmate Rainbow UNIBUS DECnet RALLY VAX DIGITAL 以下は他社の商標です。 o PostScriptは米国Adobe Systems社の商標です。 o IBMはIBM社の商標です。 _________________________________________________________________ 目次 まえがき................................................. vi 1 ユーザーズ・ガイド 1.1 概要......................................... 1-1 1.1.1 漢字コードの対応規則..................... 1-1 1.1.2 EBCDIC/ASCII変換テーブル................. 1-2 1.1.3 ソフトウェア構成......................... 1-2 1.2 jsnacodeユーティリティ....................... 1-3 1.2.1 起動方法................................. 1-3 1.2.2 jsnacodeコマンド形式..................... 1-3 1.2.3 KMAPファイル............................. 1-12 1.2.4 1バイトコード変換テーブル............... 1-13 1.2.5 jsnacodeエラーメッセージ一覧............. 1-15 1.3 jsnaknjdefユーティリティ..................... 1-18 1.3.1 起動方法................................. 1-18 1.3.2 jsnaknjdefコマンド形式................... 1-18 1.3.3 jsnaknjdefユーティリティ内のコマンド形式. 1-19 1.3.3.1 useコマンド............................ 1-19 1.3.3.2 listコマンド........................... 1-20 1.3.3.3 defineコマンド......................... 1-22 1.3.3.4 undefineコマンド....................... 1-25 1.3.3.5 helpコマンド........................... 1-26 1.3.3.6 exitコマンド........................... 1-26 1.3.3.7 quitコマンド........................... 1-27 1.3.4 jsnaknjdefエラーメッセージ一覧........... 1-28 1.4 jsnatratblユーティリティ..................... 1-29 1.4.1 変換テーブル修正マクロ................... 1-29 1.4.1.1 マクロ................................. 1-30 1.4.1.2 コメント............................... 1-32 1.4.2 変換テーブルの作成....................... 1-32 1.4.3 変換テーブル作成例....................... 1-34 iii 1.4.4 jsnatratblエラーメッセージ一覧........... 1-35 1.5 DEC/IBMコード変換ライブラリ.................. 1-38 1.5.1 コード変換ライブラリの概要............... 1-38 1.5.1.1 サポートされる漢字コード............... 1-38 1.5.1.2 ライブラリ構成......................... 1-39 1.5.1.3 リンク方法............................. 1-39 1.5.2 コード変換ライブラリの詳細............... 1-39 1.5.2.1 Item List.............................. 1-39 1.5.2.2 Item Code.............................. 1-39 1.5.2.3 変換モードBitmask...................... 1-41 1.5.2.3.1 文字列の初期/最終モード............... 1-42 1.5.2.3.2 シフト・コード........................ 1-43 1.5.2.3.3 Replaceモード(IBMからDECへの変換の場 合のみ)............................... 1-44 1.5.2.4 コード変換の例......................... 1-44 1.5.2.5 外字の変換............................. 1-45 1.5.2.6 制限事項............................... 1-45 1.5.2.7 DEC/IBMコード変換ルーチンのインタフェー ス...................................... 1-45 tra_dec_ibm_init.................................... 1-46 tra_dec_ibm_free .................................. 1-50 tra_dec_ibm ....................................... 1-52 tra_ibm_dec ....................................... 1-55 1.5.3 省略時変換テーブル....................... 1-58 1.5.4 プログラム例............................. 1-60 2 日本語RJEのインストレーション 2.1 インストレーション必要事項の確認............. 2-1 2.2 必須ソフトウェア・サブセットの確認........... 2-2 2.3 IBMホスト・システムへのアクセスについて...... 2-3 2.4 システム・ディスクのバックアップ............. 2-4 2.5 ライセンスPAKの登録.......................... 2-4 2.5.1 標準版RJEのライセンスについて............ 2-4 2.6 問題点の通知................................. 2-5 2.7 インストレーション方法....................... 2-5 2.7.1 CD-ROMからのインストレーション........... 2-5 2.7.2 IVPの実行方法............................ 2-11 2.7.3 IVPが失敗した場合........................ 2-12 iv 2.8 内部コマンド・テーブルの再構築............... 2-12 2.9 インストレーション後の日本語RJEファイルの配 置............................................ 2-12 2.10 インストレーション例......................... 2-15 索引 図 1-1 IBM-DEC漢字コード対応図................... 1-2 1-2 -k 2の場合のKMAPファイルと変更対象ファイ ル........................................ 1-12 1-3 KMAPファイルの出力例...................... 1-13 1-4 jsnacodeが提供する変換テーブル (EBCDICJIS)............................ 1-14 1-5 list表示例−1............................ 1-21 1-6 Item List structure....................... 1-39 1-7 変換例.................................... 1-44 1-8 DEC -> IBM 1バイトコード変換テーブル...... 1-58 1-9 IBM -> DEC 1バイトコード変換テーブル...... 1-59 表 1-1 Item Code一覧............................. 1-40 1-2 変換モード................................ 1-41 1-3 文字列モードの値.......................... 1-42 1-4 指定可能なItem Code....................... 1-47 1-5 指定可能なItem Code....................... 1-53 1-6 指定可能なItem Code....................... 1-56 2-1 日本語RJEのインストレーション必要事項..... 2-1 2-2 必要なサブセット.......................... 2-2 2-3 日本語RJEファイル......................... 2-12 v _________________________________________________________________ まえがき 本書の目的 本書「日本語DEC SNAリモート・ジョブ・エントリfor DEC OSF/1 ユーザーズ・ガイド/インストレーション・ガイド」では、日 本語DEC SNAリモート・ジョブ・エントリfor DEC OSF/1 (以下 日本語RJE)の4つのコンポーネントであるjsnacodeユーティリテ ィ, jsnaknjdefユーティリティ, jsnatratblユーティリティ及び DEC/IBMコード変換ライブラリの使用方法および日本語RJEをイン ストールするために必要な情報について説明します。 本書の対象者 本書は次のような方を対象としています。 o jsnacodeユーティリティを使用し、IBM-DECのファイル単位 でのコード変換を行う利用者。 o jsnaknjdefユーティリティを使用し、外字の登録を行う利用 者。 o jsnatratblユーティリティを使用し、EBCDIC/DMCS変換テー ブルの作成を行う利用者。 o DEC/IBMコード変換ライブラリを使用し、DECコードとIBMコ ードの変換を行う利用者。 このような利用者はOSF/1の基本的な知識が必要です。 IBMシステムの適用業務プログラムについての情報は、本書には記 述されていません。関連するIBM社のマニュアルを参照してくださ い。 vi 本書の構成 本書は第1章のユーザーズ・ガイドと第2章のインストレーショ ン・ガイドで構成されています。 o 第1.1章 日本語RJEのすべての利用者を対象としています。日本語RJE とはどのような製品なのか、どのようにして使用するのかを 説明します。 o 第1.2章 jsnacodeユーティリティの使用方法について説明します。 o 第1.3章 jsnaknjdefユーティリティの使用方法について説明します。 o 第1.4章 jsnatratblユーティリティの使用方法について説明します。 o 第1.5章 DEC/IBMコード変換ライブラリの使用方法について説明しま す。 o 第2章 日本語RJEのインストレーションについて説明します。 参考文献 DEC SNA Remote Job Entry for OSF/1については、以下のマニュ アルを参考にして下さい。 o DEC SNA Access Software for OSF/1 Installtion Guide o DEC SNA Access Software for OSF/1, Communications Server Administrator's Guide o DEC SNA RJE for OSF/1 Administrator's and User's Guide vii DEC SNA Peer Serverについては,以下のマニュアルを参照してく ださい。 o DEC SNA Peer Server Installation and Configuration Guide o DEC SNA Peer Server Management Guide o DEC SNA Peer Server Guide to IBM Resource Definition o DEC SNA Peer Server Network Control Language Reference DECnet SNA Gateway-STについては、以下のマニュアルを参考にし てください。 o DECnet SNA Gateway Introduction o DECnet SNA Gateway Installation Guide 漢字コードについては、以下のマニュアルを参考にして下さい。 o DEC漢字コード一覧表 o IBM漢字システム文字セット一覧表 (N:GC18-0611) 必要に応じて、以下のIBM社のマニュアルも参照してください。 o IBM VTAM 導入および資源の定義 (N:SC23-0011-4) o IBM Network Control Program and System Support Programs Resource Definition Guide (SC30-3254-01) o IBM OS/VS2 VMS System Programming Library:JES2 (GC23- 0002-1) viii 本書で使用される表記法 本書では下記の表記法を使用します。 ___________________________________________________________ 表記________説明___________________________________________ jsnaknjdef> '>'で終了しているプロンプトは、使用するコマンド 言語を示します。 [opt-arg] 形式の説明で、大括弧は省略可能な部分を示しま す。何も選択しないか1つの項目を選択するか、ま たはすべての項目を選択できます。 キーボードのキーを押すことを示す場合には、キー 名を枠で囲んで示します。 等のキーの組み合せは、CTRLキーを押した ____________状態で別のキーを押すことを示します。___________ ix 1 _________________________________________________________________ ユーザーズ・ガイド _________________________________________________________________ 1.1 概要 日本語DEC SNAリモート・ジョブ・エントリfor DEC OSF/1 (以 下日本語RJEと略す)は,DEC社のDEC SNA Remote Job Entry for OSF/1 (以下,標準版RJEと略す) と日本語変換機能を組み合わせ ることにより,DEC社のDEC SNA Peer ServerまたはDECnet SNA Gateway-STまたはDECnet SNA Gateway-CTを通して,ハイレベル な伝送制御方式で接続されたIBMシステムとOSF/1システムとの間 で,漢字コードを含むファイルの送受信を行うことが出来ます。 ファイルの送受信は標準版RJEで行い,コード変換は日本語RJEで行 います。 このユーザーズ・ガイドでは日本語RJEの日本語変換機能について 説明します。 1.1.1 漢字コードの対応規則 IBM漢字コードとDEC漢字コードを相互に変換するための2バイ ト・コード体系の対応を図 1-1に示します。 図 1-1が示すように,IBM漢字空間のJIS漢字コードについてはDEC 漢字セットの対応する各文字に対応付けられ,IBM付加文字(338文 字) およびIBMユーザ定義文字(4,370文字) については,日本語 RJE利用者の選択によりDEC拡張漢字セットのユーザ定義領域に対 応付けます。その際,次のような対応規則を設定します。 ___________________________________________________________ IBM漢字セット____対応規則__________________________________ JIS制定文字 DEC漢字セットと一対一対応 IBM付加文字 DEC拡張漢字セットの連続6区間と対応 IBMユーザ定義文 DEC拡張漢字セットの連続2区間 字の1区間__________________________________________________ ユーザーズ・ガイド 1-1 ユーザーズ・ガイド 1.1概要 図 1-1 IBM-DEC漢字コード対応図 1.1.2 EBCDIC/ASCII変換テーブル EBCDIC/ASCIIの1バイト・コード変換テーブルについては,日 本語RJEが提供する変換テーブルである/usr/lib/sna/ja_JP /jsnarjetra.tblが省略値として使用されます。これ以外のテ ーブルを使用する場合には,jsnacodeコマンドの-cオプションで 指定します。-cオプションについては,第1.2.2項を参照して下さ い。1バイト変換テーブルの作成方法については,第1.4節を参照 して下さい。 1.1.3 ソフトウェア構成 日本語RJEは以下の4つから構成されています。 o jsnacodeユーティリティ o jsnaknjdefユーティリティ o jsnatratblユーティリティ o DEC/IBMコード変換ライブラリ 1-2 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ _________________________________________________________________ 1.2 jsnacodeユーティリティ jsnacodeユーティリティは,日本語DEC SNAリモート・ジョブ・エ ントリfor DEC OSF/1 (以下日本語RJE)の本体となる部分のソフト ウェアです。OSF/1のシェル・コマンドにより起動され,その際に 指定された入力ファイルを指定されたコマンドオプションに従っ て変換し,出力ファイルを作成します。 1.2.1 起動方法 次のようなコマンドでjsnacodeは起動されます。 % jsnacode -ip dec -op ibm -i 入力ファイル名 -o 出力ファ イル名 または % jsnacode -ip ibm -op dec -i 入力ファイル名 -o 出力ファ イル名 1.2.2 jsnacodeコマンド形式 jsnacodeコマンドの形式は次の通りです。 ___________________________________________________________ jsnacode 入力ファイルをコマンドオプションの指示に従い 変換し,出力ファイルを作成します ___________________________________________________________ (形式) % jsnacode -i入力ファイル名 -o出力ファイル名 ユーザーズ・ガイド 1-3 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ 1-4 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ ___________________________________________________________ (オプション)_______________(省略値)________________________ -ip keyword -ip dec -op keyword -op dec -cファイル名 -c jsnarjetra -e [ss|ls] -e ss(-kを指定した場合は無視さ れます) -x 外字管理ファイル名 なし -f(s:n, e:n, l:n, kanji|kana) -k KMAPレコード数 なし(レコード数の省略値は1) -t なし -i 変換対象のファイル名 標準入力 -o_変換結果のファイル名____標準出力________________________ KMAPファイルについては, 第1.2.3項を参照してください。 (コマンドオプション) -ip keyword 入力ファイルのコード体系を指定します。ここで指定でき るkeywordは o ibm o dec です。 -op keyword ユーザーズ・ガイド 1-5 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ 出力ファイルのコード体系を指定します。ここで指定でき るkeywordは o ibm o dec です。 -c 1バイトコード変換テーブルのファイル名 jsnatratblユーティリティにより作成された,1バイトコー ド変換テーブルのファイル名です。jsnatratblユーティリテ ィについては第1.4節を参照してください。 ________________________ 注意 ________________________ jsnacodeユーティリティが,ファイルへのアクセス中に何ら かのエラーを検出した場合はその旨を告げるメッセージを表 示し,出力ファイルは消去されます。 ______________________________________________________ -e [ss|ls] 1. -e ssの場合 o -ip dec -op ibmの場合 入力ファイルのデータ中にSS2(X'8E') が現われ場合, 次の1バイトをJISカタカナ・コードセットと解釈しま す。SS2が付加されずにX'A1'以上X'FE'以下のコード が現れた場合は,2バイトコードの上位バイトと解釈 します。-eと-kは同時には指定できません。この指定 がない場合は,-kの指定に従います。変換したIBMコ ードの2バイトコード文字列の前後にはシフトコード (X'0E',X'0F') が挿入されます。 1-6 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ o -ip ibm -op decの場合 JISカタカナ・コードセットに変換された場合は,前に SS2を付加してからファイルに出力します。この出力フ ァイルは,端末またはプリンタに直接出力する最終形式 のファイルを想定しています。-eと-kは同時には指定で きません。指定がない場合は,-kの指定に従います。 2. -e lsの場合 o -ip dec -op ibmの場合 入力ファイルのデータ中にLS3R(ESC|) が現われたと き以後,X'A1'以上X'FE'以下のコードを2バイトコー ドの上位バイトと解釈します。LS2R(ESC}) が現われ たとき以後のコードを,すべて1バイト・コードと解 釈します。-eと-kは同時には指定できません。この指 定がない場合は,-kの指定に従います。変換したIBMコ ードの2バイトコード文字列の前後にはシフトコード (X'0E',X'0F') が挿入されます。 o -ip ibm -op decの場合 JISカタカナ・コードに変換された場合は,その1バイト 文字列の前後にLS2R, LS3Rを付加してからファイルに出 力します。この出力ファイルは,端末またはプリンタに 直接出力する最終形式のファイルを想定しています。-e と-kは同時には指定できません。指定がない場合は,-k の指定に従います。 -eオプションを指定せずに,環境変数JSNACODE_ESCAPEをss, またはlsに定義することにより,-e ssまたは-e lsと指定し た場合と同じ結果が得られます。以下はC-shellの場合の環 境変数の定義例です。 % setenv JSNACODE_ESCAPE ss ただし,明示的に-e [ss|ls]を指定した場合は,環境変数よ り優先されます。 -x外字管理ファイル名 IBM付加文字やIBMユーザ定義文字を,DECユーザ定義領域の どの文字コードに割り当てるかを定めた外字管理ファイル名 を指定します。外字管理ファイルは,jsnaknjdefユーティリ ユーザーズ・ガイド 1-7 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ ティにより作成,管理されるファイルです。-xを指定した場 合は,必ず外字管理ファイル名を指定しなければなりませ ん。-xの指定がない場合,IBMからDECへの変換の場合はIBM 付加文字やIBMユーザ定義文字はすべて"□" (X'A2A2')に, DECからIBMへの変換の場合も,DEC拡張漢字セットの文字は すべて"□"(X'A2A2')に変換します。 -f [s:pos] [e:pos | l:len] [kanji | kana] 1レコード内の変換の範囲を指定します。s:posは変換の開 始位置をバイト単位で表します。e:posは変換の終了位置を バイト単位で表します。l:lenは長さをバイト単位で表しま す。この1コマンド列で規定すべきフィールド数が指定でき ない場合は,複数回のjsnacodeコマンドを使用してくださ い。各々の-fオプションで指定する範囲が重なってはいけま せん。-fオプションの指定がない時は,1レコード全体が変 換の対象になります。sの省略値はレコードの先頭で,e, l の省略値はレコードの最後の位置を示す値です。eとlは同時 には指定できません。-fオプションを33個以上指定しても, 33個目からのオプションは無視されます。-fオプションは-e とは同時に指定できません。また, s:, e:, l:と値の間にス ペースが入ってはいけません。 モード指定のkanaとkanjiは,同時に指定することはできま せん。 o -ip dec -op ibmの場合 モード指定のkeywordは,出力ファイルの開始・終了モ ードを指定します。DEC側の開始モードは,KMAPファイ ルの指定に依存します。 o -ip ibm -op decの場合 モード指定のkeywordは,入力ファイルの開始・終了モ ードを指定します。-fオプションを指定しない場合は, 先頭レコードが2バイト・コード開始のシフト・コード (X'0E') で始まらない限り,英数字モードから始まるも のと見なします。 1-8 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ -k kmapレコード数 KMAPレコード数の省略値は1です。 o -ip dec -op ibmの場合 -kを指定した時,入力ファイル名に".kmap"を付加した 名前のファイルが,入力ファイルの2バイトコード・1 バイトコード混在情報を示すKMAPファイルであるとみな されます。ただし,環境変数JSNACODE_KMAPFILE にKMAP ファイル名が定義されている場合には,そのファイル名 が優先的に使用されます。以下はC-shellの場合の環境 変数の定義例です。 % setenv JSNACODE_KMAPFILE KMAPファイル名 コード変換はKMAPファイルに定義されている情報に従っ て実行されます。KMAPレコード数の指定がある場合, KMAPファイルの先頭レコードから指定されたレコード数 を変換する際に使用します。KMAPファイル内の全KMAPレ コード数が指定された値より小さい場合は,全KMAPレコ ード数が指定されているものとして処理されます。-kと -eは同時には指定できません。 この指定がない場合は,-eの指定に従います。 またKMAPコードが"Xk"で対応する入力コードが漢字コー ドだった場合は,KMAPコードは"XX"であると見なしま す。 入力ファイルとして,標準入力を使用した場合は, jsnacode_stdio.kmapという名前のKMAPファイルを参 照します。このファイルが無い場合はエラーとなりま す。 o -ip ibm -op decの場合 -kの指定がある場合,コマンド・パラメータで指定した 出力ファイル中に1バイトコードがあっても,エスケー プ・シーケンス(SS2,またはLS2R,LS3R) を挿入せず, 出力ファイルの後に".kmap"を付加したファイルを作成 し,2バイトコード・1バイトコードの混在情報を出力 します。ただし,もし環境変数JSNACODE_KMAPFILEにKMAP ファイル名が割り当てられている場合は,そのファイル 名でKMAPファイルが作成されます。KMAPレコード数の指 定がある場合,KMAPファイルに出力されるのは出力ファ ユーザーズ・ガイド 1-9 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ イルの先頭レコードから数えてKMAPレコード数分のレコ ードに対する2バイトコード・1バイトコードの混在情 報です。 -kと-eは同時には指定できません。この指定がない場合 は-eの指定に従います。 出力ファイルとして標準出力を使用した場合は, jsnacode_stdio.kmapという名前のKMAPファイルが作 成されます。 ________________________ 注意 ________________________ -kオプションを指定し, IBM→DEC→IBMのように変換させよ うとして, jsnacodeコマンドをパイプでつないで連続実行さ せると,出力中のKMAPファイルが参照できずにエラーとなり ます。この場合は,コマンドを複数回に分けて実行してくだ さい。 ______________________________________________________ -t このオプションは-ip dec -op ibmの指定の場合に有効で す。 -tの指定がある場合は,タブをそれ自体有効なコードと解釈 し,タブ・コードを空白文字列へ変換することを行いませ ん。 -tの指定が無い場合は,タブ・コードを次の文字位置が8の 倍数となるようにタブ文字を空白文字に変換します。 空白文字列の変換は,DECコードからIBMコードへの変換の前 に行われます。したがって2バイトコードの前後に挿入され るシフトコード文字(X'0E', X'0F') はタブ位置の計算には 含まれません。 -i入力ファイル 変換対象のファイル名を指定します。このオプションを省略 した場合は,入力として標準入力が割り当てられます。 1-10 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ -o出力ファイル 変換した結果のファイル名を指定します。このオプションを 省略した場合は,出力として標準出力が割り当てられます。 ユーザーズ・ガイド 1-11 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ 1.2.3 KMAPファイル KMAPファイルは,DEC漢字セットの2バイト文字列と1バイト文字列 (ASCII+半角カタカナ)がLS2R ,LS3R またはSS2 のコードなしで 混在したファイルを読み込む(または書き込む)際に使用する(また は作成する)ファイルです。KMAPファイルの中では,変換対象ファ イルのレコードに含まれる漢字を"XX",英数字を"X"で表し,半角 カタカナを"k"で表します。 -k KMAPレコード数で指定したKMAPファイルには,変換対象ファイ ルの先頭レコードから指定されたレコード数分の情報が含まれま す。 図 1-2 -k 2の場合のKMAPファイルと変更対象ファイル 1-12 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ % jsnacode-f s:1 l:30 -f s:41 -l:20 - _%-ip ibm -op dec -k 入力ファイル名 出力ファイル名 上記のような1レコード内のある部分のみを変換対象とした場合, 作成されるKMAPレコードは次のような図のものとなり,変換対象 となっていない部分については空白文字(X'20')が埋め込まれま す。 図 1-3 KMAPファイルの出力例 1.2.4 1バイトコード変換テーブル OSF/1システム上ではASCIIとJISカタカナが用いられます。一方, IBMシステム上では,EBCDICが用いられます。jsnacodeユーティリ ティでは,これらの文字コードを相互に変換するために,変換テ ーブルを用います。 jsnacodeユーティリティがデフォルトで提供する変換テーブルを 図 1-4に示します。 変換テーブルは最上段の0〜Fは,EBCDICコードでの上位4ビットを 表し,最左段の0〜FはEBCDICコードでの下位4ビットを表します。 上位4ビットに対応する行と下位4ビットに対応する列の交わる位 置に書き込まれている文字および16進コードが,OSF/1システム上 での文字および16進コードを表しています。 もし,ユーザが独自の変換テーブルを定義して使用したい場合は, jsnatratblユーティリティを使用して,変換テーブルを作成し, jsnacodeユーティリティでそれを使用することが可能です。 詳細は第1.4節を参照してください。 ユーザーズ・ガイド 1-13 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ 図 1-4 jsnacodeが提供する変換テーブル(EBCDICJIS) 注:EBCDICJISの場合,未定義のEBCDICコードはJISコードの SUB(X'1A')に変換されます。JISEBCDICの場合,未定義のJISコー ドはEBCDICコードのSUB(X'3F')に変換されます。 1-14 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ 1.2.5 jsnacodeエラーメッセージ一覧 jsnacodeユーティリテイにおいてエラーが発生したとき,以下に示 すようなエラーメッセージが出力されます。エラーが発生したと きは,出力されたエラーメッセージについての説明と利用者の対応 をよく読み,適切な処置を行ってください。 Abnormal input file read, 説明: 入力ファイルを読もうとしたところエラーが生じました。 利用者の対応: 入力ファイルのプロテクション等を確認して下さ い。 Abnormal output file write, 説明: 出力ファイルに書き込もうとしたところエラーが生じまし た。 利用者の対応: 出力ファイルが作成されるディレクトリのプロテク ション等を確認して下さい。 Abnormal KMAP file read or write, 説明: KMAPファイルにアクセスしようとしてエラーが生じました。 利用者の対応: KMAPファイルの内容,プロテクション等をチェック して下さい。 Abnormal GAIJI control file read, 説明: 外字管理ファイルを読み込もうとしてエラーが生じました。 利用者の対応: 外字管理ファイルのプロテクション等を確認して下 さい。 FIELD parameter mismatch, 説明: -fオプションで指定した変換範囲が,漢字の第2バイト目で 終了している等のエラーです。 利用者の対応: -fオプションで指定した値を確認して下さい。 Insufficient dynamic memory, 説明: ファイルを読み込むためのバッファが確保できません。 利用者の対応: しばらく時間が経った後,再実行し,同じエラーメッ セージが表示される場合は,システム管理者に問い合わせて下さ い。 ユーザーズ・ガイド 1-15 ユーザーズ・ガイド 1.2 jsnacodeユーティリティ Invalid parameter value specified, 説明: jsnacodeの修飾子,コマンド・パラメータで無効な値が指定 されました。 利用者の対応: 指定した値を再確認して,正しい値を指定して下さ い。 Input file not found, 説明: 入力ファイルが見つかりません。 利用者の対応: 指定した入力ファイル名を確認して下さい。 KMAP file not found, 説明: -kオプションで指定したKMAPファイルが見つかりません。 利用者の対応: 指定したKMAPファイル名を確認して下さい。 GAIJI control file not found, 説明: -xオプションで指定した外字管理ファイルが見つかりませ ん。 利用者の対応: 指定した外字管理ファイル名を確認して下さい。 No record in input file, 説明: 入力ファイルの中にレコードが存在していません。 利用者の対応: 入力ファイルの内容を確認して下さい。 No record in KMAP file, 説明: KMAPファイルの中にレコードが存在していません。 利用者の対応: KMAPファイルの内容を確認して下さい。 Translation table load error, 説明: -cオプションで指定した1バイトコード・テーブルを読み込 む際に,エラーが生じました。 利用者の対応: 指定した1バイトコード・テーブル・ファイルの構 造,プロテクション等を確認して下さい。 Invalid Combination of parameter, 説明: パラメータの組み合せが正しくありません。 利用者の対応: 正しい組み合せで実行してください。 Parameter value is not specified, 説明: パラメータ値が指定されていません。 利用者の対応: パラメータ値を指定してください。 1-16 ユーザーズ・ガイド ユーザーズ・ガイド 1.2 jsnacodeユーティリティ Invalid keyword, 説明: パラメータのキーワード名が間違っています。 利用者の対応: 正しいキーワード名を指定してください。 ユーザーズ・ガイド 1-17 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ _________________________________________________________________ 1.3 jsnaknjdefユーティリティ jsnaknjdefユーティリティは,OSF/1ユーザがIBM付加文字および IBMユーザ定義文字とDEC拡張漢字セットのユーザ定義領域の文字 との対応を設定,管理するためのソフトウェアです。このプログ ラムはjsnaknjdefコマンドにより起動されます。 1.3.1 起動方法 次のようなOSF/1のオペレーションにより起動されます。 % jsnaknjdef [ファイル名] (jsnaknjdefユーティリティの起動) jsnaknjdef> (jsnaknjdefのプロンプト) 1.3.2 jsnaknjdefコマンド形式 jsnaknjdefコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ jsnaknjdef_________________________________________________ (形式) jsnaknjdef (コマンド・パラメー 外字管理ファイル名(省略可) タ) (コマンド・オプショ なし ン)_______________________________________________________ 1-18 ユーザーズ・ガイド ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ 1.3.3 jsnaknjdefユーティリティ内のコマンド形式 jsnaknjdef>プロンプトに対し,ユーザは次のコマンドを入力する ことができます。 o use o list o define o undefine o help o exit o quit 以下にこれらのコマンド形式について説明します。 1.3.3.1 useコマンド useコマンドは,使用する外字管理ファイルを指定します。 useコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ use_____________________________________________________ (形式) use 外字管理ファイル名 ___________________________________________________________ (コマンド・パラメー タ)__________________(Default)____________________________ 外字管理ファイル名____なし_________________________________ 指定されたファイル名により既存のファイルがあれば,そのファ イルを使用対象とし,なければ新しい外字管理ファイルを作成し ます。ただし,新しいファイルを作成する場合は,スーパー・ユ ーザでなければなりません。外字管理ファイルは,IBM付加文字お よびIBMユーザ定義文字を,DECユーザ定義領域のどの部分と対応 付けるかの情報を保存するファイルです。 ユーザーズ・ガイド 1-19 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ ________________________ 注意 ________________________ useコマンドにより選択された外字管理ファイルは, jsnaknjdefユーティリティ内で次にuseコマンドを発行 するまで,define,undefine,listコマンドの対象ファイル となります。 また,現在指定されているファイルを再度指定した場合, jsnaknjdef起動時のファイル内容から編集し直すことができ ます。 ______________________________________________________ 1.3.3.2 listコマンド listコマンドは,useコマンドにより指定された外字管理ファイル の内容をoutputで指定したファイルに表形式で出力します。 listコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ list___________________________________________________ (形式) list ___________________________________________________________ (コマンド・オプショ ン)__________________(Default)____________________________ outputファイル名______標準出力_____________________________ 1-20 ユーザーズ・ガイド ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ (コマンド・オプション) outputファイル名 このオプションが省略された場合は,標準出力(端末画面) に出力します。 図 1-5 list表示例−1 jsnaknjdef> use extern.tbl jsnaknjdef> list List of the DEC-IBM external Kanji File: extern.tbl DEC Extended IBM Kanji DEC Extended IBM Kanji Kanji Kanji 1 External 17 User 6d 2 External 18 User 6d 3 External 19 User 6e 4 External 20 User 6e 5 External 21 User 6f 6 External 22 User 6f 7 User 69 23 User 70 8 User 69 24 User 70 9 undefined 25 User 71 10 undefined 26 User 71 11 User 6a 27 User 72 12 User 6a 28 User 72 13 User 6b 29 undefined 14 User 6b 30 undefined 15 User 6c 31 undefined 16 User 6c (END of list) Note : DEC Ku No. is decimal. IBM Ku No. is Hexa-decimal. 表中の”External”は,IBM付加文字を表し,”User xx”は,IBM ユーザ定義文字の第xx区を示しています。 ユーザーズ・ガイド 1-21 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ 1.3.3.3 defineコマンド defineコマンドは,useコマンドにより指定された外字管理ファイ ルの情報を定義します。 defineコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ define_______________________________________________ (形式) define (制限) このコマンドはスーパー・ユーザのみ実 行することができます ___________________________________________________________ (コマンド・オプショ ン)__________________(Default)____________________________ external なし user IBMユーザ定義文 なし 字区番号 to DECユーザ定義領域 なし 区番号_____________________________________________________ (コマンド・オプション) external IBM付加文字(386文字)について定義をする場合に指定しま す。 externalとuserを同時に指定した場合は,最後に指定したも のが有効になります。 user IBMユーザ定義文字区番号 IBMユーザ定義文字について定義をする場合に使用します。 続くオプションは,IBMユーザ定義文字区番号で69〜7Fまで を16進数で指定します。externalとuserを同時に指定した場 合は,最後に指定したものが有効になります。 1-22 ユーザーズ・ガイド ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ to DECユーザ定義領域区番号 o externalが指定されている場合 1〜26までの区番号を10進数で指定します。指定された 区番号を始めとした連続6区間にIBM付加文字が対応付け られます。たとえばto 21を指定した場合は,DECユー ザ定義領域の21〜26区にIBM付加文字が対応付けられま す。 o userが指定されている場合 1〜29までの区番号を10進数で指定します。指定された 区番号を始めとした連続2区間にIBMユーザ定義文字が対 応付けられます。たとえばuser 69,to 1を指定した場 合は,IBMユーザ定義文字69区が,DECユーザ定義領域の 1,2区に対応付けられます。 defineコマンド使用例を示します。 o 新規にファイルを作成する場合 # jsnaknjdef jsnaknjdef> use mytbl.tbl jsnaknjdef> define external to 21 jsnaknjdef> define user 69 to 1 jsnaknjdef> define user 6A to 3 jsnaknjdef> define user 6B to 5 jsnaknjdef> define user 6C to 7 jsnaknjdef> exit 上記のコマンドにより新規に作成されたmytbl.tblの中に は、次のような指定がされることになります。 _______________________________________________________ IBM漢字_______________DEC漢字__________________________ IBM付加文字 DEC拡張漢字セットの第21区〜第26 区 IBMユーザ定義文字の DEC拡張漢字セットの第1区〜第2区 第69区 IBMユーザ定義文字の DEC拡張漢字セットの第3区〜第4区 第6A区 IBMユーザ定義文字の DEC拡張漢字セットの第5区〜第6区 第6B区 ユーザーズ・ガイド 1-23 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ _______________________________________________________ IBM漢字_______________DEC漢字__________________________ IBMユーザ定義文字の DEC拡張漢字セットの第7区〜第8区 第6C区_________________________________________________ o 外字管理ファイルを更新する場合 # jsnaknjdef jsnaknjdef> use mytbl.tbl jsnaknjdef> define use 69 to 9 jsnaknjdef> exit 上記のコマンドにより既存のmytbl.tblは、次のように更新 されることになります。 _______________________________________________________ IBM漢字_______________DEC漢字__________________________ IBM付加文字 DEC拡張漢字セットの第21区〜第26 区 IBMユーザ定義文字の DEC拡張漢字セットの第9区〜第10区 第69区 IBMユーザ定義文字の DEC拡張漢字セットの第3区〜第4区 第6A区 IBMユーザ定義文字の DEC拡張漢字セットの第5区〜第6区 第6B区 IBMユーザ定義文字の DEC拡張漢字セットの第7区〜第8区 第6C区_________________________________________________ 1-24 ユーザーズ・ガイド ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ 1.3.3.4 undefineコマンド undefineコマンドは,useコマンドにより指定された外字管理ファ イルの情報をクリア(初期化)します。 undefineコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ undefine___________________________________________ (形式) undefine (制限) このコマンドはスーパー・ユーザのみ 実行することができます ___________________________________________________________ (コマンド・オプショ ン)_____________________(Default)_________________________ all なし external なし user IBMユーザ定義文字 なし 区番号_____________________________________________________ (コマンド・オプション) all 現在定義されているすべてのIBMユーザ定義文字およびIBM付 加文字を未定義にする場合に指定します。 allとexternalとuserを同時に指定した場合は,最後に指定 したものが有効になります。 external IBM付加文字(386文字)を未定義にする場合に指定します。 allとexternalとuserを同時に指定した場合は,最後に指定 したものが有効になります。 user IBMユーザ定義文字区番号 ユーザーズ・ガイド 1-25 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ IBMユーザ定義文字を未定義にする場合に使用します。続く オプションは,IBMユーザ定義文字区番号で69〜7Fまでを16 進数で指定します。allとexternalとuserを同時に指定した 場合は,最後に指定したものが有効になります。 undefineコマンド使用例 o 現在定義されているすべてのIBMユーザ定義文字およびIBM付 加文字を未定義にする場合 jsnaknjdef> undefine all o IBM付加文字を未定義にする場合 jsnaknjdef> undefine external o IBMユーザ定義文字を未定義にする場合 jsnaknjdef> define user 69 1.3.3.5 helpコマンド helpコマンドによりjsnaknjdefユーティリティのコマンド説明を 端末装置に表示します。 helpコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ help___________________________________________________ (形式)______________help_________________________________ 1.3.3.6 exitコマンド exitコマンドにより修正した箇所を保存してjsnaknjdefユーティ リティを終了します。 exitコマンドのフォーマットは,次のとおりです。 1-26 ユーザーズ・ガイド ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ ___________________________________________________________ exit___________________________________________________ (形式)______________exit_________________________________ 1.3.3.7 quitコマンド quitコマンドにより修正した箇所を保存せずに jsnaknjdefユーテ ィリティを終了します。 quitコマンドのフォーマットは,次のとおりです。 ___________________________________________________________ quit___________________________________________________ (形式)______________quit_________________________________ ユーザーズ・ガイド 1-27 ユーザーズ・ガイド 1.3 jsnaknjdefユーティリティ 1.3.4 jsnaknjdefエラーメッセージ一覧 この節では,コマンドの正常終了を受け入れられない可能性のある 条件を示すエラーメッセージをまとめます。 DECの区番号は1〜31の10進数で指定してください。IBMの区番号はで指 定してください, 説明: 入力されたコードが10進数でないか,入力されたコードが規 定された範囲を越えています。 利用者の対応: 入力コードを確認してください。 USEコマンドでファイルを指定してください, 説明: 外字管理ファイル名が指定されていません。 利用者の対応: USEコマンドを使用して,外字管理ファイルを指定 してください。 1-28 ユーザーズ・ガイド ユーザーズ・ガイド 1.4 jsnatratblユーティリティ _________________________________________________________________ 1.4 jsnatratblユーティリティ IBMシステムでは,文字コードセットとしてEBCDICコードを使用し ます。OSF/1システムではDEC Multi Character Set(DMCS)を使用 します。DMCSは標準的なASCII文字セットのスーパーセットです。 日本語RJEではDMCSと他の文字コードセットとの間で文字を変換す るテーブルを使用します。利用者はjsnatratblユーティリティを 用いて利用者独自の変換テーブルを作成することができます。そ の際,利用者は,日本語RJEで提供するテンプレート・ファイルを 用います。利用者は,テンプレートファイルを修正することによ り,独自の変換テーブルを作成します。日本語RJEで提供するテン プレートファイルは/usr/lib/sna/ja_JP/jsnarjetra.marにありま すので参照してください。 1.4.1 変換テーブル修正マクロ もし,日本語RJEで提供されている変換テーブルが利用者の要 求を満たしていない場合は,テンプレートファイル中にマクロ を定義することにより,目的とする変換テーブルを作成できま す。変更するには,テンプレートファイル/usr/lib/sna/ja_JP /jsnarjetra.marを利用者のディレクトリ下にコピーしてからvi等 のエディタで変更してください。定義できるマクロは5種類あり ます。また,各マクロの引き数として共通に以下の引き数を指定 できます。 o eb EBCDICコードを16進数2桁で指定します。 o as DMCSコードを16進数2桁またはシングル・クオーテイシ ョンマーク(')の後に文字付けて指定します。 ユーザーズ・ガイド 1-29 ユーザーズ・ガイド 1.4 jsnatratblユーティリティ ________________________ 注意 ________________________ シングル・クオーテイションマークを使用してasを指定する 場合, DMCS文字にカンマ(,)とセミコロン(;)は指定できませ ん。 カンマは引き数の区切り記号として,またセミコロンは コメント開始記号として解釈されるので,シングル・ク オーテイションのみが指定されたと判断されます。(エ ラーにはならず, 00(ヌルコード)が定義されたと解釈 されます。)よって,カンマ,セミコロンをDMCSコードと して指定する場合は,直接, 16進コード(カンマの場合 は2C,セミコロンの場合は3B )を指定してください。 ______________________________________________________ 1.4.1.1 マクロ 1. EB2AS eb,as EB2ASマクロはEBCDICからDMCSに変換する場合のEBCDICコー ドとDMCSコードの対応を定義します。ebで定義されたEBCDIC コードは,asで定義されたDMCSコードに変換されます。この マクロはEBCDICコードからDMCSコードに変換する場合の対応 を定義するだけですので,DMCSコードからEBCDICコードへの 変換には影響を与えません。 例: EB2AS 5A,'! この例ではEBCDICコードの16進数5AをDMCSコードの文字'!' (16進数21)に変換することを定義しています。DMCSコードか らEBCDICコードへの変換時の'!'文字の変換には影響を与え ません。 2. AS2EB as,eb AS2EBマクロはDMCSからEBCDICに変換する場合のDMCSコード とEBCDICコードの対応を定義します。asで定義されたDMCSコ ードは,ebで定義されたEBCDICコードに変換されます。この マクロはDMCSコードからEBCDICコードに変換する場合の対応 を定義するだけですので,EBCDICコードからDMCSコードへの 変換には影響を与えません。 1-30 ユーザーズ・ガイド ユーザーズ・ガイド 1.4 jsnatratblユーティリティ 例: AS2EB '[,5F この例ではDMCSコードの文字'['(16進数5B)をEBCDICコード の16進数5Fに変換することを定義しています。EBCDICコード からDMCSコードへの変換時の16進数5Fの変換には影響を与え ません。 3. REVTRA eb,as REVTRAマクロはEB2ASマクロとAS2EBマクロを併せたマクロで す。EBCDICコードとDMCSコードの双方向の変換を定義するこ とができます。このマクロで定義されたEBCDICコードとDMCS コードは,EBCDICコードからDMCSコードへの変換時及びDMCS コードからEBCDICコードへの変換時の両方の場合に対応付け られます。 例: REVTRA 4A,A2 この例では,EBCDICコードからDMCSコードへの変換時には, EBCDICコードの16進数4Aは,DMCSコードの16進数A2に変換 し,DMCSコードからEBCDICコードへの変換時には,DMCSコー ドの16進数A2は,EBCDICコードの16進数4Aに変換することを 定義しています。この例は以下のように定義した場合と同じ 意味を持つことになります。 AS2EB A2,4A EB2AS 4A,A2 4. DMFILL = code. 文字の割り当てられていないDMCSコードに割り当てるコード を10進数で指定します。通常は,ASCII SUBコード(10進数 26)を指定します。 例: DMFILL = 26. ユーザーズ・ガイド 1-31 ユーザーズ・ガイド 1.4 jsnatratblユーティリティ 5. END. 変換テーブルの終わりを示します。 ________________________ 注意 ________________________ マクロは1行に1つしか指定できません。 ______________________________________________________ 1.4.1.2 コメント 定義ファイル中の任意の場所にコメント文字列を入れることがで きます。コメントはセミコロン(;)で始まり,行末で終わります。 例: ; This is a comment line. 1.4.2 変換テーブルの作成 作成するには,テンプレートファイル/usr/lib/sna/ja_JP /jsnarjetra.marを利用者のディレクトリ下にコピーしてから vi等のエディタで変更してください。テンプレートファイル/usr /lib/sna/ja_JP/jsnarjetra.marを直接修正しないことをお勧めし ます。 変換テーブルの作成は,修正したテンプレートファイルについて 以下に示すコマンドを実行することにより行ないます。 % jsnatratbl [-l] [-d] [入力ファイル名 [出力ファイル名]] -lオプショ 作成された変換テーブルの内容が,表形式のテキ ン ストファイルで出力されます。入力ファィル名に ".lis"を付加したファイルが作成されます。ただし, -dオプションを指定した場合は, "tratbldef.lis"が 作成されます。 1-32 ユーザーズ・ガイド ユーザーズ・ガイド 1.4 jsnatratblユーティリティ -dオプショ jsnatratblユーティリティの省略時のテーブルを出 ン 力します。この省略時のテーブルは,入力ファイル中 に何もコマンドを指定しなかった場合と同じもので す。このオプションを指定すると入力ファイル,出力 ファイル指定共に無効になります。変換テーブルは, "tratbldef.tbl"という出力ファイル名で作成されま す。 入力ファイ jsnatratblユーティリティの入力ファイルとなる変 ル 換テーブル定義ファイル名です。このパラメータは 省略できません。ただし, -dオプションを指定した 場合は無効になり,この場合は省略可能です。 出力ファイ jsnatratblユーティリティの出力ファイルとなる変 ル 換テーブルファイル名です。このパラメータを省略 した場合は,入力ファイル名に".tbl"を付加したファ イル名で出力ファイルが作成されます。ただし, -d オプションを指定した場合は無効になります。 ユーザーズ・ガイド 1-33 ユーザーズ・ガイド 1.4 jsnatratblユーティリティ 1.4.3 変換テーブル作成例 ここで示す変換テーブルの作成例は,カナ文字用変換テーブルに EBCDICコードからDMCSコードに変換する場合は,16進数C0及び16 進数DOを'{'及び'}'に変換し,DMCSコードからEBCDICコードに変 換する場合は,'{'及び'}'を16進数4D及び16進数5Dに変換するよ うに修正する場合を示しています。 DMFILL = 26. ・ ・ ・ ;EB2AS C0,1A ;EB2AS D0,1A ;AS2EB 7B,3F ;AS2EB 7D,3F EB2AS C0,'{ EB2AS D0,'} AS2EB '{,4D AS2EB '},5D ・ ・ ・ .END 1-34 ユーザーズ・ガイド ユーザーズ・ガイド 1.4 jsnatratblユーティリティ 1.4.4 jsnatratblエラーメッセージ一覧 jsnatratblユーティリティにおいてエラーが発生したとき,以下に 示すようなエラーメッセージが出力されます。エラーが発生した ときは,出力されたエラーメッセージについての説明と利用者の対 応をよく読み,適切な処置を行ってください。 Invalid option specified xxx, 説明: jsnatratblコマンドに間違ったオプションが指定されていま す。 利用者の対応: 正しいオプションを指定してください。 Too many parameters are specified, 説明: jsnatratblコマンドのパラメータ指定が多すぎます。 利用者の対応: 指定するパラメータの数を確認してコマンドを入力 し直してください。 Input file name is not specified, 説明: jsnatratblコマンドの入力ファイル名が指定されていませ ん。 利用者の対応: 入力ファイル名を指定してください。 Invalid output file name specification, 説明: jsnatratblコマンドの出力ファイル指定が間違っています。 利用者の対応: 出力ファイル名を確認してコマンドを入力し直して ください。 Cannot open xxx, 説明: ファイルxxxをオープンできません。 利用者の対応: ファイル名またはファイルの保護属性が正しいか確 認してください。 Invalid command name specification - at line nn, 説明: nn行目に間違ったコマンドが指定されています。 利用者の対応: 正しいコマンドに修正してください。 Command parameter not found - at line nn, 説明: nn行目のコマンドのパラメータが指定されていません。 利用者の対応: パラメータを指定してください。 ユーザーズ・ガイド 1-35 ユーザーズ・ガイド 1.4 jsnatratblユーティリティ Invalid character or string exists - at line nn, 説明: nn行目のコマンドの後に不正な文字列があります。 利用者の対応: 不正文字を取り除くか,またはコマンドのパラメー タが正しいかどうか確認してください。 Too many parameter specified - at line nn, 説明: nn行目のコマンドのパラメータ数が多すぎます。 利用者の対応: パラメータの数を修正するか,またはパラメータ値 にカンマ(,)が指定されていないか確認してください。 Invalid value specification - at line nn, 説明: nn行目のコマンドのパラメータ値が正しくありません。 利用者の対応: 正しいパラメータ値を指定してください。 No value is specified - at line nn, 説明: nn行目のコマンドのパラメータ値が指定されていません。 利用者の対応: パラメータを指定してください。 Invalid decimal number specification - at line nn, 説明: nn行目のコマンドのパラメータ値が正しい10進数で指定され ていません。 利用者の対応: 正しい10進数を指定してください。 Specified value is too large - at line nn, 説明: nn行目のコマンドのパラメータ値が範囲を越えています。 利用者の対応: 正しいパラメータ値を指定してください。 equal(=)specification not found, 説明: コマンドのパラメータ指定にイコール(=)記号が指定され ていません。 利用者の対応: パラメータ値の前にイコール記号を指定してくださ い。 less arguments, 説明: コマンドのパラメータ数が足りません。 利用者の対応: パラメータの数が正しいかを,またはパラメータ値 にセミコロン(;)が指定されていないかを確認してください。 1-36 ユーザーズ・ガイド ユーザーズ・ガイド 1.4 jsnatratblユーティリティ value string is too long, 説明: コマンドのパラメータ指定が長すぎます。 利用者の対応: 正しいパラメータ値を指定してください。 invalid hexadecimal value, 説明: パラメータ指定に正しくない16進数が指定されています。 利用者の対応: 正しい16進数を指定してください。 invalid specification of EBCDIC code, 説明: EBCDICコード指定に間違った値が指定されています。 利用者の対応: EBCDICコード指定が正しいか,またはEBCDICパラメ ータにASCII文字を指定していないか確認してください。 ユーザーズ・ガイド 1-37 ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ _________________________________________________________________ 1.5 DEC/IBMコード変換ライブラリ ここではDECコードとIBMコード間の変換を行うライブラリの使用 方法を説明します。 漢字コードについては以下の関連資料を参照してください。 IBM関連資料 1. 漢字コード一覧表(N:GC18-2040-3) DEC関連資料 1. 漢字コード表(AA-A056B-TE-JO) 2. VT282 programmer Reference Manual (YJ-CT82C-01) 3. jsnaknjdefユーティリティについては本書の第1.3節をご覧 ください。 1.5.1 コード変換ライブラリの概要 DEC/IBMコード変換ライブラリはDECコード,IBMコード相互間の変 換を行うルーチン群です。 DECコード,IBMコードには1バイトコードおよび2バイトコードを 混在させることが可能です。 1.5.1.1 サポートされる漢字コード DEC,IBMともにJIS X0208-1983準拠の漢字コードをサポートしま す。それぞれの詳細は,関連資料を参照してください。 1-38 ユーザーズ・ガイド ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 1.5.1.2 ライブラリ構成 コード変換ライブラリは以下のリンク・ライブラリとして提供さ れています。 /usr/i18n/usr/lib/libtra.a 1.5.1.3 リンク方法 DEC/IBMコード変換ライブラリは,日本語RJEのライセンスが無いと 動作しません。コンパイル時には以下の例のようにリンクライブ ラリにLMFライブラリを指定してください。 cc user_prog -ltra -llmf 1.5.2 コード変換ライブラリの詳細 1.5.2.1 Item List いくつかのルーチンで使用されるItem Listは各Itemごとに下記の 構造を持ちます。プログラム言語用定義ファイル内でItem List のテンプレートが設定されています。Item Listの最後にはitem code = 0(TRA_k_end_of_list)を指定しなければなりません。 図 1-6 Item List structure _______________________________________________________________ ___________reserved_______________________item_code____________ 0 |__________________________item|value__________________________| 4 | | | 1.5.2.2 Item Code 次の表は利用可能なItem Codeの一覧を示しています。記号の値は 各言語用定義ファイル内に定義されています。 ユーザーズ・ガイド 1-39 ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 表 1-1 Item Code一覧 ___________________________________________________________ Item_Code___________Item_Value______Description____________ TRA_k_end_of_list アイテムリストの終了 TRA_k_trans_mode 変換モード 変換モードの初期値を設 Bitmask 定します。Item Valueは 表 1-2を参照してくださ い。 TRA_k_asc_ebc_tbl 変換テーブルの DECからIBMへの1バイトコ 先頭アドレス ード変換テーブル(256バ イト)を設定します。 TRA_k_ebc_asc_tbl 変換テーブルの IBMからDECへの1バイトコ 先頭アドレス ード変換テーブル(256バ イト)を設定します。 TRA_k_load_sna jsnatratblユーティリ ティで作成したtbl_file をロードすることを指 定します。tbl_fileは tra_dec_ibm_initルーチ ンの2番目の引き数で指 ____________________________________定します。_____________ ________________________ 注意 ________________________ TRA_k_asc_ebc_tbl, TRA_k_ebc_asc_tblで指定される1バイ トコード変換テーブルとはプログラマがソースコード中に配 列として設定するコード変換テーブルのことを意味します。 jsnatratbleユーティリティで作成される変換テーブルでは ありませんので注意が必要です。1バイトコード変換テーブ ルの具体例については, 第1.5.4項プログラム例を参照して ください。 また, Item CodeでTRA_k_load_snaが指定されていても,同時 にTRA_k_asc_ebc_tbl, TRA_k_ebc_asc_tblが指定されていれ ば, TRA_k_load_snaの指定は無視され,プログラマがソース コード中に配列として設定するコード変換テーブルが優先的 に使用されますので御注意ください。 ______________________________________________________ 1-40 ユーザーズ・ガイド ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 1.5.2.3 変換モードBitmask TRA_k_trans_modeのItem valueはbitmaskとなっています。各フィ ールドのオフセットを表 1-2に示します。文字列の初期,最終モ ードを除くフィールドの値が1の場合,その機能を有効(enable)に します。変換モードを指定する際には必要な機能全てを設定する 必要があります。 TRA_vのかわりにTRA_mのprefixを使うことにより,各フィールド のbit mask patternを利用することができます。 表 1-2 変換モード ___________________________________________________________ Number of Bit_Offset______________bits____Description________________ TRA_v_dec_first_mode + 2 DEC文字列初期モード TRA_v_dec_last_mode + 2 DEC文字列最終モード TRA_v_dec_shift 1 DECロッキング・シフト・コー ドの解釈 TRA_v_dec_shift_ss 1 DECシングル・シフト・コード の解釈 TRA_v_ibm_first_mode + 2 IBM文字列初期モード TRA_v_ibm_last_mode + 2 IBM文字列最終モード TRA_v_ibm_shift 1 IBMシフト・コードの解釈 TRA_v_tab_expand 1 TABコードを空白コードに展開 する TRA_v_replace 1 シフト・コード位置に空白を 入れる +表_1-3参照のこと__________________________________________ ___________________________________________________________ ユーザーズ・ガイド 1-41 ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 1.5.2.3.1 文字列の初期/最終モード 文字列の初期モード 入力側ではどのような文字セットより文字列が開始されている か,出力側ではどのような文字セットとして出力を受け取るかを 規定します。 文字列の最終モード 出力側ではどのような文字セットとして出力を終了するかを規定 します。入力側においては実際の変換対象文字列に依存するため 意味をもちません。 入出力両方のシフト・コードの解釈が有効である場合,上記モー ド設定に従い必要なシフト・コードが付加されます。 変換モードbitmaskの文字列の初期/最終モードのフィールドは以 下の値をとります。 表 1-3 文字列モードの値 ___________________________________________________________ Value_____________Description______________________________ TRA_k_kanji_mode 漢字文字列モード DEC文字列においては ASCII/漢字文字列を示し ます。 IBM文字列においてはDBCS コード列を示します TRA_k_kana_mode カナ文字列モード DEC文字列においては半角 カナ文字列を示します。 IBM文字列においてはSBCS コード列を示します TRA_k_any_mode 抑制終了モード 変換終了時のモード合わ せを抑制します TRA_k_first_mode 初期モード 最終モードを文字列初期 ____________________________________モードと同じとします___ 1-42 ユーザーズ・ガイド ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 1.5.2.3.2 シフト・コード DECコード列 半角カナ・コードと漢字コードが混在する文字列において両者を 識別するために使用するシフト・コードには2種類あります。 1. ロッキング・シフト o LS2R (%x'1B7D') 半角カタカナ・コード列の前に使用します o LS3R (%x'1B7C') 漢字コード列の前に使用します DEC漢字コード・セットでは で囲まれた文字 列が半角カタカナを表現します。半角カタカナ以外の1バイ ト・コード(アルファベット等)はどちらに含まれていてもか まいません。 2. シングル・シフト o SS2 (%x'8E') 半角カタカナ・コードの直前に使用します。ロッキン グ・シフトと異なり文字単位に使用するシフト・コード です。 それぞれTRA_v_dec_shift,TRA_v_dec_shift_ssにより指定しま す。ともに設定されているときは入力時はどちらのシフト・コー ドも解釈されますが,出力においてはシングル・シフトのみ出力 対象となります。 IBMコード列 SBCSとDBCSが混在する文字列において,両者を識別するために使 用するシフト・コードは以下のとおりです。 o SO(%x'0E') 漢字コード列の前に使用します o SI(%x'0F') ユーザーズ・ガイド 1-43 ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 漢字コード列の直後に使用します 1.5.2.3.3 Replaceモード(IBMからDECへの変換の場合のみ) 入力データのシフト・コード位置に空白文字を出力します。空白 文字は%x'40'です。とりわけ漢字とアルファベットが混在するよ うな変換において,変換後のレコード長,および各文字位置を変 えないようにできます。 1.5.2.4 コード変換の例 IBM /DEC漢字コード変換は 次のような変換が行われます。 図 1-7 変換例 o IBMコードからDECコードへ 1 SO/SIコードは削除されます 2 SO/SIコード位置に空白文字が入ります 3 **サポートしていません** 4 **サポートしていません** o DECコードからIBMコードへ 1 SO/SIコードを付加します 2 **サポートしていません** 3 SO/SIコードを付加しません 4 **サポートしていません** 1-44 ユーザーズ・ガイド ユーザーズ・ガイド 1.5 DEC/IBMコード変換ライブラリ 1.5.2.5 外字の変換 ユーザ定義文字,ベンダー定義文字などのいわゆる外字の変換に はjsnaknjdefユーティリティにより作成された外字管理ファイル を利用して変換を行います。jsnaknjdefユーティリティの詳細は 本書の第1.3節を参照してください。 1.5.2.6 制限事項 シフト・コードを利用した混在文字列を入力として与えた場合, 設定されている1バイトコードテーブルの内容によらず,半角カ ナ・コードを含んだテーブルが設定されているとみなした変換が 行なわれることがあります。 1.5.2.7 DEC/IBMコード変換ルーチンのインタフェース 以下にコード変換ルーチンのインタフェースを示します。 ユーザーズ・ガイド 1-45 DEC/IBM Code translation library tra_dec_ibm_init _________________________________________________________________ tra_dec_ibm_init 変換ルーチン使用環境の初期設定を行います _________________________________________________________________ C binding tra_dec_ibm_init ( ext_file, tbl_file, context, itemlist ) _________________________________________________________________ 戻り値 状態値を返します _________________________________________________________________ 引数 char *ext_file (Input) 外字管理ファイル名 jsnaknjdefユーティリティにより作成された外字管理ファイルを 指定してユーザ定義文字,IBM付加文字の変換を行うことができま す。 char *tbl_file (Input) jsnatratblユーティリティで作成される1バイトコード変換テーブ ル・ファイル名 itemlistにTRA_k_asc_ebc_tbl, TRA_k_ebc_asc_tblを指定した場 合は,プログラマがソースコード中に配列として宣言したコード変 換テーブルを使用するものと見なされるため, tbl_fileを指定し ても無視されます。 void *context (Output) 変換コンテキスト・ハンドル 1-46 ユーザーズ・ガイド DEC/IBM Code translation library tra_dec_ibm_init 変換コンテキスト・ハンドルが返されます。以降の呼び出しにお いてこのハンドルを用います。 struct TRA_ITEM_LIST *itemlist (Input) 初期設定を行うパラメータ・リスト 指定可能なItem Codeは次の表 1-4を参照してください。 表 1-4 指定可能なItem Code ___________________________________________________________ Item_Code_______Item_Value__________Description____________ TRA_k_end_of_ アイテム・リストの終了 list TRA_k_trans_ 変換モードBitmask 変換モードの初期値を設 mode 定します。Item Valueの 詳細は表 1-2を参照して ください。 TRA_k_asc_ebc_ テーブルの先頭アド DECからIBMへの1バイ tbl レス トコード変換テーブル (256バイト)を設定しま す。tbl_fileの指定は無 視されます。 TRA_k_ebc_asc_ テーブルの先頭アド IBMからDECへの1バイ tbl レス トコード変換テーブル (256バイト)を設定しま す。tbl_fileの指定は無 視されます。 TRA_k_load_sna jsnatratblユーティリ ティで作成したtbl_file をロードすることを指 定します。tbl_fileは tra_dec_ibm_initルーチ ンの2番目の引き数で指 ____________________________________定します。_____________ ユーザーズ・ガイド 1-47 DEC/IBM Code translation library tra_dec_ibm_init ________________________ 注意 ________________________ TRA_k_asc_ebc_tbl, TRA_k_ebc_asc_tblで指定される1バイ トコード変換テーブルとはプログラマがソースコード中に配 列として設定するコード変換テーブルのことを意味します。 jsnatratblユーティリティで作成される変換テーブルではあ りませんので注意が必要です。1バイトコード変換テーブル の具体例については, 第1.5.4項プログラム例を参照してく ださい。 また, Item CodeでTRA_k_load_snaが指定されていても,同時 にTRA_k_asc_ebc_tbl, TRA_k_ebc_asc_tblが指定されていれ ば, TRA_k_load_snaの指定は無視され,プログラマがソース コード中に配列として設定するコード変換テーブルが優先的 に使用されますので御注意ください。 ______________________________________________________ _________________________________________________________________ 戻り値 TRA_s_normal 正常終了 TRA_s_extnotacc 外字管理ファイルにアクセスできません TRA_s_cantalloc 変換環境を割り当てできません _________________________________________________________________ 機能説明 o 変換テーブル無指定時は図 1-8,図 1-9が設定されます。 o 変換モード無指定時のデフォルト設定は次のとおりです。 1-48 ユーザーズ・ガイド DEC/IBM Code translation library tra_dec_ibm_init _______________________________________________________ Field___________Value__________________________________ dec_first_mode TRA_k_kanji_mode dec_last_mode TRA_k_kanji_mode dec_shift 1 ibm_first_mode TRA_k_kana_mode ibm_last_mode TRA_k_kana_mode ibm_shift_______1______________________________________ ユーザーズ・ガイド 1-49 DEC/IBM Code translation library tra_dec_ibm_free _________________________________________________________________ tra_dec_ibm_free 変換ルーチン使用環境を解放します _________________________________________________________________ C binding tra_dec_ibm_free ( context ) _________________________________________________________________ 戻り値 状態値を返します _________________________________________________________________ 引数 void *context (Input) 変換コンテキスト・ハンドル tra_dec_ibm_initにより取得したハンドルを指定します。 _________________________________________________________________ 戻り値 TRA_s_normal 正常終了 TRA_s_badctx 変換コンテキストが正しくありません TRA_s_invparam パラメータが正しくありません TRA_s_cantfree 変換環境が解放できません 1-50 ユーザーズ・ガイド DEC/IBM Code translation library tra_dec_ibm_free _________________________________________________________________ 機能説明 tra_dec_ibm_initにより取得した変換環境は,このルーチンによ り解放する必要があります。 ユーザーズ・ガイド 1-51 DEC/IBM Code translation library tra_dec_ibm _________________________________________________________________ tra_dec_ibm DECコードの文字列をIBMコードの文字列に変換します _________________________________________________________________ C binding tra_dec_ibm ( src_buf, src_len, dst_buf, dst_len, ret_len, context, itemlist ) _________________________________________________________________ 戻り値 状態値を返します _________________________________________________________________ 引数 char *src_buf (Input) 変換対象バッファの先頭アドレス 変換すべきDECコード文字列を含んだバッファ int src_len (Input) src_bufのバイト長 char *dst_str (Output) 変換結果出力バッファの先頭アドレス 変換後のIBMコード文字列を含むバッファ int dst_len (Input) dst_bufのバイト長 int *ret_len (Output) 変換結果文字列のバイト長 1-52 ユーザーズ・ガイド DEC/IBM Code translation library tra_dec_ibm void *context (Input) 変換コンテキスト・ハンドル struct TRA_ITEM_LIST *itemlist (Input) 変換時設定を行うパラメータ・リスト tra_dec_ibm_initにおいて設定した初期値を一時的に変更するこ とが可能です。初期値は変更されませんので,呼び出しごとの設 定が必要です。 指定可能なItem Codeは表 1-5を参照してください。 表 1-5 指定可能なItem Code ___________________________________________________________ Item_Code___________Description____________________________ TRA_k_end_of_list アイテム・リストの終了 TRA_k_trans_mode 変換モードを設定します。Item Valueの詳 細は 表 1-2を参照してください。 TRA_k_asc_ebc_tbl DECからIBMへの1バイトコード変換テーブル ____________________(256バイト)を設定します。______________ _________________________________________________________________ 戻り値 TRA_s_normal 正常終了 TRA_s_truncate 結果文字列の切り詰めが行なわれました (正常終了) TRA_s_invparam パラメータが正しくありません TRA_s_badctx 変換コンテキストが正しくありません ユーザーズ・ガイド 1-53 DEC/IBM Code translation library tra_dec_ibm _________________________________________________________________ 機能説明 o DEC漢字文字セット中の未定義コードは%x'44E9'('□')に変 換します。 o DEC拡張漢字文字セットのコードの変換は使用する外字管理 ファイルの設定に依存します。未定義コードは%x'44E9'('□ ')に変換します。 o 入力バッファ(src_buf),出力バッファ(dst_buf)が同じ文字 列領域を指示していた場合の変換結果は不定です。 o 変換対象文字列に漢字および半角カナ・コードが混在する場 合には,それぞれを識別するためにシフト・コードにより明 示されている必要があります(シフト・コードとしてロッキ ング・シフト( LS2R,LS3R )またはシングル・シフト( SS2 )を使用します)。 o 正しい変換結果を得るためには変換モード設定および1バイ トコード変換テーブルが適切に設定されている必要がありま す。 1-54 ユーザーズ・ガイド DEC/IBM Code translation library tra_ibm_dec _________________________________________________________________ tra_ibm_dec IBMコードの文字列をDECコードの文字列に変換します _________________________________________________________________ C binding tra_ibm_dec ( src_buf, src_len, dst_buf, dst_len, ret_len, context, itemlist ) _________________________________________________________________ 戻り値 状態値を返します _________________________________________________________________ 引数 char *src_buf (Input) 変換対象バッファの先頭アドレス 変換すべきIBMコード文字列を含んだバッファ int src_len (Input) src_bufのバイト長 char *dst_str (Output) 変換結果出力バッファの先頭アドレス 変換後のDECコード文字列を含むバッファ int dst_len (Input) dst_bufのバイト長 int *ret_len (Output) 変換結果文字列のバイト長 ユーザーズ・ガイド 1-55 DEC/IBM Code translation library tra_ibm_dec void *context (Input) 変換コンテキスト・ハンドル struct TRA_ITEM_LIST *itemlist (Input) 変換時設定を行うパラメータ・リスト tra_ibm_dec_initにおいて設定した初期値を一時的に変更するこ とが可能です。初期値は変更されませんので,呼び出しごとの設 定が必要です。 指定可能なItem Codeは表 1-6を参照してください。 表 1-6 指定可能なItem Code ___________________________________________________________ Item_Code___________Description____________________________ TRA_k_end_of_list アイテム・リストの終了 TRA_k_trans_mode 変換モードを設定します。Item Valueの詳 細は表 1-2を参照してください。 TRA_k_ebc_asc_tbl IBMからDECへの1バイトコード変換テーブル ____________________(256バイト)を設定します。______________ _________________________________________________________________ 戻り値 TRA_s_normal 正常終了 TRA_s_truncate 結果文字列の切り詰めが行なわれました (正常終了) TRA_s_invparam パラメータが正しくありません TRA_s_badctx 変換コンテキストが正しくありません 1-56 ユーザーズ・ガイド DEC/IBM Code translation library tra_ibm_dec _________________________________________________________________ 機能説明 o 未定義漢字コードは%x'A2A2'('□')に変換します。 o ユーザ定義文字,IBM付加文字コードの変換は使用する 外字管理ファイルの設定に依存します。未定義コード は%x'A2A2'('□')に変換します。 o 入力バッファ(src_buf),出力バッファ(dst_buf)が同じ文字 列領域を指示していた場合の変換結果は不定です。 o 正しい変換結果を得るためには変換モード設定および1バイ トコード変換テーブルが適切に設定されている必要がありま す。 ユーザーズ・ガイド 1-57 ユーザーズ・ガイド tra_ibm_dec 1.5.3 省略時変換テーブル 図 1-8 DEC -> IBM 1バイトコード変換テーブル 0 1 2 3 4 5 6 7 8 9 A B C D E F -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 0 00 10 40 F0 7C D7 79 D7 - - - 58 91 A5 - - 1 01 11 4F F1 C1 D8 C1 D8 - - 41 81 92 A6 - - 2 02 12 7F F2 C2 D9 C2 D9 - - 42 82 93 A7 - - 3 03 13 7B F3 C3 E2 C3 E2 - - 43 83 94 A8 - - 4 37 3C E0 F4 C4 E3 C4 E3 - - 44 84 95 A9 - - 5 2D 3D 6C F5 C5 E4 C5 E4 - - 45 85 96 AA - - 6 2E 32 50 F6 C6 E5 C6 E5 - - 45 86 97 AC - - 7 2F 26 7D F7 C7 E6 C7 E6 - - 47 87 98 AD - - 8 16 18 4D F8 C8 E7 C8 E7 - - 48 88 99 AE - - 9 05 19 5D F9 C9 E8 C9 E8 - - 49 89 9A AF - - A 25 - 5C 7A D1 E9 D1 E9 - - 51 8A 9D BA - - B 0B 27 4E 5E D2 C0 D2 C0 - - 52 8C 9E BB - - C 0C 1C 6B 4C D3 6A D3 6A - - 53 8D 9F BC - - D 0D 1D 60 7E D4 D0 D4 D0 - - 54 8E A2 BD - - E 0E 1E 4B 6E D5 A1 D5 A1 - - 55 8F A3 BE - - F 0F 1F 61 6F D6 07 D6 07 - - 56 90 A4 BF - - ---------------------------------------------------- ※ '-'は %x'3F' 1-58 ユーザーズ・ガイド ユーザーズ・ガイド tra_ibm_dec 図 1-9 IBM -> DEC 1バイトコード変換テーブル 0 1 2 3 4 5 6 7 8 9 A B C D E F -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 0 00 10 - - 20 26 2D - - BF - - 7B 7D 24 30 1 01 11 - - A1 AA 2F - B1 C0 7E - 41 4A - 31 2 02 12 - 16 A2 AB - - B2 C1 CD - 42 4B 53 32 3 03 13 - - A3 AC - - B3 C2 CE - 43 4C 54 33 4 - - - - A4 AD - - B4 C3 CF - 44 4D 55 34 5 09 - 0A - A5 AE - - B5 C4 D0 - 45 4E 56 35 6 - 08 17 - A6 AF - - B6 C5 D1 - 46 4F 57 36 7 7F - 1B 04 A7 - - - B7 C6 D2 - 47 50 58 37 8 - 18 - - A8 B0 - - B8 C7 D3 - 48 51 59 38 9 - 19 - - A9 - - 60 B9 C8 D4 - 49 52 5A 39 A - - - - 5B 5D 7C 3A BA C9 D5 DA - - - - B 0B - - - 2E - 2C 23 - - - DB - - - - C 0C 1C - 14 3C 2A 25 40 BB - D6 DC - - - - D 0D 1D 05 15 28 29 5F 27 BC CA D7 DD - - - - E 0E 1E 06 - 2B 3B 3E 3D BD CB D8 DE - - - - F 0F 1F 07 1A 21 5E 3F 22 BE CC D9 DF - - - FF ---------------------------------------------------- ※ '-'は %x'1A' ユーザーズ・ガイド 1-59 ユーザーズ・ガイド tra_ibm_dec 1.5.4 プログラム例 DEC/IBMコード変換ライブラリの使用例 /* **++ ** ** Sample proram for DEC/IBM code-conversion library ** **-- */ #include #include "tra_def.h" #define TRUE 1 #define FALSE 0 #define BUF_SIZ 256 static unsigned char dec_string[] = "Dec 漢字コード JIS X0208-1983 準拠" ; main () { int status; long context; struct TRA_ITEM_LIST item[2]; struct TRA_MODE *tmode; char ibm_buf[BUF_SIZ], dec_buf[BUF_SIZ]; int ret_len ; /* Init Item list */ item[0].TRA_w_code = TRA_k_trans_mode; item[0].TRA_l_value = 0; item[1].TRA_w_code = TRA_k_end_of_list; /* Define translation mode */ 1-60 ユーザーズ・ガイド ユーザーズ・ガイド tra_ibm_dec tmode = (struct TRA_MODE *)(&item[0].TRA_l_value); tmode->TRA_v_dec_first_mode = TRA_k_kanji_mode; tmode->TRA_v_dec_last_mode = TRA_k_kanji_mode; tmode->TRA_v_dec_shift = TRUE; tmode->TRA_v_ibm_first_mode = TRA_k_kana_mode; tmode->TRA_v_ibm_last_mode = TRA_k_kana_mode; tmode->TRA_v_ibm_shift = TRUE; /* INITialization */ status = tra_dec_ibm_init ( "", "", (&context), item ); printf( "INIT %x\n", status ); /* DEC -> IBM translation */ status = tra_dec_ibm ( dec_string, strlen(dec_string), ibm_buf, BUF_SIZ, &ret_len, &context, 0) ; printf( "DEC -> IBM %x (%d bytes)\n", status, ret_len ); ibm_buf[ret_len] = 0; /* IBM -> DEC translation */ status = tra_ibm_dec ( ibm_buf, (unsigned short)ret_len, dec_buf, BUF_SIZ, &ret_len, &context, 0) ; printf( "IBM - > DEC %x (%d bytes)\n", status, ret_len ); dec_buf[ret_len] = 0; /* Output Before & After */ printf( "前 : %s\n", dec_string ); printf( "後 : %s\n", dec_buf ); /* Release context */ status = tra_dec_ibm_free ( &context ); printf( "FREE %x\n", status ); } ユーザーズ・ガイド 1-61 ユーザーズ・ガイド tra_ibm_dec 1バイトコード変換テーブル(配列)の定義例 /* **++ ** ** DEC-->IBM ** 1-byte code-conversion table example ** **-- */ unsigned char asc_ebc_tbl[256] = { 0x00, 0x01, 0x02, 0x03, 0x37, 0x2d, 0x2e, 0x2f, 0x16, 0x05, 0x25, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f, 0x10, 0x11, 0x12, 0x13, 0x3c, 0x3d, 0x32, 0x26, 0x18, 0x19, 0x3f, 0x27, 0x1c, 0x1d, 0x1e, 0x1f, 0x40, 0x4f, 0x7f, 0x7b, 0xe0, 0x6c, 0x50, 0x7d, 0x4d, 0x5d, 0x5c, 0x4e, 0x6b, 0x60, 0x4b, 0x61, 0xf0, 0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8, 0xf9, 0x7a, 0x5e, 0x4c, 0x7e, 0x6e, 0x6f, 0x7c, 0xc1, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xc0, 0x6a, 0xd0, 0xa1, 0x07, 0x79, 0xc1, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xc0, 0x6a, 0xd0, 0xa1, 0x07, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x58, 0x81, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89, 0x8a, 0x8c, 0x8d, 0x8e, 0x8f, 0x90, 0x91, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9a, 0x9d, 0x9e, 0x9f, 0xa2, 0xa3, 0xa4, 0xa5, 0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xac, 0xad, 0xae, 0xaf, 0xba, 0xbb, 0xbc, 0xbd, 0xbe, 0xbf, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 1-62 ユーザーズ・ガイド ユーザーズ・ガイド tra_ibm_dec 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f, 0x3f }; ユーザーズ・ガイド 1-63 ユーザーズ・ガイド tra_ibm_dec /* **++ ** ** IBM-->DEC ** 1-byte code-conversion table example ** **-- */ unsigned char ebc_asc_tbl[256] = { 0x00, 0x01, 0x02, 0x03, 0x1a, 0x09, 0x1a, 0x7f, 0x1a, 0x1a, 0x1a, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f, 0x10, 0x11, 0x12, 0x13, 0x1a, 0x1a, 0x08, 0x1a, 0x18, 0x19, 0x1a, 0x1a, 0x1c, 0x1d, 0x1e, 0x1f, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x0a, 0x17, 0x1b, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x05, 0x06, 0x07, 0x1a, 0x1a, 0x16, 0x1a, 0x1a, 0x1a, 0x1a, 0x04, 0x1a, 0x1a, 0x1a, 0x1a, 0x14, 0x15, 0x1a, 0x1a, 0x20, 0xa1, 0xa2, 0xa3, 0xa4, 0xa5, 0xa6, 0xa7, 0xa8, 0xa9, 0x5b, 0x2e, 0x3c, 0x28, 0x2b, 0x21, 0x26, 0xaa, 0xab, 0xac, 0xad, 0xae, 0xaf, 0x1a, 0xb0, 0x1a, 0x5d, 0x1a, 0x2a, 0x29, 0x3b, 0x5e, 0x2d, 0x2f, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x7c, 0x2c, 0x25, 0x5f, 0x3e, 0x3f, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x60, 0x3a, 0x23, 0x40, 0x27, 0x3d, 0x22, 0x1a, 0xb1, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6, 0xb7, 0xb8, 0xb9, 0xba, 0x1a, 0xbb, 0xbc, 0xbd, 0xbe, 0xbf, 0xc0, 0xc1, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0x1a, 0x1a, 0xca, 0xcb, 0xcc, 0x1a, 0x7e, 0xcd, 0xce, 0xcf, 0xd0, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0x1a, 0xd6, 0xd7, 0xd8, 0xd9, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0xda, 0xdb, 0xdc, 0xdd, 0xde, 0xdf, 0x7b, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x7d, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f, 0x50, 0x51, 0x52, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x24, 0x1a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59, 0x5a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 1-64 ユーザーズ・ガイド ユーザーズ・ガイド tra_ibm_dec 0x38, 0x39, 0x1a, 0x1a, 0x1a, 0x1a, 0x1a, 0xff }; ユーザーズ・ガイド 1-65 2 _________________________________________________________________ 日本語RJEのインストレーション この章では,setldインストレーション・プロシージャを使用して OSF/1システム上に日本語RJEをインストールする方法について説 明します。第2.9節では,インストレーション時に作成される日本 語RJEファイルについて,第2.10節では,システム上で実行される インストレーションについて説明します。 _________________________________________________________________ 2.1 インストレーション必要事項の確認 表 2-1を参照して,ホスト・システムが必要なすべてのソフトウ ェア,十分なディスク領域,ならびにDEC SNA Gateway製品のいず れか1つをアクセスする能力を備えているかどうかを確認してく ださい。 表 2-1 日本語RJEのインストレーション必要事項 ___________________________________________________________ 必要事項______________項目_________________________________ 配布メディア CD-ROM 必須ソフトウェア OSF/1 V3.0A 以下のDEC SNA Gateway製品の内,いずれ か1つが必要 DEC SNA Peer Server V1.2 DECnet/SNA Gateway-ST V1.2A DECnet/SNA Gateway-CT V2.1A 特権 スーパーユーザ・レベル ___________________________________________________________ (次ページに続く) 日本語RJEのインストレーション 2-1 日本語RJEのインストレーション 2.1インストレーション必要事項の確認 表 2-1 (続き) 日本語RJEのインストレーション必要事項 ___________________________________________________________ 必要事項______________項目_________________________________ ディスク・スぺース 650 KB インストレーションに 約5〜10分 必要な時間 PAK___________________ソフトウェア・ライセンス_____________ ________________________ 注意 ________________________ 本書における'DEC SNA Gateway'とは,特に断らない限り, DEC SNA Peer Server, DECnet/SNA Gateway-ST ,DECnet/SNA Gateway-CTを意味します。 ______________________________________________________ _________________________________________________________________ 2.2 必須ソフトウェア・サブセットの確認 日本語RJEをインストールする前に,表 2-1に示すソフトウェアが インストールされていなければなりません。 次の表 2-2に,日本語DEC OSF/1の必要なサブセットを示します。 表 2-2 必要なサブセット ___________________________________________________________ サブセット______説明_______________________________________ _________________日本語DEC_OSF/1サブセット_________________ OSFBASEnnn Base System OSFDCMTnnn______Preparation_Tools__________________________ 2-2 日本語RJEのインストレーション 日本語RJEのインストレーション 2.2必須ソフトウェア・サブセットの確認 ________________________ 注意 ________________________ o nnnは現在のメジャーバージョンと現在のメンテナンス バージョンを示します。 o OSFDCMTnnnは日本語リファレンス・ページをインスト ールする時に必要となるサブセットです。 o トランスポートとしてDECnetを使用する場合, DECnet/OSI(DNABASEnnn)が必要です。 ______________________________________________________ 表 2-2のサブセットがシステムにインストールされているかどう かを調べるには,日本語RJEをインストールする予定のシステムに ログインし,次のコマンドを入力してください。 # /etc/setld -i | grep subset-name subset- 検索するサブセット名 name DEC OSF/1環境で,レイヤード製品をインストールする場合の詳細 については,日本語DEC OSF/1 AXPのドキュメントを参照してくだ さい。 インストレーションに必要な時間は,システム構成にもよります が,約5〜10分必要です。 _________________________________________________________________ 2.3 IBMホスト・システムへのアクセスについて IBMシステムとのファイルの送受信は,DEC SNA Gatewayを介して標 準版RJEが行います。 DEC SNA Gateway及び標準版RJEのインストールに関する詳細は, 各製品のインストレーション・ガイドを参照してください。 日本語RJEのインストレーション 2-3 日本語RJEのインストレーション 2.4システム・ディスクのバックアップ _________________________________________________________________ 2.4 システム・ディスクのバックアップ ソフトウェアをインストールする前に,システム・ディスクのバ ックアップをとっておくことをお勧めします。このためには,そ れぞれのサイトで設定されたバックアップ・プロシージャを使用 してください。システム・ディスク・バックアップの実行方法に ついては,OSF/1のドキュメントを参照してください。 _________________________________________________________________ 2.5 ライセンスPAKの登録 日本語RJEプロダクトは,OSF/1ライセンス管理機能(LMF)をサポ ートしています。新しくライセンスが承認されたノードで日本 語RJEを使用するには,ライセンス・データベース(LDB)にライ センス・プロダクト・オーソライゼイション・キー(ライセンス PAK=Product Authorization Key)を登録しなければなりません。 ライセンスとメディアを一緒に注文した場合は,ライセンスPAKが キットと共に配布されます。それ以外の場合には,PAKはライセン ス注文書に示された場所に別個に配布されます。すでにライセン スをもっているノード上に更新として日本語RJEをインストールす る場合には,ライセンスPAK登録は既に完了しています。 第2.7節では,PAKの登録方法について説明します。詳しくは, 『DEC OSF/1 Guide to Software Licensing』またはリファレン ス・ページのlmf(8)を参照してください. 2.5.1 標準版RJEのライセンスについて 標準版RJEをインストールし起動するためには,日本語RJEと同様 に標準版RJEのライセンスをシステムに登録しておかなければなり ません。標準版RJEのライセンスの登録及びキーのロードは,日本 語RJEをインストールすることにより自動的に行なわれます。従っ て,標準版RJEのインストールは,日本語RJEのインストール後に 行うようにしてください。 2-4 日本語RJEのインストレーション 日本語RJEのインストレーション 2.5ライセンスPAKの登録 ________________________ 注意 ________________________ もし日本語RJEをインストールする前に既に標準版RJEのフィ ールドテスト用のPAKまたはTSP(Temporary Service PAK)が 登録されている場合は,LICENSEコマンドを用いてそれらを UNLOADかつDISABLEの状態にしておいてください。これらの PAKが有効になっていると,正式なPAKが登録されません。 ______________________________________________________ _________________________________________________________________ 2.6 問題点の通知 本ソフトウェアについては,日本DEC所定のソフトウェア保証基準 に定められた保証が提供されますので,その内容にしたがった処 置をとってください。 なお,ご不明な点につきましては,日本DECの各支店/営業所にお 問い合せください。 _________________________________________________________________ 2.7 インストレーション方法 ソフトウェアをインストールするには,setld インストレーシ ョン・プロシージャを使用します。このプロシージャを実行する と,一連の質問とともにプロンプトが出されます。ほとんどのプ ロンプトは,肯定(yまたはY)または否定(nまたはN)の答を求 めるものです。を入力すれば,いつでもインストレーシ ョン・プロシージャを中断できます。 OSF/1ホストに配布キットをインストールするには,スーパーユー ザ・アカウントにログインすることが必要です。 2.7.1 CD-ROMからのインストレーション 日本語RJEをインストールするには、配布キットのCD-ROMをマウン トしてから、setldインストレーション・プロシージャを使用しま す。以下に、詳細にそのプロシージャを記載します。 1. まず、CD-ROM中の日本語RJEのファイルのロケーションを確 認します。CD-ROMに含まれるファイルの一覧については、 日本語RJEのインストレーション 2-5 日本語RJEのインストレーション 2.7インストレーション方法 Consolidated Software Distribution Disk User's Guideの 索引表を参照してください。 2. CD-ROMをCDドライブに設置し、CDドライブのデバイス名でマ ウントします。 # mount -r -d /dev/dev_name /mnt dev_name CDドライブのデバイス名 3. setldインストレーション・プロシージャを使用して日本語 RJEをインストールします。 # setld -l /usr/public/cdrom/condist/jaxp/SJR100/kit インストレーション・プロシージャは次のメッセージを表示 します。 Please make sure your installation tape is mounted and on-line. Are you ready? (y/n) 標準版RJEのライセンスの登録 インストレーション中にIVPの実行を行うと以下のようなメ ッセージが表示されます。 This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows. % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: No entry in license database for this product 2-6 日本語RJEのインストレーション 日本語RJEのインストレーション 2.7インストレーション方法 Registering SNA-RJE license Loading SNA-RJE DEC SNA RJE PAK (English) installation completed. もし,登録されている標準版RJEのPAKがフィールド・テスト 用のPAKまたはTSP(Temporary Service PAK)である場合は,日 本語RJEのインストール前に,それらがunloadかつdisableの 状態でなくてはなりません。そうでない場合は,全てのサブ セットにおいて以下のメッセージが表示され,インストール が中止されます。 DEC SNA RJE PAK (English) installation failed. **************************************** * XXXXXXXnnn installation failed * **************************************** 上のメッセージのXXXXXXXnnnには各サブセット名が入りま す。この場合は, lmfコマンドによりunload, disableにした 後,再び最初からインストールを行ってください。 問題が無ければ,インストールは続行されます。自動的に標 準版RJEのライセンスが登録され,かつキーがロードされま す。 登録されると,以下のメッセージが表示されます。 DEC SNA RJE PAK (English) installation completed. 以降のサブセットのインストール時,及びすでに標準版RJEの 正式なライセンスが登録されている場合には,次のメッセー ジを表示します。 DEC SNA RJE PAK (English) has already installed. 以上で標準版RJE及び日本語RJEのライセンス登録及びLOADが 終了したことになります。ここで登録されたPAKは正式なも のですので,再び日本語RJEのインストールを最初から行う場 合でも,これをunload, disableしておく必要はありません。 日本語RJEのインストレーション 2-7 日本語RJEのインストレーション 2.7インストレーション方法 サブセットの選択 インストレーションを続ける場合は,yを入力します。プロ シージャは以下に示す,メッセージとサブセット・メニュー を表示します。 DEC SNA Remote Job Entry/Japanese for DEC OSF/1, V1.0 Copyright Digital Equipment Corporation. 1995. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DEC/IBM Code conv Man Pages 2) DEC/IBM Code conv Utility 3) DEC/IBM DBCS TRA Library 4) DEC/IBM DBCS TRA Man Pages 5) DEC/IBM ext-KANJI def Man Pages 6) DEC/IBM ext-KANJI def Utility 7) EBCDIC-ASCII Transtable Man Pages 8) EBCDIC-ASCII Transtable Utility Or you may choose one of the following options: 9) ALL of the above 10) CANCEL selections and redisplay menus 11) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 9 インストレーションを続行する場合は,1〜11のオプション を選択します。 o 1を選択すると,jsnacodeユーティリティのオンライ ン・リファレンス・ページ(マニュアル・ページ)をイ ンストールします。 2-8 日本語RJEのインストレーション 日本語RJEのインストレーション 2.7インストレーション方法 o 2を選択すると,jsnacodeユーティリティのイメージを インストールします。 o 3を選択すると,DEC/IBMコード変換ライブラリをインス トールします。 o 4を選択すると,DEC/IBMコード変換ライブラリのオンラ イン・リファレンス・ページ(マニュアル・ページ)を インストールします。 o 5を選択すると,jsnaknjdefユーティリティのイメージ をインストールします。 o 6を選択すると,jsnaknjdefユーティリティのオンライ ン・リファレンス・ページ(マニュアル・ページ)をイ ンストールします。 o 7を選択すると,jsnatratblユーティリティのイメージ をインストールします。 o 8を選択すると,jsnatratblユーティリティのオンライ ン・リファレンス・ページ(マニュアル・ページ)をイ ンストールします。 o 9を選択すると,1)から8)の全てを指定したことにな り,日本語RJEのすべての機能を利用できます。 o 10を選択すると,再びメニュー画面を表示し,最初から 選択をやり直すことができます。 o 11を選択すると,サブセットのインストールを行わず に,プロシージャを終了します。 サブセットの確認 もし,1〜11を選択すると,インストールするサブセットの 一覧を表示し,利用者が行った選択が正しいかどうか,質問 があります。例えば,9を選択した場合には,次のメッセー ジが表示されます。 You are installing the following optional subsets: DEC/IBM Code conv Man Pages DEC/IBM Code conv Utility DEC/IBM DBCS TRA Library DEC/IBM DBCS TRA Man Pages DEC/IBM ext-KANJI def Man Pages DEC/IBM ext-KANJI def Utility EBCDIC-ASCII Transtable Man Pages EBCDIC-ASCII Transtable Utility 日本語RJEのインストレーション 2-9 日本語RJEのインストレーション 2.7インストレーション方法 Is this correct? (y/n): y yを入力すると,インストレーション・プロシージャはそれ ぞれのサブセット毎にコピーと確認を実施します。nを入力 すると,再びサブセットの一覧を表示します。次の例は,9 を選択し,実行した結果として表示されるメッセージです。 Checking file system space required to install selected subsets: File system space checked OK. DEC/IBM ext-KANJI def Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM ext-KANJI def Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM Code conv Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM Code conv Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM DBCS TRA Library Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM DBCS TRA Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying EBCDIC-ASCII Transtable Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying EBCDIC-ASCII Transtable Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying Creating softlinks for SNJAKDEF210 ... done. 2-10 日本語RJEのインストレーション 日本語RJEのインストレーション 2.7インストレーション方法 インストレーション中のIVPの実行 インストレーション・プロシージャの一部として,インスト レーション検証プロシジャ(IVP)を実行することをお勧め します。各サブセットのinstall中に次の例のようなプロン プトが表示されますので, IVPを実行する場合にはyを入力し ます。 Would you like to run IVP for SNJAKDEF210? (y/n) [y]: IVPが成功すると次の例のようなメッセージが表示されま す。 IVP for SNJAKDEF210 finished successfully. IVPが失敗すると次の例のようなメッセージが表示されま す。 IVP for SNJAKDEF210 failed. 2.7.2 IVPの実行方法 日本語RJEソフトウェア・サブセットをインストールした後であれ ば,いつでもインストレーション検証プロシージャ(IVP)を実行で きます。そのためには,スーパーユーザとしてログインしなけれ ばなりません。setld -vと入力した後に,次の例に示すように, 確認したいサブセット名を入力します。 setld -v SJRCODE100 SJRCMAN100 この例でわかるように,一度に複数のサブセットの名前を指定す ることができます。それぞれのサブセット名は大文字で指定し, スペースで区切るようにします。IVPを正しく実行できた例を次に 示します。 setld -v SJRCMAN100 DEC SNA PrE/J Man Pages (SJRCMAN100) Beginning the IVP for SJRCMAN100 Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRCMAN100 finished successfully DEC SNA PrE/J Man Pages V1.0 日本語RJEのインストレーション 2-11 日本語RJEのインストレーション 2.7インストレーション方法 2.7.3 IVPが失敗した場合 IVPが失敗した場合には,次のようなメッセージが出されます。 DEC SNA PrE/J Man Pages (SJRCMAN100) Beginning the IVP for SJRCMAN100 Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRCMAN100 failed. DEC SNA PrE/J Man Pages V1.0 _________________________________________________________________ 2.8 内部コマンド・テーブルの再構築 日本語RJEをインストールしたら,OSF/1スーパーユーザ・プロン プトに対して rehashコマンドを入力します。このコマンドは, パスにあるディレクトリに存在する内部コマンド・テーブルを再 構築するようにOSF/1シェルに指示します。このコマンドについ ては,『OSF/1 Reference Pages』のrehash(1)を参照してくださ い。 # rehash _________________________________________________________________ 2.9 インストレーション後の日本語RJEファイルの配置 setldインストレーション・プロシージャは,日本語RJEファイル をシステム上に配置します。表 2-3は,日本語RJEファイルと説明 を一覧にしたもので,それぞれの位置も示してあります。 表 2-3 日本語RJEファイル _________________________________________________________________ ディレクトリおよびファイル名______説明___________________________ サブセットSJRTRA100______________________________________________ /usr/i18n/usr/lib/libtra.a DEC/IBMコード変換ライブラリ _________________________________________________________________ (次ページに続く) 2-12 日本語RJEのインストレーション 日本語RJEのインストレーション 2.9インストレーション後の日本語RJEファイルの配置 表 2-3 (続き) 日本語RJEファイル _________________________________________________________________ ディレクトリおよびファイル名______説明___________________________ サブセットSJRTRA100______________________________________________ /usr/i18n/usr/include/sna/tra_ DEC/IBMコード変換ライブラリ用ヘ def.h ッダー・ファイル /usr/lib/sna/ja_JP/tra_sample.c DEC/IBMコード変換ライブラリ用サ ンプル・プログラム _________________________________________________________________ DEC/IBMコード変換ライブラリ・リ サブセットSJRTRMAN100_____________ファレンス・ページ_____________ /usr/i18n/usr/share/ja_ JP.deckanji/man/man3/tra_dec_ ibm_init.3 /usr/i18n/usr/share/ja_ JP.deckanji/man/man3/tra_dec_ ibm_free.3 /usr/i18n/usr/share/ja_ JP.deckanji/man/man3/tra_ibm_ dec.3 /usr/i18n/usr/share/ja_ JP.deckanji/man/man3/tra_dec_ ibm.3 _________________________________________________________________ サブセットSNJAKDEF210____________________________________________ /usr/i18n/usr/bin/jsnaknjdef jsnaknjdefユーティリティ _________________________________________________________________ (次ページに続く) 日本語RJEのインストレーション 2-13 日本語RJEのインストレーション 2.9インストレーション後の日本語RJEファイルの配置 表 2-3 (続き) 日本語RJEファイル _________________________________________________________________ _________________________________________________________________ サブセットSNJAKDMAN210___________________________________________ /usr/i18n/usr/share/ja_ jsnaknjdef日本語リファレンス・ JP.deckanji/man/man8 ページ /jsnaknjdef.8 _________________________________________________________________ サブセットSJRCODE100_____________________________________________ /usr/i18n/usr/bin/jsnacode jsnacodeユーティリティ /usr/lib/sna/ja_JP jsnacodeユーティリティ・1バイ /jsnarjetra.tbl トコード変換テーブル /usr/lib/sna/ja_JP 日本語RJE用1バイトコード変換テ /jsnarjetra.mar ーブル・テンプレート・ファイル _________________________________________________________________ サブセットSJRCMAN100_____________________________________________ /usr/i18n/usr/share/ja_ jsnacodeユーティリティ日本語リ JP.deckanji/man/man1/jsnacode.1 ファレンス・ページ _________________________________________________________________ サブセットSJRTTBL100_____________________________________________ /usr/i18n/usr/bin/jsnatratbl jsnatratblユーティリティ _________________________________________________________________ サブセットSJRTTMAN100____________________________________________ /usr/i18n/usr/share/ja_ jsnatratblユーティリティ・日本 JP.deckanji/man/man8 語リファレンス・ページ /jsnatratbl.8____________________________________________________ 2-14 日本語RJEのインストレーション 日本語RJEのインストレーション 2.10インストレーション例 _________________________________________________________________ 2.10 インストレーション例 ここでは,日本語RJEのインストレーション例を示します。これ はインストレーションの一例ですので,実際のインストレーショ ン・プロシージャは多少異なることに注意してください。 # setld -l /usr/public/cdrom/condist/jaxp/SJR100/kit DEC SNA Remote Job Entry/Japanese for DEC OSF/1, V1.0 Copyright Digital Equipment Corporation. 1995. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DEC/IBM Code conv Man Pages 2) DEC/IBM Code conv Utility 3) DEC/IBM DBCS TRA Library 4) DEC/IBM DBCS TRA Man Pages 5) DEC/IBM ext-KANJI def Man Pages 6) DEC/IBM ext-KANJI def Utility 7) EBCDIC-ASCII Transtable Man Pages 8) EBCDIC-ASCII Transtable Utility Or you may choose one of the following options: 9) ALL of the above 10) CANCEL selections and redisplay menus 11) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 9 You are installing the following optional subsets: 日本語RJEのインストレーション 2-15 日本語RJEのインストレーション 2.10インストレーション例 DEC/IBM Code conv Man Pages DEC/IBM Code conv Utility DEC/IBM DBCS TRA Library DEC/IBM DBCS TRA Man Pages DEC/IBM ext-KANJI def Man Pages DEC/IBM ext-KANJI def Utility EBCDIC-ASCII Transtable Man Pages EBCDIC-ASCII Transtable Utility Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. DEC/IBM ext-KANJI def Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM ext-KANJI def Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM Code conv Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM Code conv Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM DBCS TRA Library Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying DEC/IBM DBCS TRA Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying EBCDIC-ASCII Transtable Utility Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying EBCDIC-ASCII Transtable Man Pages Copying from /usr/public/cdrom/condist/jaxp/SJR100/kit (disk) Verifying 2-16 日本語RJEのインストレーション 日本語RJEのインストレーション 2.10インストレーション例 This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: No entry in license database for this product Registering SNA-RJE license Loading SNA-RJE DEC SNA RJE PAK (English) installation completed. Creating softlinks for SNJAKDEF210 ... done. Would you like to run IVP for SNJAKDEF210? (y/n) [y]: Beginning the IVP for SNJAKDEF210... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SNJAKDEF210 finished successfully. DEC/IBM ext-KANJI def Utility Configuring "DEC/IBM ext-KANJI def Utility" (SNJAKDEF210) This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE 日本語RJEのインストレーション 2-17 日本語RJEのインストレーション 2.10インストレーション例 Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Creating softlinks for SNJAKDMAN210 ... done. Would you like to run IVP for SNJAKDMAN210? (y/n) [y]: Beginning the IVP for SNJAKDMAN210... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SNJAKDMAN210 finished successfully. DEC/IBM ext-KANJI def Man Pages Configuring "DEC/IBM ext-KANJI def Man Pages" (SNJAKDMAN210) ********************* N O T E *********************** * * * You must register a licensed DEC SNA Remote Job Entry * * /Japanese for DEC OSF/1 PAK first before you can * * begin using the CODE CONV UTIL. * * * * After the installation, please modify the template to * * include your specific PAK data, register, and load * * the license with the following commands: * * * * lmf register /usr/var/adm/lmf/SNA-RJE-OA-JAPAN * * lmf reset * * * ********************************************************** [ Press the RETURN key to continue ]: This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE 2-18 日本語RJEのインストレーション 日本語RJEのインストレーション 2.10インストレーション例 Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Creating softlinks for SJRCODE100 ... done. Would you like to run IVP for SJRCODE100? (y/n) [y]: Beginning the IVP for SJRCODE100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRCODE100 finished successfully. DEC/IBM Code conv Utility Configuring "DEC/IBM Code conv Utility" (SJRCODE100) This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Creating softlinks for SJRCMAN100 ... done. Would you like to run IVP for SJRCMAN100? (y/n) [y]: Beginning the IVP for SJRCMAN100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRCMAN100 finished successfully. DEC/IBM Code conv Man Pages Configuring "DEC/IBM Code conv Man Pages" (SJRCMAN100) 日本語RJEのインストレーション 2-19 日本語RJEのインストレーション 2.10インストレーション例 ********************* N O T E *********************** * * * You must register a licensed DEC SNA Remote Job Entry * * /Japanese for DEC OSF/1 PAK first before you can * * begin using the TRA Library. * * * * After the installation, please modify the template to * * include your specific PAK data, register, and load * * the license with the following commands: * * * * lmf register /usr/var/adm/lmf/SNA-RJE-OA-JAPAN * * lmf reset * * * ********************************************************** [ Press the RETURN key to continue ]: This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Creating softlinks for SJRTRA100 ... done. Would you like to run IVP for SJRTRA100? (y/n) [y]: Beginning the IVP for SJRTRA100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRTRA100 finished successfully. DEC/IBM DBCS TRA Library Configuring "DEC/IBM DBCS TRA Library" (SJRTRA100) 2-20 日本語RJEのインストレーション 日本語RJEのインストレーション 2.10インストレーション例 This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Creating softlinks for SJRTRMAN100 ... done. Would you like to run IVP for SJRTRMAN100? (y/n) [y]: Beginning the IVP for SJRTRMAN100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRTRMAN100 finished successfully. DEC/IBM DBCS TRA Man Pages Configuring "DEC/IBM DBCS TRA Man Pages" (SJRTRMAN100) This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: 日本語RJEのインストレーション 2-21 日本語RJEのインストレーション 2.10インストレーション例 DEC SNA RJE PAK (English) has already installed. Creating softlinks for SJRTTBL100 ... done. Would you like to run IVP for SJRTTBL100? (y/n) [y]: Beginning the IVP for SJRTTBL100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRTTBL100 finished successfully. EBCDIC-ASCII Transtable Utility Configuring "EBCDIC-ASCII Transtable Utility" (SJRTTBL100) Creating softlinks for SJRTTMAN100 ... done. This procedure will register and load the Product Authorization Key (PAK) for the software product DEC SNA RJE for DEC OSF/1 V1.0. Please disregard the instructions in your Installation Guide for loading and registering the PAK for this product (SNA-RJE). This procedure supercedes those instructions. Before beginning this procedure, you must first unload and disable any existing Field Test PAKs or Temporary Service PAKs. The commands to do this are as follows: % lmf unload 0 SNA-RJE % lmf disable SNA-RJE Please unload and disable all Field Test SNA-RJE Licences before continuing this installation. [ Press the RETURN key to continue ]: DEC SNA RJE PAK (English) has already installed. Would you like to run IVP for SJRTTMAN100? (y/n) [y]: Beginning the IVP for SJRTTMAN100... Copyright Digital Equipment Corporation. 1995. All Rights Reserved. IVP for SJRTTMAN100 finished successfully. EBCDIC-ASCII Transtable Man Pages Configuring "EBCDIC-ASCII Transtable Man Pages" (SJRTTMAN100) # script done on Fri Oct 07 10:01:33 1994 2-22 日本語RJEのインストレーション _________________________________________________________________ 索引 _C_____________________________ _H_____________________________ -cオプション helpコマンド, 1-26 jsnacodeユーティリティ, 1-2, 1-6 _I_____________________________ D IBMコード列, 1-43 _______________________________ IBM漢字コード, 1-1 DEC拡張文字, 1-1 IBM付加文字, 1-1, 1-7 DEC漢字コード, 1-1 IBMユーザ定義文字, 1-7 DECコード列, 1-43 -ipオプション DECユーザ定義領域, 1-1, 1-7 jsnacodeユーティリティ, 1-5 defineコマンド, 1-22 Item Code, 1-39 使用例, 1-23 Item List, 1-39 IVP _E_____________________________ 例, 2-11 EBCDIC/ASCII変換テーブル, 1-2 -iオプション EBCDIC/DMCS変換テーブルの作成, jsnacodeユーティリティ, 1-29 1-10, 1-11 exitコマンド, 1-26 -eオプション _J_____________________________ jsnacodeユーティリティ, 1-6 JIS漢字コード, 1-1 jsnacodeユーティリティ, 1-3 _F_____________________________ 起動, 1-3 -fオプション コマンド・ラインの最大長, jsnacodeユーティリティ, 1-8 1-8 指定可能オプションの最大数, コマンドオプション, 1-5 1-8 コマンド形式, 1-3 索引-1 jsnaknjdefコマンド形式, 1-18 jsnaknjdefユーティリティ, _Q_____________________________ 1-18 quitコマンド, 1-27 _K_____________________________ _R_____________________________ KMAPファイル, 1-9, 1-12 rehashコマンド, 2-12 環境変数JSNACODE_KMAPFILE, Replaceモード, 1-44 1-9 KMAPレコード数, 1-9 _S_____________________________ -kオプション setld jsnacodeユーティリティ, 1-9 IVP例, 2-5 jsnaknjdefユーティリティ, SS2, 1-12 1-12 L _T_____________________________ _______________________________ tra_dec_ibm, 1-52 listコマンド, 1-20 tra_dec_ibm_free, 1-50 LMF, 2-4 tra_dec_ibm_init, 1-46 LS2R, 1-7, 1-12 tra_ibm_dec, 1-55 LS3R, 1-6, 1-7, 1-12 -tオプション O jsnacodeユーティリティ, 1-10 _______________________________ -opオプション _U_____________________________ jsnacodeユーティリティ, 1-5 undefineコマンド, 1-25 OSF/1システム useコマンド, 1-19 rehashコマンド, 2-12 outputオプション X listコマンド, 1-21 _______________________________ -xオプション _P_____________________________ jsnacodeユーティリティ, 1-7 Product Authorization Key イ (PAK), 2-4 _______________________________ 1バイトコード変換テーブル, 1-13 インストレーション, 2-15 IVPの実行, 2-11 setldプロシージャ, 2-5 索引-2 インストレーション (続き) システム・ディスクのバックア _コ____________________________ ップ, 2-4 コード変換ライブラリ, 1-38 ファイルの配置, 2-12 コード変換ライブラリの概要, ライセンス登録, 2-4 1-38 インストレーション コード変換ライブラリの詳細, 必須ソフトウェア・サブセット, 1-39 2-2 インストレーション必要事項, シ 2-1 _______________________________ システム・ディスクのバックアッ エ プ, 2-4 _______________________________ シフト・コード, 1-6, 1-7, エスケープ・シーケンス, 1-9, 1-8, 1-10 1-12 シフト・コード, 1-43 LS2R, 1-7 LS3R, 1-6, 1-7 ソ エラーメッセージ _______________________________ jsnacodeユーティリティ, 1-15 ソフトウェア・サブセットの確 jsnaknjdefユーティリティ, 認, 2-2 1-28 jsnatratblユーティリティ, _ニ____________________________ 1-35 日本語RJE ソフトウェア構成, 1-2 _カ____________________________ 外字管理ファイル, 1-7 _ヒ____________________________ 外字の変換, 1-45 必須ソフトウェア・サブセット, 概要, 1-1 2-2 環境変数JSNACODE_KMAPFILE, 標準版RJE, 1-1 1-9 漢字コード ヘ DEC漢字コード, 1-1 _______________________________ IBM漢字コード, 1-1 変換テーブル作成例, 1-34 JIS漢字コード, 1-1 変換テーブル修正マクロ, 1-29 漢字コードの対応規則, 1-1 コメント, 1-32 マクロ, 1-30 変換テーブルの作成, 1-32 変換モード, 1-41 索引-3 コード変換の例, 1-44 _モ____________________________ _ホ____________________________ 文字列モード ホスト・システムへのアクセスに 最終, 1-42 ついて, 2-3 初期, 1-42 _ラ____________________________ ライセンス登録, 2-4 索引-4 日本語DEC SNAリモート・ジョブ・エントリfor DEC OSF/1 ユーザーズ・ガイド/インストレーション・ガイド _________________________________________________________________ 1995年1月 発行 日本ディジタル イクイップメント株式会社 〒167 東京都杉並区上荻1-2-1 電話 (03)5349-7111 (大代表) _________________________________________________________________ AA-QCZ3A-TE