(a)　機能

リモートインストール先で，インストール対象のパッケージがインストール済みの場合，稼働しているバージョンのソフトウェアのバックアップを取得します。

(b)　形式

Backup()

(c)　引数

なし

(d)　戻り値

なし

(a)　機能

指定したディレクトリまたはファイルをリモートコレクトします。

Collection関数は，コレクトファイルで最低3回呼び出さなければなりません。まず，引数にCOLLECTION_STARTを指定してCollection関数を呼び出し，リモートコレクトに関する設定を初期化します。そして，リモートコレクトするファイルまたはディレクトリを設定するため，引数にファイルかディレクトリを指定してCollection関数を呼び出します（100回まで複数回可）。最後に，引数にCOLLECTION_ENDを指定してCollection関数を呼び出し，収集を実行します。

(b)　形式

Collection(COLLECTION_START)
Collection(String リモートコレクトするディレクトリ名またはファイル名)
Collection(COLLECTION_END)

(c)　引数

• String リモートコレクトするディレクトリ名またはファイル名
  リモートコレクトするディレクトリ名またはファイル名を，ドライブ名も含めて指定します。ファイルまでのパスを指定したときは，ファイルがリモートコレクトされます。ディレクトリを指定したときは，ディレクトリ下のすべてのファイルがリモートコレクトされます。
  文字列で直接指定しても，ディレクトリ名またはファイル名の入った文字列型変数を指定してもかまいません。ドライブ名は，「c:」，「D:」のような英字のドライブ名のほかに，「1:」，「2:」のような数字でも指定できます。「1:」は，ハードディスクの最初のドライブになります。
  また，Windowsがインストールされているディレクトリなどの特別なディレクトリを，次の値で指定できます。
  

  %WINDOWS%

  Windowsがインストールされているディレクトリ

  %SYSTEM%

  Windowsがインストールされているディレクトリ下のSystemまたはSystem32ディレクトリ

  %NETMDMP%

  クライアントがインストールされているディレクトリ

(d)　戻り値

なし

(a)　機能

プログラムマネージャにアイコンを追加します。追加先のプログラムグループ，追加したい実行ファイル，およびアイコンのタイトルを指定してください。

この関数は，バックグラウンドインストールモードでは使用できません。

(b)　形式

CreateIcon(String プログラムグループ名,
           String 実行ファイルのパス名,
           String アイコンのタイトル)

(c)　引数

• String プログラムグループ名
  アイコンを追加するプログラムグループの名前を指定します。直接文字列で指定しても，プログラムグループ名の入った変数で指定してもかまいません。
  プログラムグループ名の最大文字数は，Windows NTの場合30文字（全角でも半角でも同じ）です。Windows Me，Windows 98，またはWindows 95の場合は，半角で30文字（全角で15文字）です。Windows NTとWindows Me，Windows 98，またはWindows 95が混在するシステムの場合，Windows 95に合わせてください。
  指定したプログラムグループがない場合は，自動的に作成されます。
  
• String 実行ファイルのパス名
  アイコンとして登録する実行ファイルのパス名を，ドライブ名も含めて指定します。直接文字列で指定しても，実行ファイルのパス名の入った変数で指定してもかまいません。実行ファイルのパス名の最大文字数は，128文字です。
  ドライブ名は，「c:」，「D:」のような英字のドライブ名のほかに，「1:」，「2:」のような数字でも指定できます。「1:」は，ハードディスクの最初のドライブになります。
  
• String アイコンのタイトル
  アイコンのタイトルを指定します。直接文字列で指定しても，アイコンのタイトルの入った変数で指定してもかまいません。アイコンのタイトルの最大文字数は，Windows NTの場合40文字（全角でも半角でも同じ）です。Windows Me，Windows 98，またはWindows 95の場合は，半角で40文字（全角で20文字）です。Windows NTとWindows Me，Windows 98，またはWindows 95が混在するシステムの場合，Windows 95に合わせてください。
  

(d)　戻り値

なし

(e)　注意事項

他社ソフトウェアや日立プログラムプロダクトのインストールには，この関数を使用できません。

