NetExec ( 〔CompName〕 , FileName , Flag , 〔ExecDirName〕 , 〔ExecPlace〕 , 〔Option〕 〔, Param1 , Param2 , …〕 )

CompName

呼び出すコンピュータ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，このコマンドを実行するコンピュータのコンピュータ名を仮定します。

なお，指定する他のコンピュータのOSはWindows NT，Windows 2000，Windows Server 2003，およびWindows XPで，JP1/Scriptがインストールされていなければなりません。また，アクセスするためのアカウントについては「2.2　他のコンピュータとの通信時のアカウント」を参照してください。

FileName

呼び出す実行ファイル名を文字列，または値を格納した変数名で指定します。

実行ファイルに指定できるファイルの種類は次のとおりです。

• 実行形式ファイル（.EXE）
• MS-DOSバッチファイル（.BAT）
• MS-DOS実行形式ファイル（.COM）
• JP1/Scriptスクリプトファイル（.SPT）
• コマンドスクリプト（.CMD）
• 関連付けられたファイル

空白を含むパス，またはファイル名を指定する場合に，パス，またはファイル名をダブルクォーテーション（"）で囲む必要はありません。

Flag

FileNameで指定された実行ファイルの終了待ちをするときは真（True）を，終了待ちをしないときは偽（False）を指定します。

ExecDirName

FileNameで指定された実行ファイルのカレントディレクトリ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，実行ファイルのディレクトリ名を仮定します。

なお，この値はFileNameで指定された実行ファイルがJP1/Scriptファイル以外の場合に有効となります。

ExecPlace

FileNameで指定された実行ファイルをサービス空間で実行するときには真（True）を，ログオン空間で実行するときには偽（False）を指定します。

この値は省略できます。省略した場合，真（True）を仮定します。

なお，CompNameで指定されたコンピュータでは，この値に真（True）が指定された場合にはJP1/Scriptサービスが，偽（False）が指定された場合にはScriptランチャが開始されていなければなりません。

Option

FileNameで指定された実行ファイルがJP1/Scriptスクリプトファイル（.SPT）の場合，オプションを指定します。

この値には次の値を指定できます。

値

意味

CopyFile

呼び側に存在するスクリプトファイルをCompNameで指定されたコンピュータにコピーして実行します。 この場合，インストールフォルダの"DATA"フォルダ下に呼び側コンピュータ名のフォルダを作成し，その下にスクリプトファイルをコピーします。コピーするスクリプトファイルの実行環境ファイル（.SPV）はコピーしません。よってコピーしたスクリプトは実行環境ファイルのない状態で実行します。また，コピーしたスクリプトファイルと同名の実行環境ファイルが呼び側コンピュータ名のフォルダ下に存在する場合はコピー時に削除します。 JP1/Script 06-00以降では，コピーするスクリプトファイルと同名のメニュー情報ファイル（.SPN）が存在する場合メニュー情報ファイルも上記のフォルダ下にコピーします。同名のファイルが呼び側に存在する場合はコピー時に削除します。 このコマンドの実行終了後，コピーしたスクリプトファイル，およびメニュー情報ファイルは削除し，コピーしたスクリプトの実行後に出力される解析トレースファイル，および実行トレースファイルは呼び側にコピーして戻します。 なお，オプションにCopyFileを指定した場合，Flagで指定した値にかかわらずコピーしたスクリプトの実行が終了するまでWindowsのログオフやシャットダウンはしないでください。

この値は省略できます。省略した場合，CompNameで指定されたコンピュータに存在するスクリプトファイルを実行します。

また，FileNameで指定された実行ファイルがJP1/Scriptスクリプトファイル（.SPT）以外の場合は無効になります。

Param1〜31

FileNameで指定されたファイルの実行に必要なパラメタがある場合，パラメタを文字列，数値，または値を格納した変数名で指定します。

複数のパラメタを指定できます。

JP1/Script 06-00以降では，複数のパラメタを一つずつ格納した一次元の配列変数を変数名で指定することもできます。

パラメタの記述規則に関しては，「6.2　コマンドラインに関する規則」を参照してください。

なお，パラメタに次の文字列を指定した場合，起動するアプリケーション側でのウィンドウ表示時のデフォルトとして扱われます。明示的にウィンドウを表示するアプリケーションには有効になりません。

パラメタ	意味
"/SPT:HIDE"	アプリケーションのウィンドウを非表示にします。
"/SPT:MIN"	アプリケーションのウィンドウをアイコン化します。
"/SPT:MAX"	アプリケーションのウィンドウを最大表示します。

パラメタはコマンドラインパラメタとして実行ファイルに渡されますが，"/SPT:HIDE"，"/SPT:MIN"，および"/SPT:MAX"パラメタはコマンドラインパラメタとしては渡されません。

HKEY_LOCAL_MACHINE\SOFTWARE\Hitachi\JP1/Script\SPTX\
Option

Net_Trace

REG_DWORD

Net_Trace_Directory

REG_SZ

' コンピュータ"SOP4A065(SCRIPT)"上のスクリプトファイルを
' ログオン空間で起動する。
comp1="SOP4A065(SCRIPT)"
prm1="/SPALV(2)"
prm2="/SPXLV(2)"
rtn1=NetExec ( comp1,_TEMP_+"NETWORK.SPT" ,True , ,False , _
,prm1 ,prm2 )
' スクリプトを終了する。
If  rtn1 = True  Then
  ' NetExecコマンドが正常終了の場合は呼び出したスクリプト
  ' ファイルの終了コードを返す。
  Exit ( _EXEC_RTN_ )
Else
  ' NetExecコマンドが異常終了の場合はエラー詳細コードを返す。
  Exit ( _RTN_ )
End