 

                     _DIGITAL_ACMS_Desktop_for_OpenVMS_____________
                      インストレーション・ガイド

                     AA-R7L6A-TE


                      1997年7月

                     本書では，OpenVMSオペレーティング・システムが動作し
                     ているシステム上にACMS Desktopソフトウェアをインス
                     トールする方法について記述しています。また，さまざ
                     まなデスクトップ・システム上に，インタフェースとサ
                     ンプル・クライアント・アプリケーションをロードする
                     方法についても説明しています。


                      オペレーティング・システム: OpenVMS VAX
                                                 OpenVMS Alpha

                      ソフトウェア・バージョン:   DIGITAL ACMS Desktop
                                                 for OpenVMS V2.3


                     日本ディジタル イクイップメント株式会社

 
           __________________________________________________________
           1997年7月

           本書の著作権は日本ディジタル イクイップメント株式会社(日本
           DEC)が保有しており，本書中の解説および図，表は日本DECの文
           書による許可なしに，その全体または一部を，いかなる場合にも
           再版あるいは複製することを禁じます。

           また，本書に記載されている事項は，予告なく変更されることが
           ありますので，あらかじめご承知おきください。万一，本書の記
           述に誤りがあった場合でも，日本DECは一切その責任を負いかね
           ます。

           本書で解説するソフトウェア(対象ソフトウェア)は，所定のライ
           センス契約が締結された場合に限り，その使用あるいは複製が許
           可されます。

           日本DECは，日本DECまたは日本DECの指定する会社から納入され
           た機器以外の機器で対象ソフトウェアを使用した場合，その性能
           あるいは信頼性について一切責任を負いかねます。

           (c) Digital Equipment Corporation Japan 1997.

           All Rights Reserved.
           Printed in Singapore.

           以下は米国Digital Equipment Corporationの商標です： ACMS,
           ACMS Desktop, Alpha, DEC, DECforms, DECnet, DECnet-DOS,
           DECtp, DECwindows, OpenVMS, PATHWORKS, PATHWORKS for DOS,
           PATHWORKS for Macintosh, VAX, VAXcluster, VAXset, VMS, VT,
           およびDIGITALロゴ

           下記は他社の商標です。

           Apple, AppleTalk, HyperCard, HyperTalk, Macintosh,および
           MacTCPは米国Apple Computer社の商標です。InterConnections,
           Inc., Terminal Emulation Services, TES, Network Print
           Services, NPS,およびDECnet/IPX PortalはInterConnections社
           の商標です。4D, 4D External Kit,および4th DimensionはACI
           and ACIUS社の商標です。Microsoft, Microsoft C, Microsoft
           COBOL, Microsoft Windows, Microsoft Windows 95, Microsoft
           Windows NT, MS, MS-DOS, Visual Basic,およびWindows NT
           は米国Microsoft社の商標です。MotifおよびOSF/MotifはOpen
           Software Foundation社の商標です。NovellおよびNetWareは
           米国Novell社の商標です。Open DesktopおよびSCOは米国Santa
           Cruz Operations社の商標です。Open Lookは，Novell社が全
           権を有する子会社である米国UNIX System Laboratories社の
           商標です。Oracle CDDおよびOracle Rdbは米国Oracle社の商標
           です。PowerBuilderはPowersoft社の商標です。UNIXはX/Open
           カンパニーリミテッドが独占的にライセンスしている米国な
           らびに他の国における登録商標です。X Window Systemは米国
           MIT(Massachusetts Institute of Technology)の商標です。

           その他のすべての商標および登録商標は，それらの各保持者に所
           有権があります。

           本書は，日本語VAX DOCUMENT V 2.1を用いて作成しています。

 
   ________________________________________________________________

                                                               目次


    まえがき................................................      x


    第1部   ACMS Desktopソフトウェア


    1     ACMS Desktopソフトウェアのインストール前の準備

          1.1   オペレーティング・システムの必要なコンポーネ
               ント.........................................    1-1

          1.2   必要なソフトウェア..........................    1-2

          1.3   インストレーション・プロシージャの必要条件..    1-2
          1.3.1     OpenVMSライセンス管理機能...............    1-2
          1.3.2     インストールに必要な時間................    1-3
          1.3.3     特権と認可..............................    1-3
          1.3.4     ディスク容量............................    1-4
          1.3.5     VMSINSTALの必要条件.....................    1-5
          1.3.6     システム・ディスクのバックアップ........    1-6
          1.3.7     リリース・ノートのプリント・キュー......    1-6

    2     ACMS Desktopソフトウェアのインストール

          2.1   全般的なインストール情報....................    2-1
          2.1.1     オンライン版リリース・ノートの参照......    2-1
          2.1.2     システムにインストールされるファイルと論
                   理名.....................................    2-1
          2.1.3     インストレーション検証プロシージャ......    2-3

          2.2   インストールの強制終了......................    2-3

          2.3   インストレーション・プロシージャ............    2-3
          2.3.1     ACMSおよびACMS Desktopの停止............    2-4
          2.3.2     VMSINSTALの起動.........................    2-5
          2.3.3     インストール時に表示される質問..........    2-7

                                                                iii

 
            2.3.4     情報メッセージ..........................   2-15
            2.3.5     インストレーション検証プロシージャの実
                     行.......................................   2-16
            2.3.6     インストレーション・プロシージャの終了..   2-16

            2.4   システム障害とインストール障害からの回復....   2-17
            2.4.1     システム障害............................   2-17
            2.4.2     ACMS Desktopのインストール・エラー......   2-18
            2.4.3     エラーからの回復........................   2-19

      3     ACMS Desktopソフトウェアのインストール後の処理

            3.1   OpenVMSシステム・ファイルの編集.............    3-1
            3.1.1     システム・スタートアップ・ファイルの編
                     集.......................................    3-1
            3.1.2     システム・シャットダウン・ファイルの編
                     集.......................................    3-3

            3.2   クラスタ環境での準備........................    3-3

            3.3   クライアント・ソフトウェアとサンプル・ソフト
                 ウェアのインストール.........................    3-4
            3.3.1     デスクトップ・システム用のクライアント・
                     ソフトウェア.............................    3-4
            3.3.2     クライアントとサーバのバージョンの対応関
                     係.......................................    3-4
            3.3.3     サンプル・ソフトウェア..................    3-5

            3.4   問題の判断と報告............................    3-6

      4     ACMS Desktop IVPの実行

            4.1   IVPの操作...................................    4-1

            4.2   IVPの単独実行...............................    4-1
            4.2.1     IVPを実行するための必要条件.............    4-2
            4.2.2     IVPの操作手順...........................    4-2
            4.2.3     IVPエラーからの回復.....................    4-3


      iv

 
         第2部   ACMS Desktopクライアント・サービス


         5     ACMS DesktopポータブルAPIサービスとサンプルのイン
              ストール

               5.1   APIおよびサンプル・ソフトウェアのインストー
                    ルの準備.....................................    5-2
               5.1.1     必要なソフトウェア......................    5-2
               5.1.2     APIインストレーションの必要条件.........    5-8
               5.1.2.1     時間..................................    5-8
               5.1.2.2     リソース..............................    5-8
               5.1.2.3     自己解凍アーカイブの使用..............    5-9

               5.2   DOSおよびWindowsのAPIのインストール.........    5-9
               5.2.1     DOSクライアント・サービスのセットアップ.   5-10
               5.2.2     DOSサンプル・アプリケーションのインスト
                        ール.....................................   5-11
               5.2.3     DOSサンプルのインストールの検証.........   5-11
               5.2.3.1     システムに追加されるDOSのサンプル・フ
                          ァイル.................................   5-13
               5.2.4     Windowsクライアント・サービスのセットア
                        ップ.....................................   5-15
               5.2.5     漢字コード変換ライブラリ................   5-16
               5.2.6     Windowsサンプル・アプリケーションのイン
                        ストール.................................   5-17
               5.2.7     Windowsサンプルのインストールの検証.....   5-17
               5.2.7.1     マルチバージョン対応のRdbバージョン6.0
                          が動作するシステムでのAVERTZサンプル・
                          アプリケーションの使用.................   5-21
               5.2.7.2     DECforms V1.4によるAvertz ACMSサンプ
                          ル・アプリケーションのビルド...........   5-22
               5.2.7.3     AVERTZユーザ名のクォータ値............   5-22
               5.2.7.4     AVERTZのアクセス制御リスト............   5-23
               5.2.7.5     AVERTZサンプル・アプリケーションのセッ
                          トアップ...............................   5-23
               5.2.7.6     ACMS Desktopサンプルの再ビルド........   5-24
               5.2.7.7     システムに追加されるWindowsサンプル・
                          ファイル...............................   5-25
               5.2.8     PowerBuilder V5.0サンプル・アプリケーシ
                        ョンのインストール.......................   5-29


                                                                       v

 
            5.2.9     Visual Basicサンプル・アプリケーションの
                     インストール.............................   5-30
            5.2.9.1     Visual Basic用のAVERTZサンプルのインス
                       トールの検証...........................   5-31
            5.2.9.2     システムに追加されるVisual Basicサンプ
                       ル・ファイル...........................   5-31
            5.2.9.3     Visual Basic強制非ブロッキング・チュー
                       トリアルの検証.........................   5-32
            5.2.9.4     FNBSAMPLに対してシステムに追加される
                       Visual Basicサンプル・ファイル.........   5-33

            5.3   Windows 95 APIのインストール................   5-34
            5.3.1     Windows 95クライアント・ソフトウェアのイ
                     ンストール...............................   5-35
            5.3.2     Windows 95用のサンプルのインストール....   5-36

            5.4   Windows NTのAPIのインストール...............   5-36
            5.4.1     Windows NTクライアント・ソフトウェアのイ
                     ンストール...............................   5-37
            5.4.2     Windows NT用のサンプルのインストール....   5-39

            5.5   OpenVMSのAPIとサンプル・クライアント・ソフト
                 ウェアのインストール.........................   5-39
            5.5.1     OpenVMS APIのインストール...............   5-39
            5.5.1.1     OpenVMSデスクトップ・システムに追加さ
                       れるAPIファイル........................   5-41
            5.5.2     OpenVMS用のMotifサンプル・クライアントの
                     インストール.............................   5-42
            5.5.2.1     OpenVMS用のMotifサンプル・ファイルのコ
                       ピー...................................   5-42
            5.5.2.2     OpenVMS用のMotifサンプルのインストール
                       の検証.................................   5-43
            5.5.2.3     OpenVMS Desktopシステムに追加されるサ
                       ンプル・ファイル.......................   5-45

            5.6   DIGITAL UNIXのAPIとサンプル・クライアント・
                 ソフトウェアのインストール...................   5-48
            5.6.1     DIGITAL UNIX APIのインストール..........   5-48
            5.6.1.1     DIGITAL UNIXデスクトップ・システムに追
                       加されるAPIファイル....................   5-50


      vi

 
               5.6.2     DIGITAL UNIX用のMotifサンプル・クライア
                        ントのインストール.......................   5-51
               5.6.2.1     DIGITAL UNIX用のMotifサンプルのインス
                          トールの検証...........................   5-52
               5.6.2.2     DIGITAL UNIXデスクトップ・システムに追
                          加されるサンプル・ファイル.............   5-53

               5.7   SCO UNIXのAPIとサンプル・クライアント・ソフ
                    トウェアのインストール.......................   5-57
               5.7.1     SCO UNIX APIのインストール..............   5-57
               5.7.1.1     SCO UNIXデスクトップ・システムに追加さ
                          れるAPIファイル........................   5-61
               5.7.2     SCO UNIX用のMotifサンプル・クライアント
                        のインストール...........................   5-62
               5.7.2.1     SCO UNIX用のMotifサンプルのインストー
                          ルの検証...............................   5-63
               5.7.2.2     SCO UNIXデスクトップ・システムに追加さ
                          れるサンプル・ファイル.................   5-64

               5.8   RISC ULTRIXのAPIとサンプル・クライアント・ソ
                    フトウェアのインストール.....................   5-68
               5.8.1     RISC ULTRIX APIのインストール...........   5-68
               5.8.1.1     RISC ULTRIXデスクトップ・システムに追
                          加されるAPIファイル....................   5-72
               5.8.2     RISC ULTRIX用のMotifサンプル・クライアン
                        トのインストール.........................   5-73
               5.8.2.1     RISC ULTRIX用のMotifサンプルのインスト
                          ールの検証.............................   5-74
               5.8.2.2     RISC ULTRIXデスクトップ・システムに追
                          加されるサンプル・ファイル.............   5-75

               5.9   インストレーション・エラー..................   5-79

         6     ACMS DesktopのMacintoshシステムとサンプル・ソフト
              ウェアのインストール

               6.1   Macintoshインストレーション・オプション.....    6-1

               6.2   Macintoshソフトウェアをインストールするため
                    の準備.......................................    6-2
               6.2.1     Macintoshシステムに必要なソフトウェア...    6-2


                                                                     vii

 
            6.2.2     インストレーション・プロシージャの必要条
                     件.......................................    6-4
            6.2.2.1     インストールに必要な時間..............    6-4
            6.2.2.2     ディスク容量..........................    6-4
            6.2.2.3     インストレーションに必要なリソース....    6-5

            6.3   Macintoshソフトウェアのインストール.........    6-5
            6.3.1     ACMS DesktopインストーラのMacintoshへの
                     コピー...................................    6-5
            6.3.1.1     VAXshareボリュームの使用によるインスト
                       ーラのコピー...........................    6-6
            6.3.1.2     VAXshareボリュームを使用しない場合のイ
                       ンストーラのコピー.....................    6-9
            6.3.2     ACMS Desktop Macintoshインストーラの実
                     行.......................................   6-10

      A   インストールの例

            A.1   OpenVMS VAXサンプル・ソフトウェアのインスト
                 ール.........................................    A-1

            A.2   OpenVMS Alphaサンプル・ソフトウェアのインス
                 トール.......................................    A-4

      索引


      例

            5-1      startup.batファイルの例..................   5-20

            5-2      config.sysファイルの例...................   5-21


      表

            1-1      ACMS Desktopソフトウェアのインストールに
                     必要な時間...............................    1-3

            1-2      必要なディスク容量.......................    1-5

            5-1      ネットワーク・アクセス...................    5-3

            5-2      APIを使用するために必要なソフトウェア....    5-4

            5-3      サンプル・アプリケーションに必要な製品...    5-7

      viii

 
               5-4      APIをインストールするために必要な時間....    5-8

               5-5      DOSのサンプル・ファイル..................   5-13

               5-6      VR_DA_BLD_MMS.COMパラメータ..............   5-25

               5-7      Windowsサンプル・ファイル................   5-25

               5-8      PowerBuilderサンプル用に追加されるファイ
                        ル.......................................   5-29

               5-9      Visual Basicサンプル・ファイル...........   5-31

               5-10     FNBSAMPLサンプル用のVisual Basicサンプ
                        ル・ファイル.............................   5-34

               5-11     OpenVMSファイル..........................   5-42

               5-12     OpenVMSシステム用のMotifサンプル・ファイ
                        ル.......................................   5-45

               5-13     DIGITAL UNIXファイル.....................   5-51

               5-14     DIGITAL UNIXシステム用のMotifサンプル・フ
                        ァイル...................................   5-53

               5-15     SCO UNIXファイル.........................   5-62

               5-16     SCO UNIXシステム用のMotifサンプル・ファイ
                        ル.......................................   5-65

               5-17     RISC ULTRIXファイル......................   5-73

               5-18     RISC ULTRIX用のMotifサンプル・ファイル...   5-76

               6-1      Macintoshで必要なディスク容量............    6-4


                                                                      ix

 
     ________________________________________________________________

                                                             まえがき


           このインストレーション・ガイドでは，ACMS Desktopソフトウェ
           ア・キットのインストールの方法について説明します。


     対象読者

           本書はACMS Desktopシステムのソフトウェアのインストールと管
           理を担当するユーザを対象にしています。本書で説明している
           インストール手順を実行するには，特権付きOpenVMSシステム管
           理者のアカウントにアクセスできなければなりません。また，
           OpenVMSインストレーション・プロシージャ（VMSINSTAL）につい
           て十分理解していることが必要です。


     オペレーティング・システム情報

           ACMS Desktopソフトウェアを使用するためには，ACMSバージョン
           4.1以上を実行していることが必要です。

           ACMS Desktopソフトウェアのこのバージョンと他のソフトウェア
           製品との互換性については，『ソフトウェア仕様書(SPD)』を参
           照してください。オペレーティング・システムのどのバージョン
           がACMS Desktopソフトウェアのこのバージョンと互換性があるか
           については，SPDで確認してください。


      x

 
        本書の構成

              本書の構成は次のとおりです。


              __________________________________________________________
              第1部_______ACMS_Desktopソフトウェア______________________

              第1章       ACMS Desktopソフトウェアをインストールする前に
                          準備／確認する事項について説明します。
              第2章       ACMS Desktopソフトウェアとサンプル・アプリケー
                          ションのインストールの方法について説明し，イン
                          ストレーション検証プロシージャ(IVP)の実行方法
                          についても説明します。また，システム障害とイン
                          ストレーション障害から回復する方法についても説
                          明します。

              第3章       ACMS Desktopソフトウェアを実行するために，イン
                          ストール後に行う事項について説明します。

              第4章       インストーレーション・プロシージャとは別に，
                          ACMS DesktopのIVPを単独で実行する方法について
              ____________説明します。__________________________________

              第2部_______ACMS_Desktopクライアント・サービス____________

              第5章       DOS，Windows，Windows NT，OpenVMS， DIGITAL
                          UNIX，SCO UNIX デスクトップ・システム用のAPIク
                          ライアント・サービスとサンプル・アプリケーショ
                          ンのインストールについて説明します。
              第6章       Macintosh用のACMS Desktopクライアント・サービ
                          スとサンプル・デスクトップ・クライアント・プロ
                          グラムのインストールについて説明します。


        関連資料

              本書では，OpenVMSのインストレーション・プロシージャについ
              ては詳しく説明していません。詳細については，ご使用の各ハー
              ドウェアの『VMS Installation and Operations』を参照してく
              ださい。そのドキュメントでは，次の手順について説明していま
              す。


                                                                      xi

 
            o  配布メディアの取り扱いとマウント

            o  現在のシステムと対象システム・デバイスの準備

           システム管理と操作に関して推奨される方針と手順についての
           説明は，サイト管理ガイド，およびOpenVMSドキュメンテーショ
           ン・セットに含まれているドキュメントのうち，システム管理と
           操作に関するドキュメントを参照してください。

           以下のドキュメントには，ACMSシステムとACMS Desktopソフトウ
           ェアの管理に関する情報がまとめられています。


      xii

 
               o  『DIGITAL ACMS for OpenVMS Managing Applications』

                  ACMSシステムの起動と停止，システム・パフォーマンス
                  の監視，チューニングの実行方法について説明します。ま
                  た，アプリケーションのインストール方法と，ユーザ，デ
                  バイス，アプリケーションの認可方法についても説明しま
                  す。

               o  『DIGITAL ACMS Desktop for OpenVMSクライアント・アプ
                  リケーション・プログラミング・ガイド』

                  デスクトップ・システムでのクライアント・ソフトウェア
                  の設計，開発，管理について説明します。

               o  『DIGITAL ACMS Desktop for OpenVMS Client Services
                  Reference Manual』

                  ACMS Desktopクライアント・サービスの構文を示します。

               o  『DIGITAL ACMS Desktop for OpenVMS Gateway Management
                  for ACMS』

                  ACMS Desktopゲートウェイのシステム管理について説明し
                  ます。また，ネットワーク・トランスポートの使用方法に
                  ついても説明します。

               o  『DIGITAL ACMS Desktop for OpenVMSリリース・ノート』

                  ACMS Desktopソフトウェアの新機能と制約事項について説
                  明します。リリース・ノートは，ソフトウェアをインスト
                  ールする前にお読みください。

                  なお，インストレーション・プロシージャを起動するとき
                  に，印刷または表示することができるリリース・ノートは
                  英語版です。

               o  『DIGITAL ACMS Desktop 4D Externals User's Guide』-オ
                  ンラインのみ

                  開発プラットフォームとして4th Dimensionを使用して，
                  ACMS DesktopのMacintoshクライアント・プログラムを作成
                  するために使用できる4D外部関数について説明します。こ
                  のドキュメントはMacintoshシステムのacmsdi-examplesフ
                  ォルダにあります。


                                                                    xiii

 
     本書で使用する表記法

           OpenVMS VAX固有の情報またはOpenVMS Alpha固有の情報を区別す
           るために，次のアイコンを左端に表示します。

           __________________________________________________________
           表記法__________説明______________________________________

           ACMS Desktop    DIGITAL ACMS Desktop for OpenVMSを簡略に表
                           記します。

           User input      この書体は，例の中でのユーザ入力を示しま
                           す。

           <Ctrl/X>        Ctrlキーを押しながら，指定されたキー(ここ
                           ではXによって示している)を押すことを示しま
                           す。

           italics         この書体は，単語または句を強調するために使
                           用します。

           WORD            大文字の文字列はルーチン名，ファイル名，フ
                           ァイル保護コードの名前，システム特権の省略
                           形を示します。

           <Return>        この記号はReturnキーを押すことを示します。

            .              例の中で使用している縦の省略記号は，その例
            .              に直接関係のない情報が省略されていることを
            .              示します。

           nn nnn.nnn nn   スペース文字は5桁以上の数字を3桁ごと
                           に区切るために使用します。たとえば，10
                           000は10000と同じです。

           n.nn            数字の中のピリオドは小数点を示します。たと
           ________________えば，1.75は1と4分の3と同じです。_________


      xiv

 
                                                                   第1部
        ________________________________________________________________

                                                ACMS Desktopソフトウェア


              第1部では，OpenVMSシステムにACMS Desktopソフトウェアをイン
              ストールする方法について説明します。

 
                                                                       1
        ________________________________________________________________

                          ACMS Desktopソフトウェアのインストール前の準備


              この章では，ACMS Desktopソフトウェアをインストールするため
              に必要な準備作業と必要条件について説明します。メディアの数
              と内容については，BOM (bill of materials)を参照してくださ
              い。キットの内容をこの情報と突き合わせてください。キットが
              破損している場合や，不足するものがある場合は，日本DECの担
              当者にご連絡ください。

              ACMS Desktopソフトウェアには，オンライン版リリース・ノート
              が含まれており，インストレーション・プロシージャでリリー
              ス・ノートを印刷または表示するオプションがあります。リリー
              ス・ノートには，インストレーション手順に関して重要な情報が
              記載されているため，インストールを開始する前に必ず参照して
              ください。


        ___________________________________________________________

        1.1   オペレーティング・システムの必要なコンポーネント

              ACMS Desktopソフトウェアをインストールするには，次のいずれ
              かのオペレーティング・システムがインストールされていなけれ
              ばなりません。

               o  OpenVMS VAXオペレーティング・システム

                  -   バージョン5.5-2

                  -   バージョン6.1

                  -   バージョン6.2

                  -   バージョン7.1

               o  OpenVMS Alphaオペレーティング・システム

                  -   バージョン6.1

                  -   バージョン6.2

                      ACMS Desktopソフトウェアのインストール前の準備 1-1

 
               -    バージョン7.1


     ___________________________________________________________

     1.2    必要なソフトウェア

           前提条件のソフトウェアおよび，ACMS Desktopソフトウェアのこ
           のバージョンと互換性のある製品については，『ソフトウェア仕
           様書(SPD)』を参照してください。

           OpenVMS Alphaシステムでは，SPDはCD-ROMに格納されています。

     ___________________________________________________________

     1.3    インストレーション・プロシージャの必要条件

           以降の各項では，ACMS Desktopソフトウェアをインストールする
           ために必要な条件について説明します。

     1.3.1  OpenVMSライセンス管理機能


           ACMS Desktopでは，OpenVMSライセンス管理機能(LMF)をサポート
           しています。OpenVMSシステムでACMS Desktopをインストールす
           るには，ソフトウェア・ライセンスを登録する必要があります。

           LMFでは，Product Authorization Key (PAK)の登録が必要です。
           必要なライセンス登録情報は，ACMS Desktopソフトウェアに同梱
           されているPAKに記載されています。PAKは，特定のソフトウェア
           を実行するために購入したライセンスに関する情報が記載されて
           いる証書です。

           インストールを実行する前に，ACMS Desktopのライセンスを登録
           してください。インストールの途中でACMS Desktopライセンスを
           登録したかどうかと，適切なライセンス・キーをロードしたかど
           うかが質問されます。ライセンスがロードされていなければ，
           ACMS Desktopソフトウェアを実行したり，IVPを実行することは
           できません。ライセンスの登録を行い，ライセンス・キーをロー
           ドした後，IVPを実行し，ACMS Desktopソフトウェアを使用でき
           るようになります。


      1-2  ACMS Desktopソフトウェアのインストール前の準備

 
              ライセンスを登録するには，まず，システム管理者のアカウント
              （SYSTEM）にログインします。ライセンスは次のいずれかの方法
              で登録できます。

               o  SYS$UPDATE:VMSLICENSE.COMプロシージャを実行する。プロ
                  ンプトが表示されたら，PAKに記載されているデータを入力
                  する。

               o  PAKの情報に対応する適切な修飾子を使用して，LICENSE
                  REGISTERコマンドを実行する。

              LMFの使い方の詳細については，『OpenVMS License Management
              Facility Manual』を参照してください。


        1.3.2  インストールに必要な時間

              表 1-1は，ACMS Desktopソフトウェアのインストールに必要なお
              よその時間を示しています。


              表 1-1 ACMS Desktopソフトウェアのインストールに必要な時間
              __________________________________________________________
              ソフトウェア_________________________必要な時間（分）_____

              OpenVMSシステム用のACMS Desktop製品  10

              OpenVMSシステム用のACMS Desktop製品  20
              とサンプル________________________________________________

              ACMS Desktopクライアント・ソフトウェアをデスクトップ・シス
              テムにインストールするために必要な時間については表 5-4を参
              照してください。


        1.3.3  特権と認可

              ACMS Desktopソフトウェアをインストールするには，次の特権が
              与えられたアカウントにログインしなければなりません。

                  SETPRV，TMPMBX，NETMBX


                      ACMS Desktopソフトウェアのインストール前の準備 1-3

 
           SYSTEMアカウントには，インストールに必要なすべての特権が与
           えられています。


           VMSINSTALは，インストールを開始するときにBYPASS特権を無効
           にし，インストール時に必要な特権を設定します。

           ACMS Desktopシステムのコンポーネントをインストールした場合
           には，インストレーション・プロシージャの最後に，製品をイン
           ストールするために使用したユーザ名と同じ名前を使用して，
           OpenVMS上でACMS Desktopサーバ・プロセスが起動されます。
           サーバはSYSTEMというユーザ名または[1,4]というUICが与えら
           れた別のユーザ名のもとで実行するようにしてください。ACMS
           Desktopサーバを正しく起動するには，インストールを実行する
           ときのユーザ名が認可されたACMSエージェントでなければなりま
           せん。ユーザ名を認可するには，ACMSUDUユーティリティを使用
           します。次の例を参照してください。

           $  SET DEFAULT SYS$SYSTEM
           $  RUN ACMSUDU
           UDU>  ADD SYSTEM/AGENT
           UDU>

           ユーザ名がACMSエージェントとして認可されていない場合には，
           IVPは異常終了し，デスクトップ・クライアント・プログラムは
           ACMSシステムにサイン・インできません。デスクトップ・クライ
           アント・プログラムがACMSシステムに正しくサイン・インできる
           ようにするには，ACMS Desktopサーバを停止し，認可されたACMS
           エージェントであるユーザ名のもとで再起動する必要がありま
           す。


     1.3.4  ディスク容量

           ACMS Desktopソフトウェアをインストールするには，インストー
           ル時に特定の空き容量が必要です。表 1-2は，インストール時と
           インストール後にACMS Desktopで必要なディスク容量を示してい
           ます。


      1-4  ACMS Desktopソフトウェアのインストール前の準備

 
              表 1-2 必要なディスク容量
              __________________________________________________________
                                          インストール時  インストール後
              コンポーネント______________(ブロック数)____(ブロック数)__

              ACMS Desktopサーバとクライ  18 000           3 500
              アント・サービス

              共通サンプル[1]                650             150

              AVERTZサンプル・アプリケー    5500           4 700
              ション

              DOSサンプル                    700             650

              Windowsサンプル                500           1 300

              Macintoshサンプル              100              40

              Motifサンプル                6 000           5 250
              [1]サンプルをインストールするときは，このソフトウェアも必_

              要となる。
              __________________________________________________________

              サンプル・アプリケーションをインストールする場合には，サン
              プル・アプリケーションのために必要なブロック数を，サーバお
              よびクライアント・サービスに必要なブロック数に加算してくだ
              さい。

              システム・ディスク上の空きディスク容量を調べるには，DCLプ
              ロンプトに対して次のコマンドを入力します。

              $ SHOW DEVICE SYS$SYSDEVICE

        1.3.5  VMSINSTALの必要条件


              VMSINSTALを起動する場合には，次の条件が満たされているかど
              うかを確認してください。

               o  特権付きアカウントにログインしていること。


                      ACMS Desktopソフトウェアのインストール前の準備 1-5

 
            o  インストールのために必要なクォータが与えられているこ
               と。

            o  DECnet/VMSソフトウェアが起動され，動作していること。

            o  他のユーザがシステムにログインしていないこと。

           インストール中にVMSINSTALで問題が検出された場合には，その
           問題が通知され，インストールを続行するかどうかが質問されま
           す。場合によっては，YESと応答してインストールを続行できま
           す。インストールを停止し，問題に対処するときは，NOと応答す
           るか，または<Return>を押します。


     1.3.6  システム・ディスクのバックアップ

           インストールを開始するときに，VMSINSTALはシステム・ディス
           クのバックアップをとっているかどうか質問します。新規ソフト
           ウェアをオペレーティング・システムにインストールする場合に
           は，その前に必ずシステム・ディスクのバックアップを実行して
           ください。

           バックアップを実行するには，サイトで設定されているバックア
           ップ手順に従ってください。システム・ディスクのバックアップ
           の実行の詳細については，OpenVMSドキュメンテーション・セッ
           トのBackupユーティリティに関する記述を参照してください。


     1.3.7  リリース・ノートのプリント・キュー

           インストール時にリリース・ノートを印刷するオプションを選択
           した場合には，VMSINSTALはプリント・キューの名前を質問しま
           す。省略時のキューはSYS$PRINTです。省略時のキューを変更す
           るときは，システムのANSIキューの名前を入力してください。


      1-6  ACMS Desktopソフトウェアのインストール前の準備

 
                                                                       2
        ________________________________________________________________

                                  ACMS Desktopソフトウェアのインストール


              この章では，ACMS Desktopソフトウェアのインストールの方法に
              ついて説明します。インストレーション・プロシージャの詳細に
              ついては，第2.3節を参照してください。


        ___________________________________________________________

        2.1   全般的なインストール情報

              この節では，リリース・ノートへのアクセス，システムに追加さ
              れるファイルと論理名の判断，インストレーション検証プロシー
              ジャ(IVP)の実行，インストレーションの強制終了について説明
              します。

        2.1.1  オンライン版リリース・ノートの参照

              ACMS Desktopソフトウェアにはオンライン版リリース・ノートが
              添付されています。リリース・ノートの表示または印刷に関す
              るプロンプトを表示するには，OPTIONS Nパラメータを指定して
              VMSINSTALを起動します。


              ACMS Desktopがインストールされた後，リリース・ノートはパブ
              リック・アクセスが可能なディレクトリに格納されます。


        2.1.2  システムにインストールされるファイルと論理名

              次のファイルには，ACMS Desktopのインストールによってシステ
              ムに追加されるファイルの一覧が格納されています。


                              ACMS Desktopソフトウェアのインストール 2-1

 
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SYSTEM_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_COMMON_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_AVERTZ_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_MSDOS_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_MSWINDOWS_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_MACINTOSH_FILES.DAT
           SYS$COMMON:[SYSTEST.ACMSDI]ACMSDI$SAMPLE_MOTIF_FILES.DAT


           これらのファイルは，ACMS Desktopソフトウェアをインストール
           した後，表示または印刷できます。

           次の論理名はインストール後にシステムに追加されます。

               ACMSDI$COMMON
               ACMSDI$EXAMPLES
               ACMSDI$EXAMPLES_ACMS
               ACMSDI$EXAMPLES_MACINTOSH
               ACMSDI$EXAMPLES_MSDOS
               ACMSDI$EXAMPLES_MSW31
               ACMSDI$EXAMPLES_NT_ALPHA
               ACMSDI$EXAMPLES_NT_I86
               ACMSDI$EXAMPLES_WIN95
               ACMSDI$EXAMPLES_VB
               ACMSDI$EXAMPLES_PB
               ACMSDI$EXAMPLES_MOTIF
               ACMSDI$EXAMPLES_MOTIF_VMS
               ACMSDI$EXAMPLES_MOTIF_VMS_ALPHA
               ACMSDI$EXAMPLES_MOTIF_SCO
               ACMSDI$EXAMPLES_MOTIF_UNIX
               ACMSDI$EXAMPLES_MOTIF_MIPS_ULTRIX
               ACMSDI$MACINTOSH
               ACMSDI$MSDOS
               ACMSDI$WIN95
               ACMSDI$NT_ALPHA
               ACMSDI$NT_I86
               ACMSDI$UNIX
               ACMSDI$VMS
               ACMSDI$VMS_ALPHA
               ACMSDI$SCO
               ACMSDI$MIPS_ULTRIX
               ACMSDI_AVERTZ_DEFAULT


      2-2  ACMS Desktopソフトウェアのインストール

 
                  AVERTZ_TDB


              これらの論理名はシステム論理名テーブルに登録されます。ACMS
              Desktopスタートアップ・コマンド・プロシージャを実行する
              と，これらの論理名がシステム論理名テーブルに登録されます。


        2.1.3  インストレーション検証プロシージャ

              ACMS Desktopソフトウェア用のインストレーション検証プロシー
              ジャ(IVP)を実行することにより，インストールが正しく行われ
              たかどうかを確認できます。インストール時に，インストールの
              一部としてIVPを実行するかどうかが質問されます。YESと応答す
              ると，VMSINSTALはIVPを実行します。ACMS Desktopが正しくイン
              ストールされたかどうかを確認するために，IVPを実行するよう
              にしてください。

              ACMS Desktopソフトウェアをインストールした後，IVPを単独で
              実行して，ソフトウェアがシステムで使用可能な状態であるかど
              うかを確認することができます。また，システム障害が発生した
              後，IVPを実行して，ユーザがACMS Desktopソフトウェアにアク
              セスできるかどうかを確認することもできます。IVPを単独で実
              行する方法については，第4章を参照してください。


        ___________________________________________________________

        2.2   インストールの強制終了

              インストレーション・プロシージャを強制終了するに
              は，<Ctrl/Y>を押します。<Ctrl/Y>を押すと，インストレー
              ション・プロシージャはそれまでに作成したすべてのファイルを
              削除して，終了します。その後，インストールを再開することが
              できます。

        ___________________________________________________________

        2.3   インストレーション・プロシージャ

              ACMS Desktopソフトウェアをインストールするには，この節で説
              明する手順を実行します。


                              ACMS Desktopソフトウェアのインストール 2-3

 
           OpenVMS Alphaシステムでコンパクト・ディスク(CD)メディアを
           CDドライブにまだ挿入していない場合は，インストールを開始す
           る前に挿入してください。


     2.3.1  ACMSおよびACMS Desktopの停止

           適切な特権(第1.3.3項を参照)が与えられたアカウントでシステ
           ムにログインします。

           Username: SYSTEM
           Password:
           $

            o  ACMS Desktopソフトウェアがすでにインストールされ，実
               行されている場合には，それをシャットダウンします。

               $  @SYS$STARTUP:ACMSDI$SHUTDOWN
               $

            o  ACMS Desktop Serial Gatewayを実行している場合には，そ
               れをシャットダウンしてください。

               $  MCR ACMSDI$SERIAL_GATE_MANAGER
                ACMSDIGW$MANAGER>  SHUTDOWN
                ACMSDIGW$MANAGER>  EXIT

            o  その後，次のコマンドを実行してACMSを停止します。

               $  ACMS/STOP SYSTEM
                  .
                  .
                  .
               $  @SYS$STARTUP:ACMSTOP
                  .
                  .
                  .
               $


      2-4  ACMS Desktopソフトウェアのインストール

 
        2.3.2  VMSINSTALの起動


              特権付きアカウントにログインした後，省略時のディレクトリを
              SYS$UPDATEディレクトリに設定します。

              $ SET DEFAULT SYS$UPDATE
              $

              次の構文を使用して，VMSINSTALを起動します。

              @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N

              saveset-name
              コンポーネントのインストール名。ACMS Desktopソフトウェアの
              場合は，次のインストール名を使用します。

              ACMSDI

              セーブセット名を指定しなかった場合には，VMSINSTALはインス
              トレーション・プロシージャでこの情報を要求するプロンプトを
              表示します。

              device-name
              配布メディアをマウントするデバイスの名前。たとえば，MUA0:
              はテープ・ドライブのデバイス名です。このインストールの場
              合，コンソール・ドライブを使用する必要はありません。しか
              し，コンソール・ドライブを使用する場合には，インストールが
              完了した後，取り出したメディアを元に戻してください。

              デバイス名を指定しなかった場合には，VMSINSTALはインストレ
              ーション・プロシージャでこの情報を要求するプロンプトを表示
              します。

              CD-ROMからインストールする場合:

              CD上のACMS Desktopセーブセットのディレクトリを確認するに
              は，CD配布キットに同梱されているカバー・レターを参照する
              か，またはインストールを開始する前に次の手順を実行します。

               1. CDドライブがすでにマウントされているかどうかを確認す
                  るために，次のように入力します。


                              ACMS Desktopソフトウェアのインストール 2-5

 
               $ SHOW DEVICE device-name

            2. CDがマウントされていない場合には，適切なMOUNTコマンド
               を使用してCDをマウントします(/FOREIGN修飾子は省略して
               ください)。

            3. セーブセット名を確認するために，DIRECTORYコマンドを使
               用します。

               $ DIRECTORY device-name:[acmsdi023.kit]*.A

           OPTIONS N
           リリース・ノートを表示または印刷するためのプロンプトを表示
           することを指定するオプション・パラメータ。OPTIONS Nパラメ
           ータを指定しなかった場合には，VMSINSTALはリリース・ノート
           を表示または印刷するためのプロンプトを表示しません。

           VMSINSTALにはこの他にもいくつかのオプションがあります。詳
           細については，ソフトウェアのインストールに関するOpenVMSの
           マニュアルを参照してください。

           次のコマンドはVMSINSTALを起動し，MUA0:テープ・ドライブある
           いはCD-ROMからACMS Desktopソフトウェアをインストールしま
           す。この例では，リリース・ノートを印刷または表示するため
           に，OPTIONS Nパラメータを使用しています。


      2-6  ACMS Desktopソフトウェアのインストール

 
              テープ・ドライブからインストールする場合:

              $ @SYS$UPDATE:VMSINSTAL ACMSDI MUA0: OPTIONS N

                    OpenVMS VAX Software Product Installation Procedure V5.5-2

              It is 29-MAR-1997 at 13:12.

              Enter a question mark (?) at any time for help.

              CD-ROMからインストールする場合:

              $ @SYS$UPDATE:VMSINSTAL ACMSDI CD$DISK:[ACMSDI023.KIT]

                    OpenVMS ALPHA Software Product Installation Procedure V6.1

              It is 29-MAR-1997 at 13:12.

              Enter a question mark (?) at any time for help.

              VMSINSTALはオプションを要求するプロンプトを表示しませ
              ん。インストール時にリリース・ノートにアクセスするには，
              VMSINSTALコマンド・ラインにOPTIONS Nを指定してください。

        2.3.3  インストール時に表示される質問

              この節では，インストール時に表示される質問について説明しま
              す。インストレーション例については，付録 Aを参照してくださ
              い。


              インストール時に表示される各質問には，行の先頭にアスタリス
              ク(*)が示されます。一部の質問では，省略時の応答が大括弧で
              囲んで示されます(たとえば，[YES])。省略時の応答を入力する
              には，<Return>を押します。

               1. アクティブ・プロセスの確認

                  VMSINSTALはすべてのアクティブ・プロセスの一覧を表示し
                  ます。その後，インストールを続行するかどうか質問しま
                  す。


                              ACMS Desktopソフトウェアのインストール 2-7

 
               %VMSINSTAL-W-ACTIVE, The following processes are still active:
                  .
                  .
                  .
               * Do you want to continue anyway [NO]?  YES

            2. システムのバックアップの確認

               VMSINSTALはシステムのバックアップを実行したかどう
               か質問します。インストールを実行する場合には，その
               前に必ずシステム・ディスクをバックアップしてくださ
               い。システム・ディスクをバックアップしてある場合に
               は，<Return>を押します。インストールを中断するとき
               は，NOと応答します。システム・ディスクをバックアップ
               した後，インストールを再開してください。

               * Are you satisfied with the backup of your system disk [YES]?

            3. メディアのマウント

               VMSINSTALを起動したときに指定したデバイスに配布ボリュ
               ームをマウントします。質問の前の行にデバイス名が表示
               されます。VMSINSTALはインストールを続行できる状態であ
               るかどうか質問します。

               続行できる状態である場合は，YESと応答します。
               VMSINSTALは，ACMS Desktopソフトウェアが格納されて
               いるメディアが指定されたデバイスにマウントされたこと
               と，インストールが開始されたことを示すメッセージを表
               示します。

               Please mount the first volume of the set on MUA0:.
               * Are you ready? YES
               %MOUNT-I-MOUNTED, ACMSDI mounted on MUA0:

               The following products will be processed:

                 ACMSDI V2.3

                       Beginning installation of ACMSDI V2.3 at 13:14

               %VMSINSTAL-I-RESTORE, Restoring product save set A...


      2-8  ACMS Desktopソフトウェアのインストール

 
                  VMSINSTALを起動するときに誤ったデバイス名を入力した
                  ために，インストールを再起動しなければならない場合
                  には，"Are you ready?"という質問に対してNOと応答し
                  てください。他の理由でインストールを強制終了するとき
                  は，<Ctrl/Y>を押します。

               4. リリース・ノート

                  VMSINSTALを起動するときにOPTIONS Nを指定した場合に
                  は，リリース・ノートを参照するためのいくつかのオプシ
                  ョンが表示されます。次のオプションが表示されます。

                  Release Notes included with this kit are always copied to SYS$HELP.

                  Additional Release Notes Options:

                      1. Display release notes
                      2. Print release notes
                      3. Both 1 and 2
                      4. None of the above

                  * Select option [2]:   1

                   o  オプション1

                      オプション1を選択すると，VMSINSTALはコンソー
                      ル端末にリリース・ノートをただちに表示しま
                      す。<Ctrl/C>を押すと，いつでも表示を終了できま
                      す。リリース・ノートは数ページあるため，オンライ
                      ンで確認するよりは，オプション2を選択してリリー
                      ス・ノートを印刷するようにしてください。

                   o  オプション2

                      オプション2を選択すると，VMSINSTALは使用するプリ
                      ント・キューの名前を要求します。

                      * Queue name [SYS$PRINT]:

                      キュー名を入力するか，または<Return>を押して大括
                      弧に囲んで示された省略時のキューを選択します。フ
                      ァイルがキューに送られます。

                   o  オプション3

                      オプション3を選択した場合には，VMSINSTALはリリー
                      ス・ノートを表示し，印刷するためにキュー名を要求
                      します。

                              ACMS Desktopソフトウェアのインストール 2-9

 
                o   オプション4

                    オプション4を選択した場合には，VMSINSTALはインス
                    トールを続行します。

            5. インストールの続行

               VMSINSTALは，インストールを続行するかどうか質問し
               ます。続行するときはYESと応答します。続行しないとき
               は，<Return>を押します。どちらの場合も，リリース・
               ノートのファイルはSYS$HELPディレクトリにコピーされま
               す。

               * Do you want to continue the installation [N]?: YES
               %VMSINSTAL-I-RELMOVED, Product's Release Notes have been moved to SYS$HELP.

               (c)Digital Equipment Corporation. 1997. All Rights Reserved.

               VMSINSTALによってインストールされるリリース・ノート・
               ファイルの名前は，現在の製品名とバージョン番号で構成
               されます。ACMS Desktopソフトウェアの以前のバージョン
               と比較する予定がある場合は，ACMS Desktopの以前のバー
               ジョンのリリース・ノートを削除しないでください。

            6. ファイルのパージの選択

               このインストールによって無効になるACMS Desktopの以
               前のバージョンのファイルをパージすることができます。
               このようなファイルはなるべくパージしてください。しか
               し，以前のバージョンのファイルを保存しておく必要があ
               る場合は，この質問に対してNOと応答してください。

               * Do you want to purge files replaced by this installation [YES]?

            7. IVPの実行の選択

               ACMS Desktopシステムのコンポーネントをインストールす
               る場合には，インストレーション・プロシージャはIVPを実
               行するかどうか質問します。IVPは，ソフトウェアが正しく
               インストールされたかどうか確認します。なるべくIVPを実
               行してください。

               * Do you want to run the IVP after the installation [YES]? YES

               ACMS Desktopソフトウェアをインストールした後でIVPを実
               行したい場合には，<Return>を押します。IVPを実行しない
               ときは，NOと応答します。

      2-10  ACMS Desktopソフトウェアのインストール

 
                  インストールが終了した後，ACMS Desktopソフトウェアが
                  使用可能な状態であるかどうかを確認するために，IVPを単
                  独で実行できます。インストレーション・プロシージャと
                  別に，ACMS DesktopのIVPを単独で実行する方法について
                  は，第4章を参照してください。

               8. サンプル・アプリケーションの選択

                  本製品がすでにインストールされている場合には，AVERTZ
                  サンプル・アプリケーションをインストールできます。本
                  製品をインストールせずに，サンプル・アプリケーション
                  のソース・ファイルだけをインストールするときは，本製
                  品のインストールに関する質問に対してNOと応答します。

        * Do you wish to install any of the ACMS Desktop samples at this time [YES]? YES

                  AVERTZサンプル・アプリケーションはACMS Desktopのドキ
                  ュメントでプログラミング・サンプルとして使用されてい
                  ます。このサンプルには，参照したり変更することができ
                  るソース・コードと，ソフトウェアを実際に体験できる実
                  行可能コードの両方が含まれています。

                  ACMS Desktopのサンプルは複数の部分に分かれています。
                  NOと応答すると，サンプルはまったくインストールされま
                  せん。この質問に対してYESと応答した場合には，どのサン
                  プルをインストールするかを指定するために，次の質問が
                  表示されます。

                   a. AVERTZサンプルの選択

                      このバック・エンド用のファイルには，ACMSタスク，
                      タスク・グループ，およびそれを設定するためのアプ
                      リケーション定義とコマンド・プロシージャが含まれ
                      ています。このサンプルをセットアップする手順につ
                      いては第5.2.7.5項を参照してください。

                        The installation of the ACMS Desktop AVERTZ Application
                        requires 4700 blocks.

                      * Do you wish to install the AVERTZ application [YES]? YES


                             ACMS Desktopソフトウェアのインストール 2-11

 
                    ACMS Desktopのサンプルを実行するには，AVERTZア
                    プリケーションをインストールします。サンプルを
                    実行する予定がない場合は，この質問に対してNOと応
                    答してください。YESと応答した場合には，AVERTZサ
                    ンプル・アプリケーションのACMSソース・ファイルは
                    SYS$EXAMPLESの[.ACMSDI]および[.ACMSDI.ACMS]サブデ
                    ィレクトリに格納されます。

                b.  DOSサンプルの選択

                    このブロッキング・クライアント・プログラム用のサ
                    ンプル・ファイルは，CおよびCOBOLで作成されたソー
                    ス・ファイルとビルド・ファイルです。

                      The installation of the ACMS Desktop MS-DOS sample
                      requires 650 blocks.

                    * Do you wish to install the MS-DOS sample [YES]? YES

                    ACMS Desktopサービスのブロッキング・フォームを使
                    用するクライアントをDOSプラットフォームで実現す
                    る場合には，YESと応答します。YESと応答した場合に
                    は，ファイルはSYS$EXAMPLESの[.ACMSDI.MSDOS]サブデ
                    ィレクトリに格納されます。デスクトップ・システム
                    にサンプル・ソース・ファイルをインストールするに
                    は，第5章に示した手順を実行します。

                c.  Windows，Visual Basic，PowerBuilder，Windows NT，
                    Windows 95サンプルの選択

                    これらのクライアント・プログラム用のサンプル・フ
                    ァイルはVisual Basic，PowerBuilder，C，Windows，
                    Windows 95，およびWindows NT用のソース・ファイル
                    とビルド・ファイルです。

                      The installation of the ACMS Desktop Windows samples
                      requires 1300 blocks.

                    * Do you wish to install the Windows samples [YES]? YES


      2-12  ACMS Desktopソフトウェアのインストール

 
                      ACMS Desktopサービスを使用するクライアントを
                      Microsoft Windowsで実現する場合には，YESと応答
                      します。YESと応答すると，ファイルはSYS$EXAMPLES
                      の[.ACMSDI.WINDOWS]サブディレクトリに格納されま
                      す。サンプル・ソース・ファイルをデスクトップ・シ
                      ステムにインストールするには，第5章に示した手順を
                      実行します。

                   d. Macintoshサンプルの選択

                      これらは，ACMSDI$EXAMPLES_MACINTOSHサンプルACMSア
                      プリケーションのビルドおよびサポートに必要なファ
                      イルです。

                        The installation of the ACMS Desktop Macintosh sample
                        requires 40 blocks.

                      * Do you wish to install the Macintosh sample [YES]? YES

                      Macintoshプラットフォームでクライアントを実現する
                      場合には，YESと応答します。YESと応答すると，ファ
                      イルはSYS$EXAMPLESの[.ACMSDI.MACINTOSH]サブディレ
                      クトリに格納されます。サンプル・ソース・ファイル
                      をデスクトップ・システムにインストールするには，
                      第6章に示した手順を実行します。

                   e. Motifサンプルの選択

                        The installation of the ACMS Desktop Motif sample
                        requires 5250 blocks.

                      * Do you wish to install the Motif sample [YES]? YES

                      Motif X WindowsのもとでOpenVMS，DIGITAL UNIX，
                      RISC ULTRIX，SCO UNIXプラットフォームでクライアン
                      トを実現する場合には，このサンプルを選択します。
                      YESと応答すると，ファイルはSYS$EXAMPLESの適切なサ
                      ブディレクトリに格納されます。

                   f. サンプルの選択の確認


                             ACMS Desktopソフトウェアのインストール 2-13

 
                    インストレーション・プロシージャは選択されたサン
                    プルの一覧を表示し，OpenVMSシステムで使用されるお
                    よそのサイズと合計サイズをブロック数で示します。
                    選択したサンプルを確認します。


                    You have made the following sample installation choices:

                        COMMON FILES                   150 BLOCKS
                        AVERTZ APPLICATION            4700 BLOCKS
                        MS-DOS SAMPLE                  650 BLOCKS
                        MICROSOFT WINDOWS SAMPLE      1200 BLOCKS
                        MACINTOSH SAMPLE                40 BLOCKS
                        MOTIF SAMPLE                  5250 BLOCKS
                        ====================================
                        TOTAL SIZE:                  11990 BLOCKS

                    * Are you satisfied with your selections [YES]? YES

                    YESと応答すると，表示されたサンプルがインストール
                    されます。NOと応答すると，サンプルを再度選択する
                    ように要求されます。

            9. ライセンス登録の確認

               VMSINSTALはPAKがインストールされているかどうか質問し
               ます。登録の前に，ACMS Desktopソフトウェアをインスト
               ールすることができます。しかし，ライセンスを登録する
               まで，ソフトウェアを使用することはできません。

                Looking up the Product Authorization Information.

                      Product:       DESKTOP-ACMS
                      Producer:      DEC
                      Version:       2.3
                      Release Date:  07-MAY-1997

               * Does this product have an authorization key registered and loaded? YES

               NOと応答すると，インストールは完了しますが，IVPは実行
               されません。YESと応答したときに，ライセンスが登録され
               ていない場合は，IVPは異常終了します。


      2-14  ACMS Desktopソフトウェアのインストール

 
        2.3.4  情報メッセージ


              この時点で，インストレーション・プロシージャはインストール
              の進捗状況に関して多くの情報メッセージを表示し，製品のさま
              ざまな使い方に関する助言を与えます。この後，質問は表示され
              ません。

              %ACMSDI-I-PROCEED, There are no further questions and all checks have been completed.
              -ACMSDI-I-PROCEED, It will take approximately 15 minutes to complete the
              installation.
              %VMSINSTAL-I-ACCOUNT, This installation updates an identifier named ACMSDI$CLIENT.
              %UAF-I-RDBMDFYMSG, identifier ACMSDI$CLIENT modified
                 .
                 .
                 .

              表示される指示はインストールに適用される可能性があるため，
              注意深く確認してください。

              ここまでインストレーション・プロシージャが正常終了した場
              合，VMSINSTALは新しいファイルまたは変更されたファイルを対
              象ディレクトリに移動し，ヘルプ・ファイルを更新します。ファ
              イルのパージを要求した場合は，ここでパージされます。次のメ
              ッセージが表示されます。

                 .
                 .
                 .
              %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...
                 .
                 .
                 .

              空き容量が制限されているシステム・ディスクにACMS Desktopを
              インストールする場合には，VMSINSTALは安全モードで動作でき
              ない可能性があります。この場合には，VMSINSTALはすべてのフ
              ァイルをただちに処理し，"%VMSINSTAL-I-MOVEFILES..."という
              メッセージを表示しません。

              ディスクでクォータが有効に設定されている場合は，メッセージ
              が表示されます。インストールのための十分なディスク・クォー
              タがアカウントに与えられていなければなりません。表 1-2を参
              照してください。


                             ACMS Desktopソフトウェアのインストール 2-15

 
     2.3.5  インストレーション検証プロシージャの実行


           IVPを実行することを選択した場合には，VMSINSTALはIVPを実行
           します。IVPが正常終了すると，次のメッセージが表示されま
           す。

           OpenVMS VAXシステムの場合:

           %RUN-S-PROC_ID, identification of created process is 210031D5
           Starting Server ACMSDI$SERVER
           The ACMS Desktop V2.3 IVP completed successfully
                        Installation of ACMSDI V2.3 completed at 13.32
              .
              .
              .
           The ACMS Desktop V2.3-00 IVP completed successfully

           OpenVMS Alphaシステムの場合:

           %RUN-S-PROC_ID, identification of created process is 00000176
           Starting Server ACMSDI$SERVER
              .
              .
              .
           The ACMS Desktop V2.3 IVP completed successfully
                        Installation of ACMSDI V2.3 completed at 13.32

               Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

               Creating installation data file: VMS$ROOT:[SYSUPD]ACMSDI023.VMI_DATA

     2.3.6  インストレーション・プロシージャの終了

           次のメッセージは，インストレーション・プロシージャがすべて
           完了したことを示します。

             Installation of ACMSDI V2.3 completed at 13:32

             VMSINSTAL procedure done at 13:33
           $


      2-16  ACMS Desktopソフトウェアのインストール

 
              特権付きアカウントからログアウトします。

              $ LOGOUT
              SYSTEM     logged out at 29-MAR-1997 14:40:12.28

              VMSINSTALは，インストール時にプロセス・シンボル・テーブル
              内のエントリを削除または変更します。したがって，この後もシ
              ステム・アカウントを使用し，これらのシンボルを復元したいと
              きは，ログアウトした後，再度ログインする必要があります。第
              3章を参照して，インストール後の作業を実行してください。


        ___________________________________________________________

        2.4   システム障害とインストール障害からの回復

              システム障害が発生したり，インストレーション・プロシージャ
              でエラーが検出されると，インストールは失敗します。

        2.4.1  システム障害


              インストール中に，停電などのシステム障害が発生した場合に
              は，VMSINSTALはシステムを再ブートしたときにインストールを
              続行しようとします。システム障害がインストールのどの時点で
              発生したかに応じて，次の3つの状況のいずれかになります。

               o  システムは，システム障害が発生する前の変更を保存して
                  いない。

                  VMSINSTALはインストールを再起動するように指示します。

               o  インストールで使用されていたシステム・ディスクが壊れ
                  た。

                  VMSINSTALはバックアップ・コピーからシステム・ディスク
                  を復元し，インストールを再起動するように要求します。

               o  VMSINSTALはインストールを続行する。

                  置換されたファイルを自動的にパージすることを要求した
                  場合でも，これらのファイルを手操作でパージするように
                  指示されます。ファイルをパージすることは可能ですが，
                  パージすると，システム・ディスクですべてのファイル
                  の最新バージョンを除き，他のすべてのバージョンが削除

                             ACMS Desktopソフトウェアのインストール 2-17

 
               されることを考慮しなければなりません。システム・ファ
               イルの複数のバージョンを保存している場合には，システ
               ム・ディレクトリから削除したいACMS Desktopファイルだ
               けを選択して削除することができます。

               ファイルをパージするには，次の手順を実行します。

                1.  システムを再ブートします。

                2.  SYSTEMアカウントにログインします。

                3.  次のコマンドを使用して，すべてのシステム・ファイ
                    ルをパージします。

                    $  PURGE/LOG SYS$SYSROOT:[*...]*.*

               この作業を実行した後，インストールは完了します。

           IVPが開始されたことを示すメッセージが表示されたら，コンポ
           ーネント・ソフトウェアのインストールは完了しています。そ
           の後でシステム障害が発生した場合には，再ブートしたときに
           VMSINSTALは次のメッセージを表示します。

           %VMSINSTAL-I-RECOVER, ACMS Desktop was being installed when the system crashed.

           The installation completed satisfactorily.

           このメッセージは，VMSINSTALが正常終了したことを示すもので
           あり，ACMS Desktopのインストールが正常終了したことを示すわ
           けではありません。

           VMSINSTALはIVPを自動的に再起動しません。第4章に説明されて
           いる手順に従って，IVPを単独で実行してください。

     2.4.2  ACMS Desktopのインストール・エラー

           ACMS DesktopソフトウェアのインストールまたはACMS Desktopサ
           ンプル・アプリケーションのインストールが，システム障害以外
           の何らかの理由で失敗した場合には，インストレーション・プロ
           シージャは失敗の原因を示すメッセージを表示します。インスト
           ールを続行するには，エラーの原因を修正するか，またはインス
           トレーション・プロシージャを最初からやり直してください。


      2-18  ACMS Desktopソフトウェアのインストール

 
              次の場合には，インストールの途中でエラーが発生する可能性が
              あります。

               o  オペレーティング・システムのバージョンが正しくない。

               o  必要なソフトウェアのバージョンが正しくない。

               o  インストールに必要なクォータが不足している。

               o  インストールに必要なシステム・パラメータ値が不足して
                  いる。

               o  OpenVMSヘルプ・ライブラリが使用中である。

              これらの状況によって生成されるエラー・メッセージの詳細に
              ついては，システム・メッセージ，リカバリ・プロシージャ，
              OpenVMSソフトウェア・インストレーションに関するOpenVMSのマ
              ニュアルを参照してください。これらの状況が発生したことが通
              知された場合には，メッセージの説明に従って適切な処置を実行
              してください(システム・パラメータを変更したり，クォータ値
              を増大しなければならない可能性があります)。インストールの
              必要条件については，第1章を参照してください。

              コンポーネント・ソフトウェアのインストールが正常終了した
              後，IVPでエラーが発生した場合には，IVPはエラーについて説明
              するメッセージを表示し，適切な対処法を示します。

              ほとんどの場合，対処法としてACMS Desktopソフトウェアを再イ
              ンストールすることが示されます。ACMS Desktopソフトウェアを
              再インストールした後，IVPでエラーが発生した場合には，DECの
              担当者にご相談ください。

        2.4.3  エラーからの回復

              ACMS Desktopソフトウェアをインストールした後，第4章の説明
              に従って，IVPを単独で実行できます。IVPを実行すると，各テス
              トおよび操作が正しく実行されるかどうかを確認できます。テス
              トまたは操作が失敗した場合には，IVPはエラーを示すメッセー
              ジを表示し，対処法を示します。


                             ACMS Desktopソフトウェアのインストール 2-19

 
           示された処置を実行した後，第4章の説明に従ってIVPを再実行し
           ます。ACMS Desktopソフトウェアを再インストールするときに，
           IVPの質問に対してYESと応答すると，IVPは自動的に実行されま
           す。それでもIVPを正しく実行できないときは，DECの担当者にご
           相談ください。


      2-20  ACMS Desktopソフトウェアのインストール

 
                                                                       3
        ________________________________________________________________

                          ACMS Desktopソフトウェアのインストール後の処理


              ACMS Desktopソフトウェアをインストールした後，次の作業を実
              行してください。

               o  OpenVMSシステム・スタートアップ・ファイルとシャットダ
                  ウン・ファイルを編集する。

               o  クラスタ環境において，クラスタの各ノードにACMSソフト
                  ウェア用のルートを準備する。

               o  『DIGITAL ACMS Desktop for OpenVMSクライアント・アプ
                  リケーション・プログラミング・ガイド』の管理に関する
                  章を参照する。

              ソフトウェアをインストールした後，インストレーション検証プ
              ロシージャ(IVP)を実行する方法については，第4章を参照してく
              ださい。

        ___________________________________________________________

        3.1   OpenVMSシステム・ファイルの編集

              システムを再ブートしたときに，ACMS Desktopソフトウェアの
              自動的なスタートアップとシャットダウンが行われるように，
              OpenVMSシステム・スタートアップ・ファイルとシャットダウ
              ン・ファイルを編集しなければなりません(システム・アップグ
              レードの場合は，通常，この手順は不要です)。

        3.1.1  システム・スタートアップ・ファイルの編集

              ACMSDI$STARTUP.COMファイルとACMSDI$SHUTDOWN.COMファイルは
              SYS$STARTUPディレクトリにあります。ACMS Desktopを起動する
              コマンド行をOpenVMSシステム・スタートアップ・ファイルに追
              加してください。スタートアップ・プロシージャをモジュールに
              分割している場合には，適切なファイルにコマンド行を追加して
              ください。


                      ACMS Desktopソフトウェアのインストール後の処理 3-1

 
           ACMS Desktopスタートアップ・コマンド行は，ACMSスタートアッ
           プ・コマンド・プロシージャを起動する行の後に追加します。次
           の例を参照してください。

           $ @SYS$STARTUP:ACMSTART.COM
              .
              .
              .
           $ @SYS$STARTUP:ACMSDI$STARTUP.COM
           $

              _______________________  注意 _______________________

              ACMS Desktopを起動する前に，ACMSを起動してください。

              _____________________________________________________

           ACMS Desktopソフトウェアを起動すると，自動的にDECnet通信
           トランスポートを使用できるようになります。NetWareまたは
           TCP/IPプロトコルも併用する場合や，DECnetのかわりにこれらの
           プロトコルを使用する場合には，使用するトランスポートをパ
           ラメータ・ファイルに指定します。パラメータ・ファイルは，
           ACMS Desktopスタートアップ・コマンド行に修飾子として指定し
           ます。

           パラメータ・ファイルは単純なASCIIテキスト・ファイルであ
           り，ACMS Desktop実行時のクォータと省略時の設定をカスタマイ
           ズするために使用します。このファイルで，OpenVMSシステムに
           インストールされている通信ライブラリの指定をカスタマイズす
           ることができます。たとえば，ACMS Desktopがすべてのトラン
           スポートを使用できるように設定するには，次の行を記述した
           ACMS_DESKTOP_SERVER.DATというファイルをSYS$MANAGER:に作成
           します。

           transport=(tcpip,netware,decnet,serial,appletalk)

           スタートアップ・コマンド行を変更して，パラメータ・ファイル
           を指定します。

           $ @SYS$STARTUP:ACMSDI$STARTUP.COM SYS$MANAGER:ACMS_DESKTOP_SERVER.DAT


      3-2  ACMS Desktopソフトウェアのインストール後の処理

 
              DCLレベルからバッチでこれと同じ機能を実行するには，次のコ
              マンドを使用します。

              $ SUBMIT/USER=SYSTEM/NOLOG SYS$STARTUP:ACMSDI$STARTUP-
              _$ /PARAMETER=(SYS$MANAGER:ACMS_DESKTOP_SERVER.DAT)


        3.1.2  システム・シャットダウン・ファイルの編集


              ACMSDI$SHUTDOWN.COMファイルはSYS$STARTUPディレクトリにあり
              ます。ファイルから次の行を探してください。

              $ @ACMSTOP.COM

              システム・シャットダウン・ファイルで，ACMSシステムを停止す
              る行の前に，次のコマンド行を追加します。

              $ @SYS$STARTUP:ACMSDI$SHUTDOWN.COM

              このコマンド・プロシージャは，すべてのアクティブ・タスクを
              キャンセルし，ACMS Desktopサーバをシャットダウンします。こ
              のようにすると，ACMS Desktopシステム・プロセスは正常に動作
              を終了することができます。また，このコマンド・プロシージャ
              は(OpenVMSのInstallユーティリティを使用して) ACMS Desktop
              イメージのインストールを取り消し，論理名の割り当てを解除し
              ます。

        ___________________________________________________________

        3.2   クラスタ環境での準備

              ACMSソフトウェアでは，VAXclusterまたはVMSclusterシステムが
              ローカル・エリア・ネットワーク(LAN)であるかのように取り扱
              われるため，クラスタの各ノードにシステム固有のルートを準備
              しなければなりません。次の例を参照してください。


                      ACMS Desktopソフトウェアのインストール後の処理 3-3

 
           $ CREATE/DIRECTORY SYS$SPECIFIC:[ACMSDI]/OWNER_UIC=SYSTEM-
           _$  /PROTECTION=(S:RWE,O:RWE,G:RE,W:RE)
           $ CREATE/DIRECTORY SYS$SPECIFIC:[SYSTEST.ACMSDI]/OWNER_UIC=SYSTEM-
           _$  /PROTECTION=(S:RWE,O:RWE,G:RE,W:RE)
           $ CREATE/DIRECTORY SYS$SPECIFIC:[SYSHLP.EXAMPLES.ACMSDI]/OWNER_UIC=SYSTEM-
           _$  /PROTECTION=(S:RWE,O:RWE,G:RE,W:RE)
           $


     ___________________________________________________________

     3.3    クライアント・ソフトウェアとサンプル・ソフトウェアのイン
            ストール

           デスクトップ・プラットフォームでACMS Desktopクライアント・
           プログラムを開発するには，デスクトップ開発システムのプラッ
           トフォームに応じたACMS Desktopクライアント・ソフトウェアを
           インストールしなければなりません。製品に含まれているサンプ
           ル・ソフトウェアを使用すると，マニュアルに説明されている設
           計手順と開発手順に従って作業を行う際に役立ちます。

     3.3.1  デスクトップ・システム用のクライアント・ソフトウェア


           インストール時には，クライアント・ソフトウェアはOpenVMSシ
           ステムに格納されます。インストールの後，このソフトウェアを
           デスクトップ開発システムに転送しなければなりません。ソフト
           ウェアを転送する手順の説明については，次の章を参照してくだ
           さい。

            o  DOS，Windows 3.n，Windows NT，Windows 95，DIGITAL
               UNIX，OpenVMS，UNIX，MIPS ULTRIX，SCO UNIX デスクトッ
               プ・システムの場合は，第5章を参照。

            o  Macintoshシステムの場合は，第6章を参照。

     3.3.2  クライアントとサーバのバージョンの対応関係

           ACMS Desktopバージョン2.nからACMS Desktopバージョン2.3にア
           ップグレードしても，既存のクライアント・プログラムは使用で
           きます。しかし，ACMS Desktopバージョン2.3のもとで新規クラ
           イアント・プログラムをビルドした場合には，ACMS Desktopバー
           ジョン2.nでその新規プログラムを使用することはできません。


      3-4  ACMS Desktopソフトウェアのインストール後の処理

 
              ACMSDIデスクトップ・サーバ通信プロトコルがACMSDIデスクト
              ップ・クライアントのプロトコルと一致しない場合には，ACMS
              Desktopサーバは接続要求を拒否します。この場合，サーバはソ
              フトウェア・イベント・ログ(SWL)にメッセージを出力します。


              クライアント側に戻されるエラー・コードは，不一致の性質に応
              じて異なります。次のエラー・コードが戻された場合は，バージ
              ョンが一致していないことを示します。

              ACMSDI_SRVDEAD      -3020
              ACMSDI_INVPROTOCOL  -3025


        3.3.3  サンプル・ソフトウェア

              インストール時にサンプル・ソフトウェアを要求した場合には，
              サンプルを格納するためのディレクトリがOpenVMSシステムに作
              成されます。ACMSおよびACMS Desktopソフトウェアのもとでサン
              プル・ソフトウェアをセットアップし，実行したい場合には，マ
              ニュアルの説明に従って適切な手順を実行してください。

               o  DOSおよびWindowsシステムの場合は，ブロッキング・クラ
                  イアント・プログラムと非ブロッキング・クライアント・
                  プログラムの両方のサンプルを使用できます。

                  ブロッキング・クライアントと非ブロッキング・クライア
                  ントのサンプルをインストールする場合は，第5章を参照し
                  てください。

               o  Macintoshシステムの場合は，バージョン7サンプル・クラ
                  イアント・プログラムを使用できます。

                  第6章の第6.1節を参照してください。

               o  OpenVMSシステムでサンプル・アプリケーションをセットア
                  ップするには，第5.2.7.5項の手順に従ってください。


                      ACMS Desktopソフトウェアのインストール後の処理 3-5

 
     ___________________________________________________________

     3.4    問題の判断と報告

           ACMS Desktopソフトウェアをインストールすると，システムの状
           態が変化します。システムの変更はシステム管理ログに記録して
           ください。ACMS Desktopソフトウェアの使用中にエラーが発生
           し，そのエラーの原因がACMS Desktopにあると考えられる場合
           は，最寄りの日本DECの各支店/営業所にご連絡願います。


      3-6  ACMS Desktopソフトウェアのインストール後の処理

 
                                                                       4
        ________________________________________________________________

                                                  ACMS Desktop IVPの実行


              この章では，インストレーション・プロシージャとは別にACMS
              Desktop IVPを実行する方法について説明します。インストレー
              ション検証プロシージャ(IVP)は通常のインストールの一部とし
              て実行できます。ACMS Desktopソフトウェアをインストールする
              ときに，IVPに関する質問に対してYESと応答した場合には，IVP
              は自動的に実行されます。何らかの理由でIVPでエラーが発生し
              た場合は，エラーに対する処置を実行した後，IVPを再実行して
              ください。インストレーション・プロシージャの一部としてIVP
              を実行する方法については，第2章を参照してください。


        ___________________________________________________________

        4.1   IVPの操作

              IVPは，インストレーション・プロシージャがACMS Desktopソフ
              トウェアを正しくインストールしたかどうかと，ACMS Desktopア
              プリケーションが正しくセットアップされていて，実行できるか
              どうかを確認します。

              IVPは，必要なすべてのファイルがシステムに格納されているか
              どうかを確認します。

        ___________________________________________________________

        4.2   IVPの単独実行

              この節では，IVPを実行するために必要な条件と手順について説
              明します。


                                              ACMS Desktop IVPの実行 4-1

 
     4.2.1  IVPを実行するための必要条件


           ディスク・クォータが有効に設定されている場合は，IVPを実行
           できません。プロシージャはプロセス・クォータを確認した直後
           に，ディスク・クォータが有効に設定されているかどうか確認し
           ます。ディスク・クォータが有効に設定されている場合には，プ
           ロシージャはそのことを示す情報メッセージを出力して終了しま
           す。


     4.2.2  IVPの操作手順

           インストレーション・プロシージャと別にIVPを実行するには，
           次の手順を実行します。

            1. SYSTEMアカウントにログインします。

               Username:  SYSTEM
               Password:

            2. カレント・ディレクトリをテスト・ディレクトリに設定し
               ます。

               $  SET DEFAULT SYS$TEST
               $

            3. ACMSインストレーション検証プロシージャ，ACMSDI$IVP.COM
               を実行します。

               IVPは現在ブートされているシステムだけで実行できます。
               ネットワーク接続を介してIVPを実行することはできませ
               ん。IVPを起動するには，次のコマンドを入力します。

               $  @ACMSDI$IVP
                  .
                  .
                  .
               The ACMS Desktop V2.3-0 IVP completed successfully
               $

               IVPの実行にかかる時間は30秒以内ですが，現在のシステム
               負荷によって多少前後します。


      4-2  ACMS Desktop IVPの実行

 
        4.2.3  IVPエラーからの回復


              IVPを実行すると，各テストおよび操作が正常終了したかどうか
              が確認されます。テストまたは操作でエラーが発生した場合に
              は，IVPは問題を示すメッセージを表示し，適切な対処法も示し
              ます。適切な処置を実行した後，IVPを再起動してください。


                                              ACMS Desktop IVPの実行 4-3

 
                                                                   第2部
        ________________________________________________________________

                                      ACMS Desktopクライアント・サービス


              第2部では，ACMS Desktopクライアント・サービスとACMS
              Desktopダイナミック・リンク・ライブラリをデスクトップ・シ
              ステムにインストールする方法について説明します。

 
                                                                       5
        ________________________________________________________________

               ACMS DesktopポータブルAPIサービスとサンプルのインストール


              ACMS Desktop製品とサンプル・ソフトウェアをホストのOpenVMS
              システムにインストールした後，適切なネットワーク・ソフトウ
              ェアがインストールされている個々のデスクトップ・システムに
              APIとサンプルをインストールできます。

              この章では，ACMS Desktopサービスのインストールについて説明
              します。

               o  第5.1.1項

                  デスクトップ・ソフトウェアのインストールの前提条件に
                  ついて説明します。

               o  第5.2節

                  DOSおよびMicrosoft Windowsオペレーティング・システム
                  用のAPIとサンプルのインストレーション手順を示します。

               o  第5.3節

                  Microsoft Windows 95オペレーティング・システム用のAPI
                  のインストレーション手順を示します。

               o  第5.4節

                  Microsoft Windows NTオペレーティング・システム用のAPI
                  のインストレーション手順を示します。

               o  第5.5節

                  OpenVMSオペレーティング・システム用のAPIとサンプルの
                  インストレーション手順を示します。

               o  第5.6節

                  DIGITAL UNIXオペレーティング・システム用のAPIのインス
                  トレーション手順を示します。

               o  第5.7節

           ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-1

 
               SCO UNIXオペレーティング・システム用のAPIとサンプルの
               インストレーション手順を示します。

            o  第5.8節

               RISC ULTRIXオペレーティング・システム用のAPIとサンプ
               ルのインストレーション手順を示します。

            o  最後の節，第5.9節

               インストール時に発生する可能性のある典型的なエラーに
               ついて説明します。

     ___________________________________________________________

     5.1    APIおよびサンプル・ソフトウェアのインストールの準備

           この節では，ACMS Desktopサービスをインストールするために必
           要な前提条件について説明します。

     5.1.1  必要なソフトウェア

           ACMS Desktopサービスをさまざまなデスクトップ・システムにイ
           ンストールする場合には，ACMSソフトウェアの適切なバージョン
           を実行しているOpenVMSシステムに対して，表 5-1に示したネッ
           トワークでアクセスできなければなりません。


      5-2  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-1 ネットワーク・アクセス
              __________________________________________________________
              デスクトップ・シ
              ステム_____________ネットワーク___________________________

              DOS                DECnet，TCP/IP，NetWare，シリアル

              Windows            DECnet，TCP/IP，NetWare，シリアル

              Windows 95         DECnet，TCP/IP

              Windows NT         DECnet，TCP/IP[1]

              OpenVMS VAX        DECnet，TCP/IP，NetWare[2]

              OpenVMS Alpha      DECnet，TCP/IP，NetWare[2]

              DIGITAL UNIX       DECnet，TCP/IP
              Alpha

              Macintosh          DECnet，TCP/IP，Apple-Talk/DECnet

              SCO UNIX           DECnet，TCP/IP

              RISC ULTRIX        DECnet，TCP/IP
              [1]TCP/IPはWindows_NTバージョン4.0でサポートされる。______

              [2]NetWareはテストのためにだけサポートされる。
              __________________________________________________________

              表 5-2は，さまざまなAPIを使用するために必要な製品を示して
              います。この表はネットワーク・トランスポート別に分かれてい
              ます。


           ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-3

 
           表 5-2 APIを使用するために必要なソフトウェア
           __________________________________________________________
           DECnetを使用するAPI____必要な製品_________________________

           DOSクライアント        PATHWORKS for DOS/Windowsバージョン
                                  5.0以上，
                                  Microsoft Visual C++バージョン
                                  1.5またはそれと互換性のあるコンパイ
                                  ラ

           Microsoft Windowsクラ  PATHWORKS for DOS/Windowsバージョン
           イアント               5.0以上，
                                  Microsoft Visual C++バージョン
                                  1.5またはそれと互換性のあるコンパイ
                                  ラ

           Windows 95クライアン   PATHWORKS for Windows 95バージョン
           ト                     1.0以上，
                                  Microsoft Visual C++バージョン
                                  4.0またはそれと互換性のあるコンパイ
                                  ラ

           Windows NTクライアン   PATHWORKS for Windows NTバージョン
           ト                     4.1b，
                                  Microsoft Visual C++バージョン
                                  4.0またはそれと互換性のあるコンパイ
                                  ラ

           Visual Basicクライア   PATHWORKS for DOS/Windowsバージョン
           ント                   5.0以上，
                                  Visual Basicバージョン3.0以上

           OpenVMS VAXクライアン  VAX Cまたはそれと互換性のあるコンパ
           ト                     イラ，
                                  DECnet-VAX

           __________________________________________________________
                                                     (次ページに続く)


      5-4  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-2 (続き) APIを使用するために必要なソフトウェア
              __________________________________________________________
              DECnetを使用するAPI____必要な製品_________________________

              OpenVMS Alphaクライア  DEC Cまたはそれと互換性のあるコンパ
              ント                   イラ，
                                     DECnet-Alpha

              RISC ULTRIXクライアン  DEC Cまたはそれと互換性のあるコンパ
              ト                     イラ[1]，
                                     DECnet-ULTRIX

              SCO UNIXクライアント   SCO UNIX System V/386またはSCO
                                     ODT，
                                     DECnet for SCO UNIX

              OpenVMS Alphaサーバ    DECnet-Alpha，
                                     ACMSリモートまたはランタイム

              OpenVMS VAXサーバ      DECnet-VAX，
                                     ACMSリモートまたはランタイム

              __________________________________________________________
              TCP/IPを使用するAPI____必要な製品_________________________

              DOSクライアント        PATHWORKS for DOS/Windowsバージョン
                                     5.0以上

              Microsoft Windowsクラ  PATHWORKS for DOS/Windowsバージョン
              イアント               5.0以上[2]

              Windows 95クライアン   Microsoft Visual C++バージョン4.0ま
              ト                     たはそれと互換性のあるコンパイラ

              Windows NTクライアン   Microsoft Visual C++バージョン4.0ま
              ト                     たはそれと互換性のあるコンパイラ

              [1]UWSを実行している場合は，DEC_Cコンパイラはすでに用意さ_

              れている。
              [2]Windowsクライアントは，Windows Socketsバージョン1.1標準
              規格に従うWindows用のTCP/IPであれば，どれでも使用できる。

              __________________________________________________________
                                                        (次ページに続く)

           ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-5

 
           表 5-2 (続き) APIを使用するために必要なソフトウェア
           __________________________________________________________
           TCP/IPを使用するAPI____必要な製品_________________________

           Macintoshクライアント  PATHWORKS for Macintosh

           DIGITAL UNIX Alpha     DEC Cまたはそれと互換性のあるコンパ
                                  イラ

           RISC ULTRIXクライアン  DEC Cまたはそれと互換性のあるコンパ
           ト                     イラ[1]

           SCO UNIXクライアント   SCO UNIX SYSTEM V/386またはSCO
                                  ODT，
                                  SCO TCP/IPランタイム

           OpenVMSサーバ          TCP/IP Services for OpenVMSバージョ
                                  ン3.2またはMultinetバージョン3.3，
                                  ACMSリモートまたはランタイム

           __________________________________________________________
           NetWareを使用するAPI___必要な製品_________________________

           DOSクライアント        Novell NetWareバージョン3.2，または
                                  PATHWORKSバージョン5.0

           Microsoft Windowsクラ  Novell NetWareバージョン3.2，
           イアント               またはPATHWORKSバージョン5.0，
                                  Microsoft Windowsバージョン3.1，
                                  Microsoft Visual C++バージョン1.5

           Visual Basicクライア   Novell NetWareバージョン3.2，または
           ント                   PATHWORKSバージョン5.0

           OpenVMSサーバ          Interconnections Leverage Host
                                  Serverバージョン3.1
           [1]UWSを実行している場合は，DEC_Cコンパイラはすでに用意さ_

           れている。

           __________________________________________________________
                                                     (次ページに続く)


      5-6  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-2 (続き) APIを使用するために必要なソフトウェア
              __________________________________________________________
              シリアル通信を使用す
              るAPI__________________必要な製品_________________________

              DOSクライアント        なし

              Microsoft Windowsクラ  なし
              イアント__________________________________________________


              表 5-3は，サンプル・アプリケーションを使用するために必要な
              製品を示しています。

        表 5-3 サンプル・アプリケーションに必要な製品
        ________________________________________________________________
        サンプル____________必要な製品__________________________________

        DOS                 Microsoft COBOLバージョン5.0，
                            Microsoft Visual C++バージョン1.5以上

        Microsoft Windows   Microsoft Windowsバージョン3.1以上，
                            Microsoft Visual C++バージョン1.5以上

        Visual Basicクライ  Microsoft Windowsバージョン3.1以上，
        アント              Microsoft Visual Basicバージョン3.0以上

        OpenVMS用のMotif    VAX C for OpenVMSバージョン3.0以上，
                            DECwindows Motif for OpenVMS Alphaバージ
                            ョン1.0

        DIGITAL UNIX Alpha  DEC C，DIGITAL UNIX for OSF/Motifバージョン
        用のMotif           1.1上のDECwindows Developers Kit

        RISC ULTRIX用の     DEC C for RISC，RISC ULTRIX for OSF/Motifバ
        Motif               ージョン1.1上のDECwindows Developer Kit

        SCO/ODT用のMotif    Open Desktop Development Systemバージョン
        ____________________1.1.ob以上__________________________________


           ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-7

 
     5.1.2  APIインストレーションの必要条件


           この項では，ソフトウェアをインストールするための必要条件に
           ついて説明します。

     5.1.2.1  時間

           表 5-4は，スタンドアロン・デスクトップ・システムにACMS
           Desktopサービスをインストールするために必要なおよその時間
           を示しています。

           インストールするために必要な時間は，ハードウェア構成とネッ
           トワーク接続に応じて異なります。

           表 5-4 APIをインストールするために必要な時間
           __________________________________________________________
           デスクトップ・シス
           テム________________インストールするために必要な時間______

           DOS (ハード・ディ   10分
           スク)

           OpenVMS              5分

           DIGITAL UNIX        10分

           SCO UNIX            10分

           ULTRIX______________10分__________________________________

     5.1.2.2  リソース

           インストレーション・プロシージャを開始する前に，次のリソー
           スを入手してください。

            o  ACMS DesktopサーバがインストールされているOpenVMSシス
               テムのDECnetノード名(TCP/IPでのホスト名)

            o  ACMS DesktopサーバがインストールされているOpenVMSシス
               テムでの有効なアカウント(ユーザ名とパスワード)

            o  ACMS Desktop APIとネットワーク・ソフトウェアを格納す
               るためのディレクトリ・サーチ・パスの通っているディレ
               クトリ

      5-8  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
               o  サンプル・ソフトウェアをインストールするためのディレ
                  クトリ

               o  API，ネットワーク・ソフトウェア，サンプル・コードをイ
                  ンストールするための十分なディスク容量

               o  TCP/IPまたはNetWareでのホスト名

        5.1.2.3 自己解凍アーカイブの使用

              次の自己解凍アーカイブが提供されています。

               o  DOS，Windows，Windows 95，およびWindows NT用のクライ
                  アントAPI

               o  DOS/Windows用のサンプル

              これらのアーカイブは実行時に展開されます。自己解凍アーカイ
              ブはInfo-ZIPの圧縮ユーティリティを使用して作成されていま
              す。Info-ZIPのソフトウェア(Zip，UnZip，UnZipSfx，および関
              連ユーティリティ)は無料で提供されており，さまざまな掲示板
              サービスやインターネットのウェブ・ブラウザ・サービスからソ
              ースまたは実行可能な形式で入手できます。

        ___________________________________________________________

        5.2   DOSおよびWindowsのAPIのインストール

              ACMS Desktopでは，MSDOS.EXEという自己解凍アーカイブが提供
              され，このアーカイブにはACMS Desktop用のDOS APIとWindows
              3.n APIに関連するすべてのファイルが格納されています。この
              アーカイブに格納されているファイルには，スタティック・リン
              ク・ライブラリと，Windowsのもとで使用されるDLLが含まれてい
              ます。サポートされるトランスポートに対して個々のオブジェク
              ト・ファイルとDLLが提供され，シリアル・トランスポート用の
              電話ダイヤリングを取り扱うファイルもあります。

              アーカイブを展開するには，PCの何も登録されていないディレク
              トリにイメージ・モードでアーカイブをコピーし，実行します。
              アーカイブが展開され，ファイルを使用できるようになります。
              たとえば，PCで次のように実行します。


           ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-9

 
           C:\ >   CD ACMSDI
           C:\ >   NFT COPY/block nodename"username password"::ACMSDI$MSDOS:MSDOS.EXE
           C:\ >   MSDOS.EXE


           DOS固有のファイルの他に，アプリケーションをビルドする際に
           必要ないくつかの共通ファイルがあります。これらのファイルは
           OpenVMSシステムのACMSDI$COMMONディレクトリにあります。

               ACMSDI.H
               FORMS.H
               PPSTUBS.C
               TDMS.H

           これらのファイルは，たとえばDECnetを使用してカレント・ディ
           レクトリにコピーします。

           C:\ >   NFT COPY nodename"username password"::ACMSDI$COMMON:*.*

           これが作業ディレクトリになる場合は，autoexec.batスタートア
           ップ・ファイルで，ライブラリのパス，インクルード・ファイ
           ル，実行パスを定義する環境変数にこのディレクトリを追加しま
           す。次の例を参照してください。

               set LIB=%LIB%;dir
               set INCLUDE=%INCLUDE%;dir
               set PATH=%PATH%;dir


     5.2.1  DOSクライアント・サービスのセットアップ

           DOS APIではスタティック・リンク・ライブラリACMSDIL.LIBを使
           用します。


           ラージ・メモリ・モデルに対してトランスポート・オブジェク
           ト・ファイルが提供されており，その名前はサポートするトラン
           スポートを反映しています。アプリケーションをビルドするとき
           に使用するトランスポートに対応したオブジェクト・ファイルを
           選択してください。


      5-10  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              __________________________________________________________
              メモリ・モ                                          シリア
              デル________DECnet_______TCP/IP_______Netware_______ル____

              ラージ______netdecl.obj__nettcpl.obj__netwarel.obj__netstl.obj


              スタティック・リンク・ライブラリにはDECnetオブジェクトが登
              録されています。DECnetを使用しない場合は，DECnetモジュール
              を削除し，使用するモジュールを挿入してください。たとえば，
              TCP/IP用にラージ・モデルをセットアップするには，次のように
              します。

                  LIB ACMSDIL.LIB -NETDECL;
                  LIB ACMSDIL.LIB +NETTCPL;

        5.2.2  DOSサンプル・アプリケーションのインストール


              DOS COBOLサンプルは，OpenVMSシステムで自己解凍アーカイブ・
              ファイルとして提供されます。アーカイブを展開するには，PCで
              何も登録されていないディレクトリにイメージ・モードでアーカ
              イブをコピーし，実行します。たとえば，PCで次のように実行し
              ます。

        C:\ >   CD ACMSDI\CLIENT
        C:\ >   NFT COPY/block nodename"user passw"::ACMSDI$EXAMPLES_MSDOS:EGCOBOL.EXE
        C:\ >   EGCOBOL.EXE

              サンプルの実行可能イメージはDECnetライブラリを使用してビル
              ドされています。DECnetを実行していない場合には，サンプルを
              使用する前に再リンクする必要があります。


        5.2.3  DOSサンプルのインストールの検証

              アプリケーションをビルドすることができるかどうかを確認する
              ために，サンプル・クライアント・プログラムのソース・コード
              をコンパイルし，リンクして，実行します。サンプル・アプリケ
              ーションをビルドするには，デスクトップ・システムに次の製品
              が必要です。


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-11

 
            o  Microsoft Visual C++バージョン1.5以上でコンパイルされ
               たオブジェクトにアクセスできるコンパイラ(Microsoft C
               を推奨)

            o  Microsoft Visual C++バージョン1.5と互換性のあるCラン
               タイム・ライブラリ

            o  Microsoft COBOLソフトウェアと互換性のあるCOBOLコンパ
               イラ(サンプル・アプリケーションをビルドするためにだけ
               必要)

           このソフトウェアには，サンプル・クライアント・プログラムを
           ビルドするためのバッチ・ファイルが含まれています。このファ
           イルはそれぞれのソフトウェア開発環境に従って変更できます。
           ファイルを変更した後，次のコマンドを入力してください。

           \CLIENT>  BLD-PPS
              .
              .
              .
           \CLIENT>  BLD-CLI
              .
              .
              .

           サンプル・クライアント・プログラムを実行するには，次のコマ
           ンドを入力します。

           \CLIENT>  CLIENT

           クライアント・プログラムはAVERTZ Vehicle Rental System (レ
           ンタカー・システム)アプリケーションのメイン・メニューを表
           示します。

           サンプル・プログラムをAVERTZサンプル・アプリケーションに接
           続するには，第5.2.7.5項に示した手順に従って，ACMSシステム
           でサンプル・アプリケーションをセットアップします。ACMSシス
           テムにサイン・インし，アプリケーションの予約タスクを使用で
           きます。

           これでインストール手順は完了し，正常終了したことが確認され
           ました。


      5-12  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
        5.2.3.1 システムに追加されるDOSのサンプル・ファイル

              表 5-5に示したCおよびCOBOL言語ファイル(.c，.h，.cbl)はすべ
              て，DOSのサンプルのインストール時にデスクトップ・システム
              にコピーされます。

              表 5-5 DOSのサンプル・ファイル
              __________________________________________________________
              名前_______________説明___________________________________

              ACMSDI.H           ACMSDI用のインクルード・ファイル

              BLD-CLI.BAT        サンプル・クライアント・プログラムをコ
                                 ンパイルおよびリンクするためのバッチ・
                                 ファイル

              BLD-PPS.BAT        サンプル・クライアント・プログラムで使
                                 用されるプレゼンテーション・プロシージ
                                 ャをコンパイルおよびリンクするためのバ
                                 ッチ・ファイル

              CHK-DATE.CBL       日付を確認するためのCOBOLプログラム

              CLASSES.CBL        サンプル・ワークスペース

              CLIENT.C           サンプル・クライアントのCメイン・プログ
                                 ラム

              CLIENT.EXE         サンプル・クライアント・プログラム

              CONTROL.CBL        サンプル・ワークスペース

              CUSTOMER.CBL       サンプル・ワークスペース

              CUSTSHDW.CBL       サンプル・ワークスペース

              CU_TRANS.CBL       サンプル・ワークスペース

              __________________________________________________________
                                                        (次ページに続く)


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-13

 
           表 5-5 (続き) DOSのサンプル・ファイル
           __________________________________________________________
           名前_______________説明___________________________________


           DISABLE.C          サンプル・プレゼンテーション・プロシー
                              ジャ

           ENABLE.C           サンプル・プレゼンテーション・プロシー
                              ジャ

           FORMS.H            DECforms状態値が登録されたサンプル・イ
                              ンクルード・ファイル

           GETSITE.CBL        サンプル・プレゼンテーション・プロシー
                              ジャ

           LOADER.BAT         OpenVMS VAXシステムからサンプルをダウン
                              ロードするためのバッチ・ファイル

           LOGIN.CBL          サンプル・クライアント初期化プロシージ
                              ャ

           LOGOFF.CBL         サンプル・クライアント終了プロシージャ

           MENU.CBL           サンプル・クライアント・メニュー・プロ
                              シージャ

           RECV.C             サンプル・プレゼンテーション・プロシー
                              ジャ

           REQUEST.C          サンプル・プレゼンテーション・プロシー
                              ジャ

           RESERVTN.CBL       サンプル・ワークスペース

           SELCUST.CBL        サンプル・プレゼンテーション・プロシー
                              ジャ

           __________________________________________________________
                                                     (次ページに続く)


      5-14  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-5 (続き) DOSのサンプル・ファイル
              __________________________________________________________
              名前_______________説明___________________________________


              SELSITE.CBL        サンプル・プレゼンテーション・プロシー
                                 ジャ

              SEND.C             サンプル・プレゼンテーション・プロシー
                                 ジャ

              SENDCTRL.CBL       サンプル・ワークスペース

              SHWCUST.CBL        サンプル・プレゼンテーション・プロシー
                                 ジャ

              SHWRESV.CBL        サンプル・プレゼンテーション・プロシー
                                 ジャ

              SITES.CBL          サンプル・ワークスペース

              SI_TRANS.CBL       サンプル・ワークスペース

              TDMS.H             TDMS状態値が登録されたサンプル・インク
                                 ルード・ファイル

              TRANS.C            サンプル・プレゼンテーション・プロシー
                                 ジャ

              TRANS.CBL          サンプル・ワークスペース

              TRANSHDW.CBL       サンプル・ワークスペース

              VERSION.C          サンプル・バージョン・チェック・プロシ
              ___________________ージャ_________________________________


        5.2.4  Windowsクライアント・サービスのセットアップ


              通常，Windowsのもとでアプリケーションをビルドする場合に
              は，スタティック・リンク・ライブラリではなく，ACMS Desktop
              で提供されるDLLが使用されます。ただし，トランスポートが


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-15

 
           DECnetの場合は，必要に応じてスタティック・リンク・ライブラ
           リを使用できます。DLLを使用するには，サポートされるトラン
           スポートを選択して，DLLを指定します。

           __________________________________________________________
           DECnet________TCP/IP________Netware_______シリアル________

           ACMSDIDN.DLL__ACMSDIWS.DLL__ACMSDINW.DLL__ACMSDIST.DLL____

           ACMS Desktop for Windowsで使用するDLLの名前はACMSDI.DLLで
           す。必要なトランスポートのサポートを含むDLLを選択してコピ
           ーし，ACMSDI.DLLを作成します。たとえば，Winsockインタフェ
           ースを介してTCP/IPを使用するには，次のように指定します。

           C:\ >  copy ACMSDIWS.DLL ACMSDI.DLL

           このようにしてコピーしたDLLをその場所で使用するには，その
           DLLを格納しているディレクトリがパスに指定されているか，ま
           たはWindows用の省略時の作業ディレクトリでなければなりませ
           ん。

           実行可能ファイルdiTskLnk.exeは，TCP/IPを使用して，Windows
           バージョン3.1のもとでサブミッタ・セッションを共用する複数
           の実行可能ファイルをサポートします。この実行可能ファイルに
           ついての説明は，『DIGITAL ACMS Desktop for OpenVMS Gateway
           Management Guide』を参照してください。


     5.2.5  漢字コード変換ライブラリ


           ACMS Desktopでは，漢字を使用するユーザのためのコード変換ラ
           イブラリを提供しています。このライブラリは，Shift JISコー
           ドとDEC Kanjiコードとの間でコード変換を行います。アプリケ
           ーションで漢字コード変換が必要な場合には，これらのライブラ
           リをクライアントのユーザ・アプリケーションとリンクすること
           ができます。

           これらのライブラリは次のディレクトリに格納されています。

               SYS$COMMON:[ACMSDI.JCNVWIN.WIN31] (Windows 3.1用)
               SYS$COMMON:[ACMSDI.JCNVWIN.WIN95] (Windows 95用)


      5-16  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              詳細については，いずれかのディレクトリに格納されている
              JCNVWIN_GUIDE.PSまたはJCBVWIN_GUIDE.TXTを参照してくださ
              い。


        5.2.6  Windowsサンプル・アプリケーションのインストール

              Windows用のAvertzサンプルは，OpenVMSシステムでACMSDI$EXAMPLES_
              MSW31:ディレクトリ内の自己解凍アーカイブ・ファイルとして2
              種類の形態で提供されます。ファイルSDK31LIB.EXEには，DECnet
              ミディアム・モデル・スタティック・リンク・ライブラリを使用
              するためのサンプル・ソース・ファイルとメーク・ファイルの両
              方が格納されています。ファイルSDK31DLL.EXEには，DLLに対し
              てビルドするための代替ファイルだけが格納されています。展開
              された実行可能ファイルは，サポートされるどのトランスポート
              のもとでも機能します。選択したアーカイブを展開するには，PC
              で何も登録されていないディレクトリにイメージ・モードでアー
              カイブをコピーし，実行します。たとえば，PCでスタティック・
              リンク・ライブラリに対してビルドするためのファイルを取得す
              るには，次の手順を実行します。

        C:\ >   CD ACMSDI\SDK31
        C:\ >   NFT COPY nodename"username password"::ACMSDI$COMMON:*.h
        C:\ >   NFT COPY/block nodename"user passw"::ACMSDI$EXAMPLES_MSW31:SDK31LIB.EXE
        C:\ >   SDK31LIB.EXE

              DLLビルド用のファイルを取得するには，上記の手順を実行して
              ソースを入手した後，DLLバージョンをビルドするためのアーカ
              イブを展開して，スタティック・リンク・メーク・ファイルを無
              効にします。

        C:\ >   NFT COPY/block nodename"user passw"::ACMSDI$EXAMPLES_MSW31:SDK31DLL.EXE
        C:\ >   SDK31DLL.EXE


        5.2.7  Windowsサンプルのインストールの検証

              アプリケーションをビルドすることができるかどうかを確認する
              ために，サンプル・クライアント・プログラム用のソース・コー
              ドをコンパイルし，リンクして，実行します。サンプル・アプリ
              ケーションをビルドするには，デスクトップ・システムに次の製
              品が必要です。


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-17

 
            o  Microsoft Visual C++バージョン1.5以上でコンパイルされ
               たオブジェクトにアクセスできるコンパイラ(Microsoft C
               を推奨)

            o  Microsoft Visual C++バージョン1.5と互換性のあるCラン
               タイム・ライブラリ

            o  Microsoft Windowsバージョン3.1またはWindows for
               Workgroupsバージョン3.1.1

            o  スタティック・リンク・ライブラリに対してビルドする場
               合は，PATHWORKSバージョン5.1 Software Developer's Kit
               が必要。

           サンプル・アプリケーションをビルドするには，次の手順を実行
           します。

            1. AVERTZメーク・ファイルを使用し，サンプル・ファイルが
               格納されているディレクトリでNMAKEを実行することによ
               り，サンプル・アプリケーションをビルドします。

                o   NMAKEを使用するには，次のコマンドを入力します。

                    nmake -f AVERTZ

            2. 次のコマンドを入力してWindowsを起動します。

               win

            3. 次のいずれかの方法でAVERTZプログラムを実行します。

                o   「ファイル名を指定して実行」コマンドの使用

                     a. プログラム・マネージャの「アイコン」メニュー
                        で「ファイル名を指定して実行」コマンドを選択
                        します。

                     b. 表示されるダイアログ・ボックスに次の場所を入
                        力します。

                        \ACMSDI\SDK31\avertz

                o   AVERTZプログラム・アイコンを画面に追加し，それを
                    ダブル・クリックします。

                     a. プログラム・マネージャの「アイコン」メニュー
                        で「登録とグループの作成」コマンドを選択しま
                        す。

      5-18  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
                           この操作を実行すると，アイコンを含むグルー
                           プ・ウィンドウが作成されます。

                       b.  ダイアログ・ボックスで「グループの作成」を選
                           択し，「OK」ボタンをクリックします。

                       c.  タイトル名を要求するプロンプトに対して，グル
                           ープ・ウィンドウの名前を入力します。次の例を
                           参照してください。

                           ACMS Desktop サンプル

                       d.  グループ・ウィンドウのファイル名を指定しま
                           す。次の例を参照してください。

                           C:\ACMSDI\SDK31\sample

                           名前を入力した後，グループ・ウィンドウ名を含
                           むウィンドウが表示されます。

                       e.  新しいグループ・ウィンドウをクリックして，そ
                           れを選択します。

                       f.  プログラム・マネージャの「アイコン」メニュ
                           ーで「登録とグループの作成」コマンドを選択し
                           て，AVERTZアイコンをグループ・ウィンドウに追
                           加します。

                       g.  ダイアログ・ボックスで「アイコンの登録」を選
                           択します。

                       h.  プロンプトに対してアイコンのタイトルを入力し
                           ます。次の例を参照してください。

                           AVERTZ.

                       i.  コマンド・ライン・フィールドにAVERTZ実行可能
                           ファイルの場所を入力します。次の例を参照して
                           ください。

                           C:\ACMSDI\SDK31

                       j.  ダイアログ・ボックスで「OK」ボタンをクリック
                           します。

                           AVERTZアイコンがグループ・ウィンドウに表示さ
                           れます。

          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-19

 
                     k. AVERTZアイコンをダブル・クリックして，サンプ
                        ル・クライアント・プログラムを実行します。


           AVERTZプログラムはAVERTZ Vehicle Rental Systemアプリケーシ
           ョンのメニュー・バーを表示します。

           サンプル・デスクトップ・クライアント・プログラムがACMS
           アプリケーションと通信できるように設定したい場合には，第
           5.2.7.5項の手順に従って，ACMSシステムでサンプル・アプリケ
           ーションをセットアップします。ACMSシステムをセットアップ
           した後，「Session」メニューを使用して，ACMSシステムにサイ
           ン・インします。サイン・インした後，「Rental」メニューを使
           用して，AVERTZアプリケーションの予約タスクを実行できます。

           これでインストール手順は完了し，インストールが正常終了した
           ことが確認されました。

           プログラムの実行中にエラーが発生した場合には，スタートアッ
           プ・ファイルまたは構成ファイルに問題があると考えられます。
           例 5-1はstartup.batファイルの例を示しています。

           例 5-1 startup.batファイルの例

           path=c:\;c:\PWV51;c:\dos;c:\MSVC\bin;c:\windows;c:\windev;c:\acmsdi
           mouse
           set lib=c:\MSVC\lib;c:\windev\lib;c:\acmsdi;c:\decnet\src
           set include=c:\MSVC\include;c:\windev\include;o:\acmsdi;c:\decnet\src
           set helpfiles=c:\MSVC\help\*.hlp
           set init=c:\MSVC\init


      5-20  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              例 5-2はconfig.sysファイルの例を示しています。

              例 5-2 config.sysファイルの例

              files= 30
              buffers=10
              device=C:\himem.sys
              shell=\command.com /P /e:1024
              device=C:\WINDOWS\smartdrv.sys 2048 1024
              lastdrive=z


              これらの例を参考にして，問題を突き止め，修正してください。

        5.2.7.1 マルチバージョン対応のRdbバージョン6.0が動作するシステ
                ムでのAVERTZサンプル・アプリケーションの使用

              サンプル・アプリケーションをセットアップするためにVR_DA_
              RUNTIME_SETUP.COMファイルを実行すると，このコマンド・フ
              ァイルはVR_READ_SERVER.OPTとVR_UPDATE_SERVER.OPTという2
              つのオプション・ファイルを起動します。これらのファイルは
              SYS$LIBRARY:SQL$USERライブラリを参照します。マルチバージョ
              ン対応のRdbバージョン6.0がインストールされたシステムには，
              SYS$LIBRARY:SQL$USERファイルはありません。そのかわり，フ
              ァイル名の最後にバージョン番号が追加されます。たとえば，
              SYS$LIBRARY:SQL$USER60のようになります。

              この名前の不一致の問題を回避するには，適切なライブラリ・フ
              ァイルを参照するように，SQL$USERという論理名を定義します。
              次の例を参照してください。

              $ DEFINE SQL$USER SYS$LIBRARY:SQL$USER60

              次のリンカ・オプション・ファイルを変更します。

                  ACMSDI$EXAMPLES_ACMS:VR_READ_SERVER.OPT
                  ACMSDI$EXAMPLES_ACMS:VR_UPDATE_SERVER.OPT

              次の行を探してください。

              SYS$LIBRARY:SQL$USERnn.OLB/LIBRARY


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-21

 
           その行を次の行と置き換えます。

           SYS$USER/LIBRARY

     5.2.7.2  DECforms V1.4によるAvertz ACMSサンプル・アプリケーショ
              ンのビルド

           Avertz ACMSサンプル・アプリケーションのVR_FORM.IFDLファイ
           ルは，DECformsバージョン1.4ではコンパイルできません。これ
           は，VR_FORM.IFDLファイルで使用しているコロン(:)をDECforms
           バージョン1.4のIFDLパーサが認識できないからです。

           この問題を回避するには，VR_FORM.IFDLファイルで":"を含む文
           字列を二重引用符(")で囲みます。

           たとえば，次の文字列を

                  Copy
                       AVERTZ_CDD_FIELD:CUSTOMER_ID from Dictionary
                  End Copy

           次のように変更します。

                  Copy
                       "AVERTZ_CDD_FIELD:CUSTOMER_ID" from Dictionary
                  End Copy

     5.2.7.3  AVERTZユーザ名のクォータ値

           VR_DA_RUNTIME_SETUP.COMコマンド・ファイルは，VR_DA_APPLサ
           ンプル・アプリケーションを実行するために必要なクォータをユ
           ーザ名AVERTZ_EXC，AVERTZ_UPD，AVERTZ_READに割り当てます。
           システムでこれらのユーザ名がすでに定義されている場合には，
           これらのユーザ名のクォータがVR_DA_APPLにとって不適切な値で
           ある可能性があります。AVERTZサンプル・アプリケーションを使
           用する場合には，VR_DA_RUNTIME_SETUP.COMを実行する前に，ユ
           ーザ名AVERTZ_EXC，AVERTZ_UPD，AVERTZ_READを削除して，これ
           らのユーザ名に対して適切なクォータが割り当てられるようにし
           てください。

           VR_DA_RUNTIME_SETUP.COMコマンド・プロシージャで操作が正し
           く実行されるようにするには，このコマンド・プロシージャをシ
           ステム・アカウントから実行してください。


      5-22  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
        5.2.7.4 AVERTZのアクセス制御リスト

              VR_DA_RUNTIME_SETUP.COMプロシージャは，AVERTZのアプリケ
              ーション名VR_DA_APPLをACMSデータベースに追加します。そ
              のためのコマンド・ラインにはACL修飾子が含まれており，ID
              を/ID=SYSTEMとして割り当てます。しかし，この処理を正しく実
              行できないことがあります。

              VR_DA_RUNTIME_SETUP.COMコマンド・プロシージャが正しく動作
              するようにするには，ID=SYSTEMをID=[UIC]に変更します。ただ
              し，UICはSYSTEMアカウントの値であり，たとえばID=[1,4]と指
              定します。

        5.2.7.5 AVERTZサンプル・アプリケーションのセットアップ

              コマンド・プロシージャVR_DA_RUNTIME_SETUP.COMは，サンプ
              ル・アプリケーションのセットアップを行います。このプロシー
              ジャを実行するには，SYSPRV特権が必要です。サンプルのセット
              アップについての詳細は，ACMSDI$EXAMPLES_ACMSディレクトリに
              あるファイルACMSDI$VR_APPLICATION_INFO.TXTを参照してくださ
              い。

              OpenVMSシステムでAVERTZサンプル・アプリケーションの準備を
              行うには，次の手順に従ってください。

               1. アプリケーションのセットアップを行うコマンド・プロシ
                  ージャを実行します。

                  $  @ACMSDI$EXAMPLES_ACMS:VR_DA_RUNTIME_SETUP
                     .
                     .
                     .
                  $

               2. ACMSシステム(必要な場合)とアプリケーションを起動しま
                  す。

                  $  ACMS/START SYSTEM
                  $  ACMS/START APPLICATION VR_DA_APPL

               3. ユーザ・アカウントの認証など，システムに応じて，他の
                  必要な管理タスクを実行します。『DIGITAL ACMS Desktop
                  for OpenVMSクライアント・アプリケーション・プログラミ
                  ング・ガイド』の管理に関する説明を参照してください。


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-23

 
           これで，DOS，Windows，Windows 95，およびMacintoshのAVERTZ
           クライアントを実行して，VR_DA_APPLの予約タスクを呼び出すこ
           とができます。

     5.2.7.6  ACMS Desktopサンプルの再ビルド

           サンプル用の実行イメージが提供されています。したがって，サ
           ンプルを実行するために再ビルドする必要はありません。ただ
           し，サンプルを修正した場合，その修正を加えたサンプルを再ビ
           ルドできるように，DEC/MMS記述ファイルを提供しています。

           サンプルを変更して，再ビルドするには，次の操作を実行しま
           す。

            1. サンプル・ソースを別のディレクトリにコピーします。

            2. コマンド・プロシージャVR_DA_BLD_MMS.COMを使用して，そ
               のディレクトリ内で別のADB名のもとでサンプルを再ビルド
               します。

                a.  AVERTZコンポーネントのためにOracle CDDディレクト
                    リを作成します。

                b.  論理名を定義します。

                    サンプルを再ビルドするためにACMSDI$EXAMPLES_ACMS
                    以外のディレクトリを使用している場合には，VR_DA_
                    BLD_LOGICALS.COMコマンド・プロシージャで論理名
                    定義を変更して，使用しているファイルとOracle CDD
                    ディレクトリを指すようにします。これらの変更は，
                    VR_DA_BLD_MMS.COMコマンド・プロシージャのBLDの部
                    分を実行する前に行ってください。

                c.  他の設定およびビルド作業を実行します。

            3. パラメータを指定せずに，コマンド・プロシージャVR_DA_
               BLD_MMS.COMを実行します。

               $ @ACMSDI$EXAMPLES:VR_DA_BLD_MMS

               すべての設定作業とビルド作業が実行されます。

           特定の作業を実行するには，表 5-6に示したパラメータのいずれ
           かを指定します。


      5-24  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-6 VR_DA_BLD_MMS.COMパラメータ
              __________________________________________________________
              キーワード_______作業_____________________________________

              BLD              VR_DA_APPLをビルドするためにMMSを実行す
                               る。

              CDD              Oracle CDDディクショナリおよびVR_DA_APPL
                               のディレクトリを設定する。

              DB_______________VEHICLE_RENTALSデータベースを作成する。__

        5.2.7.7 システムに追加されるWindowsサンプル・ファイル

              表 5-7に示したC言語ファイルとヘッダ・ファイル(.cと.h)，
              Windows (.def)，アイコン(.ico)，実行可能ファイル(.exe)，
              データ・ファイル(.dat)はすべて，APIとサンプル・クライアン
              ト・ソフトウェアのインストールでデスクトップ・システムにコ
              ピーされます。

              表 5-7 Windowsサンプル・ファイル
              __________________________________________________________
              名前_______________説明___________________________________

              ACMSDI.H           ACMS Desktop API用のインクルード・ファ
                                 イル。

              AVERTZ             サンプルをビルドするためのメーク・ファ
                                 イル。

              AVERTZ.C           サンプルのエントリ・ポイント。サンプル
                                 のメイン・ウィンドウを管理する。

              AVERTZ.DEF         Windows定義ファイル。Windowsのエント
                                 リ・ポイントとスタック・サイズを定義す
                                 る。

              AVERTZ.EXE         Windowsサンプル実行可能ファイル。

              __________________________________________________________
                                                        (次ページに続く)


          ACMS DesktopポータブルAPIサービスとサンプルのインストール 5-25

 
           表 5-7 (続き) Windowsサンプル・ファイル
           __________________________________________________________
           名前_______________説明___________________________________


           AVERTZ.H           AVERTZヘッダ・ファイル。グローバル名を
                              定義する。

           AVERTZ.RC          ユーザ・インタフェース・テンプレート。
                              メイン・ウィンドウ，メニュー，予約フォ
                              ームのレイアウトを定義する。

           AVERTZMM.C         AVERTZ構造体のメモリ管理を取り扱う。

           AVERTZMM.H         avertzmm.c用のヘッダ・ファイル。

           AVERTZPP.C         予約タスクのプレゼンテーション・プロシ
                              ージャ。チェックイン・タスクとチェック
                              アウト・タスク，およびプレゼンテーショ
                              ン・プロシージャのスタブ。

           AVERTZPP.H         avertzpp.c用のヘッダ・ファイル。

           DISABLEW.C         プレゼンテーション・プロシージャ・スタ
                              ブ。

           DRIVING.ICO        タスクを現在処理している(未選択の)セッ
                              ションのアイコン。

           ENABLEW.C          セッションIDを定義するためのプレゼンテ
                              ーション・プロシージャ。

           FORMS.H            DECformsの状態値が登録されたサンプル・
                              インクルード・ファイル。

           HELP.TXT           AVERTZユーザ・インタフェースの概要。

           __________________________________________________________
                                                     (次ページに続く)


      5-26  ACMS DesktopポータブルAPIサービスとサンプルのインストール

 
              表 5-7 (続き) Windows