(a)　機能

プログラムマネージャにグループを作成します。プログラムグループ名を指定してください。

この関数は，バックグラウンドインストールモードでは使用できません。

(b)　形式

CreateProgramGroup(String プログラムグループ名)

(c)　引数

• String プログラムグループ名
  作成するプログラムグループのグループ名を指定します。直接文字列で指定しても，プログラムグループ名の入った変数で指定してもかまいません。
  プログラムグループ名の最大文字数は，Windows NTの場合30文字（全角でも半角でも同じ）です。Windows Me，Windows 98，またはWindows 95の場合は，半角で30文字（全角で15文字）です。Windows NTとWindows Me，Windows 98，またはWindows 95が混在するシステムの場合，Windows 95に合わせてください。
  

(d)　戻り値

なし

(e)　注意事項

他社ソフトウェアや日立プログラムプロダクトのインストールをする場合は，この関数を使用できません。

(a)　機能

リモートインストール先にショートカットを作成します。この関数は，リモートインストール先が，Windows Me，Windows 98，またはWindows 95のときだけ使用できます。

この関数は，バックグラウンドインストールモードでは使用できません。

(b)　形式

CreateShortCut(String ショートカット作成先のパス名,
               String ショートカットのリンク先パス名,
               String ショートカットのタイトル)

(c)　引数

• String ショートカット作成先のパス名
  リモートインストール先に作成するショートカットを置く，フォルダのパス名を指定します。直接文字列で指定しても，パス名の入った変数で指定してもかまいません。最大文字数は，「ショートカットのタイトル」との合計で，半角で255文字（全角で127文字）です。
  
• String ショートカットのリンク先パス名
  ショートカットを作成する対象の実行ファイル名をフルパスで指定します。直接文字列で指定しても，パス名の入った変数で指定してもかまいません。最大文字数は，半角で259文字（全角で129文字）です。
  
• String ショートカットのタイトル
  ショートカットのタイトルを指定します。直接文字列で指定しても，タイトルの入った変数で指定してもかまいません。最大文字数は，「ショートカット作成先のパス名」との合計で，半角で255文字（全角で127文字）です。
  

(d)　戻り値

なし

(a)　機能

Backup関数で取得したバックアップを削除します。バックアップが取得されていない場合は，この関数を呼び出しても無視されます（エラーにはなりません）。

(b)　形式

DelBackup()

(c)　引数

なし

(d)　戻り値

なし

(a)　機能

指定したエラーステータスコード（UNIX NETM/DMシステムではエンドステータス）を設定できます。条件不一致でスクリプトを終了する場合に，設定してください。設定したエラーステータスコードは，インストール処理またはコレクト処理の終了コードとして，上位システムに通知されます。

(b)　形式

DmSetStatus(System エラーステータスコード)

(c)　引数

• System エラーステータスコード
  次の表に示すシステム変数のどれかを指定します。
  

  表D-3　システム変数

  システム変数	説明
  INSTALL_CAPAERROR	ハードディスク容量チェック時の条件不一致 （エンドステータス1＝0x92） （エンドステータス2＝0x03）
  INSTALL_HENVERROR	ハードウェア環境チェック時の条件不一致 （エンドステータス1＝0x9d） （エンドステータス2＝0x02）
  INSTALL_SENVERROR	MS-DOS，Windowsバージョンチェック時の条件不一致 （エンドステータス1＝0x9d） （エンドステータス2＝0x03）
  INSTALL_PSVRERROR	前提ソフトウェアバージョンチェック時の条件不一致 （エンドステータス1＝0x9d） （エンドステータス2＝0x04）

  これらのエラー検出時以外にDmSetStatus関数を発行しても，上位システムでは正しいエラーステータスを取得できません。また，コレクトスクリプト内で使用できるエラーステータスコードはありません。
  

(d)　戻り値

なし

(a)　機能

今回のリモートインストールで，バックアップを取得したかどうかを返します。

(b)　形式

System GetBackupStatus()

(c)　引数

なし

(d)　戻り値

• System バックアップを取得したかどうか
  バックアップを取得したかどうかを示すシステム変数を返します。戻り値は，等号（=），不等号（<>）の比較演算に使用できます。
  

  TRUE

  バックアップを取得した

  FALSE

  バックアップを取得していない

(a)　機能

スクリプトのどの個所でエラーが発生したかを調べます。On InstallErrorステートメントとOn CollectionErrorステートメントの中でだけ使用できます。

(b)　形式

System GetErrorStatus()

(c)　引数

なし

(d)　戻り値

• System エラー発生個所
  エラーが発生した個所を示すシステム変数を返します。戻り値は，等号（=），不等号（<>）の比較演算に使用できます。エラーの発生個所を次の表に示します。
  

  表D-4　エラー発生個所一覧

  システム変数	説明
  BACKUP_PROCESS	Backup関数処理中にエラー
  COLLECTION_PROCESS	Collection関数処理中にエラー
  CREATEICON_PROCESS	CreateIcon関数処理中にエラー
  CREATEPROGRAMGROUP_PROCESS	CreateProgramGroup関数処理中にエラー
  CREATESHORTCUT_PROCESS	CreateShortCut関数処理中にエラー
  GETBACKUPSTATUS_PROCESS	GetBackupStatus関数処理中にエラー
  INSTALL_PROCESS	Install関数処理中にエラー
  MISC_PROCESS	その他のスクリプト処理でエラー
  MSGBOX_PROCESS	MsgBox関数処理中にエラー
  NO_ERROR	エラーは発生していない
  RESTORE_PROCESS	Restore関数処理中にエラー
  SETSTATUS_PROCESS	SetStatus関数処理中にエラー
  SETUP_PROCESS	Setup関数処理中にエラー
  SHELL_PROCESS	Shell関数で起動したユーザプログラムでエラーまたはShell関数の実行時にエラー
  SYSINFOCOPROCESSOR_PROCESS	SysInfoCoProcessor関数処理中にエラー
  SYSINFOCPUTYPE_PROCESS	SysInfoCpuType関数処理中にエラー
  SYSINFOHDEMPTY_PROCESS	SysInfoHDEmpty関数処理中にエラー
  SYSINFOMEMORY_GDIMEMORY_PROCESS	SysInfoMemory関数のGDI_MEMORY（システム情報タイプ）処理中にエラー
  SYSINFOMEMORY_REALMEMORY_PROCESS	SysInfoMemory関数のREAL_MEMORY（システム情報タイプ）処理中にエラー
  SYSINFOMEMORY_USERMEMORY_PROCESS	SysInfoMemory関数のUSER_MEMORY（システム情報タイプ）処理中にエラー
  SYSINFOOSVERSION_MSDOS_PROCESS	SysInfoOSVersion関数のMSDOS（システム情報タイプ）処理中にエラー
  SYSINFOOSVERSION_WINDOWS_PROCESS	SysInfoOSVersion関数のWINDOWS（システム情報タイプ）処理中にエラー
  VERINFO_PROCESS	VerInfo関数処理中にエラー
  VERINFOEX_PROCESS	VerInfoEx関数処理中にエラー

(a)　機能

インストールをするソフトウェアのパッケージ識別IDを取得します。

(b)　形式

String GetResourceName()

(c)　引数

なし

(d)　戻り値

• String パッケージ識別ID
  インストールをするソフトウェアのパッケージ識別IDが返されます。戻り値は，文字列演算および比較演算に使用できます。
  

(a)　機能

インストールをするソフトウェアのバージョン，世代番号を取得します。

(b)　形式

String GetResourceVersion()

(c)　引数

なし

(d)　戻り値

• String バージョン
  インストールをするソフトウェアのバージョン，世代番号が，vvrrssggggの書式で返されます。
  

  vvrrss

  バージョン

  gggg

  世代番号

  なお，返されるのはユーザが設定している部分だけです。vvrrまでしか設定されていない場合は，vvrrだけ返されます。
  

(a)　機能

インストールするソフトウェアのパッケージ名を取得します。

(b)　形式

String GetSoftwareName()

(c)　引数

なし

(d)　戻り値

• String パッケージ名
  インストールするソフトウェアのパッケージ名が返されます。戻り値は，文字列演算および比較演算に使用できます。
  

(a)　機能

SetStatus関数で設定したステータスの現在の値を取得します。

(b)　形式

Integer GetStatus()

(c)　引数

なし

(d)　戻り値

• Integer 現在のステータス
  SetStatus関数で設定したステータスの現在の値が返されます。
  

(e)　注意事項

SetStatus関数でステータスを設定していない場合，0が返されます。

(a)　機能

配布されたソフトウェアをインストール（復元）します。

(b)　形式

Install(String インストール先ディレクトリ名の文字列)

(c)　引数

• String インストール先ディレクトリ名の文字列
  インストール先のディレクトリ名を，ドライブ名も含めて指定します。文字列で直接指定しても，ディレクトリ名の入った文字列型変数を指定してもかまいません。ディレクトリ名の最大文字数は，128文字です。
  ドライブ名は，「c:」，「D:」のような英字のドライブ名のほかに，「1:」，「2:」のような数字でも指定できます。「1:」は，ハードディスクの最初のドライブになります。
  同じスクリプトでSetup関数を使用する場合は，システム変数SETUP_DIRECTORYを必ず指定してください。
  

(d)　戻り値

なし

(e)　指定例

（例1）ドライブ名を数字で指定する場合

　　:
Install("1:\users\home\instdir")
　　:

（例2）Setup関数と組み合わせて使用する場合

　　:
Install(SETUP_DIRECTORY)
　　:
Setup()
　　:

(f)　注意事項

同じスクリプトにInstall関数を複数回記述することはできません。

(a)　機能

任意のメッセージ文字列をログファイルに出力します。出力先は，クライアントのインストール先ディレクトリ下のLOG\MAIN.LOGとLOG\USER.LOGです。クライアントのメッセージログと関連づけてメッセージを確認したいときは，MAIN.LOGを利用してください。スクリプトの開発者が任意に出力したメッセージだけを確認する場合は，USER.LOGを利用してください。また，このログは，Windows NTのイベントログにも取得されます（イベントIDが60000以降）。

（LOG\MAIN.LOGの例）

100 2004/2/3 22:29:12:13 Informational User ユーザメッセージ:XXXプログラムをアップデートしました。

（LOG\USER.LOGの例）

150 2004/2/3 22:29:12:13 1128 XXXプログラムをアップデートしました。

(b)　形式

LogFile(String 任意のメッセージ文字列)

(c)　引数

• String 任意のメッセージ文字列
  ログファイルに出力するメッセージ文字列を指定します。文字列で直接指定しても，メッセージ文字列の入った変数で指定してもかまいません。メッセージ文字列は半角で128文字（全角で64文字）以内で指定します。
  

(d)　戻り値

なし

(e)　注意事項

この関数の使用は必要最小限にしてください。この関数を多く利用すると，ディスクの入出力が多くなり，性能が低下する原因になります。

(a)　機能

任意のメッセージをメッセージボックスに表示します。メッセージボックスに表示されるボタンは，［OK］だけです。

この関数は，バックグラウンドインストールモードでは使用できません。

(b)　形式

MsgBox(String メッセージ文字列, Integer 表示時間)

(c)　引数

• String メッセージ文字列
  メッセージボックスに表示するメッセージ文字列を指定します。文字列で直接指定しても，メッセージの入った文字列型変数を指定してもかまいません。メッセージ文字列は半角で128文字（全角で64文字）以内で指定します。
  
• Integer 表示時間
  メッセージボックスの表示時間を秒で指定します。直接秒数で指定しても，表示時間の入った整数型変数を指定してもかまいません。指定できる表示時間は，1〜60秒です。
  メッセージボックスは，ここで設定した表示時間を過ぎるとユーザの応答に関係なく，自動的に閉じます。
  

(d)　戻り値

なし

(a)　機能

リモートインストール実行前に取得したバックアップを復元して，旧バージョンに戻します。バックアップが取得されていない場合は，この関数を呼び出してもエラーにはならないで無視されます。この関数をOn InstallError Doステートメント内に記述した場合，リモートインストールでエラーが発生したときだけバックアップが復元されます。

(b)　形式

Restore()

(c)　引数

なし

(d)　戻り値

なし

(a)　機能

スクリプトの処理状態を，任意のステータスコードで保存できます。保存したステータスコードは，GetStatus関数で取得してください。

スクリプトが終了すると，最後に設定したステータスコードがインストール処理またはコレクト処理の終了コードとして上位のシステムに通知されます。

(b)　形式

SetStatus(Integer ステータスコード)

(c)　引数

• Integer ステータスコード
  スクリプトの処理状態を示すステータスコードを指定します。
  直接数値で指定しても，ステータスコードの入った整数型変数で指定してもかまいません。ただし，ステータスコードとして設定できるのは0〜255です。
  

(d)　戻り値

なし

(e)　注意事項

スクリプトで最初にSetStatus関数が実行されるまでは，ステータスコードとして0が仮定されます。

(a)　機能

Install関数で復元したファイルを使って，セットアップをするプログラムを起動します。

Windowsアプリケーションのセットアッププログラムの多くは，GUI上で動作します。JP1/NETM/DMでは，このようなGUIのセットアッププログラムを使用できますが，その場合，AITファイルまたはレコーダファイル（Visual Testのスクリプト）を用意してください。画面に対してクライアントで自動的に応答するのに必要です。Automatic Installation Tool実行ライブラリがAITファイルを使って，またはVisual Test実行ライブラリがレコーダファイルを使って，GUIのセットアッププログラムに自動的に応答します。

AITファイルまたはレコーダファイルの作成方法については，マニュアル「Automatic Installation Toolガイド」を参照してください。

この関数は，バックグラウンドインストールモードでは使用できません。

(b)　形式

Setup()

(c)　引数

なし

(d)　戻り値

なし

(e)　注意事項

• 通常，この関数は他社ソフトウェアまたは日立プログラムプロダクトのセットアップで使用します。ただし，ユーザプログラムについても，GUIのセットアッププログラムを使用する場合は，この関数を使って自動的に応答させることができます。
• 同じスクリプトにSetup関数を複数回記述することはできません。

(a)　機能

外部プログラムを起動します。

(b)　形式

Shell(String 起動プログラムのフルパス名)

(c)　引数

• String 起動プログラムのフルパス名
  起動する外部プログラムを，フルパスで指定します。文字列で直接指定しても，フルパス名の入った文字列型変数で指定してもかまいません。フルパス名にスペースを含む場合は連続する二つの「"」で囲んで指定してください。
  フルパス名には，ドライブ名も含めてください。ドライブ名を省略した場合，クライアントがインストールされているドライブが仮定されます。ドライブ名は，「c:」，「D:」のような英字のドライブ名のほかに，「1:」，「2:」のような数字でも指定できます。「1:」は，ハードディスクの最初のドライブになります。
  指定するフルパス名には，外部プログラムへの引数を含めることもできます。外部プログラムの引数に「"」を含む場合は，「"」を連続する二つの「"」に置き換えて指定してください。
  リモートインストールがバックグラウンドインストールモード（Windows NT）の場合，起動する外部プログラムはコンソールモード（ウィンドウを持たないプログラム）でなければなりません。もしGUIを持つプログラムをバックグラウンドインストールモード（Windows NT）で起動した場合，GUIは表示されません。
  

(d)　戻り値

なし

(e)　指定例

（例1）

Shell("c:\winnt\system32\notepad.exe")

（例2）

Dim S As String
S = "1:\users\home\prog01.exe file01.txt"
Shell(S)

（例3）

Shell("""c:\Program Files\prog2.exe""")

（例4）

Shell("""c:\Program Files\Test\aaa.exe"" /f C:\temp\bbb.exe /I: /S ""ccc.txt""")

(f)　注意事項

• リモートコレクトはバックグラウンドで実行されるため，Windows NTの場合，コレクトスクリプトではGUI上のプログラムを指定できません。
• 外部プログラムからインストールスクリプトにエラーを通知する場合は，決められた外部プログラムへの終了通知をしなければなりません。
• 外部プログラムの処理結果をインストールスクリプトに通知しない場合は，パッケージャまたはリモートインストールマネージャで終了コードを無視するように設定してください。外部プログラムが正常に終了しなかったことをスクリプトに通知すると，処理を中断し，サーバにジョブが失敗したことを通知します。この場合，外部プログラムの処理結果コードは，ユーザステータスに設定されます。
• インストールスクリプトは，パッケージャまたはリモートインストールマネージャで設定された，外部プログラムの時間監視の有無と監視時間を基に，外部プログラムを監視します。設定された監視時間を経過するとshell関数は制御を戻します。このとき，ジョブをエラーにするかどうかについては，パッケージャまたはリモートインストールマネージャで設定できます。

(a)　機能

コプロセッサがあるかどうかを返します。

(b)　形式

System SysInfoCoProcessor()

(c)　引数

なし

(d)　戻り値

• System コプロセッサの有無
  コプロセッサがあるかどうかを示すシステム変数を返します。戻り値は，システム変数として，等号（=），不等号（<>）の比較演算に使用できます。
  

  EXIST

  コプロセッサあり

  NOEXIST

  コプロセッサなし

  Windowsの場合は，必ずEXISTが返されます。
  

(e)　注意事項

Windowsにリモートインストールをする場合に，コプロセッサなしの条件にすると，スクリプトのシステム条件不一致でエラーになります。

(a)　機能

CPU種別を取得します。

(b)　形式

System SysInfoCpuType()

(c)　引数

なし

(d)　戻り値

• System CPU種別
  CPU種別を意味するシステム変数を返します。
  
  • I_286：AMD64/Intel EM64T
  • I_386：Intel i386相当
  • I_486：Intel i486相当
  • I_PENTIUM：Intel Pentium相当
  • M_MIPS：Intel IPF
  • P_POWERPC：PowerPC
  これらの戻り値は，システム型変数として，等号（=）または不等号（<>）を使った比較演算ができます。
  

(e)　注意事項

CrusoeなどIntel互換CPUの場合は，I_PENTIUMが返されます。

(a)　機能

指定したハードディスクドライブの，空き容量を取得します。

(b)　形式

Integer SysInfoHDEmpty(System ドライブ名)

(c)　引数

• System ドライブ名
  ハードディスクの空き容量を取得するドライブのドライブ名を指定します。直接指定しても，ドライブ名の入ったシステム型変数を指定してもかまいません。
  ドライブ名には，「c:」，「D:」のような英字のドライブ名のほかに，「1:」，「2:」のような数字でも指定できます。「1:」は，ハードディスクの最初のドライブになります。
  ドライブ名には必ず「:」（コロン）を付けてください。
  

(d)　戻り値

• Integer ハードディスクの空き容量
  ハードディスクの空き容量をメガバイト単位で返します。
  

(a)　機能

各種メモリ容量を取得します。

(b)　形式

Integer SysInfoMemory(メモリ種別)

(c)　引数

• メモリ種別
  メモリ容量を取得するメモリの種類を指定します。
  

  表D-5　メモリ種別

  メモリ種別	説明
  REAL_MEMORY	実メモリの容量を取得します。
  USER_MEMORY	ユーザが利用可能なメモリ容量を取得します。この値は，起動しているアプリケーションの数によって変化します。
  GDI_MEMORY	利用可能なGDIシステムリソースの容量を取得します。この値は，最大64キロバイトです。

(d)　戻り値

• Integer メモリ容量
  各種メモリ容量を返します。単位は，次のとおりです。
  

  REAL_MEMORY

  メガバイト単位

  USER_MEMORY，GDI_MEMORY

  キロバイト単位

(a)　機能

現在使用中の各種OSのバージョンを取得します。

(b)　形式

String SysInfoOSVersion(OS種別)

(c)　引数

• OS種別
  バージョンを取得するOSの種類を指定してください。
  

  MSDOS

  現在使用中のMS-DOSのバージョンを取得します。

  WINDOWS

  現在使用中のWindowsのバージョンを取得します。

(d)　戻り値

• String バージョン
  現在使用している各種OSのバージョンをvvrrt形式で返します。戻り値は，文字列型として，文字列演算および比較演算に使用できます。
  

  vv

  バージョン

  rr

  リビジョン

  t

  タイプ（V：日本語版MS-DOS，なし：英語版MS-DOS）

  （例）

  MS-DOS 6.2/Vの場合，「0620V」になります。

  Windows 95の場合，「0400」になります。

(e)　注意事項

• Ifステートメントで，「>」,「>=」などを使って比較演算ができます。ただし，意味があるのは，戻り値の形式と同じ形式（vvrrt形式）の文字列型との比較だけです。また，tの異なるバージョンを大小比較しても意味がありません。tのないバージョンが，必ず小と判定されます。
• WindowsでMS-DOSバージョンを取得した場合，必ず「0500V」が返されます。

(a)　機能

パッケージ識別IDで指定したソフトウェアのバージョンを返します。引数の新旧タイプには，ACTIVE_VERSION（稼働中の新バージョン）を指定してください。

(b)　形式

String VerInfo(新旧タイプ, String パッケージ識別ID)

(c)　引数

• 新旧タイプ
  次のシステム変数を指定します。
  ACTIVE_VERSION：現在稼働中のバージョン
  
• String パッケージ識別ID
  JP1/NETM/DMを使ってパッケージの登録をしたときに指定したパッケージ識別IDを指定します。文字列で直接指定しても，パッケージ識別IDの入った変数で指定してもかまいません。
  パッケージ識別IDの最大文字数は，44文字です。
  

(d)　戻り値

• String ソフトウェアのバージョン
  指定したソフトウェアのバージョンがvvrrssgggg形式で返されます。
  

  vvrrss

  バージョン

  gggg

  世代番号

  もし，指定したソフトウェアがないときは，""（長さ0の文字列）が返されます。また，vvrrssggggのうち，返されるのはユーザが設定している部分だけです。vvrrまでしか設定されていない場合は，vvrrだけ返されます。
  

(e)　注意事項

この関数は，JP1/NETM/DMを使ってインストールしたソフトウェアのバージョンを取得するものです。直接FDなどからインストールしたソフトウェアについては，この関数ではバージョンを取得できません。

(a)　機能

インストール済みのパッケージのバージョンを，パッケージ名またはパッケージ識別IDから取得します。

(b)　形式

String VerInfoEx(PACKAGE_NAME, String パッケージ名)
String VerInfoEx(PACKAGE_ID, String パッケージ識別ID)

(c)　引数

• PACKAGE_NAME，またはPACKAGE_ID
  パッケージ名からソフトウェアのバージョンを調べるときは，システム変数PACKAGE_NAMEを指定します。パッケージ識別IDからソフトウェアのバージョンを調べるときは，PACKAGE_IDを指定します。
  
• String パッケージ名，またはString パッケージ識別ID
  第1引数に，PACKAGE_NAMEを指定した場合は，パッケージ名を指定します。第1引数にPACKAGE_IDを指定した場合は，パッケージ識別IDを指定します。
  文字列で直接指定しても，変数で指定してもかまいません。
  パッケージ名とパッケージ識別IDの最大文字数は，44文字です。
  

(d)　戻り値

• String ソフトウェアのバージョン
  指定したソフトウェアのバージョンがvvrrssttgggg形式で返されます。
  

  vvrrsstt

  バージョン

  gggg

  世代番号

  もし，指定したソフトウェアがないときは，""（長さ0の文字列）が返されます。また，vvrrssttggggのうち，ユーザが設定していない部分はスペースで埋められます。
  

(e)　注意事項

この関数は，JP1/NETM/DMを使ってインストールしたソフトウェアのバージョンを取得するものです。直接FDなどからインストールしたソフトウェアについては，JP1/NETM/DMの「ソフトウェア検索機能」を使って検索できるソフトウェアのバージョンだけを取得できます。