JP1 Version 10

JP1/Script(Windows(R)用)

解説・文法書

3021-3-135

目　　次

前書き

はじめに

第1編　解説編

1.　 JP1/Scriptの概要

1.1　JP1/Scriptの特長

1.2　JP1/Scriptの全体構成

1.3　JP1/Scriptを構成するプログラムの種類

1.4　JP1/Scriptで扱うファイル

1.4.1　ファイルの種類

1.4.2　ファイルの容量

1.4.3　ラージファイル

1.4.4　ファイルのアクセス権限

1.5　JP1/Scriptのシステム構成

1.5.1　JP1/AJSと連携したシステム構成

1.5.2　JP1/Baseと連携したシステム構成

1.5.3　JP1/IMと連携したシステム構成

1.5.4　クラスタ環境でJP1/Scriptを使用する場合のシステム構成

1.5.5　ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成

1.6　JP1/Scriptの操作の流れ

1.7　スクリプトを作成する前に，実行する前に

1.8　Windows Vista以降のOSの対応に関して

1.8.1　インストール先フォルダ

1.8.2　JP1/Scriptサービスの開始と監視

1.8.3　コマンドの動作

1.8.4　マネージャの設定方法

1.8.5　レジストリの変更方法

1.8.6　メッセージボックスのレイアウト

1.8.7　管理者権限での実行

1.9　排他エラーリトライ機能と試行オープン機能に関して

1.9.1　排他エラーリトライ機能

1.9.2　試行オープン機能

2.　JP1/Scriptを利用するための準備

2.1　JP1/Scriptのインストール／アンインストール

2.1.1　プログラムのインストール先のフォルダ

2.1.2　JP1/Scriptのインストール

2.1.3　JP1/Scriptサービスの登録

2.1.4　JP1/Scriptのアンインストール

2.1.5　JP1/Scriptの再インストール

2.1.6　JP1/Scriptのアップグレードインストール

2.1.7　ダウングレード

2.2　他のコンピュータとの通信時のアカウント

2.3　クラスタシステム環境での環境設定

2.3.1　Scriptランチャ動作環境の環境設定

2.3.2　Scriptランチャサービス動作環境の環境設定

2.4　ターミナルサービス環境での環境設定

2.5　ホスト名，またはIPアドレスの変更手順

2.6　稼働監視プログラムでのJP1/Scriptの監視

2.7　JP1/Scriptの起動と終了

2.7.1　JP1/Scriptを起動する

2.7.2　JP1/Scriptを終了する

2.8　システムの日時変更手順

2.9　NetExecコマンドによるリモート実行を許可するユーザの設定

3.　JP1/Scriptの操作

3.1　マネージャの操作

3.1.1　Scriptマネージャウィンドウとメニュー

3.1.2　Scriptマネージャウィンドウでのマウスとキーの操作

3.1.3　使用するエディタを決める

3.1.4　スクリプトを作成・保存する

3.1.5　簡易入力機能を使ってスクリプトを作成する

3.1.6　スクリプトを編集する

3.1.7　スクリプトの文法をチェックする

3.1.8　スクリプトを複写する

3.1.9　スクリプトを追加する

3.1.10　スクリプトを削除する

3.1.11　スクリプトの名前を変更する

3.1.12　スクリプトの実行環境（すべての項目）を設定する

3.1.13　スクリプトの実行環境（各項目）を設定する

3.1.14　スクリプトの自動起動を設定する

3.1.15　スクリプトを実行する

3.1.16　メニューフォームを作成する

3.1.17　エディタの起動と終了

3.2　エディタの操作

3.2.1　Scriptエディタウィンドウとメニュー

3.2.2　Scriptエディタウィンドウでのマウスとキーの操作

3.2.3　コメント行を設定・解除する

3.2.4　簡易入力機能を使う

3.2.5　メニューフォームを作成する

3.2.6　エディタの動作環境を設定する

3.2.7　スクリプトファイルの文法をチェックする

3.2.8　モニタリングを実行・中止する

3.2.9　スクリプトを実行する

3.2.10　モニタリング実行時のブレークポイントを設定・解除する

3.2.11　モニタリング実行時の動作環境を設定する

3.2.12　ウォッチへ変数を追加する

3.2.13　スクリプトの実行環境を設定する

3.2.14　文字列を検索する

3.2.15　文字列を置換する

3.3　簡易入力の操作

3.3.1　簡易入力の操作項目

3.3.2　コマンドやステートメントを入力する

3.3.3　JP1/Scriptの対象バージョンを指定する

3.3.4　1行の最大文字数やインデントの桁数を指定する

3.4　トレースビューアの操作

3.4.1　Scriptトレースビューアウィンドウとメニュー

3.4.2　Scriptトレースビューアウィンドウでのマウスとキーの操作

3.4.3　トレースビューアの起動と終了

3.4.4　Scriptトレースビューアウィンドウでの操作

3.4.5　トレースファイルの表示・非表示を切り替える

3.4.6　トレースファイルの内容を表示する

3.4.7　トレースファイルを別名で保存する

3.4.8　トレースファイルを削除する

3.4.9　トレースファイルをクリアする

3.4.10　トレースファイルを印刷する

3.4.11　トレースファイルの内容を検索する

3.5　トレースファイルの表示操作

3.5.1　トレースファイルの表示ウィンドウとメニュー

3.5.2　Scriptトレース表示ウィンドウでのマウスとキーの操作

3.6　メニューエディタの操作

3.6.1　Scriptメニューエディタウィンドウとメニュー

3.6.2　Scriptメニューエディタウィンドウでのマウスとキーの操作

3.6.3　新しいメニューフォームを作成する

3.6.4　メニューフォームをコピーする

3.6.5　メニューフォームを貼り付ける

3.6.6　メニューフォームを削除する

3.6.7　コントロールの属性を一括して変更する

3.6.8　コントロールを一列に並べる

3.6.9　コントロールを均等な間隔で並べる

3.6.10　コントロールをメニューフォームの中央に並べる

3.6.11　コントロールの大きさをそろえる

3.6.12　コントロールをテキストの大きさに合わせる

3.6.13　メニューフォーム上にグリッドを表示する

3.6.14　タブの移動順序を設定する

3.6.15　選択したコントロールを前面に移動する

3.6.16　選択したコントロールを背面に移動する

3.6.17　コマンドのプロパティを設定する

3.6.18　メニューフォームをテスト表示する

3.6.19　メニューフォームの内容を印刷する

3.7　プロセスビューアの操作

3.7.1　プロセスビューアの操作項目

3.7.2　実行中のスクリプトプロセスを一覧表示する

3.7.3　スクリプトプロセスの表示更新間隔を指定する

3.8　実行環境ファイルコンバータの操作

3.8.1　実行環境ファイルコンバータの概要

3.8.2　実行環境ファイルの変換手順

3.8.3　実行環境ファイルコンバータの実行方法

3.8.4　実行環境構文ファイル（.SPU）の概要

3.8.5　実行環境構文ファイル（.SPU）の詳細

4.　ダイアログの説明

4.1　Scriptマネージャウィンドウのダイアログ

4.1.1　新規作成ダイアログ

4.1.2　ファイルの複写ダイアログ

4.1.3　ファイルの追加ダイアログ

4.1.4　ファイルの上書き確認ダイアログ

4.1.5　ファイルの削除の確認ダイアログ

4.1.6　名前の変更ダイアログ

4.1.7　実行ダイアログ

4.1.8　実行環境の設定（起動情報）ダイアログ

4.1.9　実行環境の設定（終了情報）ダイアログ

4.1.10　実行環境の設定（トレース情報）ダイアログ

4.1.11　実行環境（コマンドライン）の設定ダイアログ

4.1.12　コマンドラインの設定ダイアログ

4.1.13　実行環境（作業フォルダ）の設定ダイアログ

4.1.14　実行環境（起動日時）の設定ダイアログ

4.1.15　実行環境（打ち切り時間）の設定ダイアログ

4.1.16　実行環境（トレース出力先フォルダ）の設定ダイアログ

4.1.17　実行環境（ユーザトレース情報）の設定ダイアログ

4.1.18　フォルダの変更ダイアログ

4.1.19　ファイルのプロパティダイアログ

4.1.20　自動起動の設定ダイアログ

4.1.21　エディタの関連付けダイアログ

4.1.22　オプション（サーバ情報）ダイアログ

4.1.23　更新情報ダイアログ

4.1.24　オプション（互換性）ダイアログ

4.1.25　オプション（複数起動）ダイアログ

4.1.26　オプション（JP1/IM）ダイアログ

4.1.27　オプション（トレース）ダイアログ

4.1.28　オプション（クラスタ環境）ダイアログ

4.1.29　フォルダの選択ダイアログ

4.2　Scriptエディタウィンドウのダイアログ

4.2.1　値の更新ダイアログ

4.2.2　オプション（書式）ダイアログ

4.2.3　オプション（色）ダイアログ

4.2.4　オプション（互換性）ダイアログ

4.2.5　設定ダイアログ

4.2.6　検索ダイアログ

4.2.7　ファイル名の指定ダイアログ

4.2.8　ファイルバージョンの指定ダイアログ

4.2.9　コマンドラインパラメタの設定ダイアログ

4.2.10　変数の追加ダイアログ

4.3　Scriptトレースビューアウィンドウのダイアログ

4.3.1　削除の確認ダイアログ

4.3.2　クリアの確認ダイアログ

4.3.3　コンピュータの選択ダイアログ

4.3.4　検索ダイアログ

4.4　Scriptメニューエディタウィンドウのダイアログ

4.4.1　メニューフォームプロパティ（一般）ダイアログ

4.4.2　メニューフォームプロパティ（背景）ダイアログ

4.4.3　メニューフォームプロパティ（キー）ダイアログ

4.4.4　メニューフォームプロパティ（スタイル）ダイアログ

4.4.5　メニューフォームプロパティ（壁紙）ダイアログ

4.4.6　スタティックプロパティ（一般）ダイアログ

4.4.7　スタティックプロパティ（共通）ダイアログ

4.4.8　スタティックプロパティ（背景）ダイアログ

4.4.9　スタティックプロパティ（スタイル）ダイアログ

4.4.10　ボタンプロパティ（一般）ダイアログ

4.4.11　ボタンプロパティ（共通）ダイアログ

4.4.12　ボタンプロパティ（背景）ダイアログ

4.4.13　ボタンプロパティ（キー）ダイアログ

4.4.14　ボタンプロパティ（スタイル）ダイアログ

4.4.15　ファイル参照ボタンプロパティ（一般）ダイアログ

4.4.16　ファイル参照ボタンプロパティ（共通）ダイアログ

4.4.17　ファイル参照ボタンプロパティ（背景）ダイアログ

4.4.18　ファイル参照ボタンプロパティ（キー）ダイアログ

4.4.19　ファイル参照ボタンプロパティ（スタイル）ダイアログ

4.4.20　エディットコントロールプロパティ（一般）ダイアログ

4.4.21　エディットコントロールプロパティ（共通）ダイアログ

4.4.22　エディットコントロールプロパティ（キー）ダイアログ

4.4.23　エディットコントロールプロパティ（スタイル）ダイアログ

4.4.24　直線プロパティ（一般）ダイアログ

4.4.25　ファンクションキープロパティ（一般）ダイアログ

4.4.26　ファンクションキープロパティ（共通）ダイアログ

4.4.27　ファンクションキープロパティ（スタイル）ダイアログ

4.4.28　リストコントロールプロパティ（一般）ダイアログ

4.4.29　リストコントロールプロパティ（共通）ダイアログ

4.4.30　リストコントロールプロパティ（キー）ダイアログ

4.4.31　リストコントロールプロパティ（スタイル）ダイアログ

4.4.32　コンボボックスプロパティ（一般）ダイアログ

4.4.33　コンボボックスプロパティ（共通）ダイアログ

4.4.34　コンボボックスプロパティ（キー）ダイアログ

4.4.35　コンボボックスプロパティ（スタイル）ダイアログ

4.4.36　コマンドプロパティダイアログ

4.4.37　コマンドプロパティの設定ダイアログ

4.4.38　メニューフォーム名の指定ダイアログ

4.4.39　一括変更ダイアログ

4.4.40　グリッドの設定ダイアログ

4.4.41　タブオーダの設定ダイアログ

4.4.42　メニューフォームの印刷情報ダイアログ

5.　トラブルへの対処方法

5.1　対処の手順

5.2　トラブルシューティング

5.2.1　スクリプト実行時のトラブルと対処方法

5.2.2　コマンド実行時のトラブルと対処方法

5.2.3　トレースビューア実行時のトラブルと対処方法

5.2.4　プロセスビューア実行時のトラブルと対処方法

5.3　ログ情報

5.3.1　ログ情報の種類

5.3.2　ログファイルおよびディレクトリ一覧

5.4　トラブル発生時に採取が必要な資料

5.4.1　OSの情報

5.4.2　JP1/Scriptの情報

5.4.3　オペレーション内容

5.4.4　画面上の情報

5.5　資料の採取方法

5.5.1　資料採取ツール

5.5.2　OSシステム情報の採取

5.5.3　ダンプ情報

5.5.4　JP1/Scriptの資料採取

5.5.5　Windowsイベントログの採取

5.6　バックアップとリカバリー

5.6.1　JP1/Scriptで扱うファイルのバックアップとリカバリー

5.6.2　動作環境情報のバックアップとリカバリー

第2編　文法編

6.　JP1/Scriptの規則

6.1　スクリプトに関する規則

6.1.1　変数の名前付け規則

6.1.2　利用できる変数の個数と容量

6.1.3　変数名として扱えないキーワード

6.1.4　予約変数

6.1.5　配列変数

6.1.6　定数

6.1.7　数字の記述規則

6.1.8　文字列の記述規則

6.1.9　演算規則

6.1.10　演算の優先順位

6.1.11　コーディング規則

6.1.12　JP1/Scriptの終了コード

6.1.13　JP1/Scriptのイベントログ

6.1.14　JP1/Scriptで発行するJP1イベント

6.2　コマンドラインに関する規則

6.2.1　コマンドラインの形式

6.2.2　コマンドラインのパラメタの説明

6.2.3　コマンドラインの記述規則

6.2.4　注意事項

7.　ステートメント

7.1　ステートメント一覧

7.1.1　=

7.1.2　Do...Loop

7.1.3　For...Next

7.1.4　For...End For

7.1.5　If...Then...Else

7.1.6　Select Case

7.1.7　While...End

7.1.8　Function

7.1.9　Sub

7.1.10　Call

7.1.11　Exit xx

7.1.12　GoTo

7.1.13　Continue

7.1.14　On Error

8.　基本コマンド

8.1　基本コマンド一覧

8.2　変数操作コマンド

8.2.1　Dim （変数を宣言しメモリ領域を割り当てる）

8.2.2　Dim（配列） （配列変数を宣言しメモリ領域を割り当てる）

8.2.3　SetEnvironmentまたはSetEnv （環境変数を設定する）

8.2.4　GetEnvironmentまたはGetEnv （環境変数を取得する）

8.2.5　SetGV （グローバル変数を設定する）

8.2.6　GetGV （グローバル変数を取得する）

8.2.7　DeleteGV （グローバル変数を削除する）

8.2.8　GetArrayCount （配列変数の要素数を取得する）

8.3　文字列操作コマンド

8.3.1　InStr （文字列を検索し文字位置を返す）

8.3.2　InArray （配列変数の要素から文字列を検索し，インデックス番号を返す）

8.3.3　Len （文字列の文字数を返す）

8.3.4　LCase （半角アルファベットの大文字を小文字に変換する）

8.3.5　UCase （半角アルファベットの小文字を大文字に変換する）

8.3.6　Left （左端から指定した文字数分の文字列を返す）

8.3.7　Mid （指定した文字数分の文字列を返す）

8.3.8　Right （右端から指定した文字数分の文字列を返す）

8.3.9　Space （半角スペースからなる文字列を返す）

8.3.10　LTrim （先頭のスペースを削除した文字列を返す）

8.3.11　RTrim （末尾のスペースを削除した文字列を返す）

8.3.12　Trim （先頭および末尾のスペースを削除した文字列を返す）

8.3.13　文字列連結（+） （文字列連結を行う）

8.3.14　文字列連結（&） （文字列連結を行う）

8.3.15　文字列連結（&=） （変数と式の文字列連結を行う）

8.3.16　AddStr （指定した連結文字で文字列連結を行う）

8.3.17　SeparateStrCount （文字列分割を行い，分割文字列の数を返す）

8.3.18　SeparateStr （文字列分割を行い，分割文字列を返す）

8.3.19　Str （値を文字列で返す）

8.3.20　Format （値を書式化した文字列を返す）

8.3.21　IsLower （半角アルファベットの小文字かどうかを調べる）

8.3.22　IsUpper （半角アルファベットの大文字かどうかを調べる）

8.3.23　IsSingleChar （半角文字かどうかを調べる）

8.3.24　IsMultiChar （全角文字かどうかを調べる）

8.4　日付操作コマンド

8.4.1　Date （現在の日付を返す）

8.4.2　Time （現在の時刻を返す）

8.4.3　Year （指定された日付の年を返す）

8.4.4　Month （指定された日付の月を返す）

8.4.5　Day （指定された日付の日を返す）

8.4.6　Weekday （指定された日付の曜日を返す）

8.4.7　Hour （指定された時刻の時を返す）

8.4.8　Minute （指定された時刻の分を返す）

8.4.9　Second （指定された時刻の秒を返す）

8.4.10　CalcDate （指定された日付に加算減算を行う）

8.4.11　CompDate （二つの日付を比較する）

8.4.12　GetDateCount （二つの日付の経過日数を取得する）

8.4.13　CalcTime （指定された時刻に加算減算を行う）

8.4.14　CompTime （二つの時刻を比較する）

8.4.15　GetTimeCount （二つの時刻の経過時間を取得する）

8.4.16　IsLeapYear （うるう年かどうかを調べる）

8.5　ファイル・フォルダ操作コマンド

8.5.1　IniRead （初期化ファイルから値を読み込む）

8.5.2　IniWrite （初期化ファイルに値を登録する）

8.5.3　TextFileReplace （テキストファイルの文字列を置き換える）

8.5.4　TextOpen （テキストファイルをオープンする）

8.5.5　TextClose （テキストファイルをクローズする）

8.5.6　TextRead （テキストファイルから1行分のデータを読み込む）

8.5.7　TextWrite （テキストファイルにデータを書き込む）

8.5.8　TextSeek （読み書き開始位置を先頭または末尾に移動する）

8.5.9　GetTextPosition （読み書きの開始位置を返す）

8.5.10　MakeDir （フォルダを作成する）

8.5.11　DeleteDir （フォルダを削除する）

8.5.12　DeleteFile （ファイルを削除する）

8.5.13　Rename （ファイル名を変更する）

8.5.14　TempDir （一時フォルダを取得する）

8.5.15　TempFile （一時ファイル名を作成する）

8.5.16　SetFileAttributeまたはSetFileAttr （フォルダ／ファイルの属性を設定する）

8.5.17　GetFileAttributeまたはGetFileAttr （フォルダ／ファイルの属性を取得する）

8.5.18　SetFileTime （ファイルの日付と時刻を設定する）

8.5.19　GetFileTime （ファイルの日付と時刻を取得する）

8.5.20　GetFileSize （ファイルの容量を取得する）

8.5.21　GetVersionInfoまたはGetVerInfo （ファイルのバージョン情報を取得する）

8.5.22　SplitFile （ファイルを分割する）

8.5.23　CatFiles （ファイルを統合する）

8.5.24　SetStandardFileまたはSetStdFile （標準入力・出力・エラーファイルを設定する）

8.5.25　ResetStandardFileまたはResetStdFile （標準入力・出力・エラーファイルを解除する）

8.5.26　SplitPath （フルパスを解析する）

8.5.27　MakePath （フルパスを作成する）

8.5.28　SetPath （実行フォルダのパスを設定する）

8.5.29　GetPath （実行フォルダのパスを取得する）

8.5.30　SetVolumeLabelまたはSetVolLabel （ボリュームラベルを設定する）

8.5.31　GetVolumeLabelまたはGetVolLabel （ボリュームラベルを取得する）

8.5.32　GetDiskFreeSpace （ディスク空き容量を取得する）

8.5.33　Copy （ファイルをコピーする）

8.6　メッセージ出力コマンド

8.6.1　InputBox （メッセージとテキストボックスを表示する）

8.6.2　Message （ファイル／ウィンドウにテキストを出力する）

8.6.3　MessageBox （ダイアログボックスにメッセージを表示する）

8.6.4　MessageEventLog （イベントビューアにメッセージを出力する）

8.6.5　IMEventMessage （JP1/IMまたはJP1/Baseにイベントを発行する）

8.7　メニュー呼び出しコマンド

8.7.1　Menu （ユーザ定義のメニューを表示する）

8.8　演算処理コマンド

8.8.1　+演算子（加算） （二つの式の和を求める）

8.8.2　+=演算子（加算） （変数と式の和を変数に代入する）

8.8.3　-演算子（減算・マイナス符号） （二つの数値の差を求める）

8.8.4　-=演算子（減算） （変数と式の差を変数に代入する）

8.8.5　Mod演算子（剰余演算） （二つの数値の剰余を求める）

8.8.6　Mod=演算子（剰余演算） （変数と式の剰余を変数に代入する）

8.8.7　*演算子（乗算） （二つの数値の積を求める）

8.8.8　*=演算子（乗算） （変数と式の積を変数に代入する）

8.8.9　/演算子（除算） （二つの数値の商を求める）

8.8.10　/=演算子（除算） （変数と式の商を変数に代入する）

8.8.11　¥演算子（整数除算） （二つの数値の商を求める）

8.8.12　¥=演算子（整数除算） （変数と式の商を変数に代入する）

8.8.13　^演算子（べき乗） （二つの数値のべき乗を求める）

8.8.14　^=演算子（べき乗） （変数と式のべき乗を変数に代入する）

8.8.15　比較演算子（=，<>，<，<=，>，>=） （二つの式を比較する）

8.8.16　And（論理積） （二つの式の論理積を求める）

8.8.17　Or（論理和） （二つの式の論理和を求める）

8.8.18　Not（論理否定） （式の論理否定を求める）

8.9　チェック処理コマンド

8.9.1　IsEmpty （変数がEmpty値かどうかを調べる）

8.9.2　IsDefineまたはIsDef （変数が定義されているかどうかを調べる）

8.9.3　IsNumeric （数値として評価できるかを調べる）

8.9.4　IsEmptyDir （フォルダの中身が空かどうかを調べる）

8.9.5　IsExistDir （フォルダが存在するかどうかを調べる）

8.9.6　IsExistFile （ファイルが存在するかどうかを調べる）

8.9.7　IsWriteableDir （フォルダが書き込み可能かどうかを調べる）

8.9.8　IsFileAttributeまたはIsFileAttr （フォルダ／ファイルの属性を調べる）

8.9.9　IsNew （バージョン情報／ファイル日付の新旧を比較する）

8.9.10　CheckDirName （フォルダ名の末尾が（¥）かどうかを調べる）

8.9.11　CheckDriveType （ドライブの種類を調べる）

8.10　外部プログラム呼び出しコマンド

8.10.1　Exec （自PC上の実行ファイルを呼び出す）

8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）

8.10.3　WaitForExec （実行ファイルの終了待ち／強制終了を行う）

8.10.4　GetExecStatus （実行ファイルの実行状態を取得する）

8.10.5　CallSpt （複数パラメタ指定でSPTファイルを呼び出す）

8.11　自動起動処理コマンド

8.11.1　EntryStartUp （スクリプトファイルを自動起動に登録する）

8.11.2　CancelStartUp （スクリプトファイルの自動起動の登録を解除する）

8.12　JP1呼び出しコマンド

8.12.1　JOBSubmit （キューサーバにスクリプトを登録する）

8.12.2　JOBWait （ジョブの終了を待つ）

8.12.3　JOBHold （ジョブを保留／解除する）

8.12.4　JOBCancel （ジョブをキャンセルする）

8.13　コメントコマンド

8.13.1　Remまたは ' （プログラム内にコメントを記述する）

8.14　その他のコマンド

8.14.1　Sleep （スクリプトの実行を中断する）

8.14.2　Alert （ユーザエラーを警告／解除する）

8.14.3　Beep （スピーカからビープ音を鳴らす）

8.14.4　Exit （スクリプトを終了する）

8.14.5　GetErrorMessage （エラーメッセージを取得する）

9.　特殊コマンド

9.1　特殊コマンド一覧

9.2　レジストリ操作コマンド

9.2.1　RegRead （レジストリから値を読み込む）

9.2.2　RegWrite （レジストリに値を登録する）

9.2.3　RegDelete （レジストリの値を削除する）

9.2.4　RegDeleteKey （レジストリのサブキーを削除する）

9.3　描画・表示処理コマンド

9.3.1　BitmapShow （ビットマップを表示する）

9.3.2　BitmapHide （ビットマップを消去する）

9.4　チェック処理コマンド

9.4.1　IsEmptyReg （レジストリサブキーの中身が空かどうかを調べる）

9.4.2　IsExistRegKey （レジストリサブキーが存在するかどうかを調べる）

9.4.3　IsExistService （サービスが存在するかどうかを調べる）

9.4.4　IsEmptyGroup （ショートカットが存在するかどうか調べる）

9.5　サービス操作コマンド

9.5.1　ServiceSetValue （サービス情報を設定する）

9.5.2　ServiceGetValue （サービスの情報を取得する）

9.5.3　ServiceCreate （サービスを登録する）

9.5.4　ServiceDelete （サービスを削除する）

9.5.5　ServiceStart （サービスを開始する）

9.5.6　ServiceStop （サービスを停止する）

9.5.7　ServicePause （サービスを一時停止する）

9.5.8　ServiceContinue （一時停止のサービスを再開する）

9.5.9　ServiceChange （サービスの設定情報を変更する）

9.5.10　ServiceQuery （サービスの設定情報を取得する）

9.5.11　ServiceRefer （サービスの現在の状態を取得する）

9.5.12　ServiceControl （サービスに制御コマンドを送る）

9.5.13　GetServiceName （サービス表示名からサービス名を取得する）

9.6　外部プログラム呼び出しコマンド

9.6.1　CallDll （DLLファイルを呼び出す）

9.7　ショートカット操作コマンド

9.7.1　MakeGroup （プログラムグループを作成する）

9.7.2　DeleteGroup （プログラムグループを削除する）

9.7.3　MakeShortcut （ショートカットを作成する）

9.7.4　DeleteShortcut （ショートカットを削除する）

9.8　プロセス監視コマンド

9.8.1　GetProcessCount （プロセスの起動数を取得する）

9.8.2　GetProcessInfo （プロセスの情報を取得する）

9.8.3　TerminateProcess （プロセスを強制終了する）

9.9　その他のコマンド

9.9.1　ExitWindows （スクリプトを終了しWindowsをログオフ／パワーオフ／リブートする）

9.9.2　SetRetryMode （排他エラーリトライ機能を設定する）

9.9.3　ResetRetryMode （排他エラーリトライ機能を解除する）

9.9.4　SetTrialOpenMode （試行オープン機能を設定する）

9.9.5　ResetTrialOpenMode （試行オープン機能を解除する）

10.　スクリプト制御インタフェース

10.1　スクリプト制御インタフェースとは

10.2　スクリプト制御インタフェース一覧

10.2.1　SPTHOpen （スクリプト制御マネージャをオープンする）

10.2.2　SPTHClose （スクリプト制御マネージャをクローズする）

10.2.3　SPTHGetErrorMessage （エラーメッセージを取得する）

10.2.4　SPTHTerminate （スクリプト実行を強制終了する）

10.3　スクリプト制御インタフェースの記述例

11.　スクリプトOLEコントロール

11.1　スクリプトOLEコントロールとは

11.2　SPTOコントロール

11.2.1　RTNプロパティ （メソッドのエラー詳細コードを返す）

11.2.2　EXECRTNプロパティ （実行ファイルの終了コードを返す）

11.2.3　EXECIDプロパティ （実行ファイルの識別子を返す）

11.2.4　EnableErrorMessageプロパティ （エラーの有無を返す）

11.2.5　SetGVメソッド （グローバル変数を設定する）

11.2.6　GetGVメソッド （グローバル変数を取得する）

11.2.7　DeleteGVメソッド （グローバル変数を削除する）

11.2.8　Execメソッド （実行ファイルを呼び出す）

付録

付録A　Scriptトレースのファイル出力形式

付録B　サンプルファイル

付録C　エラー詳細コード

付録D　保守ログファイル

付録E　各バージョンの変更内容

付録F　このマニュアルの参考情報

付録F.1　関連マニュアル

付録F.2　このマニュアルでの表記

付録F.3　オンラインヘルプについて

付録F.4　図中で使用する記号

付録F.5　このマニュアルで使用する記号

付録F.6　コマンドの文法で使用する記号

付録F.7　64ビット版のWindowsのレジストリキーの名称について

付録F.8　JIS 2004（JIS X 0213：2004）で追加された第3水準，第4水準漢字について

付録F.9　KB（キロバイト）などの単位表記について

付録G　用語解説

索引

[他社商品名称に関する表示]

Copyright (C) 2012, Hitachi, Ltd.
Copyright (C) 2012, Hitachi Solutions, Ltd.

前書き

■ 対象製品

適用OSのバージョン，JP1/Scriptが前提とするサービスパックやパッチなどの詳細については，リリースノートで確認してください。

P-2A12-3FA4　 JP1/Script　 10-00（適用OS：Windows）

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MS-DOSは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual Basicは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Win32は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記 | 製品名
MS-DOS | Microsoft(R) MS-DOS(R) Operating System Version 5.0/V以降
Visual Basic | Microsoft(R) Visual Basic(R)
Win32 | Microsoft(R) Win32(R)
Windows XP ※1※2 | Microsoft(R) Windows(R) XP Professional Operating System
Windows Server 2003 ※1※2 | Windows Server 2003 | Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Windows Server 2003（x64） | Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Windows Server 2003 R2 | Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Windows Server 2003 R2（x64） | Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Windows Vista ※1※3 | Windows Vista | Microsoft(R) Windows Vista(R) Business
Microsoft(R) Windows Vista(R) Enterprise
Microsoft(R) Windows Vista(R) Ultimate
Windows Vista（x64） | Microsoft(R) Windows Vista(R) Business(x64)
Microsoft(R) Windows Vista(R) Enterprise(x64)
Microsoft(R) Windows Vista(R) Ultimate(x64)
Windows Server 2008 ※1※3 | Windows Server 2008 | Microsoft(R) Windows Server(R) 2008 Datacenter
Microsoft(R) Windows Server(R) 2008 Enterprise
Microsoft(R) Windows Server(R) 2008 Standard
Windows Server 2008（x64） | Microsoft(R) Windows Server(R) 2008 Datacenter(x64)
Microsoft(R) Windows Server(R) 2008 Enterprise(x64)
Microsoft(R) Windows Server(R) 2008 Standard(x64)
Windows Server 2008 R2（x64） | Microsoft(R) Windows Server(R) 2008 R2 Datacenter(x64)
Microsoft(R) Windows Server(R) 2008 R2 Enterprise(x64)
Microsoft(R) Windows Server(R) 2008 R2 Standard(x64)
Windows 7 ※1※3※4 | Windows 7 | Microsoft(R) Windows 7 Professional
Microsoft(R) Windows(R) 7 Enterprise
Microsoft(R) Windows 7 Ultimate
Windows 7（x64） | Microsoft(R) Windows 7 Professional (x64)
Microsoft(R) Windows 7 Enterprise (x64)
Microsoft(R) Windows 7 Ultimate(x64)

注※1

Windows XP，Windows Server 2003，Windows Vista，Windows Server 2008，およびWindows 7を合わせて「Windows」と表記することがあります。

注※2

Windows XP，およびWindows Server 2003を合わせて「Windows Vistaより前のOS」と表記することがあります。

注※3

Windows Vista，Windows Server 2008，およびWindows 7を合わせて「Windows Vista以降のOS」と表記することがあります。

注※4

Windows 7は，「Windows Vista」と表記することがあります。

■ 発行

2012年10月 3021-3-135

■ 著作権

Copyright (C) 2012, Hitachi, Ltd.
Copyright (C) 2012, Hitachi Solutions, Ltd.

はじめに

このマニュアルは，プログラムプロダクトP-2A12-3FA4　JP1/Scriptの機能概要と使い方について説明したものです。

＜はじめにの構成＞

対象読者

マニュアルの構成

対象読者

このマニュアルは，次の方にお読みいただくことを前提に説明しています。

ほかのシステムでジョブ制御の経験がある方

使用するオペレーティングシステムの基本的な操作，およびBasic言語を理解している方

JP1関連製品の機能を理解している方

マニュアルの構成

このマニュアルは，次に示す編，章と付録から構成されています。

第1編　解説編

第1章　JP1/Scriptの概要

JP1/Scriptの機能概要と特長，全体構成，プログラムの種類，ファイル，システム構成について説明しています。また，JP1/Scriptの操作の流れについても説明しています。

第2章　JP1/Scriptを利用するための準備

JP1/Scriptのインストール方法，アンインストール方法，他のコンピュータとの通信時のアカウント，および各種システム環境での環境設定方法について説明しています。また，JP1/Scriptの起動と終了についても説明しています。

第3章　JP1/Scriptの操作

JP1/Scriptのマネージャ，エディタ，簡易入力，トレースビューア，トレースファイル，メニューエディタ，プロセスビューア，実行環境ファイルコンバータの操作方法について説明しています。操作の中で表示されるダイアログの説明は，第4章で詳説しています。

第4章　ダイアログの説明

Scriptマネージャウィンドウ，Scriptエディタウィンドウ，Scriptトレースビューアウィンドウ，およびScriptメニューエディタウィンドウのダイアログについて説明しています。

第5章　トラブルへの対処方法

JP1/Scriptで発生するトラブルの種類と，その対処方法について説明しています。

第2編 文法編

第6章　JP1/Scriptの規則

JP1/Scriptで使用するスクリプトに関する規則，およびコマンドラインに関する規則について説明しています。

第7章　ステートメント

スクリプトを作成するときに使用できるステートメントについて説明しています。

第8章　基本コマンド

スクリプトを作成するときに使用できる基本コマンドについて説明しています。

第9章　特殊コマンド

スクリプトを作成するときに使用できる特殊コマンドについて説明しています。

第10章　スクリプト制御インタフェース

実行中のスクリプトを制御する，スクリプト制御インタフェース（API）について説明しています。

第11章　スクリプトOLEコントロール

スクリプトコマンドを実行する，スクリプトOLEコントロールについて説明しています。

付録A　Scriptトレースのファイル出力形式

Scriptトレースで扱うファイルの出力形式について説明しています。

付録B　サンプルファイル

サンプルファイルの概要，およびサンプルファイルの実行手順について説明しています。

付録C　エラー詳細コード

JP1/Scriptのコマンド実行後の予約変数_RTN_に設定される値，およびエラー内容について説明しています。

付録D　保守ログファイル

サポートセンターへのお問い合わせの際に送付していただく保守ログファイルについて説明しています。

付録E　各バージョンの変更内容

JP1/Scriptの各バージョンの変更内容について説明しています。

付録F　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報について説明しています。

付録G　用語解説

JP1/Scriptで使用する用語の意味を解説しています。

1.　 JP1/Scriptの概要

JP1/Scriptは，Windows上でジョブを制御するスクリプトを作成して実行するためのプログラムです。

この章では，JP1/Scriptの特長，機能の概要，およびシステム構成について説明します。

＜この章の構成＞

1.1　JP1/Scriptの特長

1.2　JP1/Scriptの全体構成

1.3　JP1/Scriptを構成するプログラムの種類

1.4　JP1/Scriptで扱うファイル

1.5　JP1/Scriptのシステム構成

1.6　JP1/Scriptの操作の流れ

1.7　スクリプトを作成する前に，実行する前に

1.8　Windows Vista以降のOSの対応に関して

1.9　排他エラーリトライ機能と試行オープン機能に関して

1.1　JP1/Scriptの特長

JP1/Scriptは，Windows上でジョブを制御するスクリプトを作成して実行するためのプログラムです。JP1/Scriptを使用することで，簡単にスクリプトを作成できます。

また，今までほかのシステムでジョブ制御を行っていた場合でも，ほかのシステムでのジョブ制御と同じようなイメージで，Windows上でもジョブ制御を実現できます。

プログラムの作成／実行が容易
JP1/Scriptは，Basic言語に似たコマンドで記述されたソースコードを逐次解釈しながら，実行するプログラムです。したがって，プログラムを作成／変更してから実行するまでの手間がなく，プログラムの作成／実行が容易です。

プログラム編集／デバッグ時の負荷を軽減
JP1/Scriptの専用エディタでは，簡易入力機能を使用して入力したコマンドやステートメントをボタン一つでエディタに貼り付けることができ，コマンドやステートメントの知識がなくても手軽に間違いなく作成できます。また，モニタリング機能を使えば，スクリプトの動作を見ながら実行できるので，デバッグ時の負荷が軽減できます。

目的に合った多様なコマンドを用意
JP1/Scriptでは，ファイルやフォルダの操作やメッセージの出力などから，レジストリの操作，Windowsのシャットダウンなど，業務に必要なさまざまなコマンドを用意しています。

メニュー機能による対話形式のプログラム作成が可能
JP1/Scriptでは，メニュー機能を提供しています。メニュー機能を利用すれば，画面上で操作した内容を基にスクリプトを実行させることができ，対話業務にも適用できます。

さまざまな機能を提供
JP1/Scriptでは，このほかにもさまざまな機能を提供しています。
例えば，作成したスクリプトを自動起動させたり，スクリプトから別のスクリプトやアプリケーションを自コンピュータ上や他コンピュータ上で実行させたりすることができます。
また，プログラムの実行結果を取得できます。実行結果を取得することで，次の処理を判断できるため，プログラムの切り替えなど，柔軟な連携処理を実現できます。
さらに，他のJP1製品と連携することで統合的なジョブ管理が実現できます。

1.2　JP1/Scriptの全体構成

図1-1にJP1/Scriptの全体の構成を示します。

図1-1　JP1/Scriptの全体構成

1.3　JP1/Scriptを構成するプログラムの種類

JP1/Scriptは，表1-1に示すプログラムによって構成されています。各プログラムの関連性については，「1.2　JP1/Scriptの全体構成」を参照してください。

表1-1　JP1/Scriptのプログラム

プログラムの種類
アイコン
プログラム名
概要
プロセス監視の必要性

マネージャ
[図データ]　
SPTM.exe
JP1/Scriptで作成したスクリプトや実行環境を管理するマネージャです。
×

スクリプト実行制御
－
Sptxe.exe
スクリプトファイル（.SPT）を解析して実行します。
×

NetExecコマンド実行制御
－
SPTXNetx.exe
NextExecコマンド実行時の接続先コンピュータとの通信処理を行います。
×

Scriptランチャ
[図データ]　
Spthlnch.exe
自動起動情報に登録されたスクリプトファイルのログオン空間での起動および終了の制御や，NetExecコマンドのログオン空間での要求を制御します。
○

Scriptランチャサービス
－
SPTHLNCHSV.exe
NetExecコマンドのログオン空間での要求を制御します。
○

JP1/Scriptサービス
－
SPTHSV.exe，
SPTTMS.exe
自動起動情報に登録されたスクリプトファイルのサービス空間での起動および終了の制御や，NetExecコマンドのサービス空間での要求を制御します。
○

トレースビューア
[図データ]　
SPTTM.exe
トレースファイルの状態，および内容を表示します。
×

簡易入力
[図データ]　
Sptke.exe
コマンドやステートメントの入力作業を簡略化できる機能です。この機能を使うことで，コマンドの知識がなくても入力できます。記述したコマンドやステートメントの内容は，クリップボードやエディタに貼り付けられます。
×

エディタ
[図データ]　
SPTIEdit.exe
JP1/Script専用のエディタで，スクリプトファイルの作成，編集，保存に必要な機能を備えています。
×

メニューエディタ
[図データ]　
SPTNEdit.exe
作成したスクリプトファイルのメニューフォーム（画面）を作成したり編集したりする機能を備えています。
×

プロセスビューア
[図データ]　
SPTHView.exe
実行中のスクリプトプロセスを一覧表示したり，プロセスを監視・制御したりする機能を備えています。
×

実行環境ファイルコンバータ
－
SPTUspv.exe
実行環境ファイル（拡張子SPV）と
実行環境構文ファイル（拡張子SPU）を
相互変換できます。
×

（凡例）

－：該当するアイコンはありません。

○：監視する必要があります。

×：監視する必要はありません。

JP1/Cm2/SSOなどの稼働監視プログラムでJP1/Scriptのプロセスを監視する場合に必要であるプロセスについて記載しています。プロセス監視については，「2.6　稼働監視プログラムでのJP1/Scriptの監視」を参照してください。

1.4　JP1/Scriptで扱うファイル

＜この節の構成＞

1.4.1　ファイルの種類

1.4.2　ファイルの容量

1.4.3　ラージファイル

1.4.4　ファイルのアクセス権限

1.4.1　ファイルの種類

JP1/Scriptで扱うファイルを表1-2に示します。

なお，ファイルの容量の計算方法については，「1.4.2　ファイルの容量」を，トレースビューアが扱うファイルの出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

表1-2　JP1/Scriptで扱うファイルの種類

ファイルの種別
ファイル名
ファイルの拡張子
ファイルの形式
ファイルの内容

マネージャが扱うファイル
スクリプトファイル
.SPT
テキスト形式
スクリプト文を保存するファイルです。
ファイル名はユーザが任意に指定できます。
指定できる文字数は，半角文字で30文字以内（全角文字で15文字以内）です。
ただし，ファイル名に半角の空白，および次の文字は使用できません。

"=¥;:.,{}<>/

使用した場合の動作保証はできません。

実行環境ファイル
.SPV
バイナリ形式
一つのスクリプトファイルを実行するときの環境が設定されたファイルです。
ファイル名は，スクリプトファイルと同じになります。

自動起動情報ファイル
.SPH
バイナリ形式
ScriptランチャまたはJP1/Scriptサービスがスクリプトを自動的に実行できるようにするための，必要な情報が保存されたファイルです。
ファイル名は，SPTLNCHで固定です。
Windows XP，Windows Vista以降のOSでは，ユーザ簡易切替機能により複数ユーザの同時ログオンができるため，2種類のファイルを用意しています。

起動タイプがログオンのスクリプトが登録されるユーザ単位の自動起動情報ファイル

起動タイプがサービスのスクリプトが登録される全ユーザ共通の自動起動情報ファイル

ファイル名は両ファイルともSPTLNCHで固定です。

サーバ環境ファイル
.SPS
バイナリ形式
サーバ環境が設定されているファイルです。
ファイル名は，SPTSVで固定です。

トレースビューアが扱うファイル
解析トレースファイル
.SPA
テキスト形式
スクリプト文の構文解析の結果が保存されたファイルです。
ファイル名は，スクリプトファイルと同じになります。

実行トレースファイル
.SPX
テキスト形式
スクリプト文のコマンドの実行結果が保存されたファイルです。
ファイル名は，スクリプトファイルと同じになります。

ユーザトレースファイル（トレースファイル）
.TXT
テキスト形式
スクリプトのコマンドによって出力されたトレースが保存されたファイルです。
ファイル名はユーザが任意に指定できます。

サーバトレースファイル
.SPY
テキスト形式
クライアントにあるスクリプト文のコマンドから呼び出されたサーバのコマンド実行結果を出力するファイルです。
ファイル名は，SPTSVTRCで固定です。

エディタが扱うファイル
モニタリング情報ファイル
.SPD
バイナリ形式
モニタリング機能で利用する情報ファイルです。
ファイル名は，スクリプトファイルと同じになります。

メニューエディタが扱うファイル
メニュー情報ファイル
.SPN
バイナリ形式
メニュー，および各コントローラのプロパティ定義が記述されたファイルです。メニューエディタの起動方法によって異なります。

メニューエディタをマネージャやエディタのメニューから起動した場合
ファイル名は，スクリプトファイルと同じになります。

メニューエディタをWindowsの［スタート］メニューから起動した場合
ファイル名はユーザが任意に指定できます。

コンバータが扱うファイル
実行環境構文ファイル
.SPU
テキスト形式
実行環境ファイルコンバータで利用するファイルです。実行環境ファイルに設定されている内容が文字形式で設定されています。ファイル名はユーザが任意に指定できます。

その他のファイル
トレース管理ファイル※1
.SPB
バイナリ形式
トレースファイルを管理するファイルです。
ファイル名は，SPTLOGDBで固定です。

ワークファイル※2
.TMP
バイナリ形式
JP1/Script内部で利用するワークファイルです。

グローバル変数ファイル
.SPG
バイナリ形式
スクリプトの実行時に設定されたグローバル変数が保存されたファイルです。
ファイル名は，SPTGVで固定です。

予約語ルールファイル
.SPR
バイナリ形式
スクリプトファイルを解析・実行するために必要となる予約語に関する規則を格納したファイルです。
ファイル名は，VERvvrrで固定です。vvはJP1/Scriptのバージョンを表し，rrはJP1/Scriptのリビジョンを表しています。

NetExecコマンド制限ポリシーファイル
なし
-
NetExecコマンドを実行することを許可されているユーザが設定されているファイルです。
ファイル名は，SPTHSV_ACPおよびSPTHLSV_ACPで固定です。

保守ログファイル
.LOG
テキスト形式
JP1/Scriptの各種プログラム内でWindowsが提供する機能を呼び出した際に発生したエラーの詳細情報やエラー発生時の状況を記録したファイルです。

注※1　トレース管理ファイルは，以下のトレースファイルのファイル名，およびトレースファイルの書き出し位置などを管理しているファイルです。

解析トレースファイル

実行トレースファイル

サーバトレースファイル

ユーザトレースファイル

注※2　JP1/Scriptでは，一時的にTEMPフォルダにワークファイルを作成します。TEMPフォルダをウィルス対策ソフトのウィルスチェックの対象にした場合，JP1/Scriptアプリケーションが正常に動作しないことがありますのでご注意ください。

トレース管理ファイルに関する補足事項

次の条件の場合，トレース管理ファイルで管理するトレースファイルが増えるためトレース管理ファイルの容量が増加します。

ファイル名の異なるスクリプトを実行する

MessageコマンドでTarget引数に「Target_File」を指定して新規のファイルに出力する

ファイル名の異なるスクリプトを実行した場合，そのスクリプトファイルの解析トレースファイル，および実行トレースファイルを管理するため，容量が増加します。同じスクリプトファイルを複数回実行する場合は，トレース管理ファイルに出力されている情報を使用するため容量が増えることはありません。

MessageコマンドでTarget引数に「Target_File」を指定して新規のファイルに出力する場合，容量が増加します。

MessageコマンドのOutputName引数に指定したファイルが，すでにMessageコマンドでTarget引数に「Target_File」を指定して出力済みのファイルの場合，トレース管理ファイルに出力されている情報を使用するため容量が増えることはありません。

MessageコマンドでTarget引数に「Target_File」を指定して，ユニークなファイル名称を持ったユーザトレースファイルを大量に作成する場合，大量に作成されたファイル名，およびトレースファイルの書き出し位置などを管理するための情報が増えるため，トレース管理ファイルの容量が増大してしまいます。トレース管理ファイルの容量が増大すると，以下の現象が発生します。

スクリプトファイルの実行性能が劣化する

スクリプトファイルの実行が終了コード「20」で異常終了する

コマンドの実行がメモリ不足でエラーになる

ユニークなファイル名称を持ったユーザトレースファイルを大量に作成する場合は，TextOpen/TextWrite/TextCloseコマンドを使用して，トレースファイルを作成してください。TextOpen/TextWrite/TextCloseコマンドで作成するファイルは，トレース管理ファイルの管理対象外のファイルになるため，トレース管理ファイルの容量が増大することはありません。

1.4.2　ファイルの容量

JP1/Scriptで扱う各ファイルの容量の計算方法，またはおよその容量を次に示します。

マネージャが扱うファイル

スクリプトファイル（.SPT）
スクリプトファイルは，ユーザがどれだけの量のスクリプトを記述するのかによって，容量が異なります。したがって，スクリプトファイルのファイル容量は，ユーザ任意となります。

実行環境ファイル（.SPV）
ファイル容量は，8～12KBです。

自動起動情報ファイル（.SPH）
自動起動情報ファイル，自動起動に登録した回数によって，容量が異なります。ただし，初期割り当てサイズは36KBで，七つのスクリプトファイルを自動起動に登録できます。

サーバ環境ファイル（.SPS）
ファイル容量は，8～12KBです。

トレースビューアが扱うファイル

解析トレースファイル（.SPA）

計算方法は次のとおりです。（単位：バイト）

最大行数×（最大列数＋4）

最大行数，および最大列数は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで設定した値です。

実行トレースファイル（.SPX）

計算方法は次のとおりです。（単位：バイト）

最大行数×（最大列数＋4）

最大行数，および最大列数は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで設定した値です。

ユーザトレースファイル（.TXT）

計算方法は次のとおりです。（単位：バイト）

最大行数×（最大列数＋4）

最大行数，および最大列数は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで設定した値です。

サーバトレースファイル（.SPY）
ファイル容量は，0.2～204KBです。

エディタが扱うファイル

モニタリング情報ファイル（.SPD）
モニタリング情報ファイルは，ウォッチ変数の個数とブレークポイントの個数によって，容量が異なります。ただし，初期割り当てサイズは4KBです。

メニューエディタが扱うファイル

メニュー情報ファイル（.SPN）
メニュー情報ファイルは，定義したフォームの数やフォーム上に貼り付けたコントロールの数などによって，容量が異なります。したがって，メニュー情報ファイルのファイル容量は任意です。

コンバータが扱うファイル

実行環境構文ファイル（.SPU）
実行環境ファイル（.SPV）の容量に依存します。

その他のファイル

トレース管理ファイル（.SPB）
初期割り当てサイズは，520KBです。また，拡張サイズは1トレースファイル当たり，0.3KB～1KBです。なお，初期割り当てサイズで，8個のトレースファイルを格納できます。

グローバル変数ファイル（.SPG）
初期割り当てサイズは，20KBです。また，拡張サイズは20KBです。

保守ログファイル（.LOG）
デフォルト値で出力した場合の最大サイズは，4,032KBです。

1.4.3　ラージファイル

＜この項の構成＞

(1)　ファイルシステム

(2)　ファイルの最大容量

(3)　エラーメッセージ

(1)　ファイルシステム

FAT32，NTFSシステムのラージファイルに対応します（FAT，FAT16は対応しません）。

(2)　ファイルの最大容量

NTFSは8EB（9,223,372,036,854,775,807バイト），FAT32は3.9GB（4,294,967,295バイト）となります。それ以上の場合の動作は保証しません。

(3)　エラーメッセージ

ラージファイル対応のエラーメッセージを，次に示します。

No.
コマンド
エラーメッセージ
予約変数（値）

1
GetFileSize
取得した値が変数の上限値を超えているため，値を変数に格納できません。
_ERR_FILE_SIZE_
（536904784​）

2
IniRead
指定したファイルの容量が制限値を超えています。
_ERR_NOT_LARGE_FILE_
（536904785​）

3
IniWrite
指定したファイルの容量が制限値を超えています。
_ERR_NOT_LARGE_FILE_
（536904785​）

4
TextFileReplace
指定したファイルの容量が制限値を超えています。
_ERR_NOT_LARGE_FILE_
（536904785​）

5
GetTextPosition
読み書き開始位置が，2,147,483,647を超えています。
_ERR_FILE_POSITION_
（536904786​）

1.4.4　ファイルのアクセス権限

JP1/Scriptで作成するファイルには，ユーザの運用に合わせたアクセス権が設定できます。ファイルごとに運用に合ったアクセス権を設定することで，セキュリティ上の危険を回避できます。設定できるアクセス権を次に示します。

設定しない（権限は指定しない）

上位フォルダのアクセス権を継承する

Everyone：フルコントロール

アクセス権を設定するには，次のレジストリキーに値を設定してください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

JP1/Scriptで新規にファイルを作成するときにアクセス権を設定できるファイルを，次の表に示します。

表1-3　アクセス権を設定できるファイル

ファイル名 | 拡張子 | アクセス権限設定
上位フォルダ継承 | Everyone
スクリプトファイル | .SPT | ○ | ○
実行環境ファイル | .SPV | ○ | ○
自動起動情報ファイル | .SPH | ○ | ×
サーバ環境ファイル | .SPS | ○ | ×
解析トレースファイル | .SPA | ○ | ○
実行トレースファイル | .SPX | ○ | ○
ユーザトレースファイル | .TXT | ○ | ○
サーバトレースファイル | .SPY | ○ | ○
モニタリング情報ファイル | .SPD | ○ | ○
メニュー情報ファイル | .SPN | ○ | ○
トレース管理ファイル | .SPB | ○ | ×
グローバル変数ファイル | .SPG | ○ | ×

（凡例）

○：設定できる

×：設定できない

操作コマンドで新規にファイルを作成するときに設定できるアクセス権限を，次の表に示します。

表1-4　作成するファイルに対して設定できるアクセス権限

コマンド | アクセス権限設定
上位フォルダ継承 | Everyone
IniRead | × | ×
IniWrite | ○ | ○
TextFileReplace | × | ×
TextOpen | ○ | ○
TextClose | × | ×
TextRead | × | ×
TextWrite | × | ×
TextSeek | × | ×
GetTextPosition | × | ×
MakeDir | ○ | ○
Rename | × | ×
TempDir | × | ×
TempFile | × | ×
SplitFile | ○ | ○
CatFiles | ○ | ○
SetStandardFile | ○ | ○
Copy※ | ○ | ○
Message | ○ | ○

（凡例）

○：設定できる

×：設定できない

注※　Option6～7の値に「Security」が指定されていない場合だけ設定できます。

1.5　JP1/Scriptのシステム構成

JP1/Scriptを利用したシステム構成について説明します。

＜この節の構成＞

1.5.1　JP1/AJSと連携したシステム構成

1.5.2　JP1/Baseと連携したシステム構成

1.5.3　JP1/IMと連携したシステム構成

1.5.4　クラスタ環境でJP1/Scriptを使用する場合のシステム構成

1.5.5　ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成

1.5.1　JP1/AJSと連携したシステム構成

＜この項の構成＞

(1)　ジョブの自動運転・実行管理

(2)　クライアントからサーバ上のJP1/AJS2のキューへのジョブの登録

(1)　ジョブの自動運転・実行管理

JP1/AJS（JP1/AJS2またはJP1/AJS3）と連携してジョブの自動運転・実行管理を行う場合のシステム構成について説明します。JP1/AJSでは，JP1/Scriptで作成したスクリプトファイルをジョブとして定義して，実行できます。

ジョブの自動運転・実行管理を行う場合のJP1/AJSとの連携を次の図に示します。

図1-2　ジョブの実行運転・実行管理を行う場合のJP1/AJSとの連携

マネージャホストのジョブ定義で，エージェントホストで作成したスクリプトファイルの実行をエージェントホストに依頼するジョブを定義すると，実行時刻になった時点で，エージェントホストのスクリプトファイルが実行されます。

また，JP1/AJSでは，GUIを表示し入力待ちになるプログラムをジョブとして実行できませんが，JP1/Scriptのスクリプトファイルを利用すると，GUIを持つプログラムを起動させることができます。詳細は，「8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）」を参照してください。

(2)　クライアントからサーバ上のJP1/AJS2のキューへのジョブの登録

JP1/AJS2と連携してクライアントからサーバ上のJP1/AJS2のキューへジョブを登録する場合のシステム構成について説明します。JP1/Scriptでは，JP1/AJS2のキューに対してスクリプトファイルを登録できます。JP1/AJS2のキューに対する操作コマンドについては，「8.12　JP1呼び出しコマンド」を参照してください。

クライアントからサーバ上のJP1/AJS2のキューへジョブを登録する場合のJP1/AJS2との連携を次の図に示します。

図1-3　クライアントからサーバ上のJP1/AJS2のキューへジョブを登録する場合のJP1/AJS2との連携

1.5.2　JP1/Baseと連携したシステム構成

JP1/Baseと連携して，JP1/ScriptからJP1/BaseへJP1イベントを発行する場合のシステム構成について説明します。JP1/Scriptでは，JP1/Baseに対してJP1イベントを発行できます。JP1イベントの発行については，「4.1.26　オプション（JP1/IM）ダイアログ」および「8.6.5　IMEventMessage （JP1/IMまたはJP1/Baseにイベントを発行する）」を参照してください。

JP1/Baseと連携したシステム構成を次の図に示します。

図1-4　JP1/Baseと連携したシステム構成

1.5.3　JP1/IMと連携したシステム構成

JP1/IMと連携した場合のシステム構成について説明します。JP1/IMでは，特定のJP1イベントを受信したときに，自動的にコマンドを実行させることができる自動アクションで，JP1/Scriptで作成したスクリプトファイルを実行できます。

JP1/IMと連携したシステム構成を次の図に示します。

図1-5　JP1/IMと連携したシステム構成

1.5.4　クラスタ環境でJP1/Scriptを使用する場合のシステム構成

クラスタ環境でJP1/Scriptを使用する場合のシステム構成について説明します。JP1/Scriptでは，クラスタ環境には対応していますが，フェールオーバーなどの実行状態の引き継ぎなどはサポートしていません。クラスタ環境については「2.3　クラスタシステム環境での環境設定」を参照してください。

クラスタ環境でJP1/Scriptを使用する場合のシステム構成を次の図に示します。

図1-6　クラスタ環境でJP1/Scriptを使用する場合のシステム構成

1.5.5　ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成

ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成について説明します。ターミナルサービス環境でJP1/Scriptを使用する場合は，JP1/Scriptアクセスライセンスを購入する必要があります。ターミナルサービス環境については「2.4　ターミナルサービス環境での環境設定」を参照してください。

ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成を次の図に示します。

図1-7　ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成

1.6　JP1/Scriptの操作の流れ

JP1/Scriptの操作は，マネージャウィンドウでの操作と，トレースビューアウィンドウ（およびトレースファイルの表示ウィンドウ）での操作に大別できます。

スクリプトを完成させるまでの一連の操作は，マネージャウィンドウで実行できます。ただし，実際にスクリプトを記述する操作のときには，マネージャウィンドウからエディタ（またはユーザ指定のエディタ）を起動します。

スクリプトの実行によって作成されたトレースファイルに関する操作は，トレースビューアウィンドウで行います。

ここでは，マネージャウィンドウでスクリプトファイルを完成させるまでの操作の流れを示します。

マネージャからエディタを起動して，スクリプトファイルを作成します。文法チェック機能を利用して，スクリプトの字句解析，構文解析を行えます。

図1-8　JP1/Scriptの操作の流れ

1.7　スクリプトを作成する前に，実行する前に

＜この節の構成＞

(1)　Messageコマンドについて

(2)　解析トレースファイルおよび実行トレースファイルについて

(3)　NetExecコマンドについて

(4)　Beepコマンドについて

(5)　ファイル名パスの制限について

(6)　Scriptランチャサービスについて

(1)　Messageコマンドについて

MessageコマンドでTarget引数に「Target_File」を指定して，ユニークなファイル名称を持ったユーザトレースファイルを大量に作成する場合，大量に作成されたファイル名，およびトレースファイルの書き出し位置などを管理するための情報が増えるため，トレース管理ファイルの容量が増えます。トレース管理ファイルの容量が増えると，以下の現象が発生します。

スクリプトファイルの実行性能が劣化する

スクリプトファイルの実行が終了コード「20」で異常終了する

コマンドの実行がメモリ不足でエラーになる

ユニークなファイル名称を持ったユーザトレースファイルを大量に作成する場合は，TextOpen/TextWrite/TextCloseコマンドを使用して，トレースファイルを作成してください。TextOpen/TextWrite/TextCloseコマンドで作成するファイルは，トレース管理ファイルの管理対象外のファイルになるため，トレース管理ファイルの容量が増えることはありません。

(2)　解析トレースファイルおよび実行トレースファイルについて

解析トレースファイル，および実行トレースファイルは標準でスクリプト実行時に発生するエラー情報を出力します。実行環境の設定によりトレースファイルを出力しない設定も可能ですが，スクリプト実行時に発生するステートメントやコマンドのエラーが出力されないため，原因が特定できない場合があります。このため，トレースファイルはできるだけ出力するようにしてください。ただし，実行トレースファイルを詳細に出力する指定をする※と，出力する情報量が多くなるため，スクリプトファイルの実行性能が劣化します。

トレースファイルを出力したくない場合は，各コマンドの実行結果を判定して，エラーの場合は，エラーとなったコマンド名，および_RTN_予約変数の内容をファイル等に出力して原因を特定する方法など，エラー処理設計を考慮したスクリプトを作成してください。

注※　実行トレースファイルの出力レベルについては，「4.1.12　コマンドラインの設定ダイアログ」，または「6.2.2(3)　/SPXLV（n）（または/spxlv（n））」を参照してください。

(3)　NetExecコマンドについて

NetExecコマンドを実行するスクリプトを複数実行した場合，NetExecコマンド単位で相手先コンピュータとの処理が行われるため，NetExecコマンドを実行するスクリプトを複数実行すると，スクリプトの実行性能が劣化します。NetExecコマンドを実行するスクリプトは大量に実行しないでください。

(4)　Beepコマンドについて

Beepコマンドは，実行するOS，ハードウェア環境によってビープ音が鳴らない場合がありますので注意が必要です。詳細は，「8.14.3　Beep （スピーカからビープ音を鳴らす）」の注意事項を参照してください。

(5)　ファイル名パスの制限について

JP1/Scriptで指定する実行ファイルや，テキストファイルなどのファイル名の絶対パスは，258バイト以内で指定してください。相対パス指定の場合は，装置内の最上位階層から目的のファイルまでのパスで258バイト以内となります。

(6)　Scriptランチャサービスについて

Scriptランチャサービスは，リモートセッションでもNetExecコマンドのログオン空間での要求を制御できる機能です。ターミナルサービス環境などでは，ターミナルサーバはリモートセッションからログオンして操作します。しかし，Scriptランチャはターミナルサーバ側のプライマリセッションで起動するため，リモートセッションではScriptランチャを起動できず，NetExecコマンドのログオン空間での要求を制御できません。Scriptランチャサービスを使用すると，このようなシステム構成でもNetExecコマンドのログオン空間での要求を制御できます。

Scriptランチャサービスは，NetExecコマンドでログオン空間を指定して起動するプログラムを，Scriptランチャサービスの開始パラメータで指定したユーザのログオンセッション下に起動します。そのため，Scriptランチャサービスを使用する場合，NetExecコマンドを使用するときはログオン状態を継続しておく必要があります。ユーザのログオンは，コンソールおよびターミナルサービスのどちらからでも可能です。通常はログオン状態ではなくても，NetExecコマンドを使用する場合にログオンしていれば問題ありません。ターミナルサービスでログオンした場合は，セッションを切断すると，ログオン状態を維持できます。

Scriptランチャサービスは，次の内容でWindowsサービスに登録されます。

全般

サービス名：JP1_SCRIPT_LAUNCHER

表示名：JP1/Script Launcher Service

説明：なし

実行ファイルパス：インストール先フォルダ¥Bin¥SPTHLHSV.EXE

スタートアップの種類：手動

ログオン
ローカルシステムアカウント
Scriptランチャサービスの開始アカウントは，ローカルシステムアカウント以外は設定できません。

回復

最初のエラー：何もしない

次のエラー：何もしない

その後のエラー：何もしない

エラーカウントのリセット：0

依存関係

このサービスが依存するシステムコンポーネント：依存関係なし

このサービスが依存しているシステムコンポーネント：依存関係なし

Scriptランチャサービスを使用するとScriptランチャは起動できなくなります。Scriptランチャサービスを使用する運用の場合，ログオン空間での自動起動ができなくなります。ログオン空間での自動起動が必要な場合は，Scriptランチャサービスを使用しないで，Scriptランチャを使用してください。

Scriptランチャサービスを使用する場合の手順を次に示します。

スタートアップに登録されているScriptランチャを削除する。

Windowsサービスマネージャで，Scriptランチャサービスのプロパティを次のように変更し，プロパティダイアログを開いた状態でScriptランチャサービスを開始する。
・ 全般

スタートアップの種類：自動

開始パラメータ：ログオンユーザ名
ログオンユーザ名には，NetExecコマンドで要求されたコマンドを実行するログオン空間のアカウント名を指定します。
ログオンユーザ名は，"ユーザ名"，"ユーザ名@ドメイン名"，"ドメイン名¥ユーザ名"のどれかの形式で指定します。

必ずScriptランチャサービスを開始してから，プロパティの設定ダイアログを閉じてください。Scriptランチャサービスを開始する前にダイアログを閉じると，開始パラメータに設定した情報が消失します。情報が消失した場合は，再度「全般」タブの項目を設定し，Scriptランチャサービスを開始してしてください。

開始パラメータに指定したログオンユーザ名でログオンする。
NetExecコマンドを使用して運用している間は，ログアウトしないでください。ターミナルサービスでログオンした場合は，ログオン状態を維持したままセッションを切断すれば，ターミナルサービスクライアントを終了してもかまいません。

NetExecコマンドで要求されたコマンドを実行するログオン空間のアカウント名を変更するには，Scriptランチャサービスを停止し，手順2からやり直します。

ログオン空間のアカウント名に指定するユーザが管理者以外のユーザの場合は，事前にOSのセキュリティの設定で「グローバルオブジェクトの作成」の権利を割り当ててください。

1.8　Windows Vista以降のOSの対応に関して

Windows Vista以降のOSで実装された機能や変更された機能により，Windows Server 2003およびWindows XP上での動作と異なる機能があります。

ここでは，Windows Vista以降のOSで従来のOSと異なる点，および管理者権限での実行について説明します。

＜この節の構成＞

1.8.1　インストール先フォルダ

1.8.2　JP1/Scriptサービスの開始と監視

1.8.3　コマンドの動作

1.8.4　マネージャの設定方法

1.8.5　レジストリの変更方法

1.8.6　メッセージボックスのレイアウト

1.8.7　管理者権限での実行

1.8.1　インストール先フォルダ

Windows Vista以降のOSではインストール先のフォルダは，従来のOSと異なります。詳細は「2.1.1 プログラムのインストール先のフォルダ」を参照してください。

インストール先のフォルダが異なるため，次のフォルダが異なります。

トラブル時の資料を採取するフォルダ

バックアップおよびリカバリーするフォルダ

SetGVコマンドで作成される「SPTGV.SPG」ファイルの作成先フォルダ

NetExecコマンドのエラーログファイルの出力先フォルダ

1.8.2　JP1/Scriptサービスの開始と監視

＜この項の構成＞

(1)　JP1/Scriptサービスを開始する契機

(2)　JP1/Scriptサービスを稼働監視プログラムで監視する条件

(1)　JP1/Scriptサービスを開始する契機

Windows Vista以降のOSではJP1/Scriptサービスが常時，実行中の状態でなければなりません。他サービスからスクリプトファイルを起動する場合，スクリプトファイルを起動するサービスよりも前にJP1/Scriptサービスを開始する必要があります。

JP1/Scriptサービスが実行中でない場合の影響

JP1/Scriptサービスが実行中の状態でない場合，次に示す影響があります。

スクリプトファイル起動時，解析／実行トレースが出力されない
スクリプトファイル起動時にJP1/Scriptサービスが実行中でない場合，イベントログに次の警告メッセージを出力します。
「ID 96：JP1/Scriptサービスの状態が実行中以外のため，解析／実行トレースに実行結果が出力されません。またMessage/EntryStartUp/CancelStartUp/グローバル変数操作コマンドの実行がエラーになります。JP1/Scriptサービスを開始してから実行してください。」
なお，JP1/Scriptサービスが実行中でない状態でもスクリプトファイルの起動は中止しません。
スクリプトファイルの実行中にJP1/Scriptサービスの状態が実行中になった場合，実行中になった以降の解析／実行トレースは出力されます。

Target_File，Target_SPAFileまたはTarget_SPXFile指定のMessageコマンド，EntryStartUpコマンド，CancelStartUpコマンド，グローバル変数操作コマンドの実行が失敗する
JP1/Scriptサービスの状態が実行中以外でエラーになった場合，_RTN_予約変数に_ERR_SERVICE_NOT_BEGIN_（値：536903968）が設定されます。

サービスおよび他ユーザから実行したスクリプトプロセスをTerminateProcessコマンドで強制終了できない
指定されたプロセスIDのプロセスが存在しない場合と同様になるため，常に真（True）を返します。

マネージャの［ファイル］－［実行環境の設定］－［すべての項目］メニュー，［ファイル］－［実行環境の設定］－［起動日時］メニューおよび［ツール］－［自動起動の設定］メニューで自動起動情報の設定ができない
JP1/Scriptサービスが実行中でない状態で実行された場合，次のエラーダイアログを表示して設定ダイアログの表示を中止します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

マネージャの［ツール］－［オプション］メニューで各種オプションを設定できない
JP1/Scriptサービスが実行中でない状態で実行された場合，次のエラーダイアログを表示してオプションダイアログの表示を中止します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

エディタの［モニタリング］－［実行環境の設定］メニューで自動起動情報を設定するダイアログを表示できない
自動起動情報の設定ができません。JP1/Scriptサービスが実行中でない状態で実行された場合，次のエラーダイアログを表示して設定ダイアログの表示を中止します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

プロセスビューアにサービスおよび他ユーザで実行中のプロセスが表示できない
表示できない場合，次の警告ダイアログを表示した後，プロセスビューアを起動します。
「JP1/Scriptサービスの状態が実行中以外のため，サービスから起動したプロセスおよび他ユーザで実行中のプロセスを表示しません。表示したい場合は，JP1/Scriptサービスを開始した後，再度実行してください。」

トレースビューアが起動できない
起動できない場合，次のエラーダイアログを表示してトレースビューアの起動を中止します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

(2)　JP1/Scriptサービスを稼働監視プログラムで監視する条件

Windows Vista以降のOSでは必要に応じてJP1/Scriptサービスを稼働監視プログラムで監視してください。詳細は「2.6 稼働監視プログラムでのJP1/Scriptの監視」を参照してください。

1.8.3　コマンドの動作

Windows Vista以降のOSでは，サービスからスクリプトファイルを実行する場合，従来のOSと同様に，サービスに指定されているユーザアカウントの権限で動作します。しかし，マネージャからスクリプトファイルを実行する場合，管理者グループのユーザでログオンしても，OSのユーザアカウント制御（UAC）によりJP1/Scriptアプリケーションは標準ユーザで実行されます。

標準ユーザで実行されると影響を受けるコマンドを次に示します。

アクセス拒否のエラーとなるコマンド

ファイル操作系のコマンド

Exec，NetExecコマンド

TerminateProcessコマンド

GetProcessInfoコマンド

＜この項の構成＞

(1)　アクセス拒否のエラーとなるコマンド

(2)　ファイル操作系のコマンド

(3)　Exec，NetExecコマンド

(4)　TerminateProcessコマンド

(5)　GetProcessInfoコマンド

(1)　アクセス拒否のエラーとなるコマンド

アクセス拒否のエラーとなるコマンドを表1-3に示します。

これらのコマンドを実行するスクリプトファイルは，管理者権限で実行する必要があります。標準ユーザで実行した場合，コマンドが次のエラーになります。

「0005:アクセスは拒否されました。ファイルの属性又はセキュリティを見直してください。」

スクリプトファイルを管理者権限で実行する方法については，「1.8.7 管理者権限での実行」を参照してください。

表1-5　アクセス拒否のエラーとなるコマンド

No. | コマンド | アクセス拒否のエラーとなる条件
1 | SetEnviroment | 第一引数（Type）にSystemEnvを指定
2 | Rename | 第三引数（Metod）にRebootを指定
3 | SetVolLabel | なし
4 | RegWrite | 第一引数（RegKey）にHKEY_CURRENT_USER以外を指定※1
5 | RegDelete | 第一引数（RegKey）にHKEY_CURRENT_USER以外を指定※2
6 | RegDeleteKey | 第一引数（RegKey）にHKEY_CURRENT_USER以外を指定※3
7 | ServiceCreate | なし
8 | ServiceDelete | なし
9 | ServiceStart | なし
10 | ServiceStop | なし
11 | ServicePause | なし
12 | ServiceContinue | なし
13 | ServiceChange | なし
14 | ServiceControl | なし
15 | MakeGroup | 第二引数（RootType）にLcl_Programを指定
16 | DeleteGroup | 第二引数（RootType）にLcl_Programを指定
17 | MakeShortcut | 第一引数（RootPath）にLcl_Desktop，Lcl_Startmenu，Lcl_ProgramまたはLcl_Startupを指定
18 | DeleteShortcut | 第一引数（RootPath）にLcl_Desktop，Lcl_Startmenu，Lcl_ProgramまたはLcl_Startupを指定
19 | GetProcessCount | なし
20 | GetProcessInfo | なし
21 | TerminateProcess | なし
22 | Copy | 第九引数（Option6）または第十引数（Option7）にSecurity を指定

注※1

第一引数（RegKey）にHKEY_LOCAL_MACHINE，第二引数（SubKey）の最初のキーにSoftwareを指定した場合，HKEY_CURRENT_USER¥Software¥Classes¥VirtualStore¥Machine¥Software下にリダイレクトされるためエラーになりません。RegWriteコマンドによってリダイレクトされたエントリはRegReadコマンドで優先して読み込まれます。

注※2

リダイレクトされたSoftware下の値を削除する場合，リダイレクト先のキーを指定する必要があります。

注※3

リダイレクトされたSoftware下のキーに対して実行した場合，キーは削除されません。

(2)　ファイル操作系のコマンド

ファイル操作系のコマンドで，環境変数ProgramFilesおよびWinDirに設定されているフォルダ下のファイルに対して出力・更新した場合，ユーザごとの領域へリダイレクトされるときがあるので注意が必要です。リダイレクト先は環境変数LocalAppDataに設定されているパスのVirtualStore下になります。リダイレクトされる条件は，ファイル操作系のコマンドを実行するスクリプトファイルを標準ユーザで実行することです。リダイレクトされないためにはスクリプトファイルを管理者権限で実行しなければなりません。スクリプトファイルを管理者権限で実行する方法については「1.8.7 管理者権限での実行」を参照してください。

標準ユーザで実行したスクリプトファイルからファイル操作系コマンドで入力・参照した場合，リダイレクト先のファイルが優先して操作対象になります。

(3)　Exec，NetExecコマンド

Exec，NetExecコマンドでInstall.exe，Setup.exeなどの管理者権限が必要な実行ファイルを呼び出す場合，Exec，NetExecコマンドを実行するスクリプトファイルを標準ユーザで実行すると，次の現象が発生します。

Exec，NetExecコマンドが次のエラーになる。
「0740:要求された操作には管理者特権が必要です。」

権限昇格の［ユーザアカウント制御］ダイアログが表示される。

通常は最初にExec，NetExecコマンドが1.のエラーになり，その後OSのプログラム互換アシスタント機能が動作して2.のダイアログが表示されます。

エラーおよびダイアログの表示を抑止したい場合は，スクリプトファイルを管理者権限で実行しなければなりません。スクリプトファイルを管理者権限で実行する方法については「1.8.7 管理者権限での実行」を参照してください。

権限昇格の［ユーザアカウント制御］ダイアログで［キャンセル］ボタンをクリックした場合，Exec，NetExecコマンドが次のエラーになります。

「1223:この操作はユーザーによって取り消されました。」

(4)　TerminateProcessコマンド

他ユーザで実行中のプロセスは強制終了できません（スクリプトプロセスは強制終了できます）。他ユーザのプロセスを指定してもエラーにならないで正常終了します（存在しないプロセスを指定したときと同じ動作です）。

(5)　GetProcessInfoコマンド

自ユーザで実行中のプロセス情報だけ取得できます。他ユーザで実行中のプロセスIDを指定した場合，アクセス拒否のエラーになります。また，サービス空間で実行中のスクリプトからログオン空間で実行中のプロセスIDを指定した場合もアクセス拒否のエラーになります。

1.8.4　マネージャの設定方法

Windows Vista以降のOSではマネージャの［ツール］－［オプション］メニューで表示されるダイアログの各タブを設定する場合，マネージャを管理者権限で実行しなければなりません。マネージャを管理者権限で実行する方法については「1.8.7 管理者権限での実行」を参照してください。

1.8.5　レジストリの変更方法

Windows Vista以降のOSではHKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script下のレジストリキーの値を設定・変更する場合，レジストリエディタを管理者権限で実行しなければなりません。レジストリエディタを管理者権限で実行するには，管理者グループのユーザでログオンしたあとにレジストリエディタを起動してください。起動後，権限昇格の［ユーザアカウント制御］ダイアログが表示されますので，［続行］ボタンをクリックしてください。

1.8.6　メッセージボックスのレイアウト

Windows Vista以降のOSではMessageBoxコマンドなど，JP1/Scriptで表示するメッセージボックスのボタンは右ぞろえで表示されます。

1.8.7　管理者権限での実行

OSでユーザアカウント制御（UAC）を無効化すれば，ログオンしたユーザの権限で動作させることができますが，OSのセキュリティが低下するので，できる限り下記の操作をしてください。

＜この項の構成＞

(1)　マネージャの起動

(2)　スクリプトファイルの実行

(1)　マネージャの起動

管理者権限で起動したマネージャから実行するスクリプトファイル，エディタなどの各機能は，管理者権限で実行されます。この場合，エディタからのスクリプトファイルのモニタリング実行も，管理者権限で実行されます。

次のどちらかの方法によりマネージャを管理者権限で起動できます。

(a)　［管理者権限として実行］を指定する

操作

マネージャのショートカットを右クリックして表示されるメニューの［管理者権限として実行］を選択する。
権限昇格の［ユーザアカウント制御］ダイアログが表示されます。

［続行］ボタンをクリックする。

管理者グループでないユーザから操作した場合，管理者のパスワードを入力する。

(b)　特権レベル［管理者としてこのプログラムを実行する］を指定する

操作

マネージャのショートカットを右クリックして表示されるメニューの［プロパティ］を選択する。
［プロパティ］ダイアログが表示されます。

［互換性タブ］の特権レベル［管理者としてこのプログラムを実行する］をチェックする。

マネージャを起動する。
権限昇格の［ユーザアカウント制御］ダイアログが表示されます。
管理者グループでないユーザでは，2.の指定は有効にならないで標準ユーザで起動されます。

(2)　スクリプトファイルの実行

次のどちらかの方法によりスクリプトファイルを管理者権限で実行できます。

(a)　特権レベル［管理者としてこのプログラムを実行する］を指定する

操作

JP1/Scriptインストール先フォルダ下のsptxe.exeを右クリックして表示されるメニューの［プロパティ］を選択する。
［プロパティ］ダイアログが表示されます。

［互換性タブ］の特権レベル［管理者としてこのプログラムを実行する］をチェックする。

すべてのスクリプトファイルを実行する。
権限昇格の［ユーザアカウント制御］ダイアログが表示されます。
管理者グループでないユーザでは，2.の指定は有効にならないで標準ユーザで起動されます。

(b)　［管理者権限として実行］を指定する

操作

JP1/Scriptインストール先フォルダ下のsptxe.exeのショートカットをデスクトップなどに作成する。

作成したショートカットを右クリックして表示されるメニューの［プロパティ］を選択する。
［プロパティ］ダイアログが表示されます。

［ショートカット］タブの［リンク先］のsptxe.exeの後ろにスクリプトファイル名を指定する。

ショートカットを右クリックして表示されるメニューの［管理者権限として実行］を選択する。
sptxe.exeが実行され，権限昇格の［ユーザアカウント制御］ダイアログが表示されます。

［続行］ボタンをクリックする。

1.9　排他エラーリトライ機能と試行オープン機能に関して

排他エラーリトライ機能は，ファイルやフォルダにアクセスするコマンドやステートメントの実行で排他エラー※が発生した場合に，ファイルやフォルダへのアクセスをリトライできるようにする機能です。

また，試行オープン機能は，TextOpenコマンドで書き込みを実行したファイルをTextCloseコマンドでクローズする際，ディスクへの書き込みが完了したことを確認するために，TextCloseコマンドの実行直後にファイルを試行オープンする機能です。

Windowsのファイルシステムは，通常，ディスクへの書き込みキャッシュをしているため，デバイスレベルでディスクへの書き込み遅延が発生することがあります。そのため，ディスクへの書き込み遅延が発生している状態で，ファイルやフォルダにアクセスするコマンドやステートメントを実行すると，排他エラーでコマンドやステートメントの実行が失敗することがあります。排他エラーリトライ機能および試行オープン機能を使用すると，このようなディスクへの書き込み遅延によるコマンドやステートメント実行のエラーを回復できます。

注※　次のエラーが出力された場合，排他エラーが発生しています。

0032：プロセスはファイルにアクセスできません。別のプロセスが使用中です。

0005：アクセスは拒否されました。ファイルの属性又はセキュリティを見直してください。

＜この節の構成＞

1.9.1　排他エラーリトライ機能

1.9.2　試行オープン機能

1.9.1　排他エラーリトライ機能

更新された直後のファイルやフォルダにアクセスすると，ディスクへの書き込み遅延の影響によって一時的な排他エラーが発生することがあります。排他エラーリトライ機能を有効にすると，ファイルやフォルダで排他エラーが発生した場合，コマンドによってファイルへのアクセスをリトライするため，スクリプトにリトライ処理を記述する必要がなくなります。

排他エラーリトライ機能は，排他が解除されるか，または排他エラー以外のエラーが発生するまで，設定されたリトライ回数およびリトライ待ち時間に従ってファイルやフォルダへのアクセスをリトライします。排他エラーリトライ機能の動作は，次のとおりです。

リトライ中に排他が解除されて，ファイルやフォルダに正常にアクセスできた場合

リトライを終了して，コマンドやステートメントの実行を続行します。

リトライ中に排他エラー以外のエラーが発生した場合

リトライを終了して，コマンドやステートメントの実行を排他エラー以外のエラーで終了します。

リトライしても排他が解除されなかった場合

コマンドやステートメントの実行を排他エラーで終了します。

特定のコマンドを呼び出した場合だけリトライする場合は，SetRetryModeコマンドを使用してください。SetRetryModeコマンドを使用すると，排他エラーリトライ機能が無効でも，特定のコマンドを呼び出すときだけ排他エラーリトライ機能を有効にできます。また，コマンド単位にリトライ回数およびリトライ待ち時間を設定してリトライすることもできます。排他エラーリトライ機能を利用できるコマンドについては，「1.9.1(2)　排他エラーリトライ機能の対象となるコマンドおよびステートメント」，SetRetryModeコマンドについては，「9.9.2　SetRetryMode （排他エラーリトライ機能を設定する）」を参照してください。

＜この項の構成＞

(1)　リトライ回数およびリトライ待ち時間

(2)　排他エラーリトライ機能の対象となるコマンドおよびステートメント

(1)　リトライ回数およびリトライ待ち時間

リトライ回数およびリトライ待ち時間は，レジストリの値に設定します。

(a)　リトライ回数（単位：回）

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

IOErrorRetryCount

〔値のデータタイプ〕

REG_DWORD

〔値〕

0～100の範囲で設定します。デフォルトは0です。

0を設定した場合は，リトライしません。

値が設定されていない場合や，0～100の範囲外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

(b)　リトライ待ち時間（単位：ミリ秒）

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

IOErrorRetryWaitTime

〔値のデータタイプ〕

REG_DWORD

〔値〕

100～60,000の範囲で設定します。デフォルトは100です。

値が設定されていない場合や，100～100,000の範囲外の値が設定された場合は，デフォルトの100を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

(c)　設定が有効になるタイミングおよび有効となる範囲

レジストリに値を設定したあとに実行するすべてのスクリプトで有効です。レジストリに設定した値は，値を設定したコンピュータでだけ有効です。

(d)　リトライ回数およびリトライ待ち時間の変更

レジストリで設定したリトライ回数およびリトライ待ち時間は，SetRetryModeコマンドで変更できます。変更は，ResetRetryModeコマンドが実行されるまで有効です。

(2)　排他エラーリトライ機能の対象となるコマンドおよびステートメント

排他エラーリトライ機能の対象となるコマンドおよびステートメントの一覧を，次の表に示します。

表1-6　排他エラーリトライ機能の対象となるコマンドおよびステートメント

区分 | 分類 | コマンドまたはステートメント
基本コマンド | 変数操作 | SetGV
GetGV
DeleteGV
ファイル・フォルダ操作 | IniRead
IniWrite
TextFileReplace
TextOpen
MakeDir
DeleteDir
DeleteFile
Rename
TempDir
TempFile
SetFileAttributeまたはSetFileAttr
GetFileAttributeまたはGetFileAttr
SetFileTime
GetFileTime
GetFileSize
GetVersionInfoまたはGetVerInfo
SplitFile
CatFiles
SetStandardFileまたはSetStdFile
SetPath
Copy
メッセージ出力 | Message
メニュー呼び出し | Menu
チェック処理 | IsEmptyDir
IsExistDir
IsExistFile
IsWriteableDir
IsFileAttributeまたはIsFileAttr
IsNew
外部プログラム呼び出し | Exec
NetExec
CallSpt
自動起動処理 | EntryStartUp
CancelStartUp
特殊コマンド | レジストリ操作 | RegRead
RegWrite
RegDelete
RegDeleteKey
画像・表示処理 | BitmapShow
ショートカット操作 | MakeGroup
DeleteGroup
DeleteShortcut
プロセス監視 | GetProcessCount
TerminateProcess
ステートメント | For...End For

1.9.2　試行オープン機能

試行オープン機能を有効にすると，ファイルのディスクへの書き込みが完了したことを確認するため，TextCloseコマンドの実行直後に，設定された試行回数および試行間隔に従って，クローズしたファイルを試行オープンします。ただし，次の場合は試行オープンしません。

TextCloseコマンドのModeパラメタにReadOnlyを指定してオープンしたファイルをTextCloseコマンドでクローズした場合

ファイルのクローズが失敗してTextOpenコマンドがエラー終了した場合

試行オープン中に排他エラーが発生した場合は，排他が解除されるか，または排他エラー以外のエラーが発生するまで試行オープンをリトライします。

試行オープン機能の動作は次のとおりです。

試行オープン中に排他が解除された場合

試行オープンを終了してTextCloseコマンドは正常終了します。

試行オープン中に排他エラー以外のエラーが発生した場合

試行オープンを終了してTextCloseコマンドは正常終了します。

試行オープンしても排他が解除されなかった場合

TextCloseコマンドは正常終了します。

特定のTextCloseコマンドを実行した直後だけ試行オープンをしたい場合は，「9.9.4　SetTrialOpenMode （試行オープン機能を設定する）」を参照して，SetTrialOpenModeコマンドを使用してください。SetTrialOpenModeコマンドを使用すると，試行オープン機能が無効でも，特定のTextCloseコマンドを実行した直後だけ試行オープン機能を有効にできます。また，TextCloseコマンドの実行直後単位に，試行オープンの試行回数および試行間隔を設定することもできます。

＜この項の構成＞

(1)　試行回数および試行間隔

(1)　試行回数および試行間隔

試行回数および試行間隔は，レジストリの値に設定します。

(a)　試行回数（単位：回）

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

TrialOpenRetryCount

〔値のデータタイプ〕

REG_DWORD

〔値〕

0～100の範囲で設定します。デフォルトは0です。

0を設定した場合は，試行オープンしません。

値が設定されていない場合，および0～100の範囲外の値が設定された場合はデフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

(b)　試行間隔（単位：ミリ秒）

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

TrialOpenRetryWaitTime

〔値のデータタイプ〕

REG_DWORD

〔値〕

100～60,000の範囲で設定します。デフォルトは100です。

値が設定されていない場合，および100～100,000の範囲外の値が設定された場合は，デフォルトの100を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

(c)　設定が有効となるタイミングおよび有効となる範囲

レジストリに値を設定したあと実行するすべてのスクリプトで有効です。

レジストリに設定した値は，値を設定したコンピュータでだけ有効です。

(d)　試行回数および試行間隔の変更

レジストリで設定した試行回数および試行間隔は，SetTrialOpenModeコマンドで変更できます。変更は，ResetTrialOpenModeコマンドが実行されるまで有効です。

2.　JP1/Scriptを利用するための準備

この章では，JP1/Scriptのインストール方法，アンインストール方法，他のコンピュータとの通信時のアカウント，各種システム環境での環境設定方法などについて説明します。

＜この章の構成＞

2.1　JP1/Scriptのインストール／アンインストール

2.2　他のコンピュータとの通信時のアカウント

2.3　クラスタシステム環境での環境設定

2.4　ターミナルサービス環境での環境設定

2.5　ホスト名，またはIPアドレスの変更手順

2.6　稼働監視プログラムでのJP1/Scriptの監視

2.7　JP1/Scriptの起動と終了

2.8　システムの日時変更手順

2.9　NetExecコマンドによるリモート実行を許可するユーザの設定

2.1　JP1/Scriptのインストール／アンインストール

ここでは，JP1/Scriptのインストールの方法，JP1/Scriptサービスの登録，およびJP1/Scriptのアンインストールの方法について説明します。

＜この節の構成＞

2.1.1　プログラムのインストール先のフォルダ

2.1.2　JP1/Scriptのインストール

2.1.3　JP1/Scriptサービスの登録

2.1.4　JP1/Scriptのアンインストール

2.1.5　JP1/Scriptの再インストール

2.1.6　JP1/Scriptのアップグレードインストール

2.1.7　ダウングレード

2.1.1　プログラムのインストール先のフォルダ

JP1/Scriptプログラムのインストール先のフォルダを次に示します。

＜この項の構成＞

(1)　Windows Server 2003またはWindows XPの場合

(2)　Windows Vista以降の場合

(1)　Windows Server 2003またはWindows XPの場合

(2)　Windows Vista以降の場合

スクリプトの実行環境フォルダ（¥DATA）およびログフォルダ（¥LOG）は，無条件に上記フォルダとなります（インストール時に変更できません）。システムドライブの容量不足などで格納先を変更したい場合は，マネージャの［ツール］－［オプション］メニューで表示される［オプション］ダイアログの［クラスタの環境設定］で変更できます。ただし，システムドライブの¥Program Filesフォルダ下に変更してはいけません。¥Program Filesフォルダ下はOSによってリダイレクトされるため，プログラムが正常に動作しなくなります。

2.1.2　JP1/Scriptのインストール

JP1/Scriptのインストールの手順を次に示します。

操作

インストールの前に管理者権限でログオンする。

インストールに使用するCD-ROMをCD-ROMドライブにセットする。
JP1/Scriptインストールダイアログが表示されます。

インストールするプログラムを確認して［次へ］ボタンをクリックする。

ユーザ情報（ユーザ名と会社名）を入力して［次へ］ボタンをクリックする。
指定したユーザ名と会社名がユーザ情報として，レジストリファイルに登録されます。

JP1/Scriptのインストール先フォルダを指定して［次へ］ボタンをクリックする。
JP1/Scriptのインストール先フォルダを変更する場合は，［変更］ボタンをクリックして，インストール先を指定します。存在しないフォルダを指定した場合は，インストーラが自動的にフォルダを作成します。

［インストール］ボタンをクリックする。
インストールが開始され，インストールの進行状態を示すダイアログが表示されます。

インストールの完了ダイアログに対して，［完了］ボタンをクリックする。
［Readmeファイルを表示する］をチェックして［完了］ボタンをクリックすると，Readmeファイルを表示します。

コンピュータを再起動する。

JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）について

JP1/Scriptは，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/NETM/DMを使ったリモートインストールの詳細は，マニュアル「JP1/NETM/DM 運用ガイド1(Windows(R)用)」を参照してください。

2.1.3　JP1/Scriptサービスの登録

JP1/Scriptサービスに登録するアカウントには，サービスとしてログオンする権限が必要です。なお，インストール時にはシステムアカウントが設定されます。

アカウント名を変更する場合は，Windowsの［コントロールパネル］－［管理ツール］－［サービス］を選択し，JP1/Scriptサービスのプロパティを表示して変更してください。また，JP1/ScriptサービスからSetGV，GetGV，DeleteGV，NetExecコマンドで他のコンピュータを呼び出す場合，JP1/Scriptサービスに適切なアカウント（呼び出すコンピュータにログオンできるアカウント）を設定してください。適切なアカウントを設定しないと上記コマンドは正常に機能しません。

また，ログオンアカウントについては，「2.2　他のコンピュータとの通信時のアカウント」を参照してください。

注意

システムアカウントで実行すると，他のシステムアカウントで実行されているサービスプログラムとシステムリソースが共有され影響を受ける場合があります。システムアカウントで動作している他のサービスプログラムがある場合は，アカウントを指定してください。

再インストールおよびアップグレードインストール時には，すでに設定されているアカウント名が引き継がれます。

2.1.4　JP1/Scriptのアンインストール

JP1/Scriptのアンインストールの手順を次に示します。

操作

管理者権限でログオンする。
管理者権限でログオンしていない場合は，正常にアンインストールされません。

実行中のJP1/Scriptのプログラムをすべて終了する。
すべて終了していない場合は，正常にアンインストールされません。

Windowsの［コントロールパネル］で［プログラム］－［プログラムと機能］を選択する。
プログラムの一覧が表示されます。

プログラムの一覧からJP1/Scriptを選択し，［アンインストール］をクリックする。または，JP1/Scriptを右クリックして表示されるメニューから［アンインストール］を選択する。
JP1/Scriptがアンインストールされます。

コンピュータを再起動する。

注意

JP1/Scriptのインストーラーが作成したファイルおよびフォルダはすべて削除されます。

JP1/Scriptのインストール先フォルダ内のファイルを，ほかのアプリケーションなどでアクセス中の場合，インストール先フォルダは，アンインストールしても削除されないことがあります。

次のファイルおよびフォルダは，アンインストールの際に削除されません。不要な場合はアンインストール後に削除してください。
・システムドライブ¥ProgramData¥Hitachi¥Script下に，インストール後に作成されたファイルおよびフォルダ
・レジストリ HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script（64ビットOSの場合，HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥HITACHI¥JP1/Script）下に，インストール後に作成されたキーおよびエントリ
・レジストリ HKEY_CURRENT_USER¥Software¥JP1/Script下に作成されたキーおよびエントリ

2.1.5　JP1/Scriptの再インストール

再インストールでは，すでにインストールされているJP1/Scriptと同じバージョンのJP1/Scriptをインストールします。すでにインストールされているJP1/Scriptのインストール先のフォルダおよび設定情報は，再インストール後も引き継がれます。

JP1/Scriptの再インストールの手順を次に示します。

操作

JP1/Scriptの管理ファイルの出力先を共有ディスク上のフォルダに変更している場合，共有ディスクをオンラインにする。
共有ディスクがオフラインの状態でインストールすると，自動機能の設定が無効になるおそれがあります。

管理者権限でログオンする。
管理者権限でログオンしていない場合は，正常にインストールできません。

実行中のJP1/Scriptのプログラムをすべて終了する。
すべて終了していない場合は，正常にインストールできません。

インストールに使用するCD-ROMをCD-ROMドライブにセットする。
JP1/Scriptインストールダイアログが表示されます。

インストールするプログラムを確認して［次へ］ボタンをクリックする。

［インストール］ボタンをクリックする。
インストールが開始され，インストールの進行状態を示すダイアログが表示されます。

インストールの完了ダイアログに対して，［完了］ボタンをクリックする。

コンピュータを再起動する。

注意

再インストールをすると，適用した修正パッチが削除されます。再インストール後，修正パッチを適用し直してください。

JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）について

JP1/Scriptは，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/NETM/DMを使ったリモートインストールの詳細は，マニュアル「JP1/NETM/DM 運用ガイド1(Windows(R)用)」を参照してください。

2.1.6　JP1/Scriptのアップグレードインストール

アップグレードインストールでは，すでにインストールされているJP1/Scriptより上位のバージョンのJP1/Scriptをインストールします。すでにインストールされているJP1/Scriptのインストール先のフォルダおよび設定情報は，アップグレードインストール後も引き継がれます。

注意

10-00より前のバージョンからアップグレードインストールする場合，動作環境情報や管理ファイルをバックアップしてください。アップグレードインストールでは，すでにインストールされているJP1/Scriptをアンインストールします。アンインストール中にエラーが発生すると，JP1/Scriptの動作環境情報や管理ファイルが削除されたままの状態になるおそれがあります。アンインストール中にエラーが発生した場合は，アップグレード前のバージョンのJP1/Scriptを再インストールしたあと，再度アップグレードインストールをしてください。

07-00より前のバージョンからのアップグレードインストールはできません。古いバージョンのJP1/Scriptをいったんアンインストールしてから，新しいバージョンのJP1/Scriptを新規インストールしてください。

JP1/Scriptのアップグレードインストールの手順を次に示します。

操作

JP1/Scriptの管理ファイルの出力先を共有ディスク上のフォルダに変更している場合は，共有ディスクをオンラインにする。
共有ディスクがオフラインの状態でインストールすると，自動機能の設定が無効になるおそれがあります。

管理者権限でログオンする。
管理者権限でログオンしていない場合は，正常にインストールできません。

実行中のJP1/Scriptのプログラムをすべて終了する。
すべて終了していない場合は，正常にインストールできません。

インストールに使用するCD-ROMをCD-ROMドライブにセットする。
JP1/Scriptインストールダイアログが表示されます。

アップグレードするプログラムを確認して［次へ］ボタンをクリックする。

［インストール］ボタンをクリックする。
インストールが開始され，インストールの進行状態を示すダイアログが表示されます。

インストールの完了ダイアログに対して，［完了］ボタンをクリックする。

コンピュータを再起動する。

JP1/NETM/DMを使ったリモートインストール（ソフトウェアの配布）について

JP1/Scriptは，JP1/NETM/DMを使ったリモートインストールに対応しています。

JP1/NETM/DMを使ったリモートインストールの詳細は，マニュアル「JP1/NETM/DM 運用ガイド1(Windows(R)用)」を参照してください。

2.1.7　ダウングレード

すでにインストールされているJP1/Scriptよりも前のバージョンのJP1/Scriptをダウングレードインストールすることはできません。ダウングレードする場合は，インストールされているJP1/Scriptをいったんアンインストールしてから，古いバージョンのJP1/Scriptを新規インストールしてください。

2.2　他のコンピュータとの通信時のアカウント

ここでは，他のコンピュータとの通信時のアカウントについて説明します。

SetGV，GetGV，DeletGV，NetExecコマンドで他のコンピュータを呼び出す場合，呼び出し元のスクリプトを実行するアカウントとパスワードは適切なアカウント（呼び出し先コンピュータにログオンできるアカウントとパスワード）でなければ正常に機能を果たしません。

呼び出し元のスクリプトを実行するアカウントとパスワードはスクリプトの実行方法によって表2-1のようになります。

表2-1　コマンド呼び出し元のスクリプト実行アカウントとパスワード

No. | スクリプトの実行方法 | 呼び出し元のスクリプト実行アカウントとパスワード
1 | 自動起動によりJP1/Scriptサービスから実行する。 | JP1/Scriptサービスに設定されたログオンアカウントとパスワード※
2 | JP1/AJSのサービスプログラムから実行する。 | スクリプトを実行するJP1ユーザにマッピングされたOSユーザのアカウントとパスワード
3 | JP1/AJS以外のサービスプログラムから実行する。 | 各サービスに設定されたログオンアカウントとパスワード※
4 | 自動起動によりScriptランチャから実行する。 | コンピュータにログオンしているアカウントとパスワード
5 | マネージャやエディタから実行する。
6 | エクスプローラなどから直接実行する。

注※

SetGV，GetGV，DeletGV，NetExecコマンドで他のコンピュータを呼び出す場合，サービスのアカウントにシステムアカウントを使用できません。呼び出し先に存在するユーザアカウントをサービスのアカウントに設定してください。

また，NetExecコマンドの場合，接続が成功して呼び出したコンピュータ上で実行ファイルが実行される際の実行アカウントとパスワードは表2-2のようになります。

例えば，NetExecコマンドを使用して，ドメイン上のファイルサーバへコピーする処理（Copyコマンドを含む）を呼び出す場合の実行アカウントとパスワードも，表2-2のようになります。

表2-2　NetExecコマンドから呼び出す実行ファイルの実行アカウントとパスワード

No. | NetExecコマンドの第5引数の値 | 呼び出す実行ファイルの実行アカウントとパスワード
1 | True（サービス空間で実行） | 呼び出し先コンピュータのJP1/Scriptサービスのログオンアカウントとパスワード
2 | False（ログオン空間で実行） | 呼び出し先コンピュータにログオンしているアカウントとパスワード

SetGV，GetGV，およびDeleteGVコマンドについては「8.2.5　SetGV（グローバル変数を設定する）」，「8.2.6　GetGV（グローバル変数を取得する）」，および「8.2.7　DeleteGV （グローバル変数を削除する）」を参照してください。

NetExecコマンドについては「8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）」を参照してください。

2.3　クラスタシステム環境での環境設定

クラスタシステム環境のうち，片方を業務が実行できアクティブ状態になっている実行システム，もう片方をフェールオーバー時に実行システムに切り替わるまでスタンバイ状態になっている待機システムとします。このアクティブ・スタンバイ構成の場合，この環境下でJP1/Scriptを使用することはできますが，フェールオーバー時に実行中のスクリプトを継続して実行することはできません。しかし，フェールオーバー時に実行環境を引き継ぐことができます。

ここでは，フェールオーバー時に実行環境を引き継ぐための環境設定について説明します。

＜この節の構成＞

2.3.1　Scriptランチャ動作環境の環境設定

2.3.2　Scriptランチャサービス動作環境の環境設定

2.3.1　Scriptランチャ動作環境の環境設定

Scriptランチャ動作環境の環境設定について説明します。

操作4.から操作6.はクラスタシステム環境の実行システム，または待機システムのどちらかで設定します。それ以外の操作は二つのシステムでそれぞれ設定します。

Windows Server 2008のクラスタシステムを使用している場合，Scriptランチャをクラスタリソースに設定できません。そのため，操作3.，および操作6.の（3）の実施は不要です。この場合，NetExecコマンドで実行ファイルをログオン空間で実行するためには，実行システム，待機システム共にWindowsにログオンした状態とし，Scriptランチャを稼働させておいてください。また，操作6.の（4）について，リソースの依存関係は（1），（2）となります。

操作

JP1/Scriptをインストールする。
JP1/Scriptをインストールします。インストール先のフォルダはローカルドライブ上のフォルダにしてください。

JP1/Scriptサービスのスタートアップの種類を「手動」に変更する。
Windowsの［コントロールパネル］－［管理ツール］－［サービス］を選択し，JP1/Scriptサービスのプロパティを表示してスタートアップの種類を「自動」から「手動」に変更します。

Scriptランチャを終了し，スタートアップから削除する。
Scriptランチャが起動している場合は終了させてください。Scriptランチャを終了させる方法は，JP1/Scriptのインストール先フォルダ¥Binフォルダにある"Spthstp.exe"にコマンドライン"/INST"を付けて実行してください。終了後，スタートアップに登録されているScriptランチャを削除します。

使用する共有ディスクを決定する。
操作7.でJP1/Scriptの管理ファイルの出力先に指定する共有ディスクを決めます。

クラスタアドミニストレータを起動する。
［スタート］－［プログラム］－［管理ツール］－［クラスタアドミニストレータ］ウィンドウを起動します。

リソースを作成する。
［クラスタアドミニストレータ］ウィンドウで次に示す四つのリソースを作成します。

（1）操作4.で決定した共有ディスク　リソース

・リソースの種類：物理ディスク

・リソース名：任意

（2）論理IPアドレス　リソース

・リソースの種類：IPアドレス

・リソース名：任意

・リソースの依存関係：（1）のリソース

（3）Scriptランチャ　リソース

・リソースの種類：汎用アプリケーション

・リソース名：任意

・コマンドライン：JP1/Scriptのインストール先フォルダ¥Binフォルダの"Spthlnch.exe"

・「デスクトップとの対話をアプリケーションに許可する」をチェック

（4）JP1/Scriptサービス　リソース

・リソースの種類：汎用サービス

・リソース名：任意

・リソースの依存関係：（1），（2），（3）のリソース

・サービス名：JP1_Script

JP1/Scriptの管理ファイルの出力先を共有ディスク上のフォルダに変更する。
マネージャウィンドウの［ツール］－［オプション（クラスタ環境）］ダイアログで管理ファイルの出力先を操作4.で決定した共有ディスク上のフォルダに変更します。

システムを再起動する。
操作7.で設定した内容を有効にするため，システムを再起動します。

補足

クラスタシステム環境の二つのシステムがどちらもアクティブ状態の実行システムになっているアクティブ・アクティブ構成の場合は，JP1/Scriptを使用することはできますが，フェールオーバー時に実行中のスクリプトを継続して実行することはできません。また，フェールオーバー時に実行環境を引き継ぐこともできませんので，上記の環境設定は行わないでください。

2.3.2　Scriptランチャサービス動作環境の環境設定

Scriptランチャサービス動作環境の環境設定について説明します。

操作4.から操作6.はクラスタシステム環境の実行システム，または待機システムのどちらかで設定します。それ以外の操作は二つのシステムでそれぞれ設定します。また，クラスタシステム環境下でScriptランチャサービスを使用する場合は，実行システム，待機システムともに実ホスト名でログオンしておく必要があります。

操作

JP1/Scriptをインストールする。
JP1/Scriptをインストールします。インストール先のフォルダはローカルドライブ上のフォルダにしてください。

JP1/Scriptサービスのスタートアップの種類を「手動」に変更する。
Windowsの［コントロールパネル］－［管理ツール］－［サービス］を選択し，JP1/Scriptサービスのプロパティを表示してスタートアップの種類を「自動」から「手動」に変更します。

Scriptランチャサービスのスタートアップの種類を「手動」に変更する。
Windowsの［コントロールパネル］－［管理ツール］－［サービス］を選択し，Scriptランチャサービスのプロパティを表示してスタートアップの種類を「自動」から「手動」に変更します。

使用する共有ディスクを決定する。
操作7.でJP1/Scriptの管理ファイルの出力先に指定する共有ディスクを決めます。

クラスタアドミニストレータを起動する。
［スタート］－［プログラム］－［管理ツール］－［クラスタアドミニストレータ］ウィンドウを起動します。

リソースを作成する。
［クラスタアドミニストレータ］ウィンドウで次に示す四つのリソースを作成します。

（1）操作4で決定した共有ディスク リソース

・リソースの種類：物理ディスク

・リソース名：任意

（2）論理IPアドレス リソース

・リソースの種類：IP アドレス

・リソース名：任意

・リソースの依存関係：（1）のリソース

（3）Scriptランチャサービス リソース

・リソースの種類：汎用アプリケーション

・リソース名：任意

・コマンドライン：JP1/Scriptのインストール先フォルダ¥Binフォルダの"SPTHLHSV.EXE"

・「デスクトップとの対話をアプリケーションに許可する」をチェック

（4）JP1/Scriptサービス リソース

・リソースの種類：汎用サービス

・リソース名：任意

・リソースの依存関係：（1），（2），（3）のリソース

・サービス名：JP1_SCRIPT_LAUNCHER

JP1/Scriptの管理ファイルの出力先を共有ディスク上のフォルダに変更する。
マネージャウィンドウの［ツール］－［オプション（クラスタ環境）］ダイアログで管理ファイルの出力先を操作4.で決定した共有ディスク上のフォルダに変更します。

システムを再起動する。
操作7.で設定した内容を有効にするため，システムを再起動します。

補足

クラスタシステム環境の二つのシステムがどちらもアクティブ状態の実行システムになっているアクティブ・アクティブ構成の場合は，JP1/Scriptを使用することはできますが，フェールオーバー時に実行中のスクリプトを継続して実行することはできません。また，フェールオーバー時に実行環境を引き継ぐこともできませんので，上記の環境設定は行わないでください。

2.4　ターミナルサービス環境での環境設定

JP1/Scriptでは，Windows Server 2003ターミナルサービス，またはWindows Server 2008ターミナルサービス上でJP1/Scriptを使用できます。管理者以外のユーザでリモートセッションからログインしてJP1/Scriptを操作する場合，ログインするユーザに「グローバルオブジェクトの作成」の権利をOSのセキュリティの設定で割り当ててください。また，ターミナルサービス環境でJP1/Scriptを使用する場合は，次の点に注意してご使用ください。

Scriptランチャはターミナルサーバ側のプライマリセッションでだけ起動でき，ターミナルクライアント側のリモートセッションでは起動できません。なお，JP1/Scriptサービスは両セッションでサービスの開始／停止ができます。

自動起動に登録されたスクリプトファイルは起動のタイプにかかわらず，ターミナルサーバ側のプライマリセッションで起動されます。

NetExecコマンドから呼び出す実行ファイルをターミナルクライアント側のリモートセッションで起動する場合は，Scriptランチャサービスを使用してください。Scriptランチャサービスについては，「1.7（6）　Scriptランチャサービスについて」を参照してください。

注意

ターミナルクライアント側のリモートセッションからはBeepコマンドを使用しないでください。「0005：アクセスは拒否されました。ファイルの属性又はセキュリティを見直してください」などのエラーになります。

補足

RemoteAppを利用すると，ターミナル・サーバ上にインストールされているJP1/Scriptのプログラムのうち，特定のプログラムだけを利用者に公開できます。

RemoteApp経由で起動したプログラムは，リモートのサーバ上で動作しているため，予約変数などはリモートのサーバ上の内容です。また，各操作コマンドもリモートのサーバ上で動作します。クライアント上で起動したプログラムと同じようにデスクトップに表示されるため，混同しないように注意してください。

2.5　ホスト名，またはIPアドレスの変更手順

ホスト名，またはIPアドレスを変更する場合は，次に示す手順で作業を行ってください。

操作

他PCから変更するPCに対して実行しているスクリプトがないことを確認する。

JP1/Scriptサービス，およびScriptランチャまたはScriptランチャサービスを停止する。
Scriptランチャを終了させる方法は，JP1/Scriptのインストール先フォルダ¥Binフォルダにある"Spthstp.exe"にコマンドライン"/INST"を付加して実行してください。

変更後，JP1/Scriptサービス，およびScriptランチャまたはScriptランチャサービスを開始する。
Scriptランチャは，Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［Scriptランチャ］を選択して，開始してください。

注意

NetExec，GetGV，SetGV，DeleteGVコマンドのコンピュータ名をFQDN（完全修飾ドメイン名）形式で指定していてドメイン名を変更する場合，指定しているコンピュータ名を変更してください。

JP1/Scriptサービスのアカウントにユーザアカウントを設定していてドメイン名を変更した場合，アカウントを見直してください。

2.6　稼働監視プログラムでのJP1/Scriptの監視

プロセス監視機能を使用してJP1/Scriptのプロセスを監視する場合は，下記の監視プロセス情報に従ってJP1/Cm2/SSOのプロセス監視条件を設定してください。

監視AP名：JP1/Script V10.0(Windows)

付加情報：JP1/Script(Windows)

監視プロセス数：2

親プロセス | 子プロセス
プロセス数 | 種別※1 | プロセス名 | しきい値 | プロセス数 | 種別※1 | プロセス名 | しきい値
下限 | 上限 | 下限 | 上限
3 | 2 | SPTHSV | 1 | 1 | 1 | 2 | SPTTMS | 1 | 1
2 | Spthlnch | 1※2 | 1※3 | 0 | － | － | － | －
2 | SPTHLHSV | 1 | 1 | 0 | － | － | － | －

（凡例）

－：該当なし

注※1　プロセス名の種別（1：コマンドライン名，2：実行ファイル名）を示します。

注※2　Spthlnchプロセスは，ログオン時にスタートアップから自動的に起動されて，ログオフ時には自動的に終了するプロセスです。そのため，ログオフ時の下限は0になります。

注※3　ターミナルサービスを利用してログオンする場合「1＋ターミナルサービスを利用して同時にログオンするユーザ数」を，OSのユーザの簡易切り替え機能を使用している場合「同時にログオンする最大ユーザ数」を，ターミナルサービスとOSのユーザの簡易切り替え機能を同時に使用する場合「1＋ターミナルサービスを利用して同時にログオンするユーザ数＋同時にログオンする最大ユーザ数」を指定してください。

設定方法については，JP1/Cm2/SSOのマニュアル「JP1/Cm2/SNMP System Observer」を参照してください。

なお，JP1/Cm2/SNMP System ObserverはJP1/Performance Management/SNMP System Observer ，またはJP1/Server System Observerの後継製品です。JP1/Performance Management/SNMP System Observer をご使用の場合は，マニュアル「JP1 Version 7i JP1/Performance Management/SNMP System Observer」をまたJP1/Server System Observerをご使用の場合は，マニュアル「JP1 Version 6 統合ネットワーク管理システム サーバシステム管理」を参照してください。

SPTHSVプロセスを監視する条件は，次のどれかです。

起動のタイプがサービスでスクリプトの自動起動を行っている。

他のコンピュータからグローバル変数操作コマンド（SetGV／GetGV／DeleteGV）を実行する。

他コンピュータからプロセスビューア／トレースビューアで参照する。

第1引数にプロセスを監視するコンピュータ名を指定し，かつ第5引数にTrueを指定したNetExecコマンドを自コンピュータ，または他コンピュータで実行している。

Windows Vista以降のOSでTarget_File，Target_SPAFileまたはTarget_SPXFile指定のMessage コマンドを実行する。

Windows Vista以降のOSでEntryStartUpコマンド，CancelStartUpコマンドを実行する。

Windows Vista以降のOSでグローバル変数操作コマンドを実行する。

条件に一致しない場合，監視の必要はありません。

Spthlnchプロセスを監視する条件は，次のどちらかです。

起動のタイプがログオンでスクリプトの自動起動を行っている。

第1引数にプロセスを監視するコンピュータ名を指定し，かつ第5引数にFalseを指定したNetExecコマンドを自コンピュータ，または他コンピュータで実行している。

条件に一致しない場合，監視の必要はありません。

SPTHLHSVプロセスを監視する条件は，次のとおりです。

第1引数にプロセスを監視するコンピュータ名を指定し，かつ第5引数にFalseを指定したNetExecコマンドを自コンピュータ，または他コンピュータで実行している。

条件に一致しない場合，監視の必要はありません。

2.7　JP1/Scriptの起動と終了

ここでは，JP1/Scriptの起動と終了方法について説明します。

＜この節の構成＞

2.7.1　JP1/Scriptを起動する

2.7.2　JP1/Scriptを終了する

2.7.1　JP1/Scriptを起動する

JP1/Scriptの起動方法を説明します。

＜この項の構成＞

(1)　マネージャの起動方法

(2)　エディタの起動方法

(3)　トレースビューアの起動方法

(4)　メニューエディタの起動方法

(5)　自動起動の方法

(1)　マネージャの起動方法

JP1/Scriptを使用してスクリプトファイルを作成したり，作成したスクリプトファイルの編集をしたりする場合は，最初にJP1/Scriptのマネージャを起動します。

操作

Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［マネージャ］を選択して，JP1/Scriptのマネージャを起動する。
マネージャには，スクリプトファイルの管理や実行環境の設定，スクリプトの文法チェックなどの機能もあります。

なお，マネージャについては，「3.1.1　Scriptマネージャウィンドウとメニュー」を参照してください。

(2)　エディタの起動方法

実際にスクリプトファイルの作成や編集をする場合は，エディタを起動します。

エディタには，三つの起動方法があります。

(a)　スタートメニューからの起動方法

操作

Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［エディタ］を選択して，JP1/Scriptのエディタを起動する。

(b)　マネージャからの起動方法

操作

マネージャウィンドウでスクリプトファイルを選択する。

マネージャウィンドウの［ファイル］－［編集］を選択する。
ただし，ほかのエディタが関連付けられている場合はそのエディタが起動されます。

(c)　ドラッグアンドドロップでの起動方法

操作

エクスプローラからスクリプトファイルをドラッグして，「エディタ」アイコン，またはすでに起動しているエディタウィンドウにドロップする。
なお，エディタについては，「3.2.1　Scriptエディタウィンドウとメニュー」を参照してください。

(3)　トレースビューアの起動方法

スクリプトファイルの実行時に出力されるトレースは，トレースファイルに出力されます。トレースの状態を知りたいときは，トレースビューアを起動します。トレースビューアには二つの起動方法があります。

(a)　スタートメニューからの起動方法

操作

Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［トレースビューア］を選択して，JP1/Scriptのトレースビューアを起動する。

(b)　マネージャからの起動方法

操作

マネージャウィンドウの［ツール］－［トレースビューアの起動］を選択する。
トレースビューアを起動すると，トレースビューアウィンドウが表示されます。ウィンドウにはトレースファイルが一覧表示されています。

なお，トレースビューアについては，「3.4.1　Scriptトレースビューアウィンドウとメニュー」を参照してください。

(4)　メニューエディタの起動方法

メニューエディタには，次の五つの起動方法があります。

(a)　スタートメニューからの起動方法

操作

Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［メニューエディタ］を選択して，JP1/Scriptのメニューエディタを起動する。

(b)　マネージャからの起動方法

操作

マネージャウィンドウでスクリプトファイルを選択する。

［ツール］－［メニューエディタの起動］を選択する，または右クリックで表示されるポップアップメニューから［メニューエディタの起動］を選択する。

(c)　エディタからの起動方法

操作

［編集］－［メニューエディタ］を選択する，または右クリックで表示されるポップアップメニューから［メニューエディタ］を選択する。

(d)　ドラッグアンドドロップでの起動方法

操作

エクスプローラからメニュー情報ファイルをドラッグして，「メニューエディタ」アイコン，またはすでに起動しているメニューエディタウィンドウにドロップする。
ドロップした後，メニュー情報ファイルを更新中の場合は，更新中のメニュー情報ファイルを保存するかどうかメッセージが表示されます。

(e)　エクスプローラからの起動方法

操作

エクスプローラからメニュー情報ファイルを選択する。

［ファイル］－［開く］を選択する，またはダブルクリックする。

なお，メニューエディタについては，「3.6.1　Scriptメニューエディタウィンドウとメニュー」を参照してください。

(5)　自動起動の方法

JP1/Scriptは，JP1/ScriptサービスまたはScriptランチャを使用して，スクリプトを自動的に起動して実行できます。Scriptランチャサービスでは自動起動は使用できません。

自動起動には，次の二つの方法があります。

サービス空間で起動する方法

ログオン空間で起動する方法

自動起動する場合は，マネージャで実行環境（起動情報）を設定する必要があります。設定方法の詳細は，「3.1.14　スクリプトの自動起動を設定する」を参照してください。

2.7.2　JP1/Scriptを終了する

JP1/Scriptの終了方法を説明します。

＜この項の構成＞

(1)　マネージャの終了方法

(2)　エディタの終了方法

(3)　トレースビューアの終了方法

(4)　メニューエディタの終了方法

(5)　実行しているスクリプトファイルの強制終了方法

(6)　 JP1/AJSからのJP1/Scriptの強制終了方法

(1)　マネージャの終了方法

操作

Scriptマネージャウィンドウで，［ファイル］－［マネージャの終了］を選択する。
マネージャ機能が終了します。

(2)　エディタの終了方法

操作

Scriptエディタウィンドウで，［ファイル］－［終了］を選択する。
エディタ機能が終了します。

(3)　トレースビューアの終了方法

操作

Scriptトレースビューアウィンドウで，［ファイル］－［トレースビューアの終了］を選択する。
トレースビューア機能が終了します。

(4)　メニューエディタの終了方法

操作

Scriptメニューエディタウィンドウで，［ファイル］－［終了］を選択する。
メニューエディタ機能が終了します。

(5)　実行しているスクリプトファイルの強制終了方法

プロセスビューア，TerminateProcessコマンド，WaitForExecコマンド（Abort指定）およびExitコマンド（Abort指定）で強制終了できます。強制終了するスクリプトファイルがほかのスクリプトファイルを呼び出している場合，呼び出しているスクリプトファイルも連続して強制終了されます。スクリプトファイル以外の実行ファイルを呼び出している場合，その実行ファイルだけが強制終了されます。

(6)　 JP1/AJSからのJP1/Scriptの強制終了方法

JP1/AJSのジョブネットやジョブに登録したJP1/Scriptのスクリプトファイルは，JP1/AJSから強制終了できます。このとき，JP1/Scriptのスクリプトファイルから呼び出した実行ファイルも終了します。

また，JP1/Scriptのスクリプトファイルから呼び出した実行ファイルがJP1/ScriptのスクリプトファイルかJP1/Scriptのスクリプトファイル以外かで終了される範囲が変わってきます。具体的には次の3パターンのようになります。

パターン
呼び出し順序
JP1/AJSからJP1/Scriptのスクリプトファイルを強制終了した場合に終了される実行ファイルの範囲

パターン1
1.JP1/AJS→2.JP1/Scriptのスクリプトファイル→3.JP1/Scriptスクリプトファイル以外
3.の実行ファイルまで

パターン2
1.JP1/AJS→2.JP1/Scriptのスクリプトファイル→3.JP/Scriptのスクリプトファイル→4.JP1/Scriptのスクリプトファイル以外
4.の実行ファイルまで

パターン3
1.JP1/AJS→2.JP1/Scriptのスクリプトファイル→3.JP/Scriptのスクリプトファイル以外→4.JP1/Scriptのスクリプトファイル以外
3.の実行ファイルまで
（4.の実行ファイルは終了されない）

ただし，JP1/AJSからの強制終了要求から30秒経過してもJP1/Scriptのスクリプトファイルが終了しない場合は，Win32 APIのTerminateProcess関数を使用してJP1/Scriptのスクリプトファイルを強制終了します。TerminateProcess関数を使用した場合，JP1/Script のスクリプトファイルから呼び出した実行ファイルは終了されませんので，各パターンの「2.JP1/Scriptのスクリプトファイル」だけが終了されることになります。

注意

強制終了は，スクリプトの開発時に使用することを目的としているため，実際の業務での使用はお勧めできません。

2.8　システムの日時変更手順

システムの日時を変更する場合は，次に示す手順で作業を行ってください。

操作

JP1/Scriptサービス，およびScriptランチャを停止する。
Scriptランチャを終了させる方法は，JP1/Scriptのインストール先フォルダにある"Spthstp.exe"にコマンドライン"/INST"を付加して実行してください。

動作中のスクリプトファイルを停止する。
JP1/Scriptのプロセスビューアで動作中のスクリプトがないか確認し，必要に応じてJP1/Scriptのプロセスビューアから強制終了してください。

変更後，JP1/Scriptサービス，およびScriptランチャを開始する。
Scriptランチャは，Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－「Scriptランチャ」を選択して，開始してください。

2.9　NetExecコマンドによるリモート実行を許可するユーザの設定

NetExecコマンドによるリモート実行を許可するユーザを設定します。

操作

NetExecコマンドでリモート実行を許可するユーザを選定する。
NetExecコマンドでリモート実行を許可するユーザはNetExecコマンドで呼び出す実行ファイルを実行する空間（サービス空間およびログオン空間）単位で選定してください。

NetExecコマンド制限ポリシーファイルを配置するフォルダを作成する。
JP1/Scriptのインストール先フォルダの配下に，Confフォルダを作成してください。

NetExecコマンド制限ポリシーファイルを作成する。
NetExecコマンドで呼び出す実行ファイルを実行する空間（サービス空間およびログオン空間）単位に作成してください。作成するファイルは次のとおりです。

サービス空間の場合に作成するファイル：SPTHSV_ACPファイル

ログオン空間の場合に作成するファイル：SPTHLSV_ACPファイル

作成したNetExec実行ユーザポリシーファイルをJP1/Scriptのインストール先フォルダ¥Confフォルダに配置する。
操作3.で作成したSPTHSV_ACPファイルおよびSPTHLSV_ACPファイルをJP1/Scriptのインストール先フォルダ¥Confフォルダに配置してください。

NetExecコマンド制限ポリシーファイルに，NetExecコマンドでリモート実行を許可するユーザを設定する。
次の手順で設定します。

1. NetExecコマンド制限ポリシーファイルを右クリックして表示されるメニューから，［プロパティ］を選択する。

［プロパティ］ダイアログが表示されます。

2. ［セキュリティ］タブの［追加］ボタンをクリックし，NetExecコマンドでリモート実行を許可するユーザを追加する。

［ユーザまたはグループの選択］ダイアログで，NetExecコマンドでリモート実行を許可するユーザを選択してください。

3. ［セキュリティ］タブで追加したユーザを選択して，［アクセス許可］を次のとおり設定する。

・読み取り：許可

・書き込み：許可

4. 不要なユーザが設定されていないか確認する。

不要なユーザが設定されている場合は削除してください。

NetExecコマンド制限ポリシーファイルにファイルの管理者ユーザを設定する。
次の手順で設定します。

1. NetExecコマンド制限ポリシーファイルを右クリックして表示されるメニューから，［プロパティ］を選択する。

［プロパティ］ダイアログが表示されます。

2. ［セキュリティ］タブの［追加］ボタンをクリックし，ファイルの管理者ユーザを選択する。

［ユーザまたはグループの選択］ダイアログで，ファイルの管理者ユーザを選択してください。

3. ［セキュリティ］タブで追加したユーザを選択して，［アクセス許可］を次のとおり設定する。

フルコントロール：許可

NetExecコマンド制限ポリシーファイルに，JP1/ScriptサービスおよびScriptランチャサービスの起動ユーザを設定する。
JP1/Scriptサービスの場合はSPTHSV_ACPファイル，Scriptランチャサービスの場合はSPTHLSV_ACPファイルに対して，次の手順で設定します。

1. NetExecコマンド制限ポリシーファイルを右クリックして表示されるメニューから，［プロパティ］を選択する。

［プロパティ］ダイアログが表示されます。

2. ［セキュリティ］タブの［追加］ボタンをクリックし，JP1/ScriptサービスまたはScriptランチャサービスの実行ユーザを選択する。

［ユーザまたはグループの選択］ダイアログで，各サービスの実行ユーザを選択してください。

3. ［セキュリティ］タブで追加したユーザを選択して，［アクセス許可］を次のとおり設定する。

・読み取り：許可

・書き込み：許可

NetExecコマンド制限ポリシーファイルの配置先フォルダにリモート実行を許可するユーザを設定する。
次の手順で設定します。

1. Confフォルダを右クリックして表示されるメニューから，［プロパティ］を選択する。

［プロパティ］ダイアログが表示されます。

2. ［セキュリティ］タブの［追加］ボタンをクリックし，NetExecコマンドでリモート実行を許可するユーザを選択する。

［ユーザまたはグループの選択］ダイアログで，NetExecコマンドでリモート実行を許可するユーザを選択してください。

3. ［セキュリティ］タブで追加したユーザを選択して，［アクセス許可］を次のとおり設定する。

読み取り：許可

4. 不要なユーザが設定されていないか確認する。

不要なユーザが設定されている場合は削除してください。

NetExecコマンド制限ポリシーファイルの配置先フォルダにJP1/ScriptサービスおよびScriptランチャサービスの起動ユーザを設定する。
次の手順で設定します。

1. Confフォルダを右クリックして表示されるメニューの［プロパティ］を選択する。

［プロパティ］ダイアログが表示されます。

2. ［セキュリティ］タブの［追加］ボタンをクリックし，JP1/ScriptサービスおよびScriptランチャサービスの実行ユーザを選択する。

［ユーザまたはグループの選択］ダイアログで，各サービスの実行ユーザを選択してください。

3. ［セキュリティ］タブで追加したユーザを選択して，［アクセス許可］を次のとおり設定する。

・読み取りと実行：許可

・フォルダの内容の一覧表示：許可

・読み取り：許可

JP1/ScriptサービスおよびScriptランチャサービスを停止する。

JP1/ScriptサービスおよびScriptランチャサービスを開始する。
イベントログに次のメッセージが出力されていることを確認してください。

JP1/Scriptサービスの場合

「JP1/ScriptサービスのNetExecスレッド(NetExecコマンド実行ユーザ制限付き)を開始します。」

Scriptランチャサービスの場合

「ScriptランチャサービスのNetExecスレッド(NetExecコマンド実行ユーザ制限付き)を開始します。」

注意

NetExecコマンド制限ポリシーファイルを変更した場合は，JP1/ScriptサービスまたはScriptランチャサービスを再起動して，変更内容をNetExecコマンド制限ポリシーファイルに反映してください。

3.　JP1/Scriptの操作

この章では，JP1/Scriptのマネージャ，エディタ，簡易入力，トレースビューア，トレースファイル，メニューエディタ，プロセスビューア，実行環境ファイルコンバータの操作方法について説明します。

＜この章の構成＞

3.1　マネージャの操作

3.2　エディタの操作

3.3　簡易入力の操作

3.4　トレースビューアの操作

3.5　トレースファイルの表示操作

3.6　メニューエディタの操作

3.7　プロセスビューアの操作

3.8　実行環境ファイルコンバータの操作

3.1　マネージャの操作

Scriptマネージャウィンドウでできる操作の一覧を次に示します。

使用するエディタを決める

スクリプトを作成・保存する

簡易入力機能を使ってスクリプトを作成する

スクリプトを編集する

スクリプトの文法をチェックする

スクリプトを複写する

スクリプトを追加する

スクリプトを削除する

スクリプトの名前を変更する

スクリプトの実行環境（すべての項目）を設定する

スクリプトの実行環境（各項目）を設定する

スクリプトの自動起動を設定する

スクリプトを実行する

メニューフォームを作成する

マネージャを終了する

フォルダを変更する※

ツールバーの表示・非表示を切り替える※

ステータスバーの表示・非表示を切り替える※

スクリプトファイルを大きい／小さいアイコンで表示する※

スクリプトファイルをリスト形式（一覧）で表示する※

クライアントエリアを最新の情報に更新する※

注※

これらの操作は，特に説明していません（これらはWindowsの標準の操作に準じているか，メニュー一覧で該当するメニューを選択するだけで実行できる操作です）。

＜この節の構成＞

3.1.1　Scriptマネージャウィンドウとメニュー

3.1.2　Scriptマネージャウィンドウでのマウスとキーの操作

3.1.3　使用するエディタを決める

3.1.4　スクリプトを作成・保存する

3.1.5　簡易入力機能を使ってスクリプトを作成する

3.1.6　スクリプトを編集する

3.1.7　スクリプトの文法をチェックする

3.1.8　スクリプトを複写する

3.1.9　スクリプトを追加する

3.1.10　スクリプトを削除する

3.1.11　スクリプトの名前を変更する

3.1.12　スクリプトの実行環境（すべての項目）を設定する

3.1.13　スクリプトの実行環境（各項目）を設定する

3.1.14　スクリプトの自動起動を設定する

3.1.15　スクリプトを実行する

3.1.16　メニューフォームを作成する

3.1.17　エディタの起動と終了

3.1.1　Scriptマネージャウィンドウとメニュー

JP1/Scriptでスクリプトを作成する場合は，まずマネージャを起動させます。マネージャアイコンを起動すると，Scriptマネージャウィンドウが表示されます。マネージャでは，作成したスクリプトの保存や文法のチェックなど，スクリプトに関する操作をします。

ここでは，マネージャを起動すると表示されるScriptマネージャウィンドウについて説明します。また，マネージャの機能をメニューごとに説明します。

＜この項の構成＞

(1)　Scriptマネージャウィンドウ

(2)　Scriptマネージャウィンドウのメニュー

(1)　Scriptマネージャウィンドウ

Scriptマネージャウィンドウ，およびウィンドウの各部の名称を，図3-1に示します。

図3-1　Scriptマネージャウィンドウ

(a)　ツールバー

ツールバーには，メニューバーから選択できるコマンドの中から，頻繁に使用するコマンドだけをボタンの形で表示しています。ボタンをマウスでクリックするだけで，該当するコマンドを実行できます。オプションメニューによって非表示にすることもできます。

Scriptマネージャウィンドウのツールバーには，次のコマンドのボタンが表示されます。

［新規作成］ボタン

スクリプトファイルを新規作成します。

［編集］ボタン

スクリプトファイルを編集します。

［複写］ボタン

スクリプトファイルを複写します。

［追加］ボタン

別のフォルダのスクリプトファイルを現在のフォルダに追加します。

［削除］ボタン

スクリプトファイルを削除します。

［名前の変更］ボタン

スクリプトファイル名を変更します。

［終了］ボタン

マネージャを終了します。

［文法チェック］ボタン

スクリプトファイルの文法をチェックします。

［実行］ボタン

スクリプトファイルを実行します。

［実行環境の設定］ボタン

スクリプトファイルの実行環境を設定します。

［大きいアイコン］ボタン

スクリプトファイルを大きいアイコンで表示します。

［小さいアイコン］ボタン

スクリプトファイルを小さいアイコンで表示します。

［一覧］ボタン

スクリプトファイルをリスト形式で表示します。

［最新］ボタン

クライアントエリアを最新の状態に更新します。

［自動起動の設定］ボタン

スクリプトファイルの自動起動を設定します。

［トレースビューア］ボタン

トレースビューアを起動します。

［簡易入力］ボタン

簡易入力を起動します。

［メニューエディタ］ボタン

メニューエディタを起動します。

［プロセスビューア］ボタン

プロセスビューアを起動します。

［ヘルプ］ボタン

JP1/Scriptのオンラインヘルプを表示します。

(b)　ステータスバー

ステータスバーは，マネージャが現在実行している処理に関するメッセージや，処理終了後の状態に関するメッセージを表示するための領域です。

(c)　クライアントエリア

クライアントエリアには，ファイルを抽象化したアイコンが表示されます。

ここに表示しきれないアイコンがある場合は，Scriptマネージャウィンドウにスクロールバーが表示されます。

(2)　Scriptマネージャウィンドウのメニュー

ここでは，Scriptマネージャウィンドウのメニューウィンドウのメニューバーに表示されるメニュー，およびScriptマネージャウィンドウで表示されるポップアップメニューについて説明します。

(a)　メニューバーのメニュー

Scriptマネージャウィンドウの機能を，メニューごとに説明します。Scriptマネージャウィンドウのメニュー一覧を表3-1に示します。

表3-1　Scriptマネージャウィンドウのメニュー一覧

メニュー
コマンド（機能）
機能概要

［ファイル］
［新規作成］
スクリプトファイルを新規に作成するために，エディタを起動します。

［編集］
既存のスクリプトファイルを編集するために，エディタを起動します。

［複写］
現在表示されているフォルダのスクリプトファイルを別のフォルダへ複写します。

［追加］
別のフォルダのスクリプトファイルを現在表示されているフォルダへ追加します。

［削除］
作成されているスクリプトファイルを削除します。

［名前の変更］
スクリプトファイルの名前を別の名前に変更します。

［文法チェック］
作成されているスクリプトファイルの文法をチェックします。

［実行］
作成されているスクリプトファイルを実行します。

［実行環境の設定］－［すべての項目］
作成されているスクリプトファイルの実行環境を設定します。

［実行環境の設定］－［コマンドライン］
作成されているスクリプトファイルの実行環境のコマンドラインだけを変更します。

［実行環境の設定］－［作業フォルダ］
作成されているスクリプトファイルの実行環境の作業フォルダだけを変更します。

［実行環境の設定］－［起動日時］
作成されているスクリプトファイルの実行環境の起動日時だけを変更します。

［実行環境の設定］－［打ち切り時間］
作成されているスクリプトファイルの実行環境の打ち切り時間だけを変更します。

［実行環境の設定］－［トレース出力先フォルダ］
作成されているスクリプトファイルの実行環境のトレース出力先フォルダだけを変更します。

［実行環境の設定］－［ユーザトレース情報］
作成されているスクリプトファイルの実行環境のユーザトレース情報だけを変更します。

［フォルダの変更］
クライアントエリアに表示するフォルダを変更します。

（フォルダ名）
直前に変更したフォルダ名が表示されます。

［マネージャの終了］
Scriptマネージャウィンドウのメニューマネージャを終了します。

［表示］
［ツールバー］
ツールバーの表示・非表示を切り替えます。

［ステータスバー］
ステータスバーの表示・非表示を切り替えます。

［大きいアイコン］
作成されているスクリプトファイルを大きいアイコンで表示します。

［小さいアイコン］
作成されているスクリプトファイルを小さいアイコンで表示します。

［一覧］
作成されているスクリプトファイルをリスト形式で表示します。

［最新の情報に更新］
クライアントエリアを最新の情報に更新します。

［ツール］
［自動起動の設定］
スクリプトファイルの自動起動を設定します。

［エディタの関連付け］
スクリプトファイルを編集するエディタとの関連づけをします。

［トレースビューアの起動］
トレースビューアを起動します。

［簡易入力の起動］
簡易入力機能を起動します。

［メニューエディタの起動］
メニューエディタを起動します。

［プロセスビューアの起動］
プロセスビューアを起動します。

［オプション］
次の機能があります。
クライアントからのコマンド実行の認否設定
サーバに対するアクセス権の状況表示
利用するスクリプトエンジンのバージョン指定

［ヘルプ］
［目次］
JP1/Scriptオンラインヘルプの目次を表示します。

［キーワードで検索］
JP1/Scriptオンラインヘルプのキーワード一覧を表示します。

［ヘルプの使い方］
オンラインヘルプの使い方を表示します。

［バージョン情報］
マネージャのバージョン情報を表示します。

(b)　ポップアップメニュー

Scriptマネージャウィンドウのクライアントエリアでマウスの右ボタンをクリックすると，ポップアップメニューが表示されます。Scriptマネージャウィンドウで表示されるポップアップメニューを表3-2に示します。

表3-2　ポップアップメニュー一覧

ポップアップメニュー | 機能概要
［新規作成］ | スクリプトファイルを新規に作成します。
［編集］ | スクリプトファイルを編集します。
［複写］ | 現在表示されているフォルダのスクリプトファイルを，別のフォルダへ複写します。
［追加］ | 別のフォルダのスクリプトファイルを，現在表示されているフォルダへ追加します。
［削除］ | 作成されているスクリプトファイルを削除します。
［名前の変更］ | スクリプトファイルの名前を別の名前に変更します。
［文法チェック］ | 作成されているスクリプトファイルの文法をチェックします。
［実行］ | 作成されているスクリプトファイルを実行します。
［実行環境の設定］－［すべての項目］ | 作成されているスクリプトファイルの実行環境を設定します。
［実行環境の設定］－［コマンドライン］ | 作成されているスクリプトファイルの実行環境のコマンドラインだけを変更します。
［実行環境の設定］－［作業フォルダ］ | 作成されているスクリプトファイルの実行環境の作業フォルダだけを変更します。
［実行環境の設定］－［起動日時］ | 作成されているスクリプトファイルの実行環境の起動日時だけを変更します。
［実行環境の設定］－［打ち切り時間］ | 作成されているスクリプトファイルの実行環境の打ち切り時間だけを変更します。
［実行環境の設定］－［トレース出力先フォルダ］ | 作成されているスクリプトファイルの実行環境のトレース出力先フォルダだけを変更します。
［実行環境の設定］－［ユーザトレース情報］ | 作成されているスクリプトファイルの実行環境のユーザトレース情報だけを変更します。
［メニューエディタの起動］ | メニューエディタを起動します。
［プロパティ］ | 作成されているスクリプトファイルの情報が表示されます。

3.1.2　Scriptマネージャウィンドウでのマウスとキーの操作

＜この項の構成＞

(1)　マウス操作

(2)　キー操作

(1)　マウス操作

Scriptマネージャウィンドウのクライアントエリアでのマウス操作について，対象がアイコンの場合を表3-3に，対象が背景の場合を表3-4に示します。

表3-3　Scriptマネージャウィンドウでのマウス操作（対象がアイコンの場合）

操作 | 処理
クリック | それまでの選択を解除して，新たに対象を選択する。
ダブルクリック | スクリプトを実行する。
右ボタンシングルクリック | ポップアップメニューを表示する。

表3-4　Scriptマネージャウィンドウでのマウス操作（対象が背景の場合）

操作 | 処理
クリック | それまでの選択を解除する。
ドラッグ | ドラッグした範囲内のアイコンを選択する。
右ボタンシングルクリック | ポップアップメニューを表示する。

(2)　キー操作

Scriptマネージャウィンドウのクライアントエリアでのキー操作を表3-5に示します。

表3-5　Scriptマネージャウィンドウでのキー操作

操作 | 処理
Ctrl+N | 新規にスクリプトファイルを作成する。
Ctrl+O | 選択したスクリプトファイルを編集する。
DEL | 選択したスクリプトファイルを削除する。
Enter | 選択したスクリプトファイルを実行する。
Shift+Enter | 選択したスクリプトファイルを文法チェックする。
Shift+Ctrl+Enter | 選択したスクリプトファイルの実行環境を設定する。

3.1.3　使用するエディタを決める

JP1/Scriptには，スクリプトを作成するための専用のエディタがあります。デフォルトの設定ではこのエディタを使用するように設定されています。

ただし，特に別のエディタを使用してスクリプトを作成したい場合は，ここで説明する操作を行う必要があります。

操作

［ツール］－［エディタの関連付け］メニューを選択する。
［エディタの関連付け］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.21　エディタの関連付けダイアログ」を参照してください。

専用のエディタ以外のほかのエディタを使用する場合は，［別のエディタを使用する］ボタンをチェックし，［選択］ボタンをクリックして関連づけをするエディタを指定する。必要な場合は，エディタの作業フォルダを指定する。
ここではメモ帳を関連づけた例を示します。

ほかのエディタを使用するのをやめて，専用のエディタを使用する場合は，［別のエディタを使用する］ボタンのチェックを外します。

［OK］ボタンをクリックする。
エディタの関連づけが設定されます。

Windows標準のワードパッドは使用できません。その他のプログラム（テキスト形式で保存できるプログラム）を設定してください。

操作2.で作業フォルダの指定を省略すると，エディタのフォルダが仮定されます。

操作3.で［キャンセル］ボタンをクリックすると，エディタの関連づけがキャンセルされます。

3.1.4　スクリプトを作成・保存する

スクリプトファイルを新規に作成します。

この操作を行う前に，エディタとの関連づけを設定しておく必要があります。設定の方法については，「3.1.3　使用するエディタを決める」を参照してください。

操作

［ファイル］－［新規作成］メニューを選択する。
［新規作成］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.1　新規作成ダイアログ」を参照してください。

作成するスクリプトファイルの名前（拡張子は不要）を入力して，［OK］ボタンをクリックする。
関連づけされているエディタが起動します。

スクリプトを作成して上書き保存し，エディタを終了する。
クライアントエリアに，作成したスクリプトファイルのアイコンが表示されます。

使用するエディタが専用のエディタではなくほかのエディタの場合，作成したスクリプトファイルをクライアントエリアに反映させるためには，［表示］－［最新の情報に更新］メニューを実行してください。

Windows標準のワードパッドは使用できません。エディタとしてワードパッドが設定されている場合は，「3.1.3　使用するエディタを決める」を参照して設定をやり直してください。

操作2.でスクリプトファイルの名前を入力するときに，拡張子は指定しないでください。プログラムが自動的に拡張子（.SPT）を設定します。

マネージャとエディタは独立に動きます。エディタを起動した後，マネージャを終了しても，エディタは終了しません。

3.1.5　簡易入力機能を使ってスクリプトを作成する

スクリプトを記述する際の，コマンドやステートメントの入力作業を，簡易入力機能を使って行います。

この機能を使うことで，コマンドの知識がなくても手軽に間違いなく入力できます。

記述したコマンドやステートメントの内容を，クリップボードを経由して使用しているエディタに貼り付けます。

操作

操作手順は，使用するエディタに専用のエディタが関連づけられている場合と，ほかのエディタが関連づけられている場合とで異なります。

使用するエディタに専用のエディタが関連づけられている場合
「3.2.4　簡易入力機能を使う」を参照してください。

使用するエディタにほかのエディタが関連づけられている場合

［ファイル］－［新規作成］メニュー，またはスクリプトファイルを選択し［ファイル］－［編集］メニューを選択して，エディタを起動する。
関連づけられているエディタが起動します（メモ帳が関連づけられている例）。

マネージャの［ツール］－［簡易入力の起動］メニューを選択するか，Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［簡易入力］を選択して，簡易入力を起動する。
［Script 簡易入力］ダイアログが表示されます。

ダイアログの設定方法については「3.3　簡易入力の操作」を参照してください。

［オプション］ボタンをクリックして，［オプション（全般）］ダイアログでスクリプトファイルの作成バージョンを設定する。

ダイアログの設定方法については「3.3.3　JP1/Scriptの対象バージョンを指定する」を参照してください。

［編集］タブをクリックして，［オプション（編集）］ダイアログでクリップボードへの出力形式を設定する。

ダイアログの設定方法については「3.3.4　1行の最大文字数やインデントの桁数を指定する」を参照してください。

［OK］ボタンをクリックする。
スクリプトファイルの作成バージョン，およびクリップボードへの出力形式が設定され，［Script簡易入力］ダイアログに戻ります。

使用するコマンド，またはステートメントを検索し，選択する。
該当するコマンド，またはステートメントにフォーカスが移動します。

［表示］ボタンをクリックするか，コマンド，またはステートメントをダブルクリックする。
「引数の指定/ステートメントの構文」に，選択したコマンドの引数を入力する項目が表示されます。
ステートメントの場合は，ステートメントの構文が表示されます。

コマンドの引数の項目を入力する。

［クリップボードへ］ボタンをクリックする。
「引数の指定/ステートメントの構文」の内容がクリップボードに貼り付けられます。

クリップボードからエディタに貼り付ける。

「検索するコマンド/ステートメント」の一覧（リストボックス）で，コマンド名，またはステートメント名を選択し，マウスの右ボタンをクリックすると，選択されたコマンド，またはステートメントのヘルプが表示されます。

操作7.で引数がないコマンドの場合は，「引数の指定/ステートメントの構文」に「このコマンドに引数はありません。」というメッセージが表示されます。

3.1.6　スクリプトを編集する

作成したスクリプトファイルを編集します。

操作

クライアントエリアから，編集するスクリプトファイルのアイコンを一つ選択する。

［ファイル］－［編集］メニューを選択する。
関連づけされているエディタが起動します。

スクリプトを編集して上書き保存し，エディタを終了する。

Windows標準のワードパッドは使用できません。エディタとしてワードパッドが設定されている場合は，「3.1.3　使用するエディタを決める」を参照して設定をやり直してください。

スクリプトを編集するエディタとしてデフォルトでは，専用のエディタが関連づけけられています。

3.1.7　スクリプトの文法をチェックする

作成したスクリプトの文法をチェックします。

文法チェックとは，字句解析や構文解析だけを行って，コマンドは実行しないモードのことです。

操作

クライアントエリアから，文法をチェックするスクリプトファイルのアイコンを一つ選択する。

［ファイル］－［文法チェック］メニューを選択する。
文法チェックが実行され，実行状況，実行トレース，解析トレースを表示するウィンドウが表示されます。文法チェックの結果は，解析トレースとして表示されます。
文法チェックが終了すると，実行状況を表示するウィンドウの［終了］ボタンが選択可能になります。

解析トレースの内容を確認する。
このとき，［ファイル］－［編集］メニューを選択してエディタを起動し，解析結果を見ながらスクリプトを編集することもできます。

実行状況を表示しているウィンドウの［終了］ボタンをクリックする。
三つのウィンドウが閉じます。

文法チェックを実行すると，解析トレースファイルが作成されます。解析トレースファイルを印刷したい場合は，トレースビューアを起動し，印刷したいファイルを選択してから，［ファイル］－［印刷］メニューを選択してください。詳細は，「3.4.10　トレースファイルを印刷する」を参照してください。

3.1.8　スクリプトを複写する

現在表示されているフォルダのスクリプトファイルを，他のフォルダへ複写します。

操作

クライアントエリアから，複写するスクリプトファイルのアイコンを一つ，または複数選択する。

［ファイル］－［複写］メニューを選択する。
［ファイルの複写］ダイアログが表示されます。

ダイアログの設定方法については「4.1.2　ファイルの複写ダイアログ」を参照してください。

［選択］ボタンをクリックして，［フォルダの選択］ダイアログから複写先フォルダを選択する。

ダイアログの設定方法については「4.1.29　フォルダの選択ダイアログ」を参照してください。

［OK］ボタンをクリックする。
複写が実行されます。

［ファイルの複写］ダイアログを表示してから，一部のファイルの複写をとりやめたい場合は，［ファイルの複写］ダイアログで，とりやめたいファイルをクリックしてください。ファイルの選択状態を解除し，複写の対象から外すことができます。

操作4.で［キャンセル］ボタンをクリックすると，ファイルの複写を中断してダイアログを閉じます。

複写先フォルダに同名のファイルがある場合は，［ファイルの上書き確認］ダイアログが表示されます。

3.1.9　スクリプトを追加する

他のフォルダにあるスクリプトファイルを現在表示されているフォルダに追加します。

操作

［ファイル］－［追加］メニューを選択する。
［ファイルの追加］ダイアログが表示されます。

ダイアログの設定方法については「4.1.3　ファイルの追加ダイアログ」を参照してください。

［選択］ボタンをクリックして，［フォルダの選択］ダイアログから追加元フォルダ（追加したいファイルがあるフォルダ）を選択する。

ダイアログの設定方法については「4.1.29　フォルダの選択ダイアログ」を参照してください。

追加したいファイルを一つ，または複数選択する。

［OK］ボタンをクリックする。
ファイルの追加が実行されます。

操作4.で［キャンセル］ボタンをクリックすると，ファイルの追加を中断してダイアログを閉じます。

追加先フォルダに同名のファイルがある場合は，［ファイルの上書き確認］ダイアログが表示されます。

3.1.10　スクリプトを削除する

作成されているスクリプトファイルを削除します。

操作

クライアントエリアから，削除するスクリプトファイルのアイコンを一つ，または複数選択する。

［ファイル］－［削除］メニューを選択する。
［ファイルの削除の確認］ダイアログが表示されます。

ダイアログの設定方法については「4.1.5　ファイルの削除の確認ダイアログ」を参照してください。

［はい］ボタンをクリックする。
スクリプトファイルが一つ削除され，次に選択されているファイルに処理が移ります。
必要な回数だけ，操作を繰り返します。選択されているすべてのファイルが削除されると，ダイアログが閉じます。

操作3.で［すべて削除］ボタンをクリックすると，選択されているすべてのファイルが削除されます。

操作3.で［キャンセル］ボタンをクリックすると，ファイルの削除を中断してダイアログを閉じます。

［ファイルの削除の確認］ダイアログを表示してから，一部のファイルの削除をとりやめたい場合は，［ファイルの削除の確認］ダイアログで，とりやめたいファイルをクリックしてください。ファイルの選択状態を解除し，削除の対象から外すことができます。

3.1.11　スクリプトの名前を変更する

選択したスクリプトファイルの名前を別の名前に変更します。

操作

クライアントエリアから，名前を変更するスクリプトファイルのアイコンを一つ選択する。

［ファイル］－［名前の変更］メニューを選択する。
［名前の変更］ダイアログが表示されます。

ダイアログの設定方法については「4.1.6　名前の変更ダイアログ」を参照してください。

新しい名前を入力する。

［OK］ボタンをクリックする。
名前の変更が実行されて，ダイアログが閉じます。

操作4.で［キャンセル］ボタンをクリックすると，名前の変更を中断してダイアログを閉じます。

3.1.12　スクリプトの実行環境（すべての項目）を設定する

作成されているスクリプトファイルの実行環境を設定します。このほかに，エディタから操作する方法もあります。

エディタから操作する方法については「3.2.13　スクリプトの実行環境を設定する」を参照してください。

操作

Scriptマネージャウィンドウから操作する方法

クライアントエリアから，実行環境を設定するスクリプトファイルのアイコンを一つ，または複数選択する。

［ファイル］－［実行環境の設定］－［すべての項目］メニューを選択する。
［実行環境（起動情報）の設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.8　実行環境の設定（起動情報）ダイアログ」を参照してください。

必要な起動情報を設定する。
実行時にパラメタが必要な場合，および解析トレース，実行トレースの出力形式などを設定する場合は，コマンドラインでの指定が必要です。
コマンドラインの指定方法については，「6.2　コマンドラインに関する規則」を参照してください。

［終了情報］タブをクリックする。
［実行環境の設定（終了情報）］ダイアログが表示されます。

ダイアログの設定方法については，「 4.1.9　実行環境の設定（終了情報）ダイアログ」を参照してください。

打ち切り時間を設定する。
打ち切り時間による強制終了をしない場合は，打ち切り時間が「0」になっていることを確認してください。

［トレース情報］タブをクリックする。
［実行環境の設定（トレース情報）］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.10　実行環境の設定（トレース情報）ダイアログ」を参照してください。

必要なトレース情報を設定する。
トレースファイルの出力行数などを特に指定する必要がない場合は，このダイアログでの操作は必要ありません。

［OK］ボタンをクリックする。
実行環境が設定され，ダイアログが閉じます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でスクリプトの実行環境を設定しようとすると，次のエラーダイアログを表示します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

Scriptランチャサービスでは使用できません。

3.1.13　スクリプトの実行環境（各項目）を設定する

作成されているスクリプトファイルの実行環境を項目ごとに設定します。

操作

クライアントエリアから，実行環境を設定するスクリプトファイルのアイコンを一つ，または複数選択する。

［ファイル］－［実行環境の設定］－［コマンドライン］メニューなどの各項目を選択する。

［ファイル］－［実行環境の設定］から次のメニューを選択します。

コマンドライン

作業フォルダ

起動日時

打ち切り時間

トレース出力先フォルダ

ユーザトレース情報

［コマンドライン］を選択した場合

［実行環境（コマンドライン）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.11　実行環境（コマンドライン）の設定ダイアログ」を参照してください。

［作業フォルダ］を選択した場合

［実行環境（作業フォルダ）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.13　実行環境（作業フォルダ）の設定ダイアログ」を参照してください。

［起動日時］を選択した場合

［実行環境（起動日時）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.14　実行環境（起動日時）の設定ダイアログ」を参照してください。

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でスクリプトの実行環境（起動日時）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

［打ち切り時間］を選択した場合

［実行環境（打ち切り時間）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.15　実行環境（打ち切り時間）の設定ダイアログ」を参照してください。

［トレース出力先フォルダ］を選択した場合

［実行環境（トレース出力先フォルダ）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.16　実行環境（トレース出力先フォルダ）の設定ダイアログ」を参照してください。

［ユーザトレース情報］を選択した場合

［実行環境（ユーザトレース情報）の設定］ダイアログが表示されます。

ダイアログの設定方法については「4.1.17　実行環境（ユーザトレース情報）の設定ダイアログ」を参照してください。

必要な情報を設定する。

［OK］ボタンをクリックする。
項目ごとの実行環境が設定され，ダイアログが閉じます。

補足

Scriptランチャサービスでは使用できません。

3.1.14　スクリプトの自動起動を設定する

Scriptランチャ，またはJP1/Scriptサービスによって自動起動されるスクリプトファイルの名前を設定します。

操作

［ツール］－［自動起動の設定］メニューを選択する。
［自動起動の設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.20　自動起動の設定ダイアログ」を参照してください。

スクリプトファイル名を選択し［追加］ボタンをクリックするか，または［すべて追加］ボタンをクリックする。
選択したスクリプトファイル名が，［自動起動するスクリプトファイル名］の一覧（リストボックス）に追加されます。

［OK］ボタンをクリックする。
［自動起動するスクリプトファイル名］の一覧（リストボックス）の内容が自動起動情報ファイルとして出力されます。

［自動起動するスクリプトファイル名］の一覧（リストボックス）に不要なスクリプトファイルファイルがある場合は，それを一つ，または複数選択して［削除］，または［すべて削除］ボタンをクリックします。削除したスクリプトファイル名は，［スクリプトファイル名］の一覧（リストボックス）に追加されます。

操作3.で［キャンセル］ボタンをクリックすると，自動起動に設定しないでダイアログを閉じます。設定は初期状態に戻ります。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でスクリプトの自動起動を設定しようとすると，次のエラーダイアログを表示します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

Scriptランチャサービスでは使用できません。

3.1.15　スクリプトを実行する

作成されているスクリプトファイルを実行します。

Scriptマネージャウィンドウからの実行は，通常は実行トレースなどを確認するために行います。

操作

クライアントエリアで，実行するスクリプトファイルのアイコンを一つ選択する。

［ファイル］－［実行］メニューを選択する。またはアイコンをダブルクリックする。
［実行］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.7　実行ダイアログ」を参照してください。

実行環境の設定が必要な場合は，［詳細］ボタンをクリックし，［実行の環境設定（起動情報）］ダイアログでコマンドラインなどを設定する。

ダイアログの設定方法については，「4.1.8　実行環境の設定（起動情報）ダイアログ」を参照してください。

［実行］ダイアログで［OK］ボタンをクリックする。
スクリプトが実行され，実行状況，実行トレース，解析トレースを表示するウィンドウが表示されます。

スクリプト実行の結果は，実行トレースとして表示されます。
実行が終了すると，実行状況を表示するウィンドウの［終了］ボタンが選択できるようになります。

実行トレースの内容を確認する。

実行状況を表示しているウィンドウの［終了］ボタンをクリックする。
三つのウィンドウが閉じます。

Scriptマネージャウィンドウでスクリプトを実行すると，実行トレースファイルが作成されます。実行トレースファイルを印刷したい場合は，トレースビューアを起動し，印刷したいファイルを選択してから，［ファイル］－［印刷］メニューを選択してください。詳細は，「3.4.10　トレースファイルを印刷する」参照してください。

操作4.で［キャンセル］ボタンをクリックすると，スクリプトを実行しないでダイアログを閉じます。

実行状況，実行トレース，解析トレースを表示するウィンドウを表示させたい場合は，［ウィンドウを表示する］をチェックします。デフォルトではチェックされています。

3.1.16　メニューフォームを作成する

メニューフォームを作成します。

操作

クライアントエリアで，編集，または実行するスクリプトファイルのアイコンを一つ選択する。

［ツール］－［メニューエディタの起動］メニューを選択する。
Scriptメニューエディタウィンドウが表示されます。
メニューフォームが作成されていない場合は，Scriptメニューエディタウィンドウの手前に，［メニューフォーム名の指定］ダイアログが表示されます。なお，画面左下にはコマンドプロパティダイアログボックスが表示されます。

メニューフォームが作成されている場合は，操作4.に進んでください。

メニューフォーム名を入力する。
フォームビューに新しいメニューフォームが表示されます。操作5.に進んでください。

［編集］－［メニューフォームの新規作成］メニューを選択する。
フォームビューに新しいメニューフォームが表示されます。

メニューフォームを作成する。
作成方法については，「3.6.3　新しいメニューフォームを作成する」を参照してください。

メニューエディタを終了する。

マネージャとメニューエディタは独立に動きます。メニューエディタを起動した後，マネージャを終了しても，メニューエディタは終了しません。

3.1.17　エディタの起動と終了

エディタを起動する
実際にスクリプトファイルの作成や編集をする場合は，エディタを起動します。

操作

クライアントエリアでスクリプトファイルのアイコンを一つ選択する。

Scriptマネージャウィンドウの［ファイル］－［編集］を選択する。

別のエディタが関連づけられている場合はそのエディタが起動されます。

エディタを終了する
Scriptエディタウィンドウの［ファイル］－［終了］を選択してください。エディタが終了します。

3.2　エディタの操作

Scriptエディタウィンドウでできる操作の一覧を次に示します。

コメント行を設定・解除する

簡易入力機能を使う

Scriptメニューフォームを作成する

エディタの動作環境を設定する

スクリプトファイルの文法をチェックする

モニタリングを実行・中止する

スクリプトを実行する

モニタリング実行時のブレークポイントを設定・解除する

モニタリング実行時の動作環境を設定する

ウォッチへ変数を追加する

スクリプトファイルの実行環境を設定する

文字列を検索する

文字列を置換する

新しいスクリプトファイルを作成する※

既存のスクリプトファイルを開く※

スクリプトファイルを保存する※

スクリプトファイルに名前を付けて保存する※

スクリプトファイルの内容を印刷する※

直前の操作を元に戻す※

直前の操作をやり直す※

選択した文字列をクリップボードに切り抜く※

選択した文字列をクリップボードにコピーする※

クリップボードの文字列を指定の位置に貼り付ける※

すべての文字列を選択する※

実行ポイント行へジャンプする※

ツールバーの表示・非表示を切り替える※

ステータスバーの表示・非表示を切り替える※

ツールバーを整列させる※

ルーラーの表示・非表示を切り替える※

縦スクロールバーの表示・非表示を切り替える※

行番号の表示・非表示を切り替える※

ファイルの先頭を表示する※

ファイルの末尾を表示する※

ウォッチウィンドウの表示・非表示を切り替える※

ヘルプを表示する※

注※

これらの操作は特に説明していません（これらは，Windowsの標準の操作に準じているか，メニュー一覧で該当するメニューを選択するだけで実行できる操作です）。

＜この節の構成＞

3.2.1　Scriptエディタウィンドウとメニュー

3.2.2　Scriptエディタウィンドウでのマウスとキーの操作

3.2.3　コメント行を設定・解除する

3.2.4　簡易入力機能を使う

3.2.5　メニューフォームを作成する

3.2.6　エディタの動作環境を設定する

3.2.7　スクリプトファイルの文法をチェックする

3.2.8　モニタリングを実行・中止する

3.2.9　スクリプトを実行する

3.2.10　モニタリング実行時のブレークポイントを設定・解除する

3.2.11　モニタリング実行時の動作環境を設定する

3.2.12　ウォッチへ変数を追加する

3.2.13　スクリプトの実行環境を設定する

3.2.14　文字列を検索する

3.2.15　文字列を置換する

3.2.1　Scriptエディタウィンドウとメニュー

エディタはスクリプトを新規に作成したり，既存のスクリプトを編集したりするためのプログラムです。

ここでは，エディタを起動すると表示されるScriptエディタウィンドウについて説明します。また，エディタの機能をメニューごとに説明します。

＜この項の構成＞

(1)　Scriptエディタウィンドウ

(2)　Scriptエディタウィンドウのメニュー

(3)　エラーウィンドウ

(4)　ウォッチウィンドウ

(1)　Scriptエディタウィンドウ

Scriptエディタウィンドウ，およびウィンドウの各部の名称を，図3-2に示します。

図3-2　Scriptエディタウィンドウ

(a)　ツールバー

ツールバーには，メニューバーから選択できるコマンドの中から，頻繁に使用するコマンドだけをボタンの形で表示しています。ボタンをマウスでクリックするだけで，該当するコマンドを実行できます。表示メニューによって非表示にすることもできます。

Scriptエディタウィンドウのツールバーには，次のコマンドのボタンが表示されます。

標準ツールバー

［新規作成］ボタン

スクリプトファイルを新規に作成します。

［開く］ボタン

スクリプトファイルを開きます。

［保存］ボタン

スクリプトファイルを保存します。

［印刷］ボタン

スクリプトファイルを印刷します。

［終了］ボタン

Scriptエディタを終了します。

［ヘルプ］ボタン

JP1/Scriptのオンラインヘルプを表示します。

編集ツールバー

［元に戻す］ボタン

直前の操作を無効にします。

［やり直し］ボタン

直前の操作をやり直します。

［切り抜き］ボタン

選択した文字列をクリップボードに切り抜きます。

［コピー］ボタン

選択した文字列をクリップボードにコピーします。

［貼り付け］ボタン

クリップボードの文字列を指定の位置に貼り付けます。

［すべて選択］ボタン

記述されている文字列をすべて選択します。

［コメント設定］ボタン

選択した行をコメント行にします。

［コメント解除］ボタン

選択した行をコメント行の設定から解除します。

［簡易入力］ボタン

コマンド，またはステートメントを簡易入力します。

［メニューエディタ］ボタン

メニューエディタを起動します。

モニタリングツールバー

［文法チェック］ボタン

記述したスクリプトの文法をチェックします。

［ブレークポイントまで実行］ボタン

ブレークポイントまでの実行スタート，およびリスタートをします。

［モニタリングの中止］ボタン

モニタリングの実行を中止します。

［ステップ実行］ボタン

コマンド，またはステートメントを一つずつ実行します。

［連続ステップ実行］ボタン

コマンド，またはステートメントを連続して一つずつ実行します。

［連続ステップ実行の一時停止］ボタン

連続ステップ実行を一時停止します。

［ブレークポイントの設定／解除］ボタン

ブレークポイントを設定，または解除します。

［ブレークポイントをすべて解除］ボタン

設定されているブレークポイントをすべて解除します。

［設定］ボタン

モニタリング実行時の環境を設定します。

［ウォッチウィンドウの表示／非表示］ボタン

ウォッチウィンドウの表示・非表示を切り替えます。

［ウォッチへ追加］ボタン

指定した変数をウォッチウィンドウに追加します。

［実行環境の設定］ボタン

スクリプトファイルの環境を設定します。

検索ツールバー

［検索］ボタン

検索する文字列を入力します。

［前検索］ボタン

検索文字列を上に向かって検索します。

［次検索］ボタン

検索文字列を下に向かって検索します。

(b)　ルーラー

行のカラム数を表示する目盛りです。

(c)　行番号

スクリプトの行番号を表示するための領域です。

(d)　ブレークポイントエリア

ブレークポイントを示す記号（[図データ]）と，次に実行する位置を示す記号（[図データ]）を表示するための領域です。

(e)　ステータスバー

ステータスバーは，Scriptエディタが現在実行している処理に関するメッセージや，処理終了後の状態に関するメッセージを表示するための領域です。

(f)　クライアントエリア

クライアントエリアには，スクリプトファイルの内容が表示されます。

(2)　Scriptエディタウィンドウのメニュー

ここでは，Scriptエディタウィンドウのメニューバーに表示されるメニュー，およびScriptエディタウィンドウで表示されるポップアップメニューについて説明します。

(a)　メニューバーのメニュー

エディタの機能を，メニューごとに説明します。エディタのメニュー一覧を表3-6に示します。

表3-6　Scriptエディタのメニュー一覧

メニュー | コマンド（機能） | 機能概要
［ファイル］ | ［新規作成］ | スクリプトファイルを新規に作成します。
［開く］ | 既存のスクリプトファイルを開きます。
［保存］ | スクリプトファイルを上書き保存します。
［名前を付けて保存］ | スクリプトファイルを別名で保存します。
［印刷］ | スクリプトファイルを印刷します。
［終了］ | エディタを終了します。
（ファイル名） | 直前に保存したスクリプトファイルが最大9個表示されます。
［編集］ | ［元に戻す］ | 編集する直前の状態に戻します。
［やり直し］ | 直前の操作をやり直します。
［切り抜き］ | 選択した文字列をクリップボードに切り抜きます。
［コピー］ | 選択した文字列をクリップボードにコピーします。
［貼り付け］ | クリップボードの文字列を指定した位置に貼り付けます。
［すべて選択］ | 記述されているすべての文字列を選択します。
［コメント設定］ | 選択した行をコメント行に設定します。
［コメント解除］ | 選択したコメント行のコメント属性を解除します。
［簡易入力］ | 簡易入力機能を使って，コマンド，またはステートメントを入力します。
［メニューエディタ］ | メニューエディタを起動します。
［オプション］ | エディタの動作環境を設定します。
［モニタリング］ | ［文法チェック］ | スクリプトの文法をチェックします。
［モニタリングの実行］－［実行］ | モニタリングモードで，ブレークポイントまで実行，またはリスタートします。
［モニタリングの実行］－［ステップ実行］ | モニタリングモードで，コマンド，またはステートメントを一つずつ実行し，一つ実行するごとに一時停止します。
［モニタリングの実行］－［連続ステップ実行］ | モニタリングモードで，コマンド，またはステートメントを一つずつ実行し，［連続ステップ実行の一時停止］が選択された時点で一時停止します。
［モニタリングの実行］－［連続ステップ実行の一時停止］ | 連続ステップ実行を一時停止します。
［実行］ | スクリプトファイルを最後まで実行します。
［モニタリングの中止］ | モニタリングモードでの実行を中止します。
［ブレークポイントの設定／解除］ | ブレークポイントを設定，または解除します。
［ブレークポイントをすべて解除］ | 設定されているブレークポイントをすべて解除します。
［設定］ | モニタリング実行時の環境を設定します。
［ウォッチへ変数の追加］ | 指定した変数をウォッチウィンドウへ追加します。
［実行環境の設定］ | スクリプトファイルの環境を設定します。
［実行ポイント行へジャンプ］ | モニタリングモードで現在実行している行を表示します。
［表示］ | ［ツールバー］－［標準ツールバー］ | 標準ツールバーの表示・非表示を切り替えます。
［ツールバー］－［編集ツールバー］ | 編集ツールバーの表示・非表示を切り替えます。
［ツールバー］－［モニタリングツールバー］ | モニタリングツールバーの表示・非表示を切り替えます。
［ツールバー］－［検索ツールバー］ | 検索ツールバーの表示・非表示を切り替えます。
［ステータスバー］ | ステータスバーの表示・非表示を切り替えます。
［ツールバーの整列］ | ツールバーを整列させます。
［ルーラー］ | ルーラーの表示・非表示を切り替えます。
［縦スクロールバー］ | 縦スクロールバーの表示・非表示を切り替えます。
［横スクロールバー］ | 横スクロールバーの表示・非表示を切り替えます。
［行番号を表示］ | 行番号の表示・非表示を切り替えます。
［ファイルの先頭を表示］ | スクリプトファイルの先頭を表示します。
［ファイルの末尾を表示］ | スクリプトファイルの末尾を表示します。
［ウォッチウィンドウを表示］ | ウォッチウィンドウの表示・非表示を切り替えます。
［検索］ | ［検索］ | 検索，または置換する文字列，および方法を入力します。
［置換］ | 検索文字列を，指定した文字列に置換します。
［前検索］ | 検索文字列を上に向かって検索，または置換します。
［次検索］ | 検索文字列を下に向かって検索，または置換します。
［ヘルプ］ | ［目次］ | JP1/Scriptオンラインヘルプの目次を表示します。
［キーワードで検索］ | JP1/Scriptオンラインヘルプのキーワード一覧を表示します。
［ヘルプの使い方］ | オンラインヘルプの使い方を表示します。
［バージョン情報］ | エディタのバージョン情報を表示します。

(b)　ポップアップメニュー

Scriptエディタウィンドウのクライアントエリアでマウスの右ボタンをクリックすると，ポップアップメニューが表示されます。ポップアップメニューの内容は編集モードの場合とモニタリングモードの場合とで異なります。編集モードの場合に表示されるポップアップメニューを表3-7に，モニタリングモードの場合に表示されるポップアップメニューを表3-8に示します。

表3-7　ポップアップメニュー一覧（編集モード）

ポップアップメニュー | 機能概要
［新規作成］ | スクリプトファイルを新規に作成します。
［開く］ | 既存のスクリプトファイルを開きます。
［保存］ | スクリプトファイルを上書き保存します。
［元に戻す］ | 編集する直前の状態に戻します。
［やり直し］ | 直前の操作をやり直します。
［切り抜き］ | 選択した文字列をクリップボードに切り抜きます。
［コピー］ | 選択した文字列をクリップボードにコピーします。
［貼り付け］ | クリップボードの文字列を指定の位置に貼り付けます。
［すべて選択］ | 記述されている文字列をすべて選択します。
［コメント設定］ | 選択した行をコメント行に設定します。
［コメント解除］ | 選択したコメント行のコメント属性を解除します。
［簡易入力］ | 簡易入力機能を使って，コマンド，またはステートメントを入力します。
［メニューエディタ］ | メニューエディタを起動します。

表3-8　ポップアップメニュー一覧（モニタリングモード）

ポップアップメニュー | 機能概要
［コピー］ | 選択した文字列をクリップボードにコピーします。
［ブレークポイントの設定／解除］ | ブレークポイントを設定，または解除します。
［ウォッチへ追加］ | 選択した変数をウォッチウィンドウへ追加します。

(3)　エラーウィンドウ

モニタリング実行で発生したエラーを表示します。

(a)　クライアントエリア

種類

エラーの種類を表示します。この欄をダブルクリックすると，該当するエラーの個所にカーソルが移動します。

行

エラー発生個所の行を表示します。

列

エラー発生個所の列を表示します。

コマンド名

エラーの発生したコマンドを表示します。

内容

エラーの内容を表示します。

(b)　エラーウィンドウの操作

エラーウィンドウ上でマウスの右ボタンをシングルクリックすると，次のポップアップメニューが表示されます。

ジャンプ
選択した行／列位置へジャンプします。

(4)　ウォッチウィンドウ

モニタリング実行時に変数名とその変数の値を表示します。

ウォッチウィンドウへの変数の追加方法は「3.2.12　ウォッチへ変数を追加する」を参照してください。

(a)　クライアントエリア

変数名

変数名が表示されます。

値

変数名の値が表示されます。ただし，変数名が無効のときは「Error:Invalid Data」と表示されます。また，配列変数では次のような場合は値を参照できないため，「Error:Invalid Data」と表示されます。

インデックス番号が指定されていない。

指定したインデックス番号が有効な範囲にない。

指定した配列変数の次元が異なる。

(b)　ウォッチウィンドウの操作

ウォッチウィンドウ上でマウスの右ボタンをシングルクリックすると，次のポップアップメニューが表示されます。

値の更新
選択した変数名の値を更新します。

変数名の削除
選択した変数名を削除します。

3.2.2　Scriptエディタウィンドウでのマウスとキーの操作

＜この項の構成＞

(1)　マウス操作

(2)　キー操作

(1)　マウス操作

Scriptエディタウィンドウのクライアントエリアでのマウス操作を表3-9に示します。

表3-9　Scriptエディタウィンドウでのマウス操作

操作 | 処理
クリック | それまでの選択を解除して，新たに対象を選択する。
ダブルクリック | 文字列を選択する。
右ボタンシングルクリック | ポップアップメニューを表示する。

(2)　キー操作

Scriptエディタウィンドウのクライアントエリアでのキー操作と，モードごとの操作の可否を表3-10に示します。

表3-10　Scriptエディタウィンドウでのキー操作

操作 | 編集モード | モニタリングモード | 処理
Ctrl+A | ○ | ○ | 記述されているすべての文字列を選択する。
Ctrl+C | ○ | ○ | 選択された文字列をコピーする。
Ctrl+E | ○ | × | メニューエディタを起動する。
Ctrl+F | ○ | △ | 検索，置換する情報を入力する。
Ctrl+H | ○ | × | 検索文字列を指定した文字列に置換する。
Ctrl+K | ○ | × | コマンド，またはステートメントを簡易入力する。
Ctrl+M | ○ | × | 選択された行をコメント行にする。
Ctrl+N | ○ | × | スクリプトファイルを新規に作成する。
Ctrl+O | ○ | × | スクリプトファイルを開く。
Ctrl+P | ○ | × | スクリプトファイルを印刷する。
Ctrl+S | ○ | × | スクリプトファイルを保存する。
Ctrl+T | ○ | × | モニタリング実行時の動作環境を設定する。
Ctrl+V | ○ | × | クリップボードの内容を貼り付ける。
Ctrl+X | ○ | × | 選択された文字列を切り抜く。
Ctrl+Z | ○ | × | 編集される直前の状態に戻す。
Ctrl+F5 | ○ | × | スクリプトファイルを実行する。
Ctrl+F11 | ○ | ○ | 連続ステップ実行を開始する。
Ctrl+Home | ○ | ○ | スクリプトファイルの先頭を表示する。
Ctrl+End | ○ | ○ | スクリプトファイルの末尾を表示する。
F1 | ○ | ○ | Scriptヘルプを表示する。※
F3 | ○ | △ | 検索文字列を下に向かって検索，置換する。
F5 | ○ | ○ | ブレークポイントまで実行をスタート，またはリスタートさせる。
F7 | ○ | × | 文法チェックを行う。
F9 | ○ | ○ | ブレークポイントを設定，または解除する。
F11 | ○ | ○ | 次のコマンド，またはステートメントを一つずつ実行する。
Alt+0 | × | ○ | ウォッチウィンドウへ指定された変数を追加する。
Alt+1 | × | ○ | ウォッチウィンドウの表示，非表示を切り替える。
Alt+F4 | ○ | ○ | Scriptエディタを終了する。
Shift+F3 | ○ | △ | 検索文字列を上に向かって検索，置換する。
Shift+F5 | × | ○ | モニタリング実行を中止する。
Shift+F9 | ○ | ○ | 指定ブレークポイントをすべて解除する。
Shift+Ctrl+M | ○ | × | 選択された行のコメント化を解除する。
Shift+Ctrl+Z | ○ | × | 直前に行った操作をやり直す。
Shift+Ctrl +F11 | × | ○ | 連続ステップ実行を一時停止する。
Shift+Ctrl+Enter | ○ | × | スクリプトファイルの環境を設定する。

（凡例）

○：操作できる機能

△：一部操作できる機能

×：操作できない機能

注※　カーソルがコマンド，またはステートメントの位置にある状態でF1キーを押すと，そのコマンド，またはステートメントのヘルプが表示されます。

3.2.3　コメント行を設定・解除する

コメント行を設定，または解除します。

操作

コメント行を設定する

コメントにしたい行にカーソルを移動させる。

［編集］－［コメント設定］メニューを選択する。
カーソルのある行がコメント行になります。

コメント行を解除する

コメント行の設定を解除したい行にカーソルを移動させる。

［編集］－［コメント解除］メニューを選択する。
カーソルのある行がコメント行の設定から解除されます。

複数行を選択して操作すると，選択した行すべてに対してコメント行が設定，または解除されます。

モニタリングモードの場合は，メニューがグレーアウトされて［編集］－［コメント設定］，および［コメント解除］メニューは選択できません。

3.2.4　簡易入力機能を使う

スクリプトを記述する際の，コマンドやステートメントの入力作業を，簡易入力機能を使って行います。

この機能を使うことで，コマンドの知識がなくても手軽に間違いなく入力できます。

記述したコマンドやステートメントの内容は，［エディタへ］ボタンでエディタに貼り付けます。

操作

［編集］－［簡易入力］メニューを選択して，簡易入力を起動する。
［Script簡易入力］ダイアログが表示されます。

ダイアログの設定方法については，「3.3　簡易入力の操作」を参照してください。

［オプション］ボタンをクリックして，［簡易入力オプション（全般）］ダイアログでスクリプトファイルの作成バージョンを設定する。

ダイアログの設定方法については，「3.3.3　JP1/Scriptの対象バージョンを指定する」を参照してください。

［編集］タブをクリックして，［簡易入力オプション（編集）］ダイアログでエディタへの出力形式を設定する。

ダイアログの設定方法については，「3.3.4　1行の最大文字数やインデントの桁数を指定する」を参照してください。

［OK］ボタンをクリックする。
スクリプトファイルの作成バージョン，およびエディタへの出力形式が設定され，［Script簡易入力］ダイアログに戻ります。

使用するコマンド，またはステートメントを検索し，選択する。
該当するコマンド，またはステートメントにフォーカスが移動します（ここでは，「CalcTime」を選択）。

［表示］ボタンをクリックするか，コマンド，またはステートメントをダブルクリックする。
「引数の指定/ステートメントの構文」に，選択したコマンドの引数を入力する項目が表示されます。
ステートメントの場合は，ステートメントの構文が表示されます。

コマンドの引数の項目を入力する。

［エディタへ］ボタンをクリックする。
「引数の指定/ステートメントの構文」の内容がエディタに貼り付けられます。

「検索するコマンド/ステートメント」の一覧（リストボックス）で，コマンド名，またはステートメント名を選択し，マウスの右ボタンをクリックすると，選択されたコマンド，またはステートメントのヘルプが表示されます。

操作5.で引数がないコマンドの場合は，「引数の指定/ステートメントの構文」に「このコマンドに引数はありません。」というメッセージが表示されます。

3.2.5　メニューフォームを作成する

メニューフォームを作成します。

操作

［編集］－［メニューエディタ］メニューを選択する。
Scriptメニューエディタウィンドウが表示されます。
メニューフォームが作成されていない場合は，Scriptメニューエディタウィンドウの手前に，［メニューフォーム名の指定］ダイアログが表示されます。なお，画面左下にはコマンドプロパティダイアログボックスが表示されます。

メニューフォームが作成されている場合は，操作3.に進んでください。

メニューフォーム名を入力する。
フォームビューに新しいメニューフォームが表示されます。操作4.に進んでください。

［編集］－［メニューフォームの新規作成］メニューを選択する。
フォームビューに新しいメニューフォームが表示されます。

メニューフォームを作成する。
作成方法については，「3.6.3　新しいメニューフォームを作成する」を参照してください。

メニューエディタを終了する。

エディタがモニタリングモードになっている場合は，［編集］－［メニューエディタ］メニューはグレーアウトされて選択できません。

3.2.6　エディタの動作環境を設定する

エディタの動作環境を設定します。

操作

［編集］－［オプション］メニューを選択する。
［オプション（書式）］ダイアログが表示されます。

ダイアログの設定方法については「4.2.2　オプション（書式）ダイアログ」を参照してください。

書式に関する情報を設定する。

［色］タブをクリックする。
［オプション（色）］ダイアログが表示されます。

表示色に関する情報を設定する。
すべての項目の表示色をデフォルトに戻すには［すべてリセット］を選択してください。
ダイアログの設定方法については「4.2.3　オプション（色）ダイアログ」を参照してください。

［互換性］タブをクリックする。
［オプション（互換性）］ダイアログが表示されます。

ファイルバージョンの有無をチェックするかどうかを設定する。
ダイアログの設定方法については「4.2.4　オプション（互換性）ダイアログ」を参照してください。

［OK］ボタンをクリックする。
エディタの動作環境が設定され，ダイアログが閉じます。

3.2.7　スクリプトファイルの文法をチェックする

スクリプトファイルの文法をチェックします。

操作

［モニタリング］－［文法チェック］メニューを選択する。
エディタがモニタリングモードになり，文法チェックが開始されます。
文法チェック時は一瞬，暗くなります。

（文法チェック中の表示）

（文法チェック終了の表示）
文法エラーがある場合はエラーウィンドウにエラー内容が表示されます。

エラーウィンドウの内容を確認する。

モニタリングモードのときは，メニューがグレーアウトされて［モニタリング］－［文法チェック］は選択できません。

ファイル名のないスクリプトファイルに対して文法チェックを実行しようとすると，ファイル名を付けて保存するためのダイアログが表示されます。ファイル名を付けて保存しないと，文法チェックは実行できません。

スクリプトファイルの内容が更新されている場合は，更新された内容で文法チェックを実行しますが，ファイルへの保存は行いません。

3.2.8　モニタリングを実行・中止する

スクリプトファイルの動作を確認しながら実行することをモニタリングといいます。

モニタリングの方法には，次の3種類があります。

メニュー | 機能
実行 | ブレークポイントまで実行，またはリスタートします。
ステップ実行 | コマンド，またはステートメントを一つずつ実行します。
連続ステップ実行 | コマンド，またはステートメントを一つずつ実行し，［連続ステップ実行の一時停止］が選択された時点で一時停止します。

操作

「実行」の場合

［モニタリング］－［モニタリングの実行］－［実行］，またはツールバーの［ブレークポイントまで実行］ボタンを選択する。
Scriptエディタがモニタリングモードになり，モニタリングが始まります。次に実行される行の左側には，実行する位置を示す記号（[図データ]）が表示されます。コメント行やスペース行は無視されます。
ブレークポイント（[図データ]）の指定されている行まで実行されると，実行が一時的に停止されます。

ブレークポイントのダイアログの設定方法については，「3.2.10　モニタリング実行時のブレークポイントを設定・解除する」を参照してください。

モニタリングを中止したい場合は，［モニタリング］－［モニタリングの中止］メニュー，またはツールバーの［モニタリングの中止］ボタンを選択する。
メニューを選択した時点で，モニタリングが中止され，エディタは編集モードに戻ります。

「ステップ実行」の場合

［モニタリング］－［モニタリングの実行］－［ステップ実行］，またはツールバーの［ステップ実行］ボタンを選択する。
エディタがモニタリングモードになり，モニタリングが始まります。次に実行される行の左側には，実行する位置を示す記号（[図データ]）が表示されます。コメント行やスペース行は無視されます。

モニタリングを中止したい場合は，［モニタリング］－［モニタリングの中止］メニュー，またはツールバーの［モニタリングの中止］ボタンを選択する。
メニューを選択した時点で，モニタリングが中止され，エディタは編集モードに戻ります。

「連続ステップ実行」の場合

［モニタリング］－［モニタリングの実行］－［連続ステップ実行］，またはツールバーの［連続ステップ実行］ボタンを選択する。
エディタがモニタリングモードになり，モニタリングが始まります。次に実行される行の左側には，実行する位置を示す記号（[図データ]）が表示されます。コメント行やスペース行は無視されます。

モニタリングを一時停止したいところで［モニタリング］－［モニタリングの実行］－［連続ステップ実行の一時停止］メニュー，またはツールバーの［連続ステップ実行の一時停止］ボタンを選択する。
メニューを選択した時点で，モニタリングが一時停止されます。

モニタリングを中止したい場合は，［モニタリング］－［モニタリングの中止］メニュー，またはツールバーの［モニタリングの中止］ボタンを選択する。
メニューを選択した時点で，モニタリングが中止され，エディタは編集モードに戻ります。

無限ループになるスクリプトファイルの連続ステップ実行中に，［モニタリング］－［モニタリングの実行］－［連続ステップ実行の一時停止］メニューを選択しても，連続ステップ実行は一時停止されません。このような場合は，［モニタリング］－［モニタリングの中止］メニューを選択してステップ実行を中止してください。

モニタリングで検出された解析エラーや実行エラーは，エラーウィンドウに表示されます。また，ウォッチウィンドウに追加されている変数の値は，実行中に逐一更新されて，表示されます。

（エラーウィンドウの例）

ウォッチウィンドウを表示したい場合は，モニタリング実行中に［表示］－［ウォッチウィンドウを表示］メニューをチェックしてください。このメニューは，モニタリング実行中にしかチェックできません。

（ウォッチウィンドウの例）

ファイル名のないスクリプトファイルに対してモニタリングを実行しようとすると，ファイル名を付けて保存するためのダイアログが表示されます。ファイル名を付けて保存しないと，モニタリングは実行できません。

スクリプトファイルの内容が更新されている場合は，更新された内容でモニタリングを実行しますが，ファイルへの保存は行いません。

On Error Gotoステートメントを指定しているスクリプトファイルに対して，モニタリングを実行しないでください。

3.2.9　スクリプトを実行する

スクリプトファイルを最後まで実行します。モニタリングではなく，通常のスクリプト実行です。

操作

［モニタリング］－［実行］を選択する。
スクリプトの実行が始まります。モニタリングではないので，次に実行される行を示す（[図データ]）は表示されません。
スクリプトの最後の行まで実行すると，実行が終了します。

モニタリングではないので，［表示］－［ウォッチウィンドウ］メニューがチェックされていても，実行中にウォッチウィンドウは表示されません。

3.2.10　モニタリング実行時のブレークポイントを設定・解除する

モニタリングの実行時に，一時的に実行を停止させる位置を設定，または解除します。

操作

ブレークポイントを設定する

ブレークポイントを設定したい行にカーソルを移動させる。

［モニタリング］－［ブレークポイントの設定］メニューを選択する。
カーソルのある行にブレークポイントが設定されます。ブレークポイントは，行の左側に[図データ]で表示されます。

一部のブレークポイントを解除する

ブレークポイントを解除したい行にカーソルを移動させる。

［モニタリング］－［ブレークポイントの解除］メニューを選択する。
カーソルのある行のブレークポイントが解除されます。

すべてのブレークポイントを解除する

［モニタリング］－［ブレークポイントをすべて解除］メニューを選択する。

表示されているスクリプトファイルのブレークポイントがすべて解除されます。

編集モードの場合は，任意の行にブレークポイントを設定できます。モニタリングモードの場合，ブレークポイントを設定できるのは，実行対象となっているコマンド，またはステートメント単位に限られます。

コメント行やスペース行にブレークポイントが設定されている場合は，エディタが自動的に下方向に適切な位置を検索して，そこにブレークポイントを設定します。適切な位置が見つからなかった場合，ブレークポイントは設定されないで，スクリプトファイルの先頭行で実行が一時的に停止されます。

3.2.11　モニタリング実行時の動作環境を設定する

モニタリング実行時の動作環境を設定します。

操作

［モニタリング］－［設定］メニューを選択する。
［設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.2.5　設定ダイアログ」を参照してください。

必要な情報を入力する。
モニタリング実行時に必要な情報を設定します。

［OK］ボタンを選択する。
モニタリング時の動作環境が設定され，ダイアログが閉じます。

3.2.12　ウォッチへ変数を追加する

ウォッチウィンドウに指定した変数を追加します。

操作

モニタリングモードで，［モニタリング］－［ウォッチへ変数の追加］メニューを選択する。
［変数の追加］ダイアログが表示されます。

ダイアログの設定方法について，「4.2.10　変数の追加ダイアログ」を参照してください。

追加したい変数の名前を入力する。
入力できるのは半角で99文字までです。これを超えた変数名を入力することはできません。

［追加］ボタンを選択する。
入力した変数の名前がウォッチウィンドウに追加されます。

モニタリングモードで，Scriptエディタウィンドウのクライアントエリアで文字列を選択してから［モニタリング］－［ウォッチへ変数の追加］メニューを選択すると，選択した文字列が「変数名」に表示されます。

［キャンセル］ボタンを選択すると，変数を追加しないで［変数の追加］ダイアログが閉じられます。

追加した変数をウォッチウィンドウから削除する場合は，変数名を右クリックし，［変数名の削除］メニューを選択します。

3.2.13　スクリプトの実行環境を設定する

作成されているスクリプトファイルの実行環境を設定します。このほかに，Scriptマネージャウィンドウで操作する方法もあります。

複数のスクリプトファイルの実行環境を同時に設定する場合は，Scriptマネージャウィンドウで操作してください。Scriptマネージャウィンドウの操作方法については，「3.1.12　スクリプトの実行環境（すべての項目）を設定する」を参照してください。

操作

実行環境を設定するスクリプトファイルを表示する。

［モニタリング］－［実行環境の設定］メニューを選択する。
［実行環境の設定（起動情報）］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.8　実行環境の設定（起動情報）ダイアログ」を参照してください。

必要な起動情報を設定する。
実行時にパラメタが必要な場合，および解析トレース，実行トレースの出力形式などを設定する場合は，コマンドラインでの指定が必要です。
コマンドラインでの指定については，「6.2　コマンドラインに関する規則」を参照してください。

［終了情報］タブをクリックする。
［実行環境の設定（終了情報）］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.9　実行環境の設定（終了情報）ダイアログ」を参照してください。

打ち切り時間を設定する。
打ち切り時間による強制終了をしない場合は，打ち切り時間が「0」になっていることを確認してください。

［トレース情報］タブをクリックする。
［実行環境の設定（トレース情報）］ダイアログが表示されます。

ダイアログの設定方法については，「4.1.10　実行環境の設定（トレース情報）ダイアログ」を参照してください。

必要なトレース情報を設定する。
トレースファイルの出力行数などを特に指定する必要がない場合は，このダイアログでの操作は必要ありません。

［OK］ボタンをクリックする。
実行環境が設定され，ダイアログが閉じます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でスクリプトの実行環境を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

3.2.14　文字列を検索する

スクリプトファイル中の文字列を検索します。

操作

検索するスクリプトファイルを表示する。

［検索］－［検索］メニューを選択する。
［検索］ダイアログが表示されます。

ダイアログの設定方法については，「4.2.6　検索ダイアログ」を参照してください。

［置換する］がチェックされていないことを確認する。
［置換する］がチェックされている場合は，チェックを外してください。

［検索］に検索文字列を指定する。また，必要に応じて［大文字／小文字の区別］，および［単語の検索］をチェックする。

［前検索］ボタン，または［次検索］ボタンを選択する。
検索文字列が検索されます。検索文字列がない場合は，ビープ音が鳴ります。

検索を終了する場合は，［キャンセル］ボタンを選択する。
［検索］ダイアログが閉じられます。

3.2.15　文字列を置換する

スクリプトファイル中の文字列を置換します。

操作

置換するスクリプトファイルを表示する。

［検索］－［置換］メニューを選択する。
［検索］ダイアログが表示されます。

ダイアログの設定方法については，「4.2.6　検索ダイアログ」を参照してください。

［置換する］がチェックされていることを確認する。
［置換する］がチェックされていない場合は，チェックしてください。

［検索］に置換前の文字列を指定する。また，必要に応じて［大文字／小文字の区別］，および［単語の検索］をチェックする。

［置換］に置換後の文字列を指定する。

［前検索］ボタン，または［次検索］ボタンを選択する。
指定した内容で置換が始まります。置換すべき文字列がない場合は，ビープ音が鳴ります。

置換を終了する場合は，［キャンセル］ボタンを選択する。
［検索］ダイアログが閉じられます。

3.3　簡易入力の操作

コマンドやステートメントの入力作業を簡略化して入力できます。この機能を使うことで，コマンドの知識がなくても手軽に間違いなく入力できます。また，記述したコマンドやステートメントの内容は，クリップボードに貼り付けられます。

＜この節の構成＞

3.3.1　簡易入力の操作項目

3.3.2　コマンドやステートメントを入力する

3.3.3　JP1/Scriptの対象バージョンを指定する

3.3.4　1行の最大文字数やインデントの桁数を指定する

3.3.1　簡易入力の操作項目

簡易入力アイコンを起動する，エディタの［編集］－［簡易入力］を選択する，またはマネージャの［ツール］－［簡易入力の起動］を選択すると，［Script簡易入力］ダイアログが表示されます。

［Script簡易入力］ダイアログを，図3-3に示します。

図3-3　［Script簡易入力］ダイアログ

(a)　処理対象バージョン

現在指定されているスクリプトエンジンのバージョンが表示されます。「検索するコマンド/ステートメント」の一覧（リストボックス）には，指定されているスクリプトエンジンのバージョンに対応する，コマンド，およびステートメントが表示されます。

(b)　検索するコマンド/ステートメント

一覧（リストボックス）には，指定されているスクリプトエンジンのバージョンに対応する，コマンド，およびステートメントが表示されます。選択したいコマンド，およびステートメントが表示されていない場合は，コマンド名，ステートメント名，またはコマンド名，ステートメント名の一部を入力して検索してください。

(c)　説明

「検索するコマンド/ステートメント」で選択されたコマンド，またはステートメントの簡単な説明が表示されます。

(d)　対象OS

現在選択しているコマンド，またはステートメントをサポートしているOSが表示されます。

(e)　引数の指定/ステートメントの構文

「検索するコマンド/ステートメント」で選択されたコマンドの引数を入力する項目が表示されます。ステートメントの場合は，ステートメントの構文が表示されます。

［Script簡易入力］ダイアログには，次のボタンが表示されます。

［表示］ボタン

「引数の指定/ステートメントの構文」に，選択されたコマンドの引数を入力する項目，またはステートメントの構文が表示されます。ただし，選択されたコマンドの引数がない場合は，「このコマンドには引数はありません。」が表示されます。

［クリップボードへ］ボタン（または［エディタへ］ボタン）

簡易入力をエディタから起動した場合は［エディタへ］，マネージャ，またはWindowsの［スタート］メニューから起動した場合は［クリップボードへ］と表示されます。

「引数の指定/ステートメントの構文」に表示された内容が，エディタ，またはクリップボードに貼り付けられます。

［オプション］ボタン

［簡易入力オプション（全般情報）設定］ダイアログが表示されます。ダイアログの設定方法については，「3.3.3　JP1/Scriptの対象バージョンを指定する」を参照してください。

［終了］ボタン

［Script簡易入力］ダイアログを閉じます。

3.3.2　コマンドやステートメントを入力する

スクリプトを記述する際の，コマンドやステートメントの入力作業を，このダイアログで行います。ここでは，CalcDateの表示例を示します。

＜この項の構成＞

(1)　操作

(1)　操作

［表示］ボタンを選択すると，「引数の指定/ステートメントの構文」に，選択されたコマンドの引数を入力する項目，またはステートメントの構文が表示されます。ただし，引数がないコマンドの場合は，「このコマンドに引数はありません。」が表示されます。

必要に応じてコマンドの引数を入力します。

［クリップボードへ］ボタンを選択すると，「引数の指定/ステートメントの構文」に表示された内容が，クリップボードに貼り付けられます。

［終了］ボタンを選択すると，［Script簡易入力］ダイアログを閉じます。

3.3.3　JP1/Scriptの対象バージョンを指定する

［Script簡易入力］ダイアログで［オプション］ボタンを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「全般」「編集」の二つのタブがあります。

「全般」タブを選択すると，［オプション（全般）］ダイアログが表示されます。

＜この項の構成＞

(1)　項目

(2)　操作

(1)　項目

対象バージョン

スクリプトファイルをJP1/Scriptのどのバージョンで作成するかを指定します。

デフォルトではインストールしたJP1/Scriptのバージョンが設定されています。

(2)　操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

3.3.4　1行の最大文字数やインデントの桁数を指定する

［Script簡易入力］ダイアログで［オプション］ボタンを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「全般」「編集」の二つのタブがあります。

「編集」タブを選択すると，［オプション（編集）］ダイアログが表示されます。

＜この項の構成＞

(1)　項目

(2)　操作

(1)　項目

1桁の最大桁数

Scriptエディタ，またはクリップボードに貼り付ける編集内容の1行の最大数を指定します。

64～999の範囲で指定してください。デフォルトでは「80」が設定されています。

インデント桁数

クリップボードに貼り付ける編集内容のインデントの値を指定します。

0～16の範囲で指定してください。デフォルトでは「4」が設定されています。

必須項目をチェックする

コマンドの必ず入力しなければならない引数の項目に，正しくデータが入力されているかどうかをチェックします。

デフォルトではチェックされていません。

(2)　操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

3.4　トレースビューアの操作

トレースビューアは，マネージャで作成したスクリプトの実行状態，およびトレース情報を表示するためのプログラムです。スクリプトの実行状態，およびトレース情報は，トレースファイルに出力されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でトレースビューアを起動しようとすると，次の警告ダイアログを表示した後，トレースビューアの起動を中止します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この節の構成＞

3.4.1　Scriptトレースビューアウィンドウとメニュー

3.4.2　Scriptトレースビューアウィンドウでのマウスとキーの操作

3.4.3　トレースビューアの起動と終了

3.4.4　Scriptトレースビューアウィンドウでの操作

3.4.5　トレースファイルの表示・非表示を切り替える

3.4.6　トレースファイルの内容を表示する

3.4.7　トレースファイルを別名で保存する

3.4.8　トレースファイルを削除する

3.4.9　トレースファイルをクリアする

3.4.10　トレースファイルを印刷する

3.4.11　トレースファイルの内容を検索する

3.4.1　Scriptトレースビューアウィンドウとメニュー

トレースビューアを起動すると表示されるScriptトレースビューアウィンドウ，およびトレースビューアのメニューの種類について説明します。また，トレースファイルを開いたときに表示されるウィンドウ，およびメニューの種類についても説明します。

＜この項の構成＞

(1)　 Scriptトレースビューアウィンドウ

(2)　 Scriptトレースビューアウィンドウのメニュー

(1)　 Scriptトレースビューアウィンドウ

Scriptトレースビューアウィンドウ，およびウィンドウの各部の名称を，図3-4に示します。

図3-4　Scriptトレースビューアウィンドウ

(a)　ツールバー

ツールバーには，メニューバーから選択できるコマンドの中から，頻繁に使用するコマンドだけをボタンの形で表示します。ボタンをマウスでクリックするだけで，該当するコマンドを実行できます。オプションメニューによって非表示にすることもできます。

Scriptトレースビューアウィンドウのツールバーには，次のコマンドのボタンが表示されます。

［保存］ボタン

トレースファイルを別名で保存します。

［表示］ボタン

トレースファイルの内容を表示します。

［削除］ボタン

トレースファイルを削除します。

［印刷］ボタン

トレースファイルを印刷します。

［終了］ボタン

トレースビューアを終了します。

［クリア］ボタン

トレースファイルを空（ファイルサイズ0）にします。

［すべて選択］ボタン

すべての項目を選択します。

［解析トレース］ボタン

解析トレース一覧の表示・非表示を切り替えます。

［実行トレース］ボタン

実行トレース一覧の表示・非表示を切り替えます。

［ユーザトレース］ボタン

ユーザトレース一覧の表示・非表示を切り替えます。

［サーバトレース］ボタン

サーバトレース一覧の表示・非表示を切り替えます。

［最新］ボタン

表示しているトレースファイルの情報を最新の情報に更新します。

［コンピュータの選択］ボタン

表示するトレースファイルの接続先コンピュータ名を設定します。

［ヘルプ］ボタン

JP1/Scriptのオンラインヘルプを表示します。

(b)　ステータスバー

ステータスバーは，トレースビューアが現在実行している処理に関するメッセージや，処理終了後の状態に関するメッセージを表示するための領域です。

(c)　クライアントエリア

ここには，トレースファイル情報（種別，ファイル名，行数，更新日時，格納先フォルダ）が表示されます。トレースファイル情報の左端には，各トレースファイルの実行状態がアイコンで表示されます。表示されるアイコンは，複数起動を許可されているスクリプトの場合と，複数起動を許可されていないスクリプトの場合とで異なります。各アイコンの見方を次に示します。

表3-11　複数起動を許可されているスクリプトの場合

表示※
実行状態
意味

[図データ]
（白，黄緑）
実行中
一つ以上のスクリプトが実行中であることを表します。

[図データ]
（白，青）
正常終了（一部終了）
一つ以上のスクリプトが正常に終了したことを表します。

[図データ]
（白，赤）
システムエラー（一部終了）
一つ以上のスクリプトのコマンド実行中にエラーが発生し，スクリプトの実行を中断したことを表します。

[図データ]
（白，黄）
ユーザエラー（一部終了）
一つ以上のスクリプトでAlertコマンド，またはExitWindowsコマンドを実行したこと，または強制的に終了されたことを表します（Alertコマンド実行後にシステムエラーになる場合もあります）。

[図データ]
（水色，青）
正常終了（すべて終了）
すべてのスクリプトが正常に終了したことを表します。

[図データ]
（水色，黒）
未実行（すべて終了）
すべてのスクリプトが1回も実行されていないことを表します（構文解析などのエラーでコマンドが実行されなかった場合などに表示されます）。

[図データ]
（水色，赤）
システムエラー（すべて終了）
すべてのスクリプトが終了しましたが，一つ以上のスクリプトでコマンド実行中にエラーが発生し，スクリプト実行を中断したことを表します。

[図データ]
（水色，黄）
ユーザエラー（すべて終了）
すべてのスクリプトが終了しましたが，一つ以上のスクリプトでAlertコマンド，またはExitWindowsコマンドを実行したこと，または強制的に終了されたことを表します（Alertコマンド実行後にシステムエラーになる場合もあります）。

注※　表示欄の括弧内はアイコンの丸印の色を表します。

表3-12　複数起動を許可されていないスクリプトの場合

表示※
実行状態
意味

[図データ]　
管理対象外
実行状態を管理しないファイル（解析トレース，ユーザトレース）であることを表します。

[図データ]
（黒）
未実行
スクリプトが1回も実行されていないことを表します。

[図データ]
（黄緑）
実行中
スクリプトが実行中であることを表します。

[図データ]
（青）
正常終了
スクリプトが正常に終了したことを表します。

[図データ]
（赤）
異常終了（システムエラー）
スクリプトのコマンド実行中にエラーが発生し，スクリプトの実行を中断したことを表します。

[図データ]
（黄）
異常終了（ユーザエラー）
Alertコマンド，またはExitWindowsコマンドを実行したこと，または強制的に終了されたことを表します（Alertコマンド実行後にシステムエラーになる場合もあります）。

注※　表示欄の括弧内はアイコンの丸印の色を表します。

(2)　 Scriptトレースビューアウィンドウのメニュー

トレースビューアの機能をメニューごとに説明します。トレースビューアのメニュー一覧を表3-13に示します。

表3-13　トレースビューアのメニュー一覧

メニュー | コマンド（機能） | 機能概要
［ファイル］ | ［名前を付けて保存］ | 選択されているトレースファイルに別の名前を付けて保存します。
［トレースファイルの表示］ | 選択されているトレースファイルの内容を表示します。
［トレースファイルの削除］ | 選択されているトレースファイルを削除します。
［印刷］ | 選択されているトレースファイルの内容を印刷します。
［トレースビューアの終了］ | トレースビューアを終了します。
［編集］ | ［トレースファイルのクリア］ | トレースファイルを空（ファイルサイズ0）にします。
［すべて選択］ | すべての項目を選択します。
［表示］ | ［ツールバー］ | ツールバーの表示・非表示を切り替えます。
［ステータスバー］ | ステータスバーの表示・非表示を切り替えます。
［未使用時に最小化］ | 未使用のとき，最小化します。
［解析トレース］ | 解析トレース一覧の表示・非表示を切り替えます。
［実行トレース］ | 実行トレース一覧の表示・非表示を切り替えます。
［ユーザトレース］ | ユーザトレース一覧の表示・非表示を切り替えます。
［サーバトレース］ | サーバトレース一覧の表示・非表示を切り替えます。
［最新の情報に更新］ | トレースファイルの情報を最新の情報に更新します。
［オプション］ | ［コンピュータの選択］ | 表示するトレースファイルの接続先コンピュータ名を設定します。
［ヘルプ］ | ［目次］ | JP1/Scriptオンラインヘルプの目次を表示します。
［キーワードで検索］ | JP1/Scriptオンラインヘルプのキーワード一覧を表示します。
［ヘルプの使い方］ | オンラインヘルプの使い方を表示します。
［バージョン情報］ | トレースビューアのバージョン情報を表示します。

3.4.2　Scriptトレースビューアウィンドウでのマウスとキーの操作

Scriptトレースビューアウィンドウでのマウス操作とキーの操作について説明します。

＜この項の構成＞

(1)　マウス操作

(2)　キー操作

(1)　マウス操作

Scriptトレースビューアウィンドウのクライアントエリアでのマウス操作を表3-14に示します。

表3-14　Scriptトレースビューアウィンドウでのマウス操作

操作 | 処理
クリック | それまでの選択を解除して，新たに対象を選択する。
ダブルクリック | トレースファイルの内容表示ウィンドウを表示する。

(2)　キー操作

Scriptトレースビューアウィンドウのクライアントエリアでのキー操作を表3-15に示します。

表3-15　Scriptトレースビューアウィンドウでのキー操作

操作 | 処理
Ctrl + A | すべてのトレースファイルを選択する。
Ctrl + P | トレースファイルを印刷する。
Del | トレースファイルを削除する。
Enter | トレースファイルの内容表示ウィンドウを表示する。

3.4.3　トレースビューアの起動と終了

＜この項の構成＞

(1)　トレースビューアを起動する

(2)　トレースビューアを終了する

(1)　トレースビューアを起動する

スクリプトファイルの実行時に出力されるトレースは，トレースファイルに出力されます。トレースの状態を知りたいときは，トレースビューアを起動します。

次の2種類の起動方法があります。

(a)　スタートメニューから起動する方法

操作

Windowsの［スタート］メニューから［プログラム］－［JP1_Script］－［トレースビューア］を選択して，JP1/Scriptのトレースビューアを起動する。
Scriptトレースビューアウィンドウが表示されます。ウィンドウにはトレースファイルが一覧表示されています。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でトレースビューアを起動しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

(b)　Scriptマネージャウィンドウから起動する方法

操作

Scriptマネージャウィンドウで，［ツール］－［トレースビューアの起動］を選択する。
トレースビューアを起動できます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でトレースビューアを起動しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

(2)　トレースビューアを終了する

［ファイル］－［トレースビューアの終了］を選択してください。トレースビューアが終了して，Scriptトレースビューアウィンドウが閉じます。

3.4.4　Scriptトレースビューアウィンドウでの操作

Scriptトレースビューアウィンドウ（およびトレースファイルの表示ウィンドウ）でできる操作の一覧を次に示します。

トレースファイルの表示・非表示を切り替える

トレースファイルの内容を表示する

トレースファイルを別名で保存する

トレースファイルを印刷する

トレースファイルを削除する

トレースファイルをクリアする

トレースファイルの内容を検索する

ツールバーの表示・非表示を切り替える※

ステータスバーの表示・非表示を切り替える※

未使用時に最小化する※

クライアントエリアを最新の情報に更新する※

クライアントエリアに表示するトレースファイルの接続先コンピュータ名を設定する※

トレースファイルの表示ウィンドウを閉じる※

トレースファイルの行番号の表示・非表示を切り替える※

トレースファイルの表示ウィンドウを縦（または横）に並べる※

注※

これらの操作は特に説明していません（これらはWindowsの標準の操作に準じているか，メニュー一覧で該当するメニューを選択するだけで実行できる操作です）。

3.4.5　トレースファイルの表示・非表示を切り替える

Scriptトレースビューアウィンドウに一覧表示される実行トレースファイル，解析トレースファイル，ユーザトレースファイル，サーバトレースファイルの表示・非表示を切り替えます。例えば，スクリプトファイルが完成し，業務で実行する場合には，解析トレースは必要ないので非表示にします。

操作

実行トレースの表示・非表示を切り替える場合は，［表示］－［実行トレース］メニューを選択する。

解析トレースの表示・非表示を切り替える場合は，［表示］－［解析トレース］メニューを選択する。

ユーザトレースの表示・非表示を切り替える場合は，［表示］－［ユーザトレース］メニューを選択する。

サーバトレースの表示・非表示を切り替える場合は，［表示］－［サーバトレース］メニューを選択する。

解析トレースの表示・非表示の切り替え例

3.4.6　トレースファイルの内容を表示する

Scriptトレースビューアウィンドウで選択したトレースファイルの内容を，トレースファイルの表示ウィンドウに表示します。一度に複数のファイルを選択することもできます。

操作

Scriptトレースビューアウィンドウで，トレースファイルを一つ，または複数選択する。

［ファイル］－［トレースファイルの表示］メニューを選択する。
Scriptトレース表示ウィンドウに，トレースファイルの内容が表示されます。

Scriptトレース表示ウィンドウで，［ファイル］－［表示ウィンドウを閉じる］，または［ファイル］－［全ての表示ウィンドウを閉じる］を選択する。
Scriptトレース表示ウィンドウが閉じて，Scriptトレースビューアウィンドウに戻ります。

Scriptトレースビューアウィンドウで，［表示］－［未使用時に最小化］メニューが選択されている場合は，操作2.でトレースファイルの表示ウィンドウが表示されたときに，Scriptトレースビューアウィンドウが最小化します。

3.4.7　トレースファイルを別名で保存する

選択したトレースファイルを別名で保存します。

操作

Scriptトレースビューアウィンドウのクライアントエリアから，別名で保存したいトレースファイルを一つ選択する。または，トレースファイルの表示ウィンドウに，別名で保存したいファイルが表示されていることを確認する。

［ファイル］－［名前を付けて保存］メニューを選択する。表示されるダイアログで名前を指定し，［保存］ボタンをクリックする。

選択したトレースファイルが指定した名前で保存されます。

操作2.で［キャンセル］ボタンをクリックすると，別名での保存を中断してダイアログを閉じます。

3.4.8　トレースファイルを削除する

Scriptトレースビューアウィンドウで選択されているトレースファイルを削除します。またはトレースファイルの表示ウィンドウに表示されているトレースファイルを削除します。

操作

Scriptトレースビューアウィンドウのクライアントエリアから，削除するトレースファイルを一つ，または複数選択する。または，トレースファイルの表示ウィンドウに，削除したいファイルが表示されていることを確認する。

［ファイル］－［トレースファイルの削除］メニューを選択する。
［確認］ダイアログが表示されます。

ダイアログの設定方法については，「4.3.1　削除の確認ダイアログ」を参照してください。

［はい］ボタンをクリックする。
トレースファイルが一つ削除され，次に選択されているファイルに処理が移ります（複数のファイルが選択されている場合）。

必要な回数だけ，操作を繰り返します。選択されているすべてのファイルが削除されると，ダイアログが閉じます。

操作3.で［すべて］ボタンをクリックすると，選択されているすべてのファイルが削除されます。

操作3.で［キャンセル］ボタンをクリックすると，ファイルの削除を中断してダイアログを閉じます。

3.4.9　トレースファイルをクリアする

Scriptトレースビューアウィンドウで選択されているトレースファイルを空（ファイルサイズ0）にします。または，トレースファイルの表示ウィンドウに表示されているトレースファイルを空にします。

操作

Scriptトレースビューアウィンドウのクライアントエリアから，クリアするトレースファイルを一つ，または複数選択する。または，トレースファイルの表示ウィンドウに，クリアしたいトレースファイルが表示されていることを確認する。

［編集］－［トレースファイルのクリア］メニューを選択する。
［確認］ダイアログが表示されます。

ダイアログの設定方法については，「4.3.2　クリアの確認ダイアログ」を参照してください。

［はい］ボタンをクリックする。
トレースファイルが一つクリアされます。

複数のファイルが選択されている場合，次に選択されているファイルに処理が移ります。
必要な回数だけ，操作を繰り返します。選択されているすべてのファイルがクリアされると，ダイアログが閉じます。

操作3.で［すべて］ボタンをクリックすると，選択されているすべてのファイルがクリアされます。

操作3.で［キャンセル］ボタンをクリックすると，ファイルのクリアを中断してダイアログを閉じます。

3.4.10　トレースファイルを印刷する

Scriptトレースビューアウィンドウで選択したトレースファイルの内容を印刷します。または，トレースファイルの表示ウィンドウの内容を印刷します。

操作

Scriptトレースビューアウィンドウのクライアントエリアから，印刷するトレースファイルを一つ選択する。または，トレースファイルの表示ウィンドウに，印刷したいトレースファイルが表示されていることを確認する。

［ファイル］－［印刷］メニューを選択する。表示される［印刷］ダイアログに必要な情報を設定する。

［OK］ボタンをクリックする。
トレースファイルの内容が印刷されます。

操作3.で［キャンセル］ボタンをクリックすると，印刷を中断してダイアログを閉じます。

タブ文字は，半角スペース4個分を仮定して印刷します。

指定された用紙の範囲に収まらない場合は，折り返して印刷します。

3.4.11　トレースファイルの内容を検索する

表示しているトレース情報から，指定した文字列を検索します。

操作

Scriptトレースビューアウィンドウのクライアントエリアから，検索するトレースファイルを一つ選択する。

［ファイル］－［トレースファイルの表示］メニューを選択し，トレースファイルを表示する。

［検索］－［検索］メニューを選択する。
［検索］ダイアログが表示されます。

ダイアログの設定方法については，「4.3.4　検索ダイアログ」を参照してください。

検索する文字列を指定して，［上検索］ボタン，または［下検索］ボタンをクリックする。
検索処理が実行されます。

操作3.で［キャンセル］ボタンをクリックすると，検索を実行しないでダイアログを閉じます。

検索文字列を指定しないで検索を実行しようとすると，ビープ音がなります。

3.5　トレースファイルの表示操作

＜この節の構成＞

3.5.1　トレースファイルの表示ウィンドウとメニュー

3.5.2　Scriptトレース表示ウィンドウでのマウスとキーの操作

3.5.1　トレースファイルの表示ウィンドウとメニュー

トレースファイルの表示ウィンドウは，スクリプトの実行状態，およびトレース情報を表示するためのウィンドウです。

ここでは，トレースファイルを開いたときに表示されるウィンドウ，およびメニューの種類について説明します。

トレースビューアの出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

＜この項の構成＞

(1)　Scriptトレース表示ウィンドウ

(2)　Scriptトレース表示ウィンドウのメニュー

(1)　Scriptトレース表示ウィンドウ

Scriptトレースビューアウィンドウに表示されているトレースファイルをダブルクリックすると，Scriptトレース表示ウィンドウが表示されます。Scriptトレース表示ウィンドウ，およびウィンドウの各部の名称を図3-5に示します。

図3-5　Scriptトレース表示ウィンドウ

(a)　ツールバー

ツールバーには，メニューバーから選択できるコマンドの中から，頻繁に使用するコマンドだけをボタンの形で表示します。ボタンをマウスでクリックするだけで，該当するコマンドを実行できます。オプションメニューによって，非表示にすることもできます。

Scriptトレース表示ウィンドウのツールバーには，次のコマンドのボタンが表示されます。

［保存］ボタン

トレースファイルを別名で保存します。

［印刷］ボタン

トレースファイルを印刷します。

［削除］ボタン

トレースファイルを削除します。

［閉じる］ボタン

トレースファイルの表示ウィンドウを終了します。

［すべて閉じる］ボタン

現在表示されているすべてのScriptトレース表示ウィンドウを終了します。

［クリア］ボタン

トレースファイルを空（ファイルサイズ0）にします。

［行番号］ボタン

行番号の表示・非表示を切り替えます。

［最新］ボタン

トレースファイルの内容を最新の状態にします。

［検索］ボタン

検索情報を設定します。

［上検索］ボタン

検索文字列を現在の位置から上方向に検索します。

［下検索］ボタン

検索文字列を現在の位置から下方向に検索します。

［ヘルプ］ボタン

JP1/Scriptのオンラインヘルプを表示します。

(b)　ステータスバー

ステータスバーは，トレースビューアが現在実行している処理に関するメッセージや，処理終了後の状態に関するメッセージを表示するための領域です。

(c)　クライアントエリア

クライアントエリアには，トレースファイルの内容が表示されます。

ここに表示しきれない内容がある場合は，スクロールバーが表示されます。

このクライアントエリアに表示する文字の表示フォント，およびフォントサイズを変更できます。

〔レジストリキー〕

HKEY_CURRENT_USER¥SOFTWARE¥HITACHI¥JP1/Script¥SPTTM¥TraceWindow

〔値名1〕

Font

〔値のデータタイプ1〕

REG_SZ

〔値1〕

フォント

〔設定が有効になるタイミング〕

Scriptトレース表示ウィンドウの次回表示時

〔値名2〕

FontSize

〔値のデータタイプ2〕

REG_DWORD

〔値2〕

フォントサイズ

〔設定が有効になるタイミング〕

Scriptトレース表示ウィンドウの次回表示時

(2)　Scriptトレース表示ウィンドウのメニュー

Scriptトレース表示ウィンドウの機能を，メニューごとに説明します。Scriptトレース表示ウィンドウのメニュー一覧を表3-16に示します。

表3-16　Scriptトレース表示ウィンドウのメニュー一覧

メニュー | コマンド（機能） | 機能概要
［ファイル］ | ［名前を付けて保存］ | 選択されているトレースファイルに別の名前を付けて保存します。
［トレースファイルの削除］ | 選択されているトレースファイルを削除します。
［印刷］ | 選択されているトレースファイルの内容を印刷します。
［トレース表示を閉じる］ | 現在表示されているトレースファイルの表示ウィンドウを終了します。
［すべてのトレース表示を閉じる］ | 現在表示されているすべてのトレースファイルの表示ウィンドウを終了します。
［編集］ | ［トレースファイルのクリア］ | トレースファイルを空（ファイルサイズ0）にします。
［表示］ | ［ツールバー］ | ツールバーの表示・非表示を切り替えます。
［ステータスバー］ | ステータスバーの表示・非表示を切り替えます。
［行番号を表示］ | 行番号の表示・非表示を切り替えます。
［縦に並べる］ | 表示されているトレースファイルの表示ウィンドウを，デスクトップ上に縦に並べます。
［横に並べる］ | 表示されているトレースファイルの表示ウィンドウを，デスクトップ上に横に並べます。
［すべてのトレース表示を最小化］ | 表示されているトレースファイルの表示ウィンドウを，すべて最小化します。
［最新の情報に更新］ | 表示しているトレースファイルの内容を，最新状態にします。
［検索］ | ［検索］ | 検索する情報を入力します。
［上検索］ | 検索文字列を上に向かって検索します。
［下検索］ | 検索文字列を下に向かって検索します。
［ヘルプ］ | ［目次］ | JP1/Scriptオンラインヘルプの目次を表示します。
［キーワードで検索］ | JP1/Scriptオンラインヘルプのキーワード一覧を表示します。
［ヘルプの使い方］ | オンラインヘルプの使い方を表示します。
［バージョン情報］ | JP1/Scriptトレース表示のバージョン情報を表示します。

3.5.2　Scriptトレース表示ウィンドウでのマウスとキーの操作

＜この項の構成＞

(1)　マウス操作

(2)　キー操作

(1)　マウス操作

Scriptトレース表示ウィンドウのクライアントエリアでのマウス操作を表3-17に示します。

表3-17　Scriptトレース表示ウィンドウでのマウス操作

操作 | 処理
クリック | それまでの選択を解除して，新たに対象を選択する。

(2)　キー操作

Scriptトレース表示ウィンドウのクライアントエリアでのキー操作を表3-18に示します。

表3-18　Scriptトレース表示ウィンドウでのキー操作

操作 | 処理
Ctrl + B | 検索文字列を上方向に向かって検索する。
Ctrl + C | 選択した部分をクリップボードへコピーする。
Ctrl + F | ［検索情報指定］ダイアログを表示する。
Ctrl + N | 検索文字列を下方向に向かって検索する。
Ctrl + P | トレースファイルを印刷する。
Del | トレースファイルを削除する。

3.6　メニューエディタの操作

Scriptメニューエディタウィンドウでできる操作の一覧を次に示します。

新しいメニューフォームを作成する

メニューフォームをコピーする

メニューフォームを貼り付ける

メニューフォームを削除する

コントロールの属性を一括して変更する

コントロールを一列に並べる

コントロールを均等な間隔で並べる

コントロールをメニューフォームの中央に並べる

コントロールの大きさをそろえる

コントロールをテキストの大きさに合わせる

メニューフォーム上にグリッドを表示する

タブの移動順序を設定する

選択したコントロールを前面に移動する

選択したコントロールを背面に移動する

コマンドのプロパティを設定する

メニューフォームをテスト表示する

メニューフォームの内容を印刷する

新しいメニュー情報ファイルを作成する※

既存のメニュー情報ファイルを開く※

メニュー情報ファイルを保存する※

メニュー情報ファイルに名前をつけて保存する※

直前の編集作業を無効にする※

直前の編集作業をやり直す※

選択したコントロールをクリップボードに切り抜く※

選択したコントロールをクリップボードにコピーする※

クリップボードのコントロールをメニューフォームに貼り付ける※

メニューフォーム上のすべてのコントロールを選択する※

選択したコントロールを削除する※

ツールバーの表示／非表示を切り替える※

ステータスバーの表示／非表示を切り替える※

コントロールボックスの表示／非表示を切り替える※

プロパティダイアログの表示／非表示を切り替える※

コマンドプロパティダイアログの表示／非表示を切り替える※

ヘルプを表示する

注※

これらの操作は特に説明していません（これらはWindowsの標準の操作に準じているか，メニュー一覧で該当するメニューを選択するだけで実行できる操作です）。

＜この節の構成＞

3.6.1　Scriptメニューエディタウィンドウとメニュー

3.6.2　Scriptメニューエディタウィンドウでのマウスとキーの操作

3.6.3　新しいメニューフォームを作成する

3.6.4　メニューフォームをコピーする

3.6.5　メニューフォームを貼り付ける

3.6.6　メニューフォームを削除する

3.6.7　コントロールの属性を一括して変更する

3.6.8　コントロールを一列に並べる

3.6.9　コントロールを均等な間隔で並べる

3.6.10　コントロールをメニューフォームの中央に並べる

3.6.11　コントロールの大きさをそろえる

3.6.12　コントロールをテキストの大きさに合わせる

3.6.13　メニューフォーム上にグリッドを表示する

3.6.14　タブの移動順序を設定する

3.6.15　選択したコントロールを前面に移動する

3.6.16　選択したコントロールを背面に移動する

3.6.17　コマンドのプロパティを設定する

3.6.18　メニューフォームをテスト表示する

3.6.19　メニューフォームの内容を印刷する

3.6.1　Scriptメニューエディタウィンドウとメニュー

メニューエディタは，作成したスクリプトファイルに対応した画面（メニューフォーム）を作成するためのプログラムです。メニューエディタで作成した画面（メニューフォーム）は，メニュー情報ファイルとして保存されます。作成した画面（メニューフォーム）はMenuコマンドを使用して表示させます。Menuコマンドの詳細は「8.7.1　Menu （ユーザ定義のメニューを表示する）」を参照してください。

ここでは，メニューエディタを起動すると表示されるScriptメニューエディタウィンドウについて説明します。また，メニューエディタの機能をメニューごとに説明します。

＜この項の構成＞

(1)　Scriptメニューエディタウィンドウ

(2)　Scriptメニューエディタウィンドウのメニュー

(1)　Scriptメニューエディタウィンドウ

Scriptメニューエディタウィンドウ，およびウィンドウの各部の名称を，図3-6に示します。

図3-6　Scriptメニューエディタウィンドウ

(a)　ツールバー

ツールバーには，メニューバーから選択できるコマンドの中から，頻繁に使用するコマンドだけをボタンの形で表示しています。ボタンをマウスでクリックするだけで，該当するコマンドを実行できます。表示メニューによって非表示にすることもできます。

Scriptメニューエディタウィンドウのツールバーには，次のコマンドのボタンが表示されます。

［新規作成］ボタン

メニュー情報ファイルを新規に作成します。

［開く］ボタン

メニュー情報ファイルを開きます。

［保存］ボタン

メニュー情報ファイルを保存します。

［メニューフォームの印刷］ボタン

メニューフォームの定義内容を印刷します。

［終了］ボタン

メニューエディタを終了します。

［メニューフォームの新規作成］ボタン

メニューフォームを新規に作成します。

［元に戻す］ボタン

直前の操作を無効にします。

［やり直し］ボタン

直前の操作をやり直します。

［切り抜き］ボタン

選択したコントロールをクリップボードに切り抜きます。

［コピー］ボタン

選択したコントロールをクリップボードにコピーします。

［貼り付け］ボタン

クリップボードのコントロールをメニューフォームに貼り付けます。

［すべて選択］ボタン

メニューフォームに記述されているコントロールをすべて選択します。

［左寄せ配置］ボタン

コントロールを，基準となるコントロールの左端にそろえます。

［右寄せ配置］ボタン

コントロールを，基準となるコントロールの右端にそろえます。

［上寄せ配置］ボタン

コントロールを，基準となるコントロールの上端にそろえます。

［下寄せ配置］ボタン

コントロールを，基準となるコントロールの下端にそろえます。

［左右均等配置］ボタン

コントロールを左右のスペースが均等になるように配置します。

［上下均等配置］ボタン

コントロールを上下のスペースが均等になるように配置します。

［上下中央配置］ボタン

コントロールを，メニューフォーム内で垂直方向の中央に配置します。

［左右中央配置］ボタン

コントロールを，メニューフォーム内で水平方向の中央に配置します。

［幅を合わせる］ボタン

コントロールをほかのコントロールの幅に合わせます。

［高さを合わせる］ボタン

コントロールをほかのコントロールの高さに合わせます。

［サイズを合わせる］ボタン

コントロールをほかのコントロールのサイズに合わせます。

［グリッドの設定］ボタン

グリッドを設定します。

［前面へ移動］ボタン

選択されたコントロールを前面に移動します。

［背面へ移動］ボタン

選択されたコントロールを背面に移動します。

［コマンドプロパティの設定］ボタン

コマンドのプロパティ定義を設定します。

［テスト表示］ボタン

作成した画面（メニューフォーム）をテスト表示します。

［ヘルプ］ボタン

JP1/Scriptのオンラインヘルプを表示します。

(b)　ステータスバー

ステータスバーは，メニューエディタが現在実行している処理に関するメッセージや，処理終了後の状態に関するメッセージを表示するための領域です。

(c)　メニューフォーム

画面を作成するシートです。ここで作成した画面の情報がメニュー情報ファイルに記述されます。

(d)　メニューフォームツリービュー

メニュー情報ファイルに記述されている，すべてのメニューフォーム名をツリー形式で表示する領域です。メニューフォーム名をクリックすると，メニューフォームビューにメニューフォームが表示されます。

(e)　メニューフォームビュー

メニュー情報ファイルに記述されているメニューフォームを表示する領域です。

(f)　コントロールボックス

利用できるコントロールがボタンで表示されています。コントロールのボタンを選択してからメニューフォーム上にドラッグアンドドロップすると，選択したコントロールがメニューフォーム上に貼り付けられます。

コントロールボックスを，図3-7に示します。

図3-7　コントロールボックス

コントロールボックスの各コントロールについて，次に説明します。

［ポインタ］

コントロールを選択するとき使います。

［スタティック］

スタティック（見出し）を，メニューフォーム上に貼り付ける場合に選択します。

［ボタン］

ボタンを，メニューフォーム上に貼り付ける場合に選択します。

［ファイル参照ボタン］

ファイル参照ボタンを，メニューフォーム上に貼り付ける場合に選択します。

［エディット］

エディットを，メニューフォーム上に貼り付ける場合に選択します。

［直線］

直線を，メニューフォーム上に貼り付ける場合に選択します。

［ファンクションキー］

ファンクションキーを，メニューフォーム上に貼り付ける場合に選択します。このコントロールは，キーボードのファンクションキーと対応させるためのコントロールです。

［リスト］

リストを，メニューフォーム上に貼り付ける場合に選択します。

［コンボボックス］

コンボボックスを，メニューフォーム上に貼り付ける場合に選択します。

(2)　Scriptメニューエディタウィンドウのメニュー

ここでは，Scriptメニューエディタウィンドウのメニューバーに表示されるメニュー，およびScriptメニューエディタウィンドウで表示されるポップアップメニューについて説明します。

(a)　メニューバーのメニュー

メニューエディタの機能を，メニューごとに説明します。メニューエディタのメニュー一覧を表3-19に，レイアウトコマンドのカスケードメニュー一覧を表3-20に示します。

表3-19　メニューエディタのメニュー一覧

メニュー | コマンド（機能） | 機能概要
［ファイル］ | ［新規作成］ | メニュー情報ファイルを新規に作成します。
［開く］ | メニュー情報ファイルを開きます。
［保存］ | メニュー情報ファイルを保存します。
［名前を付けて保存］ | 選択されているメニュー情報ファイルに別の名前を付けて保存します。
［メニューフォームの印刷］ | メニューフォームの定義内容を印刷します。
［終了］ | メニューエディタを終了します。
（メニュー情報ファイル名） | 直前に保存したメニュー情報ファイル名が表示されます。
［編集］ | ［メニューフォームの新規作成］ | メニューフォームを新規に作成します。
［メニューフォームのコピー］ | 既存のメニューフォームをクリップボードにコピーします。
［メニューフォームの貼り付け］ | クリップボードのメニューフォームを貼り付けます。
［メニューフォームの削除］ | クリップボードのメニューフォームを削除します。
［元に戻す］ | 編集する直前の状態に戻します。
［やり直し］ | 直前の操作をやり直します。
［切り抜き］ | 選択したコントロールをクリップボードに切り抜きます。
［コピー］ | 選択したコントロールをクリップボードにコピーします。
［貼り付け］ | クリップボードのコントロールをメニューフォーム上に貼り付けます。
［すべて選択］ | メニューフォーム上に記述されているすべてのコントロールを選択します。
［削除］ | 選択したコントロールを削除します。
［一括変更］ | 選択したコントロールの属性を一括して変更します。
［レイアウト］ | メニューフォームに貼り付けたコントロールのレイアウトを整えます。また，［レイアウト］コマンドの下には，カスケードメニューが表示されます。カスケードメニューについては，表3-20を参照してください。
［表示］ | ［ツールバー］ | ツールバーの表示・非表示を切り替えます。
［ステータスバー］ | ステータスバーの表示・非表示を切り替えます。
［コントロールボックス］ | コントロールボックスの表示・非表示を切り替えます。
［プロパティ］ | プロパティダイアログの表示・非表示を切り替えます。
［コマンドプロパティ］ | コマンドプロパティダイアログの表示・非表示を切り替えます。
［ツール］ | ［コマンドプロパティの設定］ | コマンドのプロパティを定義します。
［テスト表示］ | 作成した画面（メニューフォーム）をテスト表示します。
［ヘルプ］ | ［目次］ | JP1/Scriptオンラインヘルプの目次を表示します。
［キーワードで検索］ | JP1/Scriptオンラインヘルプのキーワード一覧を表示します。
［ヘルプの使い方］ | オンラインヘルプの使い方を表示します。
［バージョン情報］ | JP1/Scriptメニューエディタのバージョン情報を表示します。

表3-20　レイアウトコマンドのカスケードメニュー一覧

カスケードメニュー | コマンド（機能） | 機能概要
［整列］ | ［左端］ | コントロールを，基準となるコントロールの左端にそろえます。
［右端］ | コントロールを，基準となるコントロールの右端にそろえます。
［上端］ | コントロールを，基準となるコントロールの上端にそろえます。
［下端］ | コントロールを，基準となるコントロールの下端にそろえます。
［上下中央］ | コントロールを，基準となるコントロールの垂直方向の中央に配置します。
［左右中央］ | コントロールを，基準となるコントロールの水平方向の中央に配置します。
［スペースの均等化］ | ［左右方向］ | コントロールを，左右のスペースが均等になるように配置します。
［上下方向］ | コントロールを，上下のスペースが均等になるように配置します。
［メニューフォーム内での整列］ | ［上下中央］ | コントロールを，メニューフォーム上で垂直方向の中央に配置します。
［左右中央］ | コントロールを，メニューフォーム上で水平方向の中央に配置します。
［同じサイズに設定］ | ［幅］ | コントロールを，ほかのコントロールの幅に合わせます。
［高さ］ | コントロールを，ほかのコントロールの高さに合わせます。
［幅と高さ］ | コントロールを，ほかのコントロールのサイズに合わせます。
［テキストへのサイズ合わせ］ | － | コントロールをテキストのサイズに合わせます。
［グリッドの設定］ | － | グリッドを設定します。
［タブオーダの設定］ | － | タブオーダを設定します。
［前面へ移動］ | － | 選択したコントロールを前面に移動します。
［背面へ移動］ | － | 選択したコントロールを背面に移動します。

(b)　ポップアップメニュー

Scriptメニューエディタウィンドウのメニューフォームビューでマウスの右ボタンをクリックすると，ポップアップメニューが表示されます。Scriptメニューエディタウィンドウで表示されるポップアップメニューを表3-21に示します。

表3-21　ポップアップメニュー一覧

ポップアップメニュー | 機能概要
［新規作成］ | メニュー情報ファイルを新規に作成します。
［開く］ | 既存のメニュー情報ファイルを開きます。
［保存］ | メニュー情報ファイルを上書き保存します。
［メニューフォームの印刷］ | メニューフォームの定義内容を印刷します。
［メニューフォームのコピー］ | 既存のメニューフォームをクリップボードにコピーします。
［メニューフォームの貼り付け］ | クリップボードのメニューフォームを貼り付けます。
［メニューフォームの削除］ | 既存のメニューフォームを削除します。
［元に戻す］ | 編集する直前の状態に戻します。
［やり直し］ | 直前の操作をやり直します。
［切り抜き］ | 選択したコントロールを切り抜きます。
［コピー］ | 選択したコントロールをクリップボードにコピーします。
［貼り付け］ | クリップボードのコントロールをメニューフォーム上に貼り付けます。
［すべて選択］ | メニューフォーム上に記述されているコントロールすべてを選択します。
［削除］ | 選択したコントロールを削除します。
［一括変更］ | 選択したコントロールの属性を一括して変更します。
［レイアウト］ | メニューフォームに貼り付けたコントロールのレイアウトを整えます。また，［レイアウト］コマンドの下には，カスケードメニューが表示されます。カスケードメニューについては，表3-20を参照してください。
［コマンドプロパティの設定］ | コマンドのプロパティを定義します。
［テスト表示］ | 作成した画面（メニューフォーム）をテスト表示します。
［プロパティ］ | 選択したコントロールのプロパティダイアログを表示します。

3.6.2　Scriptメニューエディタウィンドウでのマウスとキーの操作

＜この項の構成＞

(1)　マウス操作

(2)　キー操作

(1)　マウス操作

メニューフォームビュー上でのマウス操作を表3-22に示します。

表3-22　Scriptメニューエディタウィンドウでのマウス操作

操作 | 処理
クリック | 新たに対象を選択する。またはそれまでの選択を解除する。
ダブルクリック | メニューフォーム，または各コントロールのプロパティダイアログを表示する。
右ボタンシングルクリック | ポップアップメニューを表示する。
ドラッグ | 各コントロールを移動，または選択する。複数のコントロールを選択状態にした場合，選択順序はコントロールの座標位置をYXソートした結果と同じになる。
Ctrl+ドラッグ | 選択されたコントロールを複写する。

(2)　キー操作

Scriptメニューエディタウィンドウのメニューフォームビューでのキー操作を表3-23に示します。

表3-23　Scriptメニューエディタウィンドウでのキー操作

操作 | 処理
Alt+1 | コントロールボックスの表示，非表示を切り替える。
Alt+2 | プロパティダイアログの表示，非表示を切り替える。
Alt+3 | コマンドプロパティダイアログの表示，非表示を切り替える。
Alt+F4 | メニューエディタを終了する。
Alt+R | コントロールを左右のスペースが均等になるように配置する。
Alt+D | コントロールを上下のスペースが均等になるように配置する。
Ctrl+A | メニューフォーム上のすべてのコントロールを選択する。
Ctrl+C | 選択されたコントロールをコピーする。
Ctrl+F | メニューフォームを新規に作成する。
Ctrl+K | コマンドのプロパティを定義する。
Ctrl+N | メニュー情報ファイルを新規に作成する。
Ctrl+O | メニュー情報ファイルを開く。
Ctrl+P | メニューフォームの内容を印刷する。
Ctrl+S | メニュー情報ファイルを保存する。
Ctrl+V | クリップボードの内容をメニューフォームに貼り付ける。
Ctrl+X | 選択されたコントロールを切り抜く。
Ctrl+Z | 編集される直前の状態に戻す。
Ctrl+F9 | コントロールをダイアログ内で垂直方向の中央に配置する。
Ctrl+L | コントロールをほかのコントロールの左端にそろえる。
Ctrl+R | コントロールをほかのコントロールの右端にそろえる。
Ctrl+U | コントロールをほかのコントロールの上端にそろえる。
Ctrl+D | コントロールをほかのコントロールの下端にそろえる。
Delete | 選択されたメニューフォーム，またはコントロールを削除する。
F5 | メニューフォームをテスト表示する。
F7 | コントロールをテキストの大きさに合わせる。
F9 | コントロールをほかのコントロールの垂直方向の中央に配置する。
Shift+F9 | コントロールをほかのコントロールの水平方向の中央に配置する。
Shift+Ctrl+Z | 直前の操作をやり直す。
Shift+Ctrl +F9 | コントロールをダイアログ内で水平方向の中央に配置する。
← | 選択された一つ以上のコントロールを左方向に移動する（グリッド単位）。
→ | 選択された一つ以上のコントロールを右方向に移動する（グリッド単位）。
↑ | 選択された一つ以上のコントロールを上方向に移動する（グリッド単位）。
↓ | 選択された一つ以上のコントロールを下方向に移動する（グリッド単位）。
Alt+← | 選択された一つ以上のコントロールを左方向に移動する（ピクセル単位）。
Alt+→ | 選択された一つ以上のコントロールを右方向に移動する（ピクセル単位）。
Alt+↑ | 選択された一つ以上のコントロールを上方向に移動する（ピクセル単位）。
Alt+↓ | 選択された一つ以上のコントロールを下方向に移動する（ピクセル単位）。
Shift+← | 選択された一つのコントロールを，左上を基準にして左方向にサイズ変更する（グリッド単位）※。
Shift+→ | 選択された一つのコントロールを，左上を基準にして右方向にサイズ変更する（グリッド単位）※。
Shift+↑ | 選択された一つのコントロールを，左上を基準にして上方向にサイズ変更する（グリッド単位）※。
Shift+↓ | 選択された一つのコントロールを，左上を基準にして下方向にサイズ変更する（グリッド単位）※。
Shift+Alt+↑ | 選択された一つのコントロールを，左上を基準にして上方向にサイズ変更する（ピクセル単位）※。
Shift+Alt+↓ | 選択された一つのコントロールを，左上を基準にして下方向にサイズ変更する（ピクセル単位）※。
Shift+Alt+← | 選択された一つのコントロールを，左上を基準にして左方向にサイズ変更する（ピクセル単位）※。
Shift+Alt+→ | 選択された一つのコントロールを，左上を基準にして右方向にサイズ変更する（ピクセル単位）※。
Enter | 選択された一つのコントロールのプロパティを表示する。

注※　選択されたコントロールが直線の場合，操作は無効になります。

3.6.3　新しいメニューフォームを作成する

新しいメニューフォームを作成します。

メニューフォームとは，作成されたスクリプトファイルを実行したときに画面上に表示させるウィンドウのことです。メニューフォーム上には，コントロールと呼ばれる，ボタンやリストボックスなどを配置できます。

操作

［編集］－［メニューフォームの新規作成］メニューを選択する。
［メニューフォーム名の指定］ダイアログが表示されます。

ダイアログの設定方法については，「4.4.38　メニューフォーム名の指定ダイアログ」を参照してください。

メニューフォーム名を入力する。

［OK］ボタンをクリックする。

メニューフォームビューには新しいメニューフォームが表示され，メニューフォームツリービューには操作2.で入力したメニューフォーム名が追加されます。

3.6.4　メニューフォームをコピーする

既存のメニューフォームをコピーします。

操作

メニューフォームツリービューからメニューフォームを選択する。

［編集］－［メニューフォームのコピー］を選択する。
選択されたメニューフォームがクリップボードにコピーされます。

3.6.5　メニューフォームを貼り付ける

クリップボードのメニューフォームを貼り付けます。

操作

［編集］－［メニューフォームの貼り付け］メニューを選択する。
クリップボードのメニューフォームが，メニューフォームビューに表示されます。また，貼り付けたメニューフォームの名前がメニューフォームツリービューに表示されます。

貼り付けるメニューフォームの名前がすでにある場合，貼り付けられる前の名前の末尾に「1」以降の数字が付加されます。（例：Name → Name1，Name1 → Name2）

3.6.6　メニューフォームを削除する

作成したメニューフォームを削除します。

操作

メニューフォームツリービューからメニューフォームを選択する。

［編集］－［メニューフォームの削除］を選択する。
選択されたメニューフォームが削除されます。

3.6.7　コントロールの属性を一括して変更する

メニューフォーム上のコントロールの属性を一括して変更します。

操作

メニューフォーム上でコントロールを選択する。
ここでは，ボタン1とボタン2を選択します。

［編集］－［一括変更］メニューを選択する。
［一括変更］ダイアログが表示されます。

ダイアログの設定方法については，「4.4.39　一括変更ダイアログ」を参照してください。

変更内容を設定する。
ここでは，［スタイル］ボタンをクリックし，スタイルを変更します。

［ボタンプロパティ］ダイアログで，「高く飛び出させる」を選択します。

［OK］をクリックする。
［一括変更］ダイアログに戻ります。

［OK］をクリックする。
操作3.で変更した新しい内容でコントロールが設定されます。

コントロールが選択されていないと，メニューがグレーアウトされてメニューを選択できません。

選択されたコントロールに直線が含まれる場合にはメニューがグレーアウトされてメニューを選択できません。

3.6.8　コントロールを一列に並べる

2個以上のコントロールを一列に並べます。

最初に選択したコントロールの位置が基準になり，あとから選択したコントロールが移動されます。

操作

メニューフォーム上でコントロールを2個以上選択する。

あとから選択したコントロールを，最初に選択した基準となるコントロールに合わせる。
並べ方によって，次のように操作が異なります。

左端にそろえる場合

［編集］－［レイアウト］－［整列］－［左端］

右端にそろえる場合

［編集］－［レイアウト］－［整列］－［右端］

上端にそろえる場合

［編集］－［レイアウト］－［整列］－［上端］

下端にそろえる場合

［編集］－［レイアウト］－［整列］－［下端］

垂直方向の中央にそろえる場合

［編集］－［レイアウト］－［整列］－［上下中央］

水平方向の中央にそろえる場合

［編集］－［レイアウト］－［整列］－［左右中央］

選択したコントロールが一列に並びます。

コントロールを2個以上選択しないと，メニューがグレーアウトされてメニューを選択できません。

3.6.9　コントロールを均等な間隔で並べる

選択した3個以上のコントロールを均等な間隔で並べます。

左右方向に並べる方法と，上下方向に並べる方法があります。

操作

コントロールを左右方向に均等な間隔で並べる

メニューフォーム上でコントロールを3個以上選択する。

［編集］－［レイアウト］－［スペースの均等化］－［左右方向］を選択する。
選択したうちでいちばん左にあるコントロールといちばん右にあるコントロールを基準として，その間にあるコントロールが均等に並びます。

コントロールを上下方向に均等な間隔で並べる

メニューフォーム上でコントロールを3個以上選択する。

［編集］－［レイアウト］－［スペースの均等化］－［上下方向］を選択する。
選択したうちでいちばん上にあるコントロールといちばん下にあるコントロールを基準として，その間にあるコントロールが均等に並びます。

コントロールを3個以上選択しないと，メニューがグレーアウトされてメニューを選択できません。

3.6.10　コントロールをメニューフォームの中央に並べる

選択したコントロールをメニューフォームの中央に並べます。

メニューフォームの水平方向の中央に並べる方法と，垂直方向の中央に並べる方法があります。

操作

水平方向の中央に並べる

メニューフォーム上でコントロールを選択する。

［編集］－［レイアウト］－［メニューフォーム内での整列］－［左右中央］メニューを選択する。
メニューフォームの水平方向の中央に選択したコントロールが並びます。

垂直方向の中央に並べる

メニューフォーム上でコントロールを選択する。

［編集］－［レイアウト］－［メニューフォーム内での整列］－［上下中央］メニューを選択する。
メニューフォームの垂直方向の中央に選択したコントロールが並びます。

3.6.11　コントロールの大きさをそろえる

コントロールの大きさを他のコントロールの大きさにそろえます。

幅をそろえる方法，高さをそろえる方法，幅と高さをそろえる方法があります。

操作

幅をそろえる

メニューフォーム上で2個以上コントロールを選択する。

［編集］－［レイアウト］－［同じサイズに設定］－［幅］を選択する。
最初に選択したコントロールと同じ幅に，あとから選択したコントロールの幅がそろいます。

高さをそろえる

メニューフォーム上で2個以上コントロールを選択する。

［編集］－［レイアウト］－［同じサイズに設定］－［高さ］を選択する。
最初に選択したコントロールと同じ高さに，あとから選択したコントロールの高さがそろいます。

幅と高さをそろえる

メニューフォーム上で2個以上コントロールを選択する。

［編集］－［レイアウト］－［同じサイズに設定］－［幅と高さ］を選択する。
最初に選択したコントロールと同じ幅と高さに，あとから選択したコントロールの幅と高さがそろいます。

コントロールを2個以上選択しないと，メニューがグレーアウトされてメニューを選択できません。

3.6.12　コントロールをテキストの大きさに合わせる

選択したコントロールの大きさをテキストの大きさに合わせます。

操作

メニューフォーム上でコントロールを選択する。

［編集］－［レイアウト］－［テキストへのサイズ合わせ］メニューを選択する。
選択したコントロールの大きさがテキストの大きさにそろいます。

コントロールが選択されていないと，メニューがグレーアウトされてメニューを選択できません。

選択されたコントロールが，スタティックコントロール，ボタンコントロール，またはファイル参照ボタンコントロール以外の場合にはメニューがグレーアウトされてメニューを選択できません。

3.6.13　メニューフォーム上にグリッドを表示する

メニューフォーム上にグリッドを表示します。グリッドの間隔を設定できます。

操作

［編集］－［レイアウト］－［グリッドの設定］を選択する。
［グリッドの設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.4.40　グリッドの設定ダイアログ」を参照してください。

［グリッドを使用する］をチェックする。

［幅］，［高さ］，および［マージン］を設定する。
［幅］，［高さ］，および［マージン］は，ピクセル単位で設定できます。

［OK］をクリックする。
グリッドがメニューフォーム上に表示されます。

コントロールをメニューフォーム上にドラッグすると，コントロールはグリッド上にしか配置できません。グリッドとは関係なくコントロールを配置する場合には，Altキーを押しながらコントロールをドラッグしてください。

Shiftキーを押しながらコントロールをドラッグすると，コントロールを縦方向と横方向にだけ移動できます。

グリッドを表示させたくない場合は，「グリッドを使用する」のチェックを外してください。

3.6.14　タブの移動順序を設定する

タブの移動順序を設定します。

操作

メニューフォームを表示する。

［編集］－［レイアウト］－［タブオーダの設定］を選択する。
［タブオーダの設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.4.41　タブオーダの設定ダイアログ」を参照してください。

フィールド名を選択する。
移動したいフィールド名を選択します（ここでは，Edit4を選択）。

フィールドを移動させる。
選択したフィールドを上に移動させたい場合には［上に移動］ボタン，下に移動させたい場合には［下に移動］ボタン，フィールドの座標の位置の順序でソートしたい場合には［座標位置でソート］を選択します。

［OK］ をクリックする。

3.6.15　選択したコントロールを前面に移動する

選択したコントロールを前面に移動します。

操作

メニューフォーム上のコントロールを選択する。

［編集］－［レイアウト］－［前面へ移動］を選択する。
選択したコントロールがいちばん手前に移動されます。

コントロールが選択されていないと，メニューがグレーアウトされてメニューを選択できません。

3.6.16　選択したコントロールを背面に移動する

選択したコントロールをいちばん後ろに移動します。

操作

メニューフォーム上のコントロールを選択する。

［編集］－［レイアウト］－［背面へ移動］メニューを選択する。
選択したコントロールが背面に移動します。

コントロールが選択されていないと，メニューがグレーアウトされてメニューを選択できません。

3.6.17　コマンドのプロパティを設定する

コマンドのプロパティを設定します。

操作

［ツール］－［コマンドプロパティの設定］を選択する。
［コマンドプロパティの設定］ダイアログが表示されます。

ダイアログの設定方法については，「4.4.37　コマンドプロパティの設定ダイアログ」を参照してください。

必要な情報を入力する。

［OK］をクリックする。
コマンドのプロパティが設定されます。

3.6.18　メニューフォームをテスト表示する

メニューフォームをテスト表示します。

操作

［ツール］－［テスト表示］を選択する。

作成したメニューフォームが表示されます。

3.6.19　メニューフォームの内容を印刷する

作成したメニューフォームの内容を印刷します。

操作

［ファイル］－［メニューフォームの印刷］メニューを選択する。
［メニューフォームの印刷情報］ダイアログが表示されます。

必要な情報を設定する。

［印刷実行］ボタンをクリックする。
メニューフォームの内容が印刷されます。

操作3.で［キャンセル］ボタンをクリックすると，ダイアログを閉じます。

3.7　プロセスビューアの操作

実行中のスクリプトプロセスを監視・制御できます。

また，他のコンピュータで実行中のプロセスも監視・制御できます。

この場合，接続先のコンピュータに存在するユーザでログオンしておく必要があります。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でプロセスビューアを起動しようとすると，次の警告ダイアログを表示した後，プロセスビューアを起動します。

「JP1/Scriptサービスの状態が実行中以外のため，サービスから起動したプロセスおよび他ユーザで実行中のプロセスが表示できません。」

＜この節の構成＞

3.7.1　プロセスビューアの操作項目

3.7.2　実行中のスクリプトプロセスを一覧表示する

3.7.3　スクリプトプロセスの表示更新間隔を指定する

3.7.1　プロセスビューアの操作項目

プロセスビューアアイコンを起動する，またはマネージャの［ツール］－［プロセスビューアの起動］を選択すると，［Scriptプロセスビューア］メッセージボックスが表示されます。

［Scriptプロセスビューア］メッセージボックスを，図3-8に示します。

図3-8　［Scriptプロセスビューア］メッセージボックス

＜この項の構成＞

(1)　コンピュータ名

(2)　クライアントエリア

(1)　コンピュータ名

接続先コンピュータの名称を指定します。［選択］ボタンをクリックして，表示されるコンピュータの選択ダイアログで，接続するコンピュータの名称を選択できます。指定したコンピュータとの接続でエラーが発生した場合は，エラーメッセージが表示されます。また，指定したコンピュータと接続できない場合は，未接続状態になりクライアントエリアには何も表示されません。なお，接続したコンピュータの名称は履歴としてコンボボックスに残ります。

(2)　クライアントエリア

接続先のコンピュータで実行されているスクリプトファイルの情報（プロセス）が表示されます。

ファイル名

現在実行されているスクリプトプロセスのスクリプトファイル名が表示されます。NetExecコマンドから呼び出された実行ファイルは "NetExec－ファイル名" の形式で表示されます。

ステータス

スクリプトプロセスの実行状態が表示されます。

実行状態を示す値は次のとおりです。

実行中：プロセスは実行中です。

終了中：プロセスは終了処理中です。

PID

スクリプトプロセスのプロセスIDが表示されます。

起動日

スクリプトプロセスの起動日が "mm/dd" の形式（mm:月， dd:日）で表示されます。

起動時刻

スクリプトプロセスの起動時刻が "HH:MM:SS" の形式（HH:時， MM:分， SS:秒）で表示されます。

稼働時間

スクリプトプロセスを起動してからの稼働時間が "HH:MM:SS" の形式（HH:時， MM:分， SS:秒）で表示されます。

起動種別

スクリプトプロセスの起動種別が表示されます。

ログオン：ログオン空間で起動されています。

サービス：サービス空間で起動されています。

フォルダ

スクリプトファイルのフォルダ名が表示されます（カレントフォルダ）。

［Scriptプロセスビューア］メッセージボックスには，次のボタンが表示されます。

［オプション］ボタン

クライアントエリアのプロセス表示の更新間隔を設定します。更新の間隔は1秒から60秒の間で設定します。

［プロセスの終了］ボタン

接続先のコンピュータで実行されているスクリプトファイルを終了します（プロセスの終了）。

プロセスを終了するときは，クライアントエリアで終了するプロセスを選択して［プロセスの終了］ボタンをクリックします。表示される［JP1/Scriptプロセスの終了］メッセージで［はい］ボタンをクリックすると，クライアントエリアで選択したプロセスが終了します。

このボタンを無効にしたい場合は，次に示すレジストリキーの値に1を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script¥SPTHView¥Option

〔値名〕

TermButton

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：［プロセスの終了］ボタンを有効にする

1：［プロセスの終了］ボタンを無効にする

〔設定が有効になるタイミング〕

プロセスビューアの次回起動時

［終了］ボタン

［Scriptプロセスビューア］メッセージボックスが閉じます。

［ヘルプ］ボタン

［Scriptプロセスビューア］メッセージボックスのオンラインヘルプが表示されます。

3.7.2　実行中のスクリプトプロセスを一覧表示する

現在実行されているスクリプトプロセスを一覧表示し，プロセスの監視や制御ができます。他のコンピュータで実行されているスクリプトプロセスを一覧表示することもできます。

操作

［コンピュータ名］に他の接続先コンピュータを指定すると，指定した接続先コンピュータで実行されているスクリプトプロセスが表示されます。

［オプション］ボタンを選択すると，［Scriptプロセスビューアオプション］ダイアログが表示されます。ダイアログの設定方法については「3.7.3　スクリプトプロセスの表示更新間隔を指定する」を参照してください。

一覧表示されたスクリプトプロセスを一つ，または複数選択して［プロセスの終了］ボタンを選択すると，選択したスクリプトプロセスを強制終了します。

［終了］ボタンを選択すると，［Scriptプロセスビューア］メッセージボックスを閉じます。

3.7.3　スクリプトプロセスの表示更新間隔を指定する

［Scriptプロセスビューア］メッセージボックスで［オプション］ボタンを選択すると，［オプション］ダイアログが表示されます。

ダイアログの項目

表示の更新間隔

［Scriptプロセスビューア］メッセージボックスで一覧表示されているスクリプトプロセスの表示の更新間隔を秒単位で指定します。

1～60の範囲で指定してください。デフォルトでは「1」が設定されています。

ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［Scriptプロセスビューアオプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないで［Scriptプロセスビューアオプション］ダイアログを閉じます。

3.8　実行環境ファイルコンバータの操作

＜この節の構成＞

3.8.1　実行環境ファイルコンバータの概要

3.8.2　実行環境ファイルの変換手順

3.8.3　実行環境ファイルコンバータの実行方法

3.8.4　実行環境構文ファイル（.SPU）の概要

3.8.5　実行環境構文ファイル（.SPU）の詳細

3.8.1　実行環境ファイルコンバータの概要

UNIX版JP1/Scriptへの実行環境ファイル移行のためのツールです。このプログラムによって実行環境ファイルから実行環境構文ファイル（実行環境ファイル内容がテキストファイル形式で記述されているファイル）を作成できます。

3.8.2　実行環境ファイルの変換手順

Windows上の実行環境ファイルをUNIX上に移行する手順は次のとおりです。

操作

変換する実行環境ファイル（.SPV）を「Script実行環境ファイルコンバータ」で指定して実行する。
実行環境構文ファイル（.SPU）が作成されます。

作成された実行環境構文ファイル（.SPU）をFTP転送でUNIX上に移動する。

手順2.で移動した実行環境構文ファイル（.SPU）を「Script実行環境ファイルコンバータ」に指定して実行する。
UNIX上で使用できる実行環境ファイル（.SPV）が作成されます。

図3-9　実行環境ファイルの移行の流れ

3.8.3　実行環境ファイルコンバータの実行方法

実行環境ファイルコンバータを実行するには，コマンドプロンプトを起動してからコマンドラインに次の形式でコマンドを入力します。

＜この項の構成＞

(1)　実行環境ファイル（.SPV）から実行環境構文ファイル（.SPU）への変換

(2)　実行環境構文ファイル（.SPU）から実行環境ファイル（.SPV）への変換

(1)　実行環境ファイル（.SPV）から実行環境構文ファイル（.SPU）への変換

変換元ファイルに実行環境ファイルの拡張子「.SPV」を指定した場合，この変換を行います。

形式（△：スペース）

sptuspv△/i△fromFileName(△/o△toDirName)

説明

fromFileName

実行環境構文ファイル（.SPU）に変換する実行環境ファイル（.SPV）を指定します。ファイル名にワイルドカード指定ができます。

toDirName

変換後の実行環境構文ファイル（.SPU）が出力されるフォルダを指定します。指定を省略した場合，変換元ファイルと同じフォルダに出力されます。変換後のファイルがすでにある場合は，今までの内容はすべて失われます。

(2)　実行環境構文ファイル（.SPU）から実行環境ファイル（.SPV）への変換

変換元ファイルに実行環境構文ファイルの拡張子「.SPU」を指定した場合，この変換を行います。

形式（△：スペース）

sptuspv△/i△fromFileName(△/o△toDirName)(△operand)

説明

fromFileName

実行環境ファイル（.SPV）に変換する実行環境構文ファイル（.SPU）を指定します。ファイル名にワイルドカード指定ができます。

toDirName

変換後の実行環境ファイル（.SPV）が出力されるフォルダを指定します。指定を省略した場合，変換元ファイルと同じフォルダに出力されます。変換後のファイルがすでにある場合は，今までの内容はすべて失われます。

operand

次のオペランドを指定できます。

/SPT:ALL

一つの実行環境構文ファイル（.SPU）から出力先フォルダに存在するすべてのスクリプトファイル（.SPT）に適用させたい場合に指定します。toDirName，またはtoDirName省略時はfromFileNameの後ろに指定します。

/SPT:ALLを指定した場合，変換元ファイル名にワイルドカードは指定できません（オペランドの組み合わせエラーになります）。

/SPT:ALLを指定した場合の実行環境ファイル作成の流れを次の図に示します。

図3-10　/SPT:ALLを指定した場合の実行環境ファイル作成の流れ

戻り値

正常に終了した場合は，0が返されます。正常に終了しなかった場合は，そのエラーコードが返されます。

表示するメッセージ

sptuspvでは，表3-24に示すメッセージがコンソールに表示されます。コンソールがない状態で実行する場合などは，実行時に標準出力をファイルに割り当て，メッセージを確認してください。メッセージはファイルの変換単位で表示されます。

実行環境ファイル，実行環境構文ファイルにエラーがある場合は，エラーがあるファイルの変換を中止します。fromFileNameのファイル名にワイルドカードを指定していて，未変換のファイルが存在する場合は，変換を続行します。

表3-24　実行環境ファイルコンバータの戻り値とメッセージ

項番 | 戻り値 | 戻り値の意味 | メッセージ
1 | 0 | 正常に終了しました（ワイルドカード指定時，対象ファイルすべての変換が正常に終了しました）。 | ファイルを変換しました。（変換されたファイル名）
2 | 1 | 実行環境構文ファイルの構文に誤りがあります。 | 実行環境構文ファイルの構文に誤りがあります。（エラーとなったファイル名）
3 | 2 | 範囲外の数値が指定されています。 | 実行環境構文ファイル中に範囲外の値が設定されています。（エラーとなったファイル名）
4 | 3 | ファイル形式に誤りがあります。 | ファイルが壊れているかまたはファイルの形式が異なります。（エラーとなったファイル名）
5 | － | 出力先フォルダに変換するファイルが既に存在します。 | 変換後のファイルが出力先ディレクトリに既に存在しました。このファイルの内容はすべて失われました。（上書きされたファイル名）
6 | 4 | 入力ファイルが存在しません。 | システムエラーメッセージ。（エラーとなったファイル名）
7 | 5 | 入力ファイルアクセスエラー。 | ファイル管理情報が読めません。（エラーとなったファイル名）
8 | 20 | 出力先ディレクトリが見つかりません。 | 出力先のディレクトリが見つかりません。（エラーとなったディレクトリ名）
9 | 21 | 出力ファイルアクセスエラー。 | システムエラーメッセージ。（エラーとなったファイル名）
10 | 22 | 実行環境ファイル（.SPV），実行環境構文ファイル（.SPU）以外のファイルを指定しました。 | 指定できないファイルです。（エラーとなったファイル名）
11 | 23 | パラメタを何も指定していないか，指定した内容が不正です。 | パラメタの指定が不正です。
12 | 24 | オペランドが不正です。 | 指定したパラメタの組み合わせに誤りがあります。
13 | 25 | メモリが不足しています。 | メモリが不足しました。
14 | 26 | 対象となるスクリプトファイルがありません。 | 出力先のディレクトリに対象となるスクリプトファイルが存在しませんでした。
15 | 27 | 指定したディレクトリが見つかりません。 | 実行環境構文ファイル中に指定しているディレクトリが見つかりません。（エラーとなったディレクトリ名）
16 | － | 出力ファイルの上書き時に書き込みエラーが発生しました。 | 既に存在するファイルに対して書き込みエラーが発生したため，ファイルを削除しました。（エラーとなったファイル名）
17 | 99 | 一部変換が失敗しました。※ | －

注※

入力ファイルのワイルドカード指定時，項番2，3，4，6，7が発生した場合に返ります。

そのファイルの変換は行われなかったが，そのほかの対象ファイルの変換は行った場合に返ります。

項番2，3，4，6，7以外のエラー時は，その時点で処理が中断されます。

3.8.4　実行環境構文ファイル（.SPU）の概要

実行環境構文ファイル（.SPU）とは，スクリプトの実行環境が設定されている実行環境ファイルの内容をテキスト形式で表したファイルのことです。

実行環境構文ファイルの概要を表3-25に示します。

表3-25　実行環境構文ファイルの概要

ファイルの種類 | ファイル名 | 拡張子 | ファイルの内容
コンバータが扱うファイル | 実行環境構文ファイル | .SPU | 実行環境ファイルの内容をテキスト形式で表したファイルです。実行環境の設定をテキストエディタから行うことを目的としています。

3.8.5　実行環境構文ファイル（.SPU）の詳細

実行環境構文ファイルの形式を図3-11に示します。

図3-11　実行環境構文ファイルのフォーマット

説明

コマンドライン。
トレースファイル，およびイベントログの出力の有無がWindows版の形式で記述されている場合は，UNIX版の形式で変換されます。

作業フォルダ。実行環境ファイルから実行環境構文ファイルに変換した場合，常に空とします。実行環境構文ファイルから実行環境ファイルに変換した場合，この値は有効になります。存在しないフォルダ名の場合，実行環境ファイル変換時に構文エラーとなり，実行環境ファイルは作成されません。

複数起動の許可。許可する場合は1，許可しない場合は0を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。

起動のタイプ。ログオンの場合は0，サービスの場合は1を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

自動起動で日の指定を行うかどうかを指定します。指定する場合は1，指定しない場合は0を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

曜日指定。指定する場合は1，指定しない場合は0を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

曜日。指定できる値は1から7までです。範囲以外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

表3-26　指定値に対する曜日

値 | 曜日
1 | 月曜
2 | 火曜
3 | 水曜
4 | 木曜
5 | 金曜
6 | 土曜
7 | 日曜

日付指定。指定する場合は1，指定しない場合は0を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

日付。指定できる値は1から31までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

時刻指定。指定する場合は1，指定しない場合は0を記述します。それ以外を記述した場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

時刻（時間）。指定できる値は0から23までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

時刻（分）。指定できる値は0から59までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。
Windows版Scriptコンバータの場合だけ有効です。※

打ち切り時間。実行するスクリプトファイルを何分後に強制終了させるかを指定します。指定できる値は0から1,440までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。ただし，0が指定された場合は打ち切り時間なしとみなします。
Windows版Scriptコンバータの場合だけ有効です。※

トレースの出力先フォルダ。存在しないフォルダの場合，解析エラーとします。実行環境ファイルから実行環境構文ファイルに変換した場合，常に空とします。実行環境構文ファイルから実行環境ファイルに変換した場合，この値は有効となります。存在しないフォルダ名の場合，実行環境ファイル変換時に構文エラーとなり，実行環境ファイルは作成されません。

トレース最大行数。指定できる値は100から9,999までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。

トレース最大列数。指定できる値は128から1,024までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。

ユーザトレース最大行数。指定できる値は100から9,999までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。

ユーザトレース最大列数。指定できる値は128から1,024までです。範囲外の値が指定されている場合実行環境ファイル変換時に構文エラーとなり実行環境ファイルは作成されません。

注※　UNIX版の実行環境構文ファイルで記述した（してある）場合，実行環境ファイル（.SPV）の変換ではデフォルト値となります。

その他

実行環境構文ファイル（.SPU）の記述規則は次のとおりです。

すべて項目は省略できることとし，記述しなかった項目にはデフォルト値を仮定します。

同じ項目を二つ以上記述した場合，あとに記述されている値が有効となります。

指定項目の記述する順序は自由です。

行の先頭に"#"を記述することによって，その行はコメントとして扱えます。

4.　ダイアログの説明

この章では，Scriptマネージャウィンドウ，Scriptエディタウィンドウ，Scriptトレースビューアウィンドウ，およびScriptメニューエディタウィンドウのダイアログについて説明します。

＜この章の構成＞

4.1　Scriptマネージャウィンドウのダイアログ

4.2　Scriptエディタウィンドウのダイアログ

4.3　Scriptトレースビューアウィンドウのダイアログ

4.4　Scriptメニューエディタウィンドウのダイアログ

4.1　Scriptマネージャウィンドウのダイアログ

Scriptマネージャウィンドウの操作中に表示されるダイアログの一覧を，次に示します。

各ダイアログの項目，および操作については，4.1.1項以降に説明します。

新規作成ダイアログ

ファイルの複写ダイアログ

ファイルの追加ダイアログ

ファイルの上書き確認ダイアログ

ファイルの削除の確認ダイアログ

名前の変更ダイアログ

実行ダイアログ

実行環境の設定（起動情報）ダイアログ

実行環境の設定（終了情報）ダイアログ

実行環境の設定（トレース情報）ダイアログ

実行環境（コマンドライン）の設定ダイアログ

コマンドラインの設定ダイアログ

実行環境（作業フォルダ）の設定ダイアログ

実行環境（起動日時）の設定ダイアログ

実行環境（打ち切り時間）の設定ダイアログ

実行環境（トレース出力先フォルダ）の設定ダイアログ

実行環境（ユーザトレース情報）の設定ダイアログ

フォルダの変更ダイアログ

ファイルのプロパティダイアログ

自動起動の設定ダイアログ

エディタの関連付けダイアログ

オプション（サーバ情報）ダイアログ

更新情報ダイアログ

オプション（互換性）ダイアログ

オプション（複数起動）ダイアログ

オプション（JP1/IM）ダイアログ

オプション（トレース）ダイアログ

オプション（クラスタ環境）ダイアログ

フォルダの選択ダイアログ

＜この節の構成＞

4.1.1　新規作成ダイアログ

4.1.2　ファイルの複写ダイアログ

4.1.3　ファイルの追加ダイアログ

4.1.4　ファイルの上書き確認ダイアログ

4.1.5　ファイルの削除の確認ダイアログ

4.1.6　名前の変更ダイアログ

4.1.7　実行ダイアログ

4.1.8　実行環境の設定（起動情報）ダイアログ

4.1.9　実行環境の設定（終了情報）ダイアログ

4.1.10　実行環境の設定（トレース情報）ダイアログ

4.1.11　実行環境（コマンドライン）の設定ダイアログ

4.1.12　コマンドラインの設定ダイアログ

4.1.13　実行環境（作業フォルダ）の設定ダイアログ

4.1.14　実行環境（起動日時）の設定ダイアログ

4.1.15　実行環境（打ち切り時間）の設定ダイアログ

4.1.16　実行環境（トレース出力先フォルダ）の設定ダイアログ

4.1.17　実行環境（ユーザトレース情報）の設定ダイアログ

4.1.18　フォルダの変更ダイアログ

4.1.19　ファイルのプロパティダイアログ

4.1.20　自動起動の設定ダイアログ

4.1.21　エディタの関連付けダイアログ

4.1.22　オプション（サーバ情報）ダイアログ

4.1.23　更新情報ダイアログ

4.1.24　オプション（互換性）ダイアログ

4.1.25　オプション（複数起動）ダイアログ

4.1.26　オプション（JP1/IM）ダイアログ

4.1.27　オプション（トレース）ダイアログ

4.1.28　オプション（クラスタ環境）ダイアログ

4.1.29　フォルダの選択ダイアログ

4.1.1　新規作成ダイアログ

Scriptマネージャウィンドウで［ファイル］－［新規作成］を選択したときに表示されるダイアログです。

作成するスクリプトファイル名を設定します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

作成するスクリプトファイル名

作成するスクリプトファイル名を設定します。

エンジンバージョンを挿入する

スクリプトファイルの先頭に，スクリプトファイルを実行するスクリプトエンジンのバージョンを挿入するときに指定します。なおこの指定は，エディタの関連付けダイアログで，専用のエディタ以外が関連付けられている場合にだけ有効です。

(2)　ダイアログでの操作

作成するスクリプトファイル名を入力して［OK］ボタンをクリックすると，［ツール］－［エディタの関連付け］で指定したエディタが起動します。

［キャンセル］ボタンをクリックすると新規作成を中断します。

(3)　処理詳細

ファイル名は，Windowsファイルシステムの名前の規則に従ってください。ただし，次の半角文字は使用できません。

「=」， 「:」， 「，」， 「.」， 「{」， 「}」

使用するネットワークOSによっては，ファイルの名前の付け方が異なります。各ネットワークOSのファイルシステムの名前の規則に従ってください。

使用するエディタが，［ツール］－［エディタの関連付け］メニューで指定されていないときは，その旨のメッセージを表示して処理を中断します。

専用のエディタで作成したスクリプトファイルを，Scriptマネージャウィンドウのクライアントエリアに反映するには，［表示］－［最新の状態に更新］メニューを実行する必要があります。

［エンジンバージョンを挿入する］を指定すると，スクリプトファイルの先頭行に，次の内容が挿入されます。
「#FileVersion=VVRR（VV：JP1/Scriptのバージョン， RR：JP1/Scriptのリビジョン）」
VVRRにはインストールされているJP1/Scriptのバージョンリビジョンが設定されます。
上記の指定がない場合は，Scriptマネージャウィンドウの［オプション（互換性）］ダイアログで設定されたバージョンで，スクリプトファイルが実行されます。

注意

Windows標準のワードパットはエディタとして使用できません。そのほかの，TXT形式で保存できるエディタをご利用ください。

スクリプトエンジンのバージョンは，インストールされているJP1/Scriptのバージョンと同じである必要はありません。指定したスクリプトエンジンのバージョンの文法規則を適用して，スクリプトファイルを実行できます。詳細は，「6.1.11 コーディング規則」を参照してください。

4.1.2　ファイルの複写ダイアログ

Scriptマネージャウィンドウで，アイコンを一つ選択してから，［ファイル］－［複写］メニューを選択すると表示されるダイアログです。

現在表示されているフォルダから別のフォルダへ複写するスクリプトファイルを選択します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

複写するファイル名

マネージャウィンドウであらかじめ選択した一つ，または複数のファイル名が表示されます。

複写先のフォルダ

複写先のフォルダ名を指定します。

［選択］ボタンを選択すると［フォルダの選択］ダイアログが表示されます。

選択

このボタンを選択すると，複写先のフォルダを選択する［フォルダの選択］ダイアログが表示されます。

(2)　ダイアログでの操作

複写先のフォルダ名を入力し，複写するファイル名から一つ，または複数のファイルを選択します。［選択］ボタンを押して，複写先のフォルダを選択することもできます。

［OK］ボタンをクリックするとファイルが複写されます。［キャンセル］ボタンをクリックすると，ファイルの複写を中断します。

(3)　処理詳細

複写処理中は進捗ダイアログに複写状況が表示されます。

複写先に同じ名前のファイルがある場合は，［ファイルの上書き確認］ダイアログが表示されます。

4.1.3　ファイルの追加ダイアログ

Scriptマネージャウィンドウで，アイコンを一つ選択してから，［ファイル］－［追加］メニューを選択すると表示されるダイアログです。

ほかのフォルダのスクリプトファイルを現在表示されているフォルダに追加します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

追加するファイル名

追加元フォルダにあるスクリプトファイルが表示されます。

ここで，追加するファイル名を一つ，または複数選択します。

追加元フォルダ

追加するファイルがあるフォルダ名を指定します。

選択

このボタンを選択すると，追加元のフォルダを選択する［フォルダの選択］ダイアログが表示されます。

(2)　ダイアログでの操作

複写先のフォルダ名を入力し，複写するファイル名から一つ，または複数のファイルを選択します。［選択］ボタンを押して，複写先のフォルダを選択することもできます。

［OK］ボタンをクリックするとファイルが複写されます。［キャンセル］ボタンをクリックすると，ファイルの複写を中断します。

(3)　処理詳細

追加処理中は進捗ダイアログに追加状況が表示されます。

追加先（現在のフォルダ）に同じ名前のファイルがある場合は，［ファイルの上書き確認］ダイアログが表示されます。

4.1.4　ファイルの上書き確認ダイアログ

ファイルの複写やファイルの追加で，ファイルが上書きされるときに表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

元のファイル

複写，または追加するファイルの名前が表示されます。上書きはできません。

ファイル名の下には，ファイルの容量，更新日付・時刻が表示されます。

新しいファイル

上書きされるファイルの名前が表示されます。ファイル名の下には，上書きされるファイルの容量，更新日付・時刻が表示されます。

上書きしない場合は，新しい名前を指定し，［はい］ボタンをクリックします。

(2)　ダイアログでの操作

ファイルを上書きする場合は，［はい］，または［すべて上書き］ボタンをクリックします。［すべて上書き］ボタンをクリックした場合は，以降のファイルに対して上書き確認されなくなります。

［いいえ］ボタンをクリックするとファイルは上書きされないで処理が続行されます。

［キャンセル］ボタンをクリックすると処理は中断されます。

4.1.5　ファイルの削除の確認ダイアログ

Scriptマネージャウィンドウで，アイコンを一つ選択してから，［ファイル］－［削除］メニューを選択すると表示されるダイアログです。

作成されているスクリプトファイルを削除します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

削除するファイル名

Scriptマネージャウィンドウであらかじめ選択した一つ，または複数のファイル名が表示されます。

(2)　ダイアログでの操作

削除するファイル名の一覧から，一つ，または複数のファイルを選択します。［はい］ボタンを選択すると，ファイルが削除されて，Scriptマネージャウィンドウのクライアントエリアからアイコンが消去されます。複数のファイルを選択した場合は，次のファイルに処理が移ります。

［すべて削除］ボタンを選択すると，削除するファイル名の一覧に表示されているすべてのファイルが削除されます。

［いいえ］ボタンを選択すると，ファイルは削除されません。複数のファイルを選択した場合は，次のファイルに処理が移ります。

［キャンセル］ボタンをクリックすると，ファイルの削除を中止します。

4.1.6　名前の変更ダイアログ

［ファイル］－［名前の変更］メニューを選択すると表示されるダイアログです。

Scriptマネージャウィンドウであらかじめ選択したスクリプトファイルの名前を別の名前に変更します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

元の名前

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

新しい名前

変更する名前を表示します。

(2)　ダイアログでの操作

新しい名前を入力して［OK］ボタンを選択すると，ファイル名が変更されます。

［キャンセル］ボタンを選択すると，ダイアログを閉じて名前の変更を中止します。

(3)　処理詳細

ファイル名は，Windowsファイルシステムの名前の規則に従ってください。ただし，次の半角文字は使用できません。

「=」， 「:」， 「，」， 「.」， 「{」， 「}」

使用するネットワークOSによっては，ファイルの名前の付け方が異なります。各ネットワークOSのファイルシステムの名前の規則に従ってください。

4.1.7　実行ダイアログ

Scriptマネージャウィンドウで，アイコンを一つ選択してから，［ファイル］－［実行］メニューを選択すると表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

実行するスクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

ウィンドウを表示する

解析トレース，実行トレース，および実行状況のウィンドウを表示するかどうかを指定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，スクリプトが実行されます。

［キャンセル］ボタンを選択すると，スクリプトの実行が中止されます。

［詳細］ボタンを選択すると，実行環境を設定できます。設定した内容は，実行環境ファイルに登録されます。
実行環境の設定方法については，「4.1.8　実行環境の設定（起動情報）ダイアログ」，「4.1.9　実行環境の設定（終了情報）ダイアログ」，「4.1.10　実行環境の設定（トレース情報）ダイアログ」を参照してください。

(3)　処理詳細

実行中は，実行状態を表す状態表示画面が表示されます。

4.1.8　実行環境の設定（起動情報）ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［すべての項目］メニューを選択すると，［実行環境の設定］ダイアログが表示されます。

また，［実行］ダイアログから［詳細］ボタンを選択しても表示されます。

［実行環境の設定］ダイアログには，「起動情報」「終了情報」「トレース情報」の三つのタブがあります。

「起動情報」タブを選択すると，［実行環境の設定（起動情報）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態で実行環境の設定（起動情報）をしようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境の設定（起動情報）］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

コマンドライン

実行時に必要なコマンドラインを指定します。

パラメタや，トレースファイル，およびイベントログの出力の有無などを指定できます。

［設定］ボタンを選択すると，［コマンドラインの設定］ダイアログが表示されます。

詳細は，「6.2　コマンドラインに関する規則」を参照してください。

作業フォルダ

実行時のカレントドライブ，またはフォルダを指定します。

［選択］ボタンを選択すると，［フォルダの選択］ダイアログが表示されます。

指定がない場合は，スクリプトファイルのフォルダが選択されます。

起動情報

自動起動する場合の起動先の空間を指定します。曜日・日・時刻の設定が無い場合，次に示す条件で起動されます。

ログオン：OSにログオンした時

サービス：電源投入時

起動先がログオンで曜日・日・時刻を設定していてもOSにログオンしていなければ，起動されません。

複数起動を許可する

一つのスクリプトを複数同時に実行することを許可する場合にチェックします。

同時実行数の上限はありません。しかし，同時実行数が多くなれば，その分システムリソースを消費します。そのため，同時実行するスクリプト数に注意してください。

この値をチェックした場合，トレース出力先フォルダは［実行環境の設定（トレース情報）］ダイアログの「出力先フォルダ」ではなく，［オプション（複数起動）］ダイアログの「トレースファイルの出力先フォルダ」で指定します。ダイアログの設定方法については，「4.1.25　オプション（複数起動）ダイアログ」を参照してください。

なお，トレース出力先フォルダはスクリプトファイル単位に指定できません。そのため，同一名称のスクリプトファイルそれぞれに「複数起動を許可する」を指定した場合，それぞれの解析トレースファイル，および実行トレースファイルは，同一フォルダに同一名称で出力されることになりますので，注意してください。

自動起動情報に登録する

Scriptランチャによって自動起動する場合にチェックします。

曜日の設定をする※

指定曜日を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

曜日※

毎週何曜日に起動するかを指定します。

「曜日の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

日の設定をする※

指定日を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

日※

毎月何日に起動するかを指定します。

1～31の範囲で指定してください。なお，指定した日が存在しない月は起動されません。

「日の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

時刻の設定をする※

指定時刻を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

時刻※

何時何分に起動するかを指定します。

00:00～23:59の範囲で指定してください。なお，指定時刻がScriptランチャの起動時刻より前の場合は，翌日に起動されます。

「時刻の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

注※　JP1/Scriptサービスの起動時，またはScriptランチャの起動時にだけ有効になる情報です。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報が各実行環境ファイルとして作成されます。

［キャンセル］を選択すると，実行環境ファイルを作成しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

日，および時刻が設定されていない場合，JP1/Scriptサービスの起動時，またはScriptランチャの起動時に起動されます。

Windows XPでは，起動のタイプがログオンのスクリプトファイルに対して自動起動情報の登録をした場合，登録したユーザでしか自動起動されません。

4.1.9　実行環境の設定（終了情報）ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［すべての項目］メニューを選択すると，［実行環境の設定］ダイアログが表示されます。

また，［実行］ダイアログから［詳細］ボタンを選択しても表示されます。

［実行環境の設定］ダイアログには，「起動情報」「終了情報」「トレース情報」の三つのタブがあります。

「終了情報」タブを選択すると，［実行環境の設定（終了情報）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態で実行環境の設定（終了情報）をしようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境の設定（終了情報）］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

打ち切り時間

実行するスクリプトファイルを何分後に強制終了させるかを指定します。

0～1,440の範囲で指定してください。ただし，0が指定された場合は打ち切り時間なしとみなします。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報が各実行環境ファイルとして作成されます。

［キャンセル］を選択すると，実行環境ファイルを作成しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

「打ち切り時間」を設定しておけば，特定の時間内に終了するはずの処理が何らかの異常によって終了しなかった場合に，自動的に強制終了させることができます。

4.1.10　実行環境の設定（トレース情報）ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［すべての項目］メニューを選択すると，［実行環境の設定］ダイアログが表示されます。

また，［実行］ダイアログから［詳細］ボタンを選択しても表示されます。

［実行環境の設定］ダイアログには，「起動情報」「終了情報」「トレース情報」の三つのタブがあります。

「トレース情報」タブを選択すると，［実行環境の設定（トレース情報）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態で実行環境の設定（トレース情報）をしようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境の設定（トレース情報）］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

出力先フォルダ

解析トレースファイル，および実行トレースファイルを出力する先のフォルダを指定します。

存在しないフォルダ名を指定した場合，スクリプトファイル実行開始時に作成されます。

［選択］ボタンを選択すると，［フォルダの選択］ダイアログが表示されます。

なお，［実行環境の設定（起動情報）］ダイアログで「複数起動を許可する」がチェックされた場合にはグレーアウトされ指定できません。

最大行数

解析トレースファイル，および実行トレースファイルの最大出力行数を指定します。

100～9,999の範囲で指定してください。

最大列数

解析トレースファイル，および実行トレースファイルの最大出力列数を指定します。

128～1,024の範囲で指定してください。

ユーザトレース情報

最大行数

ユーザトレースファイルの最大出力行数を指定します。

100～9,999の範囲で指定してください。

最大列数

ユーザトレースファイルの最大出力列数を指定します。

128～1,024の範囲で指定してください。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報が各実行環境ファイルとして作成されます。

［キャンセル］を選択すると，実行環境ファイルを作成しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

4.1.11　実行環境（コマンドライン）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［コマンドライン］メニューを選択すると，［実行環境（コマンドライン）の設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（コマンドライン）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

コマンドライン

実行時に必要なコマンドラインを指定します。

パラメタや，トレースファイル，およびイベントログの出力の有無などを指定できます。

［設定］ボタンを選択すると，［コマンドラインの設定］ダイアログが表示されます。

詳細は，「6.2　コマンドラインに関する規則」を参照してください。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

4.1.12　コマンドラインの設定ダイアログ

［実行環境の設定（起動情報）］，または［実行環境（コマンドライン）の設定］ダイアログで，［設定］ボタンをクリックすることによって表示されるダイアログです。

実行時に必要なコマンドラインを設定します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

解析トレースファイル

解析トレースファイルの出力の有無を指定します。

デフォルトでは「出力する」が設定されています。

ここで指定した内容は，［実行環境の設定（起動情報）］ダイアログ，および［実行環境の設定（コマンドライン）］ダイアログのコマンドラインに"/SPALV(n)"の形式※で設定されます。

実行トレースファイル

実行トレースファイルの出力の有無，および出力レベルを指定します。

デフォルトでは「エラー時の結果だけ出力する」が設定されています。

ここで指定した内容は，［実行環境の設定（起動情報）］ダイアログ，および［実行環境の設定（コマンドライン）］ダイアログのコマンドラインに"/SPXLV(n)"の形式※で設定されます。

「正常時の結果も出力する」または「コマンド開始時刻と終了時刻も出力する」を選択すると，出力される情報量が多くなるため，スクリプトファイルの実行性能が劣化します。

出力しないイベントログ

実行時に出力されるイベントログの出力を抑止する場合に選択します。

［すべて選択］ボタンを選択すると，すべてのイベントログが選択されます。［クリア］ボタンを選択すると，選択したイベントログを選択解除します。

デフォルトではすべての項目が選択されていません。

ここで指定した内容は，［実行環境の設定（起動情報）］ダイアログ，および［実行環境の設定（コマンドライン）］ダイアログのコマンドラインに"/NOEVLOG"，または"/NOEVLOG(n，n，…)"の形式※で設定されます。

ユーザコマンドライン※

ユーザ指定のコマンドラインを指定します。

注※　コマンドの形式は，「6.2.2　コマンドラインのパラメタの説明」を参照してください。

(2)　ダイアログでの操作

必要に応じて，コマンドラインの情報を設定します。

［OK］を選択すると，ダイアログで設定した情報が［実行環境の設定（起動情報）］ダイアログのコマンドラインに設定されます。

［キャンセル］を選択すると，内容を変更しないでダイアログを閉じます。

処理詳細

「出力しないイベントログ」のリストには，実行時に出力されるイベントログのうちログの種類がエラー以外のイベントログが表示されています。

4.1.13　実行環境（作業フォルダ）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［作業フォルダ］メニューを選択すると，［実行環境（作業フォルダ）の設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（作業フォルダ）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

作業フォルダ

実行時のカレントドライブ，またはフォルダを指定します。指定がない場合は，スクリプトファイルのフォルダが選択されます。

補足

実行時のカレントフォルダ（作業フォルダ）は，SetPathコマンドで設定できます。

SetPathコマンドの詳細は，「8.5.28　SetPath （実行フォルダのパスを設定する）」を参照してください。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

4.1.14　実行環境（起動日時）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［起動日時］メニューを選択すると，［実行環境（起動日時）の設定］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態で実行環境（起動日時）を設定しようとすると，次のエラーダイアログを表示します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

Scriptランチャサービスでは使用できません。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（起動日時）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

起動のタイプ

ログオン・サービス

ログオン時に起動するか，サービス（電源投入時）で起動するかを選択します。

自動起動情報に登録する

Scriptランチャによって自動起動する場合にチェックします。

曜日の設定をする※

指定曜日を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

曜日※

毎週何曜日に起動するかを指定します。

「曜日の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

日の設定をする※

指定日を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

日※

毎月何日に起動するかを指定します。

1～31の範囲で指定してください。なお，指定した日が存在しない月は起動されません。

「日の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

時刻の設定をする※

指定時刻を決めて起動する場合に選択します。

「自動起動情報に登録する」がチェックされていない場合は，グレーアウトされて選択できません。

時刻※

何時何分に起動するかを指定します。

00:00～23:59の範囲で指定してください。なお，指定時刻がScriptランチャの起動時刻より前の場合は，翌日に起動されます。

「時刻の設定をする」がチェックされていない場合は，グレーアウトされて指定できません。

注※　JP1/Scriptサービスの起動時，またはScriptランチャの起動時にだけ有効になる情報です。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

日，および時刻が設定されていない場合，JP1/Scriptサービスの起動時，またはScriptランチャの起動時に起動されます。

4.1.15　実行環境（打ち切り時間）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［打ち切り時間］メニューを選択すると，［実行環境（打ち切り時間）の設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（打ち切り時間）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

打ち切り時間

実行するスクリプトファイルを何分後に強制終了させるかを指定します。

0～1,440の範囲で指定してください。ただし，0が指定された場合は打ち切り時間なしとみなします。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

「打ち切り時間」を設定しておけば，特定の時間内に終了するはずの処理が何らかの異常によって終了しなかった場合に，自動的に強制終了させることができます。

4.1.16　実行環境（トレース出力先フォルダ）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［トレース出力先フォルダ］メニューを選択すると，［実行環境（トレース出力先フォルダ）の設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（トレース出力先フォルダ）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

複数起動を許可する

複数のプロセスから同時に実行することを許可する場合にチェックします。

この値をチェックした場合，トレース出力先フォルダは「出力先フォルダ」ではなく，［オプション（複数起動）］ダイアログの「トレースファイルの出力先フォルダ」で指定します。

同時実行数の上限はありません。しかし，同時実行数が多くなれば，その分システムリソースを消費します。そのため，同時実行するスクリプト数に注意してください。

出力先フォルダ

解析トレースファイル，および実行トレースファイルを出力する先のフォルダを指定します。

存在しないフォルダ名を指定した場合，スクリプトファイル実行開始時に作成されます。

［選択］ボタンを選択すると，［フォルダの選択］ダイアログが表示されます。

「複数起動を許可する」がチェックされた場合にはグレーアウトされ指定できません。

最大行数

解析トレースファイル，および実行トレースファイルの最大出力行数を指定します。

100～9,999の範囲で指定してください。

最大列数

解析トレースファイル，および実行トレースファイルの最大出力列数を指定します。

128～1,024の範囲で指定してください。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

4.1.17　実行環境（ユーザトレース情報）の設定ダイアログ

Scriptマネージャウィンドウでアイコンを一つ，または複数選択してから，［ファイル］－［実行環境の設定］－［ユーザトレース情報］メニューを選択すると，［実行環境（ユーザトレース情報）の設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［実行環境（ユーザトレース情報）の設定］ダイアログでは，選択したスクリプトファイルに対して，次の項目を設定できます。

スクリプトファイル名

Scriptマネージャウィンドウで選択したファイル（アイコン）の名前が表示されます。

アイコンを複数選択した場合は複数のファイルの名前を昇順にソートして表示します。

最大行数

ユーザトレースファイルの最大出力行数を指定します。

100～9,999の範囲で指定してください。

最大列数

ユーザトレースファイルの最大出力列数を指定します。

128～1,024の範囲で指定してください。

(2)　ダイアログでの操作

必要に応じて，実行環境の情報を設定します。

［OK］を選択すると，ダイアログで設定した情報で各実行環境ファイルが変更されます。

［キャンセル］を選択すると，各実行環境ファイルを変更しないでダイアログを閉じます。

(3)　処理詳細

アイコンを複数選択した場合の各項目のデフォルトでは，「スクリプトファイル名」の先頭に表示されたファイルの実行環境の情報が設定されています。また，「スクリプトファイル名」に表示されたファイルの名前を一つ選択するとそのファイルの情報が各項目に設定されます。

4.1.18　フォルダの変更ダイアログ

［ファイル］－［フォルダの変更］メニューを選択すると表示されるダイアログです。

クライアントエリアに表示中のフォルダ（現在選択されているフォルダ）を，指定されたフォルダに変更します。クライアントエリアには，指定されたフォルダに格納されているスクリプトファイルが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　補足

(1)　ダイアログの項目

フォルダ

上の表示領域には，選択しているフォルダ名が表示されます。

フォルダ名が表示領域より長い場合は，最終部分が表示されます。

下の表示領域には，ドライブ名とフォルダ名がツリー構造で表示されます。

ネットワーク

［ネットワークドライブの割り当て］ダイアログを表示します。

(2)　ダイアログでの操作

フォルダを選択してから［OK］ボタンをクリックすると，フォルダが変更され，変更後のフォルダの情報がクライアントエリアに表示されます。

［キャンセル］ボタンをクリックすると，フォルダを変更しないでダイアログを閉じます。

(3)　補足

直前に変更したフォルダは，このダイアログを表示しないでも変更できます。その場合は，［ファイル］メニューにあるフォルダ名を直接選択してください。

4.1.19　ファイルのプロパティダイアログ

Scriptマネージャウィンドウでアイコンを一つ選択してから，マウスの右ボタンをクリックし，ポップアップメニューから［プロパティ］を選択すると表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(1)　ダイアログの項目

スクリプトファイル名

選択されたファイル（アイコン）の名前が表示されます。

作成日時

ファイルの作成日と時刻が表示されます。

更新日時

ファイルの更新日と時刻が表示されます。

ファイル容量

ファイルの容量が表示されます。

4.1.20　自動起動の設定ダイアログ

Scriptマネージャウィンドウで，［ツール］－［自動起動の設定］メニューを選択すると表示されるダイアログです。

Scriptランチャによって自動起動されるスクリプトファイルの名前を設定します。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態で自動起動を設定しようとすると，次のエラーダイアログを表示します。
「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

Scriptランチャサービスでは使用できません。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

スクリプトファイル名

現在の実行フォルダ下にある実行環境ファイルのうち「自動起動情報へ登録する」が定義されていないスクリプトファイルのファイル名が表示されます。

自動起動するスクリプトファイル名

実行環境ファイルで「自動起動情報へ登録する」が定義されているスクリプトファイルのファイル名が表示されます。

起動

起動のタイプが表示されます。

時刻

時刻による起動が設定されているかどうかを表示します。

設定されている場合は○を，設定されていない場合は×を表示します。

日

日による起動が設定されているかどうかを表示します。

設定されている場合は○を，設定されていない場合は×を表示します。

打切り

打ち切り時間の設定がされているかどうかを表示します。

設定されている場合は○を，設定されていない場合は×を表示します。

(2)　ダイアログでの操作

「スクリプトファイル名」のリストボックスから自動起動させたいスクリプトファイルを選択して［追加］ボタンを選択すると，選択したファイルが「自動起動するスクリプトファイル名」のリストボックスに追加され，「スクリプトファイル名」のリストボックスから削除されます。

［すべて追加］ボタンを選択すると，すべてのファイルが「自動起動するスクリプトファイル名」のリストボックスに追加され，「スクリプトファイル名」のリストボックスから削除されます。

「自動起動するスクリプトファイル名」のリストボックスからファイルを選択して［削除］ボタンを選択すると，選択したファイルが「自動起動するスクリプトファイル名」のリストボックスから削除され，「スクリプトファイル名」のリストボックスに追加されます。

［すべて削除］ボタンを選択すると，すべてのファイルが「自動起動するスクリプトファイル名」のリストボックスから削除され，「スクリプトファイル名」のリストボックスに追加されます。

［OK］ボタンを選択すると，「自動起動するスクリプトファイル名」のリストボックスの内容を自動起動情報ファイルとして出力します。

［キャンセル］ボタンを選択すると，自動起動情報ファイルを出力しないでダイアログを閉じます。

(3)　処理詳細

最初にダイアログを開いたときは，その時点の自動起動情報ファイルの内容がリストボックスに表示されます。

現在の実行フォルダ下にあるスクリプトファイルのうち実行環境ファイルがない場合は，このダイアログを開いた時点で作成されます。［OK］ボタン，［キャンセル］ボタンのどちらを選択しても実行環境ファイルは作成されます。

Windows XPでは，起動のタイプがログオンのスクリプトファイルを追加した場合，追加したユーザでしか自動起動されません。

4.1.21　エディタの関連付けダイアログ

Scriptマネージャウィンドウで，［ツール］－［エディタの関連付け］メニューを選択すると表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

別のエディタを使用する

Scriptエディタ以外のエディタを使用する場合はチェックします。

アプリケーション名

関連付けするエディタの名前を表示します。

エディタは，［選択］ボタンを選択して表示されるアプリケーションの一覧から選択できます。

作業フォルダ

関連付けするエディタの作業フォルダを表示します。

作業フォルダは，［選択］ボタンを選択して表示される一覧から選択できます。

(2)　ダイアログでの操作

関連付けをするアプリケーション名を選択して［OK］ボタンを選択すると，エディタを関連付けします。

［キャンセル］ボタンを選択すると，エディタを関連付けしないでダイアログを閉じます。

(3)　処理詳細

作業フォルダの指定を省略した場合，次のフォルダが仮定されます。

［別のエディタを使用する］をチェックしたとき：

そのエディタが格納されているフォルダが仮定されます。

［別のエディタを使用する］をチェックしないとき：

編集対象のスクリプトファイルが格納されているフォルダが仮定されます。

4.1.22　オプション（サーバ情報）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「サーバ情報」タブを選択すると，［オプション（サーバ情報）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（サーバ情報）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

コマンド名

クライアントによる実行の認否を設定するコマンド名が表示されます。

認否

クライアントによる各コマンドの実行を許可するかどうかが表示されます。

○が許可を，×が禁止を意味します。

更新

このボタンを選択すると，［更新情報］ダイアログが表示されます。

サーバトレースを出力する

サーバ上で実行したコマンドのトレース情報を出力するかどうかを設定します。

デフォルトではチェックされています。

出力先は，インストール先フォルダの"DATA"フォルダ※下で"SPTSVTRC.SPY"固定です。

ただし，［ツール］－［オプション（クラスタ環境）］ダイアログで管理ファイルの出力先が変更されている場合，指定されたフォルダ下に出力します。

注※　Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

プロセスビューアを受け付ける

クライアントによるプロセスビューアの操作を受け付けるかどうかを設定します。

デフォルトではチェックされています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

このダイアログで設定した「プロセスビューアを受け付ける」以外のサーバの環境は，サーバ環境ファイル（SPTSV.SPS）に保存されます。

4.1.23　更新情報ダイアログ

［オプション（サーバ情報）］ダイアログで，［更新］ボタンをクリックすることによって表示されるダイアログです。

クライアントによる各コマンドの実行を許可するかどうかを設定します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

対象コマンド名

更新の対象となるコマンド名が表示されます。

クライアントで実行を許可する

クライアントによる各コマンドの実行を許可するかどうかを設定します。

デフォルトでは，チェックされています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［更新情報］ダイアログを閉じ，［オプション（サーバ情報）］ダイアログに戻ります。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じ，［オプション（サーバ情報）］ダイアログに戻ります。

4.1.24　オプション（互換性）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「互換性」タブを選択すると，［オプション（互換性）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（互換性）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

スクリプトエンジンのバージョン

スクリプトファイルを実行するときに使用するスクリプトエンジンのバージョンを指定します。

デフォルトでは，「0100xxを使用」が設定されています。

注意

スクリプトエンジンのバージョンは，インストールされているJP1/Scriptのバージョンと同じである必要はありません。

指定したスクリプトエンジンのバージョンの文法規則を適用して，スクリプトファイルを実行できます。詳細は，「6.1.11　コーディング規則」を参照してください。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

実行するスクリプトファイルの先頭にスクリプトエンジンのバージョンが記述されていない場合，ここで指定したバージョンのスクリプトエンジンが使用されます。

4.1.25　オプション（複数起動）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「複数起動」タブを選択すると，［オプション（複数起動）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（複数起動）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

トレースファイルの出力先フォルダ

複数起動時に出力するトレースファイルの出力先フォルダを指定します。

指定できるのは，ローカルドライブにあるフォルダだけです。デフォルトでは「（JP1/Scriptインストールディレクトリ）¥DATA」※が設定されています。

ここで指定した内容は，［実行環境の設定］－［すべての項目］ダイアログの［起動情報］タブページ，または［実行環境の設定］－［トレース出力先フォルダ］ダイアログの「複数起動を許可する」がチェックされている場合にだけ有効になります。

注※　Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

［ツール］－［オプション（クラスタ環境）］ダイアログで「管理ファイルの出力先を変更する」がチェックされている場合，「トレースファイルの出力先フォルダ」はグレーアウトされて指定された値は無効になります。

4.1.26　オプション（JP1/IM）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「JP1/IM」タブを選択すると，［オプション（JP1/IM）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（JP1/IM）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

コマンドの実行結果などをJP1/IMのイベントコンソールへ表示する

コマンドの実行結果などをJP1/IMのイベントコンソールに表示する場合にチェックします。

表示するイベント

スクリプトの開始

スクリプトの開始を表すイベントを，イベントコンソールに表示させる場合にチェックします。

スクリプトの終了

スクリプトの終了を表すイベントを，イベントコンソールに表示させる場合にチェックします。

コマンドエラー終了時のエラーメッセージ

コマンドのエラー終了を表すイベントを，イベントコンソールに表示させる場合にチェックします。

コマンド正常終了時のメッセージ

コマンドの正常終了を表すイベントを，イベントコンソールに表示させる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「コマンドの実行結果などをJP1/IMのイベントコンソールへ表示する」の項目は，ご使用のPCにJP1/IM，またはJP1/Baseがインストールされている場合にだけ設定できます。インストールされていない場合には，グレーアウトされて設定できません。

ご使用のPCにJP1/IM，またはJP1/Baseがインストールされていれば，JP1/IM，またはJP1/Baseのサービスが起動されているかどうかには関係なく，このダイアログで設定した内容が有効になります。

スクリプトをマネージャ（ウィンドウを表示する）や専用のエディタから起動した場合は，表示するイベントのうち「スクリプトの開始」や「スクリプトの終了」を指定していても，JP1/IMのイベントコンソールへ表示しません。

この機能で実行結果を表示できるコマンドは次のとおりです。

(a)　基本コマンド

TextOpen ， TextClose ， MakeDir ， DeleteDir ， DeleteFile ， Rename ， SetFileAttribute ， GetFileAttribute ， SetFileTime ， GetFileTime ， GetFileSize ， GetVersionInfo ， SplitFile ， CatFiles ， SetStandardFile ， ResetStandardFile ， SetVolumeLabel ， GetVolumeLabel ， Copy ， Exec ， NetExec ， WaitForExec ， EntryStartUp ， CancelStartUp ， JOBSubmit ， JOBWait ， JOBHold ， JOBCancel

(b)　特殊コマンド

ServiceCreate ， ServiceDelete ， ServiceStart ， ServiceStop ， ServicePause ， ServiceContinue ， ServiceChange ， ServiceControl ， CallDll ， MakeGroup ， DeleteGroup ， MakeShortcut ， DeleteShortcut ， TerminateProcess ， ExitWindows

4.1.27　オプション（トレース）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「トレース」タブを選択すると，［オプション（トレース）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（トレース）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

トレース管理ファイルの初期割り当てデータ数

トレース管理ファイルに登録できるトレースファイルの初期割り当て件数を指定します。

16～32,000の範囲で指定してください。デフォルトでは「1024」が設定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

初期割り当てデータ数を変更するとトレース管理ファイル（SPTLOGDB.SPB）の内容はクリアされます。このため，トレースビューアウィンドウに表示されていたデータは表示されなくなります。また，トレースファイルの表示ウィンドウの表示が不正になることもあります。この場合は，トレースファイルの表示ウィンドウを開き直してください。

4.1.28　オプション（クラスタ環境）ダイアログ

Scriptマネージャウィンドウで，［ツール］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「サーバ情報」「互換性」「複数起動」「JP1/IM」「トレース」「クラスタ環境」の六つのタブがあります。

「クラスタ環境」タブを選択すると，［オプション（クラスタ環境）］ダイアログが表示されます。

補足

Windows Vista以降のOSでは，JP1/Scriptサービスが実行中以外の状態でオプション（クラスタ環境）を設定しようとすると，次のエラーダイアログを表示します。

「JP1/Scriptサービスの状態が実行中以外のため，実行できません。JP1/Scriptサービスを開始した後，再度実行してください。」

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

管理ファイルの出力先を変更する

管理ファイルの出力先を通常の出力先以外に変更する場合にチェックします。通常の出力先はインストール先フォルダの"DATA"フォルダ※下です。

管理ファイルとは，JP1/Scriptで扱うファイルのうち自動起動情報ファイル，サーバ環境ファイル，サーバトレースファイル，トレース管理ファイル，グローバル変数ファイルのことを指します。

出力先フォルダ

「管理ファイルの出力先を変更する」がチェックされている場合，管理ファイルの出力先フォルダを指定します。クラスタ環境の共有ディレクトリ上のフォルダを指定します。

指定できるのは，インストール先フォルダの"DATA"フォルダ※以外のフォルダです。

注※　Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

(2)　ダイアログでの操作

［OK］ボタンを選択すると，変更と再起動を確認するダイアログが表示され，［再起動］ボタンを選択すると指定した内容が設定されて［オプション］ダイアログを閉じ，システムを再起動します。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

クラスタ環境でJP1/Scriptを使用することはできますが，フェールオーバー時に実行中のスクリプトを継続して実行することはできません。しかし，このダイアログで管理ファイルの出力先を共有ディスク上に変更している場合，実行環境を引き継ぐことができます。詳細は，「2.3　クラスタシステム環境での環境設定」を参照してください。

このダイアログで管理ファイルの出力先を変更した場合，新しい設定を有効にするためにシステムの再起動が必要です。

管理ファイルの出力先を変更する以前にすでに使用していた各管理ファイルがある場合，それらのファイルは変更前フォルダに残り，それまでのファイルの内容は無効になります。
指定された「出力先フォルダ」に各管理ファイルがすでにある場合はそのファイルを参照し，存在しない場合は新規に作成します。

「出力先フォルダ」に出力されたファイルは複数のコンピュータから同時に参照することはできません。

「管理ファイルの出力先を変更する」がチェックされている場合，複数起動時に出力するトレースファイルの出力先フォルダは「出力先フォルダ」の"Trace"フォルダ下になります。［ツール］－［オプション（複数起動）］ダイアログの「トレースファイルの出力先フォルダ」で指定された値は無効になります。

管理ファイルの出力先を変更するとトレース管理ファイル（SPTLOGDB.SPB）の内容と各トレースファイルの内容が不一致になる場合があります。そのためトレースビューアウィンドウに表示される内容（行数と更新日付）が正しくない場合があります。

4.1.29　フォルダの選択ダイアログ

各ダイアログでフォルダを指定する必要がある場合に，［選択］ボタンを選択すると表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

フォルダ

上の表示領域には，選択しているフォルダ名が表示されます。

フォルダ名が表示領域より長い場合は，最終部分が表示されます。

下の表示領域には，ドライブ名とフォルダ名がツリー構造で表示されます。

ネットワーク

［ネットワークドライブの割り当て］ダイアログを表示します。

(2)　ダイアログでの操作

［OK］ボタンをクリックすると，指定したフォルダの情報が取り込まれます。

［キャンセル］をクリックするとフォルダの情報を取り込まないでダイアログを閉じます。

4.2　Scriptエディタウィンドウのダイアログ

Scriptエディタウィンドウの操作中に表示されるダイアログの一覧を，次に示します。

各ダイアログの項目，および操作については，4.2.1項以降に説明します。

値の更新ダイアログ

オプション（書式）ダイアログ

オプション（色）ダイアログ

オプション（互換性）ダイアログ

設定ダイアログ

検索ダイアログ

ファイル名の指定ダイアログ

ファイルバージョンの指定ダイアログ

コマンドラインパラメタの設定ダイアログ

変数の追加ダイアログ

＜この節の構成＞

4.2.1　値の更新ダイアログ

4.2.2　オプション（書式）ダイアログ

4.2.3　オプション（色）ダイアログ

4.2.4　オプション（互換性）ダイアログ

4.2.5　設定ダイアログ

4.2.6　検索ダイアログ

4.2.7　ファイル名の指定ダイアログ

4.2.8　ファイルバージョンの指定ダイアログ

4.2.9　コマンドラインパラメタの設定ダイアログ

4.2.10　変数の追加ダイアログ

4.2.1　値の更新ダイアログ

［ウォッチウィンドウ］で変数名をダブルクリックすると，［値の更新］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

変数名

更新する対象の変数名が表示されます。

値

更新したい値を入力します。値は1,024バイトまで入力できます。

更新する対象の変数名が無効なときは，入力できません。

(2)　ダイアログでの操作

［更新］ボタンを選択すると，指定した変数の値が更新されて［値の更新］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，変数の値を更新しないでダイアログを閉じます。

4.2.2　オプション（書式）ダイアログ

Scriptエディタウィンドウで，［編集］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「書式」と「色」と「互換性」の三つのタブがあります。

「書式」タブを選択すると，［オプション（書式）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

フォント名

文字のフォント名が表示されます。フォントを変更するには，［フォントの指定］ボタンを選択します。

デフォルトでは「FixedSys」が設定されています。

フォントサイズ

文字のフォントサイズを指定します。フォントサイズを変更するには，［フォントの指定］ボタンを選択します。

デフォルトでは「14」が設定されています。

文字の折り返し

文字を折り返す方法を選択します。

デフォルトでは「ウィンドウ幅で折り返す」が選択されています。

ウィンドウ幅で折り返す

文字をウィンドウ幅で折り返す場合に選択します。

文字数を指定する

文字を固定の文字数で折り返す場合に選択します。

折り返し文字数

折り返す文字数を指定します。

「文字数を指定する」が選択されている場合にだけ指定できます。

20～512の範囲で指定してください。

タブの文字数

タブの文字数を選択します。

デフォルトでは「4」が選択されています。

タブ記号を表示する

タブを示す記号の表示／非表示を指定します。

デフォルトではチェックされています。

改行記号を表示する

改行を示す記号の表示／非表示を指定します。

デフォルトではチェックされています。

全角スペース記号を表示する

全角スペースを表す記号の表示／非表示を指定します。

デフォルトではチェックされています。

「元に戻す」の実行回数

［編集］－［元に戻す］を何回まで実行できるようにするかを指定します。

10～999の範囲で指定してください。デフォルトでは「100」が指定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した書式が設定されて［オプション］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，書式を変更しないでダイアログを閉じます。

4.2.3　オプション（色）ダイアログ

Scriptエディタウィンドウで，［編集］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「書式」と「色」と「互換性」の三つのタブがあります。

「色」タブを選択すると，［オプション（色）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

テキスト

テキストの色を指定します。

デフォルトでは「システムカラー」が設定されます。

編集時の背景

編集モードの時の背景色を指定します。

デフォルトでは「システムカラー」が設定されます。

モニタリング時の背景

モニタリングモードの時の背景色を指定します。

デフォルトでは「灰色」が設定されます。

コメント行

コメント行の色を指定します。

デフォルトでは「緑色」が設定されます。

改行記号

改行記号の色を指定します。

デフォルトでは「赤色」が設定されます。

コマンド

コマンドの色を指定します。

デフォルトでは「青色」が設定されます。

ステートメント

ステートメントの色を指定します。

デフォルトでは「青色」が設定されます。

キーワード

キーワードの色を指定します。

デフォルトでは「青色」が設定されます。

文字列

文字列の色を指定します。

デフォルトでは「暗紫色」が設定されます。

更新行番号

更新行番号の色を指定します。

デフォルトでは「黄色」が設定されます。

現在位置カーソル

現在位置を示すカーソルの色を指定します。

デフォルトでは「青色」が設定されます。

すべてリセット

すべての項目に対する色の指定をデフォルト値に戻します。

(2)　ダイアログでの操作

［すべてリセット］以外の各項目のボタンを選択すると，［色の設定］ダイアログが表示され，色が選択できます。さらに，［色の設定］ダイアログの［色の作成］ボタンを選択すると，［色の作成］ダイアログが表示され，色を作成して指定できます。

［OK］ボタンを選択すると，指定した色が設定されて［オプション］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，色を変更しないでダイアログを閉じます。

4.2.4　オプション（互換性）ダイアログ

Scriptエディタウィンドウで，［編集］－［オプション］メニューを選択すると，［オプション］ダイアログが表示されます。

［オプション］ダイアログには，「書式」と「色」と「互換性」の三つのタブがあります。

「互換性」タブを選択すると，［オプション（互換性）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

ファイルバージョンの有無をチェックする

スクリプトファイルの保存時に，ファイルの先頭にファイルバージョンの有無をチェックするかどうかを指定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［オプション］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.2.5　設定ダイアログ

Scriptエディタウィンドウで，［モニタリング］－［設定］メニューを選択すると，［設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

コマンドラインパラメタ

モニタリング時に必要となるパラメタを指定します。

モニタリング開始時にコマンドラインパラメタを指定する

モニタリング開始時に［コマンドラインパラメタの設定］ダイアログを表示し，コマンドラインパラメタを設定する場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［設定］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

指定できるコマンドラインパラメタは半角で1,024文字までです。

［設定］ダイアログとスクリプトの実行環境ファイルの両方のコマンドラインに指定がある場合，モニタリング実行時には両方の指定が有効になります。
この場合，［設定］ダイアログで指定されたコマンドラインの値が先に，実行環境ファイルで指定されたコマンドラインの値が後になる順序でモニタリング実行します。
ただし，ダイアログに"/SPXLV(3)"，実行環境に"/SPXLV(0)"のように同種で異なる指定が両方にある場合はダイアログの指定が優先されます。

＜例＞

次のように指定された場合，位置変数%1はABC，%2は123となり，/SPXLV(3)が優先され，/NOEVLOGが有効になります。

ダイアログで指定されたコマンドライン： /SPXLV(3) ABC

実行環境で指定されたコマンドライン： /SPXLV(0) 123 /NOEVLOG

［設定］ダイアログに設定された内容はエディタ終了時にモニタリング情報ファイルに格納されます。

4.2.6　検索ダイアログ

Scriptエディタウィンドウで，［検索］－［検索］メニューを選択すると，［検索］ダイアログが表示されます。

［検索］－［検索］メニューを選択しないで［検索］－［前検索］，または［後検索］メニューを選択した場合も，［検索］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

置換する

文字列を置換する場合はチェックします。

デフォルトではチェックされていません。

検索

検索する文字列を指定します。

置換

検索文字列を置き換える文字列を指定します。「置換する」がチェックされている場合だけ，指定できます。

大文字／小文字の区別

大文字と小文字を区別して検索する場合はチェックします。

デフォルトではチェックされていません。

単語の検索

単語だけを検索する場合にチェックします。

デフォルトではチェックされていません。

(2)　ダイアログでの操作

［前検索］ボタンを選択すると，検索文字列を上方向に検索します。

［次検索］ボタンを選択すると，検索文字列を下方向に検索します。

［すべて置換］ボタンを選択すると，スクリプトファイル中にあるすべての検索文字列を「置換」で指定した文字列に置換します。

［キャンセル］ボタンを選択すると，ダイアログを閉じます。

(3)　処理詳細

「置換」，および「検索」に指定した文字列は，過去10件分だけドロップダウンリストに記憶されます。

検索文字列がない場合はビープ音が鳴ります。

4.2.7　ファイル名の指定ダイアログ

Scriptエディタウィンドウで，ファイル名の付いていないスクリプトファイルをモニタリング実行，または実行しようとすると，［ファイル名の指定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

スクリプトファイル名

スクリプトファイル名を指定します。

(2)　ダイアログでの操作

［参照］ボタンを選択すると，［ファイルを開く］ダイアログが表示されます。

［OK］ボタンを選択すると，そのファイル名でスクリプトファイルが保存され，モニタリング実行，または実行が開始されます。

［キャンセル］ボタンを選択すると，ファイル名を設定しないでダイアログを閉じます。

［環境の設定］ボタンを選択すると，［実行環境の設定］ダイアログが表示されます。

4.2.8　ファイルバージョンの指定ダイアログ

オプション（互換性）ダイアログの「ファイルバージョンの有無をチェックする」がチェックされている

スクリプトファイルの先頭にファイルバージョンが記述されていない

これら二つの条件を満たすスクリプトファイルに対して，Scriptエディタウィンドウで，次のうちのどれかの操作をすると，［ファイルバージョンの指定］ダイアログが表示されます。

a．［ファイル］－［保存］を選択

b．［ファイル］－［名前を付けて保存］を選択

c．別のスクリプトファイルを表示

d．［モニタリング］－［文法チェック］を選択

e．［モニタリング］－［モニタリングの実行］－［実行］を選択

f．［モニタリング］－［モニタリングの実行］－［ステップ実行］を選択

g．［モニタリング］－［モニタリングの実行］－［連続ステップ実行］を選択

h．［モニタリング］－［実行］を選択

i．エディタを終了

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

ファイルバージョン

スクリプトファイルの先頭に記述するファイルバージョンを指定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定したバージョンをスクリプトファイルの先頭に記述して，ファイルが保存されます。

［無視して続行］ボタンを選択すると，バージョンを記述しないでスクリプトファイルが保存され，＜説明＞a～iのうち，実行しようとしていた操作が続行されます。

［キャンセル］ボタンを選択すると，＜説明＞a～iのうち，実行しようとしていた操作が取り消されます。この場合，スクリプトファイルの先頭にバージョンは記述されません。また，スクリプトファイルは保存されません。

4.2.9　コマンドラインパラメタの設定ダイアログ

Scriptエディタウィンドウで，［モニタリング］－［設定］メニューを選択すると表示される［設定］ダイアログで「モニタリング開始時にコマンドラインパラメタを指定する」がチェックされている状態で，モニタリング実行，ステップ実行，連続ステップ実行のどれかをした場合に［コマンドラインパラメタの設定］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

コマンドラインパラメタ

モニタリング時に必要となるパラメタを指定します。

次回から表示しない

次回モニタリング開始時に［コマンドラインパラメタの設定］ダイアログを表示させない場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コマンドラインパラメタの設定］ダイアログを閉じ，モニタリングを実行します。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じ，モニタリングを実行します。

(3)　処理詳細

指定できるコマンドラインパラメタは半角で1,024文字までです。

［コマンドラインパラメタの設定］ダイアログとスクリプトの実行環境ファイルの両方のコマンドラインに指定がある場合，モニタリング実行時には両方の指定が有効になります。
この場合，［コマンドラインパラメタの設定］ダイアログで指定されたコマンドラインの値が先に，実行環境ファイルで指定されたコマンドラインの値が後になる順序でモニタリング実行します。
ただし，ダイアログに"/SPXLV(3)"，実行環境に"/SPXLV(0)"のように同種で異なる指定が両方にある場合はダイアログの指定が優先されます。

＜例＞

次のように指定された場合，位置変数%1はABC，%2は123となり，/SPXLV(3)が優先され，/NOEVLOGが有効になります。

ダイアログで指定されたコマンドライン： /SPXLV(3) ABC
実行環境で指定されたコマンドライン： /SPXLV(0) 123 /NOEVLOG

［コマンドラインパラメタの設定］ダイアログに設定された内容はエディタ終了時にモニタリング情報ファイルに格納されます。

4.2.10　変数の追加ダイアログ

Scriptエディタウィンドウで，［モニタリング］－［ウォッチへ変数の追加］メニューを選択すると，［変数の追加］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

変数名

追加する変数名を指定します。

(2)　ダイアログでの操作

［追加］ボタンを選択すると，指定した変数名がウォッチウィンドウに追加されて［変数の追加］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，変数を追加しないでダイアログを閉じます。

(3)　処理詳細

［モニタリング］－［ウォッチへ変数の追加］メニューはモニタリングモードの場合にだけ，選択できます。

同じ変数を複数指定しても，存在しない変数を指定してもエラーにはなりません。

指定できる変数名は半角で99文字までです。これを超えた部分は切り捨てられます。

4.3　Scriptトレースビューアウィンドウのダイアログ

Scriptトレースビューアウィンドウの操作中に表示されるダイアログの一覧を，次に示します。

各ダイアログの項目，および操作については，4.3.1項以降に説明します。

削除の確認ダイアログ

クリアの確認ダイアログ

コンピュータの選択ダイアログ

検索ダイアログ

＜この節の構成＞

4.3.1　削除の確認ダイアログ

4.3.2　クリアの確認ダイアログ

4.3.3　コンピュータの選択ダイアログ

4.3.4　検索ダイアログ

4.3.1　削除の確認ダイアログ

トレースファイルを一つ，または複数選択してから，［ファイル］－［トレースファイルの削除］メニューを選択すると表示されるダイアログです。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

選択したトレースファイルを削除してもいいですか？

選択されているトレースファイル名が一つ表示されます。

(2)　ダイアログでの操作

［はい］ボタンを選択すると，表示されているトレースファイルが削除されます。複数のファイルが選択されている場合は，次のファイルに処理が移ります。

［すべて］ボタンを選択すると，選択されているすべてのトレースファイルが削除されます。

［いいえ］ボタンを選択すると，表示されているトレースファイルを削除しません。複数のファイルが選択されている場合は，次のファイルに処理が移ります。

［キャンセル］ボタンをクリックすると，ファイルの削除を中止してダイアログを閉じます。

4.3.2　クリアの確認ダイアログ

トレースファイルを一つ，または複数選択してから，［編集］－［トレースファイルのクリア］メニューを選択すると表示されるダイアログです。

選択されているトレースファイルを空（ファイルサイズ0）にします。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

選択したトレースファイルをクリアしてもいいですか？

選択されているトレースファイル名が一つ表示されます。

(2)　ダイアログでの操作

［はい］ボタンを選択すると，表示されているトレースファイルがクリアされます。複数のファイルが選択されている場合は，次のファイルに処理が移ります。

［すべて］ボタンを選択すると，選択されているすべてのトレースファイルがクリアされます。

［いいえ］ボタンを選択すると，表示されているトレースファイルをクリアしません。複数のファイルが選択されている場合は，次のファイルに処理が移ります。

［キャンセル］ボタンをクリックすると，ファイルのクリアを中止してダイアログを閉じます。

4.3.3　コンピュータの選択ダイアログ

［オプション］－［コンピュータの選択］メニューを選択すると表示されるダイアログです。

接続するコンピュータを変更します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

コンピュータ名

接続先のコンピュータ名（最大15文字）を設定します。

コンピュータの選択

自コンピュータと接続されているコンピュータの一覧が表示されます。

(2)　ダイアログでの操作

一覧からコンピュータを選択して［OK］ボタンを選択すると，指定されたコンピュータと接続します。

［キャンセル］ボタンをクリックすると，コンピュータの接続先を変更しないでダイアログを閉じます。

(3)　処理詳細

コンピュータ名は最大15文字です。

指定したコンピュータと接続できない場合は，クライアントエリアには何も表示されません。

4.3.4　検索ダイアログ

トレースファイルの表示ウィンドウで，［検索］－［検索］メニューを選択すると表示されるダイアログです。

表示されているトレースファイルから，指定した文字列を検索します。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

検索

検索したい文字列を指定します。

大文字／小文字の区別

検索する条件として，大文字と小文字を区別する場合にチェックします。

(2)　ダイアログでの操作

検索する文字列を指定して［上検索］ボタンをクリックすると，現在の位置から上に向かって検索を実行します。［下検索］ボタンをクリックすると，現在の位置から下へ向かって検索を実行します。

［キャンセル］ボタンをクリックすると，検索を実行しないでダイアログを閉じます。

(3)　処理詳細

表示中の文字列を選択している状態で［検索］メニューを選択すると，選択中の文字列を検索文字列と仮定します。

4.4　Scriptメニューエディタウィンドウのダイアログ

Scriptメニューエディタウィンドウの操作中に表示されるダイアログの一覧を，次に示します。各ダイアログの項目，および操作については，4.4.1項以降に説明します。

メニューフォームプロパティ（一般）ダイアログ

メニューフォームプロパティ（背景）ダイアログ

メニューフォームプロパティ（キー）ダイアログ

メニューフォームプロパティ（スタイル）ダイアログ

メニューフォームプロパティ（壁紙）ダイアログ

スタティックプロパティ（一般）ダイアログ

スタティックプロパティ（共通）ダイアログ

スタティックプロパティ（背景）ダイアログ

スタティックプロパティ（スタイル）ダイアログ

ボタンプロパティ（一般）ダイアログ

ボタンプロパティ（共通）ダイアログ

ボタンプロパティ（背景）ダイアログ

ボタンプロパティ（キー）ダイアログ

ボタンプロパティ（スタイル）ダイアログ

ファイル参照ボタンプロパティ（一般）ダイアログ

ファイル参照ボタンプロパティ（共通）ダイアログ

ファイル参照ボタンプロパティ（背景）ダイアログ

ファイル参照ボタンプロパティ（キー）ダイアログ

ファイル参照ボタンプロパティ（スタイル）ダイアログ

エディットコントロールプロパティ（一般）ダイアログ

エディットコントロールプロパティ（共通）ダイアログ

エディットコントロールプロパティ（キー）ダイアログ

エディットコントロールプロパティ（スタイル）ダイアログ

直線プロパティ（一般）ダイアログ

ファンクションキープロパティ（一般）ダイアログ

ファンクションキープロパティ（共通）ダイアログ

ファンクションキープロパティ（スタイル）ダイアログ

リストコントロールプロパティ（一般）ダイアログ

リストコントロールプロパティ（共通）ダイアログ

リストコントロールプロパティ（キー）ダイアログ

リストコントロールプロパティ（スタイル）ダイアログ

コンボボックスプロパティ（一般）ダイアログ

コンボボックスプロパティ（共通）ダイアログ

コンボボックスプロパティ（キー）ダイアログ

コンボボックスプロパティ（スタイル）ダイアログ

コマンドプロパティダイアログ

コマンドプロパティの設定ダイアログ

メニューフォーム名の指定ダイアログ

一括変更ダイアログ

グリッドの設定ダイアログ

タブオーダの設定ダイアログ

メニューフォームの印刷情報ダイアログ

＜この節の構成＞

4.4.1　メニューフォームプロパティ（一般）ダイアログ

4.4.2　メニューフォームプロパティ（背景）ダイアログ

4.4.3　メニューフォームプロパティ（キー）ダイアログ

4.4.4　メニューフォームプロパティ（スタイル）ダイアログ

4.4.5　メニューフォームプロパティ（壁紙）ダイアログ

4.4.6　スタティックプロパティ（一般）ダイアログ

4.4.7　スタティックプロパティ（共通）ダイアログ

4.4.8　スタティックプロパティ（背景）ダイアログ

4.4.9　スタティックプロパティ（スタイル）ダイアログ

4.4.10　ボタンプロパティ（一般）ダイアログ

4.4.11　ボタンプロパティ（共通）ダイアログ

4.4.12　ボタンプロパティ（背景）ダイアログ

4.4.13　ボタンプロパティ（キー）ダイアログ

4.4.14　ボタンプロパティ（スタイル）ダイアログ

4.4.15　ファイル参照ボタンプロパティ（一般）ダイアログ

4.4.16　ファイル参照ボタンプロパティ（共通）ダイアログ

4.4.17　ファイル参照ボタンプロパティ（背景）ダイアログ

4.4.18　ファイル参照ボタンプロパティ（キー）ダイアログ

4.4.19　ファイル参照ボタンプロパティ（スタイル）ダイアログ

4.4.20　エディットコントロールプロパティ（一般）ダイアログ

4.4.21　エディットコントロールプロパティ（共通）ダイアログ

4.4.22　エディットコントロールプロパティ（キー）ダイアログ

4.4.23　エディットコントロールプロパティ（スタイル）ダイアログ

4.4.24　直線プロパティ（一般）ダイアログ

4.4.25　ファンクションキープロパティ（一般）ダイアログ

4.4.26　ファンクションキープロパティ（共通）ダイアログ

4.4.27　ファンクションキープロパティ（スタイル）ダイアログ

4.4.28　リストコントロールプロパティ（一般）ダイアログ

4.4.29　リストコントロールプロパティ（共通）ダイアログ

4.4.30　リストコントロールプロパティ（キー）ダイアログ

4.4.31　リストコントロールプロパティ（スタイル）ダイアログ

4.4.32　コンボボックスプロパティ（一般）ダイアログ

4.4.33　コンボボックスプロパティ（共通）ダイアログ

4.4.34　コンボボックスプロパティ（キー）ダイアログ

4.4.35　コンボボックスプロパティ（スタイル）ダイアログ

4.4.36　コマンドプロパティダイアログ

4.4.37　コマンドプロパティの設定ダイアログ

4.4.38　メニューフォーム名の指定ダイアログ

4.4.39　一括変更ダイアログ

4.4.40　グリッドの設定ダイアログ

4.4.41　タブオーダの設定ダイアログ

4.4.42　メニューフォームの印刷情報ダイアログ

4.4.1　メニューフォームプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，メニューフォームを選択してダブルクリックすると，［メニューフォームプロパティ］ダイアログが表示されます。

［メニューフォームプロパティ］ダイアログには，「一般」，「背景」，「キー」，「スタイル」，「壁紙」の五つのタブがあります。

「一般」タブを選択すると，［メニューフォームプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［メニューフォームプロパティ（一般）］ダイアログでは，選択したメニューフォームに対して，次の項目を設定できます。

キャプション

メニューフォームのキャプションを指定します。文字列，または文字列を格納した変数名を指定できます。

変数名に配列変数は指定できません。

変数名

「キャプション」に変数名を指定する場合にチェックします。

メニューフォーム名

メニューフォーム名を指定します。

メニューフォーム名は，変数の名前付け規則に従って指定してください。

終了監視時間

メニューフォームの終了時間を秒単位で指定します。

0～86,400の範囲で指定してください。ただし，0が指定された場合は終了監視しないものとみなします。

幅

メニューフォームの幅をピクセル単位で指定します。

115～9,999の範囲で指定してください。デフォルトでは「600」が設定されています。

高さ

メニューフォームの高さをピクセル単位で指定します。

22～9,999の範囲で指定してください。デフォルトでは「400」が設定されています。

背景色

メニューフォームの背景色を色の設定ダイアログから指定します。

デフォルトでは「灰色」が設定されています。

表示位置を指定する

メニューフォームを起動したときの表示位置を指定する場合にチェックします。

X座標・Y座標

メニューフォームを起動したときの表示位置のX座標とY座標を，ピクセル単位の値，または値を格納した変数名で指定します。

「表示位置を指定する」がチェックされている場合にだけ指定できます。

「X座標」も「Y座標」もデフォルトでは「0」が設定されています。

変数で指定

「X座標」と「Y座標」に変数名を指定する場合にチェックします。

「表示位置を指定する」がチェックされている場合にだけチェックできます。

チェックした場合は，「X座標」と「Y座標」のどちらも変数名を指定してください。変数名に配列変数は指定できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォームプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示位置を指定する」がチェックされていない場合は，起動したときにメニューフォームは画面の中央に表示されます。

4.4.2　メニューフォームプロパティ（背景）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，メニューフォームを選択してダブルクリックすると，［メニューフォームプロパティ］ダイアログが表示されます。

［メニューフォームプロパティ］ダイアログには，「一般」，「背景」，「キー」，「スタイル」，「壁紙」の五つのタブがあります。

「背景」タブを選択すると，［メニューフォームプロパティ（背景）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［メニューフォームプロパティ（背景）］ダイアログでは，選択したメニューフォームの背景について，次の項目を設定できます。

表示形式

背景に画像を表示させる方法をドロップダウンリストから選択します。

デフォルトでは「画像を表示しない」が設定されています。

ファイル名

背景に表示させる画像のファイル名を指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

参照

画像ファイルを指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォームプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.3　メニューフォームプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，メニューフォームを選択してダブルクリックすると，［メニューフォームプロパティ］ダイアログが表示されます。

［メニューフォームプロパティ］ダイアログには，「一般」，「背景」，「キー」，「スタイル」，「壁紙」の五つのタブがあります。

「キー」タブを選択すると，［メニューフォームプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［メニューフォームプロパティ（キー）］ダイアログでは，選択したメニューフォームのキーについて，次の項目を設定できます。

キー

終了キーとして設定するキーを選択します。

キーとして選択できるのは，Esc，Enter，およびF1～F12です。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

>>追加

選択したキーを終了キーとして追加する場合にクリックします。

<<削除

選択したキーを終了キーから削除する場合にクリックします。

終了キー

終了キーから削除するキーを選択します。

デフォルトでは「Esc」が設定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォームプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

終了キーが「Esc」の場合，入力されたデータのチェック処理や変数への値の代入などはしないでメニューフォームを終了します。終了キーが「Esc」以外の場合，入力されたデータのチェック処理や変数への値の代入などをしてメニューフォームを終了します。

メニューフォーム上にファンクションキーがある場合，F1～F12は終了キーとして選択できないため，「キー」のリストには表示されません。

また，次の場合には，「終了キー」のF1～F12の設定は無効になります。メニューフォームを開いた時点で警告メッセージが表示されます。

すでにF1～F12を「終了キー」に設定している状態でファンクションキーを定義した場合。

JP1/Script 06-71より前のバージョンで作成されたメニューフォームで，ファンクションキーが定義され，「終了キー」にF1～F12が設定されている場合。

4.4.4　メニューフォームプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，メニューフォームを選択してダブルクリックすると，［メニューフォームプロパティ］ダイアログが表示されます。

［メニューフォームプロパティ］ダイアログには，「一般」，「背景」，「キー」，「スタイル」，「壁紙」の五つのタブがあります。

「スタイル」タブを選択すると，［メニューフォームプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［メニューフォームプロパティ（スタイル）］ダイアログでは，選択したメニューフォームについて，次の項目を設定できます。

最小化ボタン

メニューフォームに最小化ボタンを付ける場合にチェックします。

「タイトルバー」がチェックされている場合にだけチェックできます。

システムメニュー

メニューフォームにシステムメニューを設定する場合にチェックします。

「タイトルバー」がチェックされている場合にだけチェックできます。

デフォルトではチェックされています。

フォアグランドに表示

メニューフォームをフォアグランドに表示させる場合にチェックします。

タイトルバー

メニューフォームにタイトルバーを付ける場合にチェックします。

デフォルトではチェックされています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォームプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.5　メニューフォームプロパティ（壁紙）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，メニューフォームを選択してダブルクリックすると，［メニューフォームプロパティ］ダイアログが表示されます。

［メニューフォームプロパティ］ダイアログには，「一般」，「背景」，「キー」，「スタイル」，「壁紙」の五つのタブがあります。

「壁紙」タブを選択すると，［メニューフォームプロパティ（壁紙）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［メニューフォームプロパティ（壁紙）］ダイアログでは，選択したメニューフォームに貼る壁紙について，次の項目を設定できます。

表示形式

壁紙となる画像の表示方法をドロップダウンリストから選択します。

デフォルトでは「画像を表示しない」が設定されています。

タスクバーを隠さず表示

タスクバーを隠さないで画像を壁紙として表示させる場合にチェックします。

ファイル名

壁紙として表示させる画像のファイル名を指定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォームプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.6　スタティックプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，スタティックコントロールを選択してダブルクリックすると，［スタティックプロパティ］ダイアログが表示されます。

［スタティックプロパティ］ダイアログには，「一般」，「共通」，「背景」，「スタイル」の四つのタブがあります。

「一般」タブを選択すると，［スタティックプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［スタティックプロパティ（一般）］ダイアログでは，スタティックコントロールに表示させるテキストについて，次の項目を設定できます。

テキスト

表示させるテキストを指定します。文字列，または文字列を格納した変数名が指定できます。

変数名に配列変数は指定できません。

変数名

「テキスト」に変数名を指定する場合にチェックします。

アイコン

スタティックコントロールにアイコンを表示させる場合にチェックします。

ファイル名

スタティックコントロールに表示させるアイコンファイル名を指定します。

「アイコン」がチェックされている場合にだけ設定できます。

参照

［ファイルを開く］ダイアログからアイコンファイルを指定します。

「アイコン」がチェックされている場合にだけ設定できます。

アイコン番号

「ファイル名」で指定したアイコンファイル内のアイコンを0から始まる数値で選択します。

「アイコン」がチェックされている場合にだけ設定できます。

拡大表示する

スタティックコントロールに2倍拡大したアイコンを表示させる場合にチェックします。

「アイコン」がチェックされている場合にだけ設定できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［スタティックプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.7　スタティックプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，スタティックコントロールを選択してダブルクリックすると，［スタティックプロパティ］ダイアログが表示されます。

［スタティックプロパティ］ダイアログには，「一般」，「共通」，「背景」，「スタイル」の四つのタブがあります。

「共通」タブを選択すると，［スタティックプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［スタティックプロパティ（共通）］ダイアログでは，スタティックコントロールに表示させるテキストについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。

フィールド名は，変数の名前付け規則に従って指定してください。

テキストの配置

縦方向・横方向

テキストを配置するときの縦方向と横方向の位置をドロップダウンリストから選択します。

デフォルトでは「縦方向」は「上寄り」，「横方向」は「左寄り」が設定されています。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

スタティックコントロールの背景の色を指定します。

デフォルトでは「灰色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

注意

JP1/Script 06-71以降では，［起動時にフォーカスを位置付ける］，および［再表示時にフォーカスを位置付ける］は無効状態で表示されるようになりました。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［スタティックプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.8　スタティックプロパティ（背景）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，スタティックコントロールを選択してダブルクリックすると，［スタティックプロパティ］ダイアログが表示されます。

［スタティックプロパティ］ダイアログには，「一般」，「共通」，「背景」，「スタイル」の四つのタブがあります。

「背景」タブを選択すると，［スタティックプロパティ（背景）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［スタティックプロパティ（背景）］ダイアログでは，スタティックコントロールの背景に表示させる画像について，次の項目を設定できます。

表示形式

背景に画像を表示させる方法をドロップダウンリストから選択します。

デフォルトでは「画像を表示しない」が設定されています。

ファイル名

背景に表示させる画像のファイル名を指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

参照

画像ファイルを指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［スタティックプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.9　スタティックプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，スタティックコントロールを選択してダブルクリックすると，［スタティックプロパティ］ダイアログが表示されます。

［スタティックプロパティ］ダイアログには，「一般」，「共通」，「背景」，「スタイル」の四つのタブがあります。

「スタイル」タブを選択すると，［スタティックプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［スタティックプロパティ（スタイル）］ダイアログでは，スタティックコントロールのスタイルについて，次の項目を設定できます。

境界線

コントロールの周囲に境界線を作成する場合にチェックします。

くぼみ境界線

コントロールの周囲にくぼんだ境界線を作成する場合にチェックします。

深くへこませる

コントロールの周囲を深くへこませる場合にチェックします。

浅くへこませる

コントロールの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

コントロールの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

コントロールの周囲を低く飛び出させる場合にチェックします。

透過

コントロールを透過させる場合にチェックします。

枠に影をつける

コントロールの枠に影を付ける場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［スタティックプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.10　ボタンプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ボタンコントロールを選択してダブルクリックすると，［ボタンプロパティ］ダイアログが表示されます。

［ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「一般」タブを選択すると，［ボタンプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ボタンプロパティ（一般）］ダイアログでは，ボタンコントロールについて，次の項目を設定できます。

テキスト

ボタンに表示させるテキストを指定します。文字列，または文字列を格納した変数名が指定できます。

変数名に配列変数は指定できません。

変数名

「テキスト」に変数名を指定する場合にチェックします。

コマンド番号

ボタンをクリックしたときに実行されるコマンドの番号を指定します。

コマンド

このボタンを選択すると，［コマンドプロパティの設定］ダイアログが表示されます。

コマンドのプロパティを設定します。

アイコン

ボタンにアイコンを表示させる場合にチェックします。

ファイル名

ボタンに表示させるアイコンファイル名を指定します。

「アイコン」がチェックされている場合にだけ設定できます。

参照

［ファイルを開く］ダイアログからアイコンファイルを指定します。

「アイコン」がチェックされている場合にだけ設定できます。

アイコン番号

「ファイル名」で指定したアイコンファイル内のアイコンを0から始まる数値で選択します。

「アイコン」がチェックされている場合にだけ設定できます。

拡大表示する

ボタンに2倍拡大したアイコンを表示させる場合にチェックします。

「アイコン」がチェックされている場合にだけ設定できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.11　ボタンプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ボタンコントロールを選択してダブルクリックすると，［ボタンプロパティ］ダイアログが表示されます。

［ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「共通」タブを選択すると，［ボタンプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［ボタンプロパティ（共通）］ダイアログでは，ボタンコントロールについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。変数の名前付け規則に従って指定してください。

テキストの配置

縦方向・横方向

テキストを配置するときの縦方向と横方向の位置をドロップダウンリストから選択します。

デフォルトでは，「縦方向」「横方向」とも，「中央」が設定されています。

起動時にフォーカスを位置付ける

メニューフォームを起動するとき，フォーカスを位置付ける場合にチェックします。

再表示時にフォーカスを位置付ける

メニューフォームを再表示するとき，フォーカスを位置付ける場合にチェックします。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

ボタンコントロールの背景の色を指定します。

デフォルトでは「灰色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.12　ボタンプロパティ（背景）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ボタンコントロールを選択してダブルクリックすると，［ボタンプロパティ］ダイアログが表示されます。

［ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「背景」タブを選択すると，［ボタンプロパティ（背景）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ボタンプロパティ（背景）］ダイアログでは，ボタンコントロールの背景について，次の項目を設定できます。

表示形式

背景に画像を表示させる方法をドロップダウンリストから選択します。

デフォルトでは「画像を表示しない」が設定されています。

ファイル名

背景に表示させる画像のファイル名を指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

参照

画像ファイルを指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.13　ボタンプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ボタンコントロールを選択してダブルクリックすると，［ボタンプロパティ］ダイアログが表示されます。

［ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「キー」タブを選択すると，［ボタンプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ボタンプロパティ（キー）］ダイアログでは，ボタンコントロールのキーについて，次の項目を設定できます。

アクセラレータキーを指定する

アクセラレータキーを指定する場合にチェックします。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

キー

指定するキーをドロップダウンリストから選択します。

「アクセラレータキーを指定する」がチェックされている場合にだけ選択できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.14　ボタンプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ボタンコントロールを選択してダブルクリックすると，［ボタンプロパティ］ダイアログが表示されます。

［ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「スタイル」タブを選択すると，［ボタンプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ボタンプロパティ（スタイル）］ダイアログでは，ボタンコントロールの背景について，次の項目を設定できます。

標準のボタン

標準のボタンを指定する場合にチェックします。

標準のボタンはメニューフォーム上で一つだけ指定できます。

平面

ボタンを3D表示しない場合にチェックします。

深くへこませる

コントロールの周囲を深くへこませる場合にチェックします。

浅くへこませる

コントロールの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

コントロールの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

コントロールの周囲を低く飛び出させる場合にチェックします。

透過

コントロールを透過させる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.15　ファイル参照ボタンプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファイル参照ボタンを選択してダブルクリックすると，［ファイル参照ボタンプロパティ］ダイアログが表示されます。

［ファイル参照ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「一般」タブを選択すると，［ファイル参照ボタンプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［ファイル参照ボタンプロパティ（一般）］ダイアログでは，ファイル参照ボタンについて，次の項目を設定できます。

テキスト

ファイル参照ボタンに表示させるテキストを指定します。文字列，または文字列を格納した変数名が指定できます。

変数名に配列変数は指定できません。

変数名

「テキスト」に変数名を指定する場合にチェックします。

「ファイルを開く」ダイアログを表示

［ファイルを開く］ダイアログを表示させる場合にチェックします。

「ファイル名を付けて保存」ダイアログを表示

［ファイル名を付けて保存］ダイアログを表示させる場合にチェックします。

「フォルダの選択」ダイアログを表示

［フォルダの選択］ダイアログを表示させる場合にチェックします。

リンク先フィールド名

［ファイルを開く］ダイアログ，［ファイル名を付けて保存］ダイアログで選択されたファイル名，または［フォルダの選択］ダイアログで選択されたフォルダ名を格納するコントロールのフィールド名を指定します。

必ず指定してください。

ファイル拡張子

［ファイルを開く］ダイアログ，または［ファイル名をつけて保存］ダイアログに表示させる，ファイルのフィルタの形式を指定します。次の拡張子から選択します。

実行形式ファイル<*.EXE>

フィルタに実行形式ファイルを指定する場合にチェックします。

バッチファイル<*.BAT>

フィルタにバッチファイルを指定する場合にチェックします。

スクリプトファイル<*.SPT>

フィルタにスクリプトファイルを指定する場合にチェックします。

すべてのファイル<*.*>

フィルタにすべてのファイルを指定する場合にチェックします。

その他

フィルタに上記以外のファイルを指定する場合にチェックします。

拡張子

フィルタに指定する拡張子を指定します。「その他」をチェックした場合にだけ使用できます。

説明

フィルタに表示されるファイルの説明を指定します。「その他」をチェックした場合にだけ使用できます。

ただし，「「フォルダの選択」ダイアログを表示」がチェックされている場合にはグレーアウトされて選択できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファイル参照ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「「ファイルを開く」ダイアログを表示」，または「「ファイル名を付けて保存」ダイアログを表示」が定義されている場合，リンク先のフィールドに"¥"や"/"などを含む文字列を指定して［ファイル参照］ボタンを選択してもダイアログは表示されません。

4.4.16　ファイル参照ボタンプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファイル参照ボタンを選択してダブルクリックすると，［ファイル参照ボタンプロパティ］ダイアログが表示されます。

［ファイル参照ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「共通」タブを選択すると，［ファイル参照ボタンプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［ファイル参照ボタンプロパティ（共通）］ダイアログでは，ファイル参照ボタンに表示させるテキストについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。

フィールド名は，変数の名前付け規則に従って指定してください。

テキストの配置

縦方向・横方向

テキストを配置するときの縦方向と横方向の位置をドロップダウンリストから選択します。

デフォルトでは「縦方向」「横方向」とも，「中央」が設定されています。

起動時にフォーカスを位置付ける

メニューフォームを起動するとき，フォーカスを位置付ける場合にチェックします。

再表示時にフォーカスを位置付ける

メニューフォームを再表示するとき，フォーカスを位置付ける場合にチェックします。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

ファイル参照ボタンの背景の色を指定します。

デフォルトでは「灰色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファイル参照ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.17　ファイル参照ボタンプロパティ（背景）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファイル参照ボタンを選択してダブルクリックすると，［ファイル参照ボタンプロパティ］ダイアログが表示されます。

［ファイル参照ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「背景」タブを選択すると，［ファイル参照ボタンプロパティ（背景）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ファイル参照ボタンプロパティ（背景）］ダイアログでは，ファイル参照ボタンの背景について，次の項目を設定できます。

表示形式

背景に画像を表示させる方法をドロップダウンリストから選択します。

デフォルトでは「画像を表示しない」が設定されています。

ファイル名

背景に表示させる画像のファイル名を指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

参照

画像ファイルを指定します。

ただし，「表示形式」で「画像を表示しない」が選択されている場合は指定できません。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファイル参照ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.18　ファイル参照ボタンプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファイル参照ボタンを選択してダブルクリックすると，［ファイル参照ボタンプロパティ］ダイアログが表示されます。

［ファイル参照ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「キー」タブを選択すると，［ファイル参照ボタンプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ファイル参照ボタンプロパティ（キー）］ダイアログでは，ファイル参照ボタンのキーについて，次の項目を設定できます。

アクセラレータキーを指定する

アクセラレータキーを指定する場合にチェックします。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

キー

指定するキーをドロップダウンリストから選択します。

「アクセラレータキーを指定する」がチェックされている場合にだけ選択できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファイル参照ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.19　ファイル参照ボタンプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファイル参照ボタンを選択してダブルクリックすると，［ファイル参照ボタンプロパティ］ダイアログが表示されます。

［ファイル参照ボタンプロパティ］ダイアログには，「一般」，「共通」，「背景」，「キー」，「スタイル」の五つのタブがあります。

「スタイル」タブを選択すると，［ファイル参照ボタンプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ファイル参照ボタンプロパティ（スタイル）］ダイアログでは，ファイル参照ボタンのキーについて，次の項目を設定できます。

標準のボタン

標準のファイル参照ボタンを指定する場合にチェックします。

標準ボタンはメニューフォーム上で一つだけ指定できます。

平面

ファイル参照ボタンを3D表示しない場合にチェックします。

深くへこませる

ファイル参照ボタンの周囲を深くへこませる場合にチェックします。

浅くへこませる

ファイル参照ボタンの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

ファイル参照ボタンの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

ファイル参照ボタンの周囲を低く飛び出させる場合にチェックします。

透過

ファイル参照ボタンを透過させる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファイル参照ボタンプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.20　エディットコントロールプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，エディットコントロールを選択してダブルクリックすると，［エディットコントロールプロパティ］ダイアログが表示されます。

［エディットコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「一般」タブを選択すると，［エディットコントロールプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［エディットコントロールプロパティ（一般）］ダイアログでは，エディットコントロールについて，次の項目を設定できます。

テキスト

エディットコントロールに表示させるテキストを格納した変数名を指定します。

なお，この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

入力桁数をチェックする

入力桁数をチェックする場合にチェックします。

最大桁数

入力桁数の最大値を指定します。

「入力桁数をチェックする」がチェックされている場合にだけ設定できます。

1～1,024の範囲で指定してください。デフォルトでは「10」が設定されています。

入力完了時の動作を指定する

入力完了時の動作をチェックする場合にチェックします。

「入力桁数をチェックする」がチェックされている場合にだけ設定できます。

ただし，「スタイル」タブの「コマンド選択フィールド」と同時に指定することはできません。

コマンドを実行する

入力完了時にコマンドを実行する場合に選択します。

「入力完了時の動作を指定する」がチェックされている場合にだけ選択できます。

コマンド番号

入力完了時に実行するコマンドのコマンド番号を指定します。

「コマンドを実行する」が選択されている場合にだけ設定できます。

コマンド

［コマンドプロパティの設定］ダイアログからコマンドのプロパティを設定します。

「コマンドを実行する」が選択されている場合にだけ設定できます。

他のコントロールにフォーカスを移動する

入力完了時にほかのコントロールにフォーカスを移動させる場合に選択します。

「入力完了時の動作を指定する」がチェックされている場合にだけ選択できます。

タブオーダに従う

入力完了時に移動するフォーカスの移動順序をタブオーダに従わせる場合にチェックします。

「他のコントロールにフォーカスを移動する」が選択されている場合にだけチェックできます。

移動先のフィールド名

入力完了時にフォーカスが移動するコントロールのフィールド名を指定します。

メニューフォーム上にあるボタン・ファイル参照ボタン・エディットコントロール・リストコントロール・コンボボックスのフィールド名が一覧表示されます。

「他のコントロールにフォーカスを移動する」が選択され，かつ「タブオーダに従う」が選択されていない場合にだけ設定できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［エディットコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「テキスト」で指定した変数には，エディットコントロールで入力された文字列が格納されます。

エディットコントロールに入力された半角文字1文字は1桁，全角文字1文字は2桁とみなします。

エディットコントロールに入力できる桁数が残り1桁の状態で全角文字を入力した場合，文字の入力は受け付けられないでフォーカスも移動しません。

「タブオーダに従う」がチェックされている場合，入力桁数に達した後フォーカスはタブオーダに従って移動します。

「移動先のフィールド名」に指定されたフィールド名がメニューフォーム上にない場合，フォーカスはタブオーダに従って移動します。

4.4.21　エディットコントロールプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，エディットコントロールを選択してダブルクリックすると，［エディットコントロールプロパティ］ダイアログが表示されます。

［エディットコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「共通」タブを選択すると，［エディットコントロールプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［エディットコントロールプロパティ（共通）］ダイアログでは，エディットコントロールについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。

フィールド名は，変数の名前付け規則に従って指定してください。

テキストの配置

「縦方向」は「上寄り」，「横方向」は「左寄り」が設定されています。

起動時にフォーカスを位置付ける

メニューフォームを起動するとき，フォーカスを位置付ける場合にチェックします。

再表示時にフォーカスを位置付ける

メニューフォームを再表示するとき，フォーカスを位置付ける場合にチェックします。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

エディットコントロールの背景の色を指定します。

デフォルトでは「白色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［エディットコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.22　エディットコントロールプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，エディットコントロールを選択してダブルクリックすると，［エディットコントロールプロパティ］ダイアログが表示されます。

［エディットコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「キー」タブを選択すると，［エディットコントロールプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［エディットコントロールプロパティ（キー）］ダイアログでは，エディットコントロールのキーについて，次の項目を設定できます。

アクセラレータキーを指定する

アクセラレータキーを指定する場合にチェックします。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

キー

指定するキーをドロップダウンリストから選択します。

「アクセラレータキーを指定する」がチェックされている場合にだけ選択できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［エディットコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.23　エディットコントロールプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，エディットコントロールを選択してダブルクリックすると，［エディットコントロールプロパティ］ダイアログが表示されます。

［エディットコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「スタイル」タブを選択すると，［エディットコントロールプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［エディットコントロールプロパティ（スタイル）］ダイアログでは，エディットコントロールについて，次の項目を設定できます。

番号専用

エディットコントロールに数字以外の文字の入力を禁止する場合にチェックします。

水平オートスクロール

テキストを入力しきれない場合，テキストを自動的にスクロールさせるときにチェックします。

デフォルトではチェックされています。

パスワード

入力するテキストの内容が見えないように，入力するテキストをすべて * （アスタリスク）で表示させる場合にチェックします。

境界線

エディットコントロールの周囲に境界線を作成する場合にチェックします。

大文字専用

入力されたテキストをすべて大文字に変換して表示する場合にチェックします。

小文字専用

入力されたテキストをすべて小文字に変換して表示する場合にチェックします。

読み取り専用

エディットコントロールに対しての入力や編集を禁止する場合にチェックします。

入力必須

エディットコントロールに必ず入力させる場合にチェックします。この項目をチェックすると，値が入力されなかった場合に警告メッセージを出します。

コマンド選択フィールド

エディットコントロールをコマンド選択フィールドにする場合にチェックします。コマンド選択フィールドにコマンド番号を入力してEnterキーを押すと，「4.4.37　コマンドプロパティの設定ダイアログ」で定義したコマンドを実行します。

深くへこませる

エディットコントロールの周囲を深くへこませる場合にチェックします。

デフォルトではチェックされています。

浅くへこませる

エディットコントロールの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

エディットコントロールの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

エディットコントロールの周囲を低く飛び出させる場合にチェックします。

自動クリア

メニューフォームが表示された時にエディットコントロールを常に空の状態にさせる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［エディットコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「大文字専用」と「小文字専用」は同時にはチェックできません。

「読み取り専用」と「自動クリア」は同時にはチェックできません。

4.4.24　直線プロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，直線を選択してダブルクリックすると，［直線プロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［直線プロパティ（一般）］ダイアログでは，直線について，次の項目を設定できます。

線

種類

直線の種類をドロップダウンリストから選択します。

デフォルトでは「実線」が設定されています。

太さ

直線の太さをピクセル単位で指定します。

デフォルトでは「1」が設定されています。

色

直線の色を指定します。

デフォルトでは「黒色」が設定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［直線プロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.25　ファンクションキープロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファンクションキーコントロールを選択してダブルクリックすると，［ファンクションキープロパティ］ダイアログが表示されます。

［ファンクションキープロパティ］ダイアログには，「一般」，「共通」，「スタイル」の三つのタブがあります。

「一般」タブを選択すると，［ファンクションキープロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ファンクションキープロパティ（一般）］ダイアログでは，ファンクションキーコントロールについて，次の項目を設定できます。

テキスト

リストで選択しているファンクションキーに表示するテキストを指定します。

コマンド番号

リストで選択しているファンクションキーをクリックしたときに実行されるコマンドの番号を指定します。

クリア

リストで選択しているファンクションキーのデータの内容をクリアします。

コマンド

リストで選択しているファンクションキーに対応するコマンドのプロパティを設定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファンクションキープロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.26　ファンクションキープロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファンクションキーコントロールを選択してダブルクリックすると，［ファンクションキープロパティ］ダイアログが表示されます。

［ファンクションキープロパティ］ダイアログには，「一般」，「共通」，「スタイル」の三つのタブがあります。

「共通」タブを選択すると，［ファンクションキープロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［ファンクションキープロパティ（共通）］ダイアログでは，ファンクションキーコントロールについて，次の項目を設定できます。

フィールド名

「FunctionKey」が設定されています。

テキストの配置

縦方向・横方向

テキストを配置するときの縦方向と横方向の位置をドロップダウンリストから選択します。

デフォルトでは，「縦方向」「横方向」とも，「中央」が設定されています。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

ファンクションキーコントロールの背景の色を指定します。

デフォルトでは「灰色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

注意

JP1/Script 06-71以降では，［起動時にフォーカスを位置付ける］，および［再表示時にフォーカスを位置付ける］は無効状態で表示されるようになりました。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファンクションキープロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.27　ファンクションキープロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，ファンクションキーコントロールを選択してダブルクリックすると，［ファンクションキープロパティ］ダイアログが表示されます。

［ファンクションキープロパティ］ダイアログには，「一般」，「共通」，「スタイル」の三つのタブがあります。

「スタイル」タブを選択すると，［ファンクションキープロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［ファンクションキープロパティ（スタイル）］ダイアログでは，ファンクションキーコントロールについて，次の項目を設定できます。

平面

ボタンを3D表示させない場合にチェックします。

深くへこませる

コントロールの周囲を深くへこませる場合にチェックします。

浅くへこませる

コントロールの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

コントロールの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

コントロールの周囲を低く飛び出させる場合にチェックします。

透過

コントロールを透過させる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［ファンクションキープロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.28　リストコントロールプロパティ（一般）ダイアログ

Scriptメニューエディタのメニューフォームビューで，リストコントロールを選択してダブルクリックすると，［リストコントロールプロパティ］ダイアログが表示されます。

［リストコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「一般」タブを選択すると，［リストコントロールプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［リストコントロールプロパティ（一般）］ダイアログでは，リストコントロールについて，次の項目を設定できます。

テキストを変数から取得する

リストに表示させるテキストを変数から取得する場合にチェックします。

テキスト表示用変数名

リストに表示させるテキストを設定する変数名を指定します。

「テキストを変数から取得する」がチェックされている場合にだけ設定できます。

この変数名が2次元の配列変数の場合，メニューフォーム実行時にエラーになります。

テキスト

リストに表示させるテキストを指定します。

ただし，「テキストを変数から取得する」がチェックされている場合は設定できません。

クリア

データをリストから削除します。

ただし，「テキストを変数から取得する」がチェックされている場合は削除できません。

選択データ用変数名

リストのステータスを設定する変数名を指定します。

この変数名が次の場合，メニューフォーム実行時にエラーになります。

「テキストを変数から取得する」がチェックされないで，かつこの変数名が配列変数の場合。

「テキストを変数から取得する」がチェックされ，複数選択ができないリストで，かつ，この変数名が配列変数の場合。

「テキストを変数から取得する」がチェックされ，複数選択できるリストで，かつこの変数名が2次元の配列変数の場合。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［リストコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「テキストを変数から取得する」がチェックされている場合，「テキスト表示用変数名」の要素で値が格納されていない要素はリストに表示されません。

「選択データ用変数名」に格納される値は次のようになります。

「テキストを変数から取得する」がチェックされている場合：

選択されたデータの「テキスト表示用変数名」でのインデックス番号が格納される。

「テキストを変数から取得する」がチェックされていない場合：

複数選択不可能なリストの場合：アイテム番号が格納される。

複数選択可能なリストの場合："001…100"形式の数字列が格納される。

4.4.29　リストコントロールプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，リストコントロールを選択してダブルクリックすると，［リストコントロールプロパティ］ダイアログが表示されます。

［リストコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「共通」タブを選択すると，［リストコントロールプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［リストコントロールプロパティ（共通）］ダイアログでは，リストコントロールについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。

フィールド名は，変数の名前付け規則に従って指定してください。

テキストの配置

縦方向・横方向

テキストを配置するときの縦方向と横方向の位置をドロップダウンリストから選択します。

デフォルトでは「縦方向」は「中央」，「横方向」は「左寄り」が設定されています。

起動時にフォーカスを位置付ける

メニューフォームを起動するとき，フォーカスを位置付ける場合にチェックします。

再表示時にフォーカスを位置付ける

メニューフォームを再表示するとき，フォーカスを位置付ける場合にチェックします。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

リストコントロールの背景の色を指定します。

デフォルトでは「白色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［リストコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.30　リストコントロールプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，リストコントロールを選択してダブルクリックすると，［リストコントロールプロパティ］ダイアログが表示されます。

［リストコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「キー」タブを選択すると，［リストコントロールプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［リストコントロールプロパティ（キー）］ダイアログでは，リストコントロールについて，次の項目を設定できます。

アクセラレータキーを指定する

アクセラレータキーを指定する場合にチェックします。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

キー

指定するキーをドロップダウンリストから選択します。

「アクセラレータキーを指定する」がチェックされている場合にだけ選択できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［リストコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.31　リストコントロールプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，リストコントロールを選択してダブルクリックすると，［リストコントロールプロパティ］ダイアログが表示されます。

［リストコントロールプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「スタイル」タブを選択すると，［リストコントロールプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［リストコントロールプロパティ（スタイル）］ダイアログでは，リストコントロールについて，次の項目を設定できます。

複数選択

複数のデータを選択する場合にチェックします。

境界線

リストコントロールの周囲に境界線を作成する場合にチェックします。

深くへこませる

リストコントロールの周囲を深くへこませる場合にチェックします。

デフォルトではチェックされています。

浅くへこませる

リストコントロールの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

リストコントロールの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

リストコントロールの周囲を低く飛び出させる場合にチェックします。

透過

リストコントロールを透過させる場合にチェックします。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［リストコントロールプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.32　コンボボックスプロパティ（一般）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，コンボボックスを選択してダブルクリックすると，［コンボボックスプロパティ］ダイアログが表示されます。

［コンボボックスプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「一般」タブを選択すると，［コンボボックスプロパティ（一般）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［コンボボックスプロパティ（一般）］ダイアログでは，コンボボックスについて，次の項目を設定できます。

テキストを変数から取得する

コンボボックスに表示させるテキストを変数から取得する場合にチェックします。

テキスト表示用変数名

コンボボックスに表示させるテキストを設定する変数名を指定します。

「テキストを変数から取得する」がチェックされている場合にだけ設定できます。

この変数名が2次元の配列変数の場合，メニューフォーム実行時にエラーになります。

テキスト

コンボボックスに表示させるテキストを指定します。

ただし，「テキストを変数から取得する」がチェックされている場合は設定できません。

リストされるデータ

コンボボックスのリストに表示されるデータの一覧です。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

追加

「リストされるデータ」の末尾に「テキスト」に指定したテキストを追加します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

挿入

「リストされるデータ」で選択されているデータの上に「テキスト」に指定したテキストを挿入します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

更新

「リストされるデータ」で選択されているデータを「テキスト」に指定したテキストで更新します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

削除

「リストされるデータ」の中で選択されているデータを削除します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

上に移動

「リストされるデータ」の中で選択されているデータを上に移動します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

下に移動

「リストされるデータ」の中で選択されているデータを下に移動します。

ただし，「テキストを変数から取得する」がチェックされている場合は有効になりません。

選択データ用変数名

コンボボックスのステータスを設定する変数名を指定します。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

ドロップダウンされる行数

コンボボックスをドロップダウンしたときに表示されるデータの数を指定します。

1～100の範囲で指定してください。デフォルトでは「5」が設定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コンボボックスプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「テキストを変数から取得する」がチェックされている場合，「テキスト表示用変数名」の要素で値が格納されていない要素はドロップダウンリストに表示されません。

「選択データ用変数名」にはコンボボックスで選択，または入力された文字列が格納されます。

4.4.33　コンボボックスプロパティ（共通）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，コンボボックスを選択してダブルクリックすると，［コンボボックスプロパティ］ダイアログが表示されます。

［コンボボックスプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「共通」タブを選択すると，［コンボボックスプロパティ（共通）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［コンボボックスプロパティ（共通）］ダイアログでは，コンボボックスについて，次の項目を設定できます。

フィールド名

フィールドの名称を指定します。

フィールド名は，変数の名前付け規則に従って指定してください。

テキストの配置

「縦方向」は「中央」，「横方向」は「左寄り」が設定されています。

起動時にフォーカスを位置付ける

メニューフォームを起動するとき，フォーカスを位置付ける場合にチェックします。

再表示時にフォーカスを位置付ける

メニューフォームを再表示するとき，フォーカスを位置付ける場合にチェックします。

テキストカラー

テキストの色を指定します。

デフォルトでは「黒色」が設定されています。

背景色

コンボボックスの背景の色を指定します。

デフォルトでは「白色」が設定されています。

フォント名

現在選択されているフォント名を表示します。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「MS Pゴシック」が設定されています。

スタイル

現在選択されているフォントのスタイルを表示します。

フォントのスタイルを変更するには，［フォント］ボタンを選択します。

デフォルトでは「標準」が設定されています。

サイズ

現在選択されているフォントのサイズを表示します。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「12」が設定されています。

取り消し線

取り消し線の指定の有無を表示します。

取り消し線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

下線

下線の指定の有無を表示します。

下線を変更するには，［フォント］ボタンを選択します。

デフォルトでは「なし」が設定されています。

表示状態を制御する

コントロールの表示状態を制御する場合にチェックします。

変数名

コントロールの表示状態を示す値を格納する変数名を指定します。

「表示状態を制御する」がチェックされている場合にだけ設定できます。

この変数名が配列変数の場合，メニューフォーム実行時にエラーになります。

コントロールの表示状態を示す値は次のとおりです。

DISABLE

コントロールはメニューフォーム上に無効状態で表示されます。

HIDE

コントロールはメニューフォーム上には表示されません。

その他

コントロールはメニューフォーム上に有効状態で表示されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コンボボックスプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「表示状態を制御する」がチェックされていない場合，コントロールはメニューフォーム上に有効状態で表示されます。

テスト表示では「表示状態を制御する」の指定は無効になります。

4.4.34　コンボボックスプロパティ（キー）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，コンボボックスを選択してダブルクリックすると，［コンボボックスプロパティ］ダイアログが表示されます。

［コンボボックスプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「キー」タブを選択すると，［コンボボックスプロパティ（キー）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［コンボボックスプロパティ（キー）］ダイアログでは，コンボボックスについて，次の項目を設定できます。

アクセラレータキーを指定する

アクセラレータキーを指定する場合にチェックします。

Ctrl

モデファイキーにCtrl キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Shift

モデファイキーにShift キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

Alt

モデファイキーにAlt キーを指定する場合にチェックします。

「アクセラレータキーを指定する」がチェックされている場合にだけチェックできます。

キー

指定するキーをドロップダウンリストから選択します。

「アクセラレータキーを指定する」がチェックされている場合にだけ選択できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コンボボックスプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.35　コンボボックスプロパティ（スタイル）ダイアログ

Scriptメニューエディタウィンドウのメニューフォームビューで，コンボボックスを選択してダブルクリックすると，［コンボボックスプロパティ］ダイアログが表示されます。

［コンボボックスプロパティ］ダイアログには，「一般」，「共通」，「キー」，「スタイル」の四つのタブがあります。

「スタイル」タブを選択すると，［コンボボックスプロパティ（スタイル）］ダイアログが表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［コンボボックスプロパティ（スタイル）］ダイアログでは，コンボボックスについて，次の項目を設定できます。

編集可能

編集可能なコンボボックスを作成する場合にチェックします。

水平オートスクロール

テキストを入力しきれない場合，テキストを自動的にスクロールさせるときにチェックします。

大文字専用

入力されたテキストをすべて大文字に変換して表示させる場合にチェックします。

小文字専用

入力されたテキストをすべて小文字に変換して表示させる場合にチェックします。

入力必須

コンボボックスに必ず入力させる場合にチェックします。

入力データをチェックする

コンボボックスのリストの一覧にないデータが入力されたときにエラーにする場合にチェックします。

「編集可能」がチェックされている場合にだけチェックできます。

深くへこませる

コンボボックスの周囲を深くへこませる場合にチェックします。

浅くへこませる

コンボボックスの周囲を浅くへこませる場合にチェックします。

高く飛び出させる

コンボボックスの周囲を高く飛び出させる場合にチェックします。

低く飛び出させる

コンボボックスの周囲を低く飛び出させる場合にチェックします。

入力桁数をチェックする

入力桁数をチェックする場合にチェックします。

「編集可能」がチェックされている場合にだけチェックできます。

最大桁数

入力桁数の最大値を指定します。

「入力桁数をチェックする」がチェックされている場合にだけ設定できます。

1～1,024の範囲で指定してください。デフォルトでは「10」が設定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コンボボックスプロパティ］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

「大文字専用」と「小文字専用」は，同時にはチェックできません。

「入力データをチェックする」で指定されたデータチェックでは，大文字と小文字を区別しません。

4.4.36　コマンドプロパティダイアログ

ボタンコントロールをクリックしたときのコマンドの実行について，定義するダイアログです。

Scriptメニューエディタウィンドウで，［表示］－［コマンドプロパティ］を選択すると，［コマンドプロパティ］ダイアログの表示／非表示を切り替えられます。

デフォルトではコマンド番号1には「実行内容」は「何もしない」，「メニューフォームの状態」は「メニューフォームをクローズする」が，コマンド番号2には「実行内容」は「何もしない」，「メニューフォームの状態」は「キャンセルして直前のメニューフォームに戻る」が設定されています。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［コマンドプロパティ］ダイアログでは，コマンドの実行について，次の項目を設定できます。

コマンド一覧

［コマンドプロパティの設定］ダイアログで設定されたコマンドの一覧が表示されます。

一覧には次の項目が表示されます。

番号

コマンドの番号が表示されます。

実行内容

コマンドの実行内容が表示されます。

メニューフォームの状態

コマンドを実行した後のメニューフォームの状態が表示されます。

実行対象

コマンドの実行対象が表示されます。

実行フォルダ

コマンドの実行フォルダが表示されます。

閉じる

コマンドプロパティダイアログを閉じます。

クリア

選択したコマンド番号の，プロパティ定義の内容をクリアします。

設定

コマンドのプロパティを定義したいときにクリックします。

［コマンドプロパティの設定］ダイアログが表示されます。

(2)　ダイアログでの操作

［閉じる］ボタンをクリックすると，［コマンドプロパティ］ダイアログが閉じます。

4.4.37　コマンドプロパティの設定ダイアログ

ボタンコントロールやファンクションキーコントロールをクリックしたとき，またはエディットコントロールへ入力を完了したときのコマンドのプロパティを定義するダイアログです。

［コマンドプロパティの設定］ダイアログは，［ツール］－［コマンドプロパティの設定］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　ボタン押下時の動作

(4)　処理詳細

(1)　ダイアログの項目

［コマンドプロパティの設定］ダイアログでは，コマンドについて，次の項目を設定できます。

コマンド番号

コマンドの番号を指定します。

ボタン押下時の動作

実行内容・メニューフォームの状態

コマンドの実行内容と，コマンドを実行した後の実行状態をドロップダウンリストから選択します。

デフォルトでは，「実行内容」は「外部コマンドを実行する」，「メニューフォームの状態」は「メニューフォームをクローズする」が設定されています。

「ボタン押下時の動作」の指定については，「（3）ボタン押下時の動作」を参照してください。

実行するファイルパス

実行する対象のファイルパスを指定します。文字列，または文字列を格納した変数名が指定できます。指定した文字列，または変数に格納された文字列がファイルパスとして不正な場合はエラーになります。

ファイルパスは「実行内容」が「外部コマンドを実行する」の場合にだけ指定できます。

変数名に配列変数は指定できません。

変数名

「実行するファイルパス」に変数名を指定する場合にチェックします。

参照

「実行するファイルパス」を，［ファイルを開く］ダイアログから指定します。

パラメータ

実行対象へ渡すパラメータを指定します。文字列，または文字列を格納した変数名で指定します。

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

変数名に配列変数は指定できません。

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

パラメータは「実行内容」が「外部コマンドを実行する」の場合にだけ指定できます。

変数名

「パラメータ」に変数名を指定する場合にチェックします。

また，変数は一つしか指定できません。変数として二つ以上のパラメータを渡したい場合は，一つの変数に値を複数設定してください（値をスペースで区切る）。

実行フォルダ

コマンドの実行フォルダを指定します。文字列，または文字列を格納した変数名で指定します。

実行フォルダは「実行内容」が「外部コマンドを実行する」の場合にだけ指定できます。

「実行フォルダ」を省略すると，現在のフォルダが内部的に仮定されます。

変数名に配列変数は指定できません。

変数名

「実行フォルダ」に変数名を指定する場合にチェックします。

参照

［フォルダの選択］ダイアログから「実行フォルダ」を指定します。

実行するメニューフォーム名

実行するメニューフォームの名称を指定します。

メニューフォームの名称は「実行内容」が「ファイル内のメニューフォームを表示する」の場合にだけ指定できます。

実行するサブルーチン名

実行するサブルーチンの名称を指定します。

サブルーチンの名称は「実行内容」が「ファイル内のサブルーチンを呼び出す」の場合にだけ指定できます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［コマンドプロパティの設定］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　ボタン押下時の動作

［コマンドプロパティの設定］ダイアログで設定する「ボタン押下時の動作」の「実行内容」と「メニューフォームの状態」の指定の組み合わせと指定時の処理動作を次に示します。

(a)　実行内容「外部コマンドを実行する」の場合

メニューフォームの状態
指定
処理動作

「メニューフォームをクローズする」
○
外部コマンドを実行し，終了を待たないでメニューフォームを終了する。

「キャンセルして
直前のメニューフォームに戻る」
×
－

「直前のメニューフォームに戻る」
○
外部コマンドを実行し，終了を待たないで直前のメニューフォームに戻る。

「表示したまま終了を待つ」
○
外部コマンドを実行し，メニューフォームを使用不能な状態で表示して終了を待つ。

「非表示にして終了を待つ」
○
外部コマンドを実行し，メニューフォームを非表示にして終了を待つ。

「最小化して待つ」
○
外部コマンドを実行し，メニューフォームを最小化して終了を待つ。

「アイドル状態にする」
○
外部コマンドを実行するだけで，終了待ちはしない。

（凡例）

○：組み合わせ可能な指定

×：組み合わせ不可能な指定

－：該当なし

(b)　実行内容「ファイル内のメニューフォームを表示する」の場合

メニューフォームの状態
指定
処理動作

「メニューフォームをクローズする」
×
－

「キャンセルして
直前のメニューフォームに戻る」
×
－

「直前のメニューフォームに戻る」
×
－

「表示したまま終了を待つ」
○
ファイル内の新しいメニューフォームを表示し，メニューフォームを使用不能な状態で表示して終了を待つ。

「非表示にして終了を待つ」
○
ファイル内の新しいメニューフォームを表示し，メニューフォームを非表示にして終了を待つ。

「最小化して待つ」
×
－

「アイドル状態にする」
×
－

（凡例）

○：組み合わせ可能な指定

×：組み合わせ不可能な指定

－：該当なし

(c)　実行内容「ファイル内のサブルーチンを呼び出す」の場合

メニューフォームの状態
指定
処理動作

「メニューフォームをクローズする」
○
ファイル内のサブルーチンを呼び出し，メニューフォームを使用不能な状態で表示して終了を待つ。サブルーチンがFunctionステートメントでその戻り値がTrueの場合はメニューフォームを終了し，True以外の場合は何もしない。

「キャンセルして
直前のメニューフォームに戻る」
×
－

「直前のメニューフォームに戻る」
○
ファイル内のサブルーチンを呼び出し，メニューフォームを使用不能な状態で表示して終了を待つ。サブルーチンがFunctionステートメントでその戻り値がTrueの場合は直前のメニューフォームに戻り，True以外の場合は何もしない。

「表示したまま終了を待つ」
○
ファイル内のサブルーチンを呼び出し，メニューフォームを使用不能な状態で表示して終了を待つ。

「非表示にして終了を待つ」
○
ファイル内のサブルーチンを呼び出し，メニューフォームを非表示にして終了を待つ。

「最小化して待つ」
×
－

「アイドル状態にする」
×
－

（凡例）

○：組み合わせ可能な指定

×：組み合わせ不可能な指定

－：該当なし

(d)　実行内容「ファンクションキーを切り替える」の場合

メニューフォームの状態 | 指定 | 処理動作
「メニューフォームをクローズする」 | × | －
「キャンセルして直前のメニューフォームに戻る」 | × | －
「直前のメニューフォームに戻る」 | × | －
「表示したまま終了を待つ」 | × | －
「非表示にして終了を待つ」 | × | －
「最小化して待つ」 | × | －
「アイドル状態にする」 | × | －

（凡例）

○：組み合わせ可能な指定

×：組み合わせ不可能な指定

－：該当なし

(e)　実行内容「何もしない」の場合

メニューフォームの状態
指定
処理動作

「メニューフォームをクローズする」
○
メニューフォームを終了する。

「キャンセルして
直前のメニューフォームに戻る」
○
入力されたデータのチェック，および変数への値の代入をしないで，直前のメニューフォームに戻る。

「直前のメニューフォームに戻る」
○
直前のメニューフォームに戻る。

「表示したまま終了を待つ」
×
－

「非表示にして終了を待つ」
×
－

「最小化して待つ」
○
最小化する。

「アイドル状態にする」
○
何もしない。

（凡例）

○：組み合わせ可能な指定

×：組み合わせ不可能な指定

－：該当なし

(4)　処理詳細

「実行内容」を「外部コマンドを実行する」に設定している場合，予約変数には次の値が格納されます。

メニューフォームの状態 | 予約変数 | 格納される値
「アイドル状態にする」 | _EXEC_RTN_ | なし
_EXEC_ID_ | 実行ファイルの識別子
「アイドル状態にする」以外 | _EXEC_RTN_ | 外部コマンドの終了コード

Menuコマンドから実行された外部コマンドの終了コードに0以外が返された場合，メッセージボックスを表示します。メッセージボックスを表示しない場合は，次に示すレジストリの値に0を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥SPTX

〔値名〕

Menu_EmgMsgBox

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：メッセージボックスを表示しない

1：メッセージボックスを表示する

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

4.4.38　メニューフォーム名の指定ダイアログ

新しいメニューフォームを作成するときに，メニューフォーム名を指定するダイアログです。

［メニューフォーム名の指定］ダイアログは，［編集］－［メニューフォームの新規作成］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［メニューフォーム名の指定］ダイアログでは，次の項目を設定できます。

メニューフォーム名

メニューフォーム名を指定します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［メニューフォーム名の指定］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.39　一括変更ダイアログ

メニューフォーム上のコントロールの属性を一括して変更するダイアログです。

［一括変更］ダイアログは，［編集］－［一括変更］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［一括変更］ダイアログでは，次の項目を設定できます。

テキストの配置

テキストの配置を一括変更する場合にチェックします。

ただし，選択されたコントロールにエディットコントロール，またはコンボボックスが含まれる場合にはグレーアウトされてチェックできません。

縦方向・横方向

テキストの縦方向と横方向の位置をドロップダウンリストから選択します。

「テキストの配置」がチェックされている場合にだけ選択できます。

テキストカラー

テキストの色を一括変更する場合にチェックし，色の設定ダイアログからテキストの色を指定します。

背景色

背景の色を一括変更する場合にチェックし，色の設定ダイアログから背景の色を指定します。

背景

背景の情報を一括変更する場合にチェックし，選択したコントロールのプロパティ（背景）ダイアログで背景の情報を指定します。

ただし，選択されたコントロールにスタティック，ボタン，またはファイル参照ボタン以外のコントロールが含まれる場合にはグレーアウトされてチェックできません。

スタイル

スタイルを一括変更する場合にチェックし，選択したコントロールのプロパティ（スタイル）ダイアログでスタイルの情報を指定します。

選択されたコントロールがすべて同じ種類の場合にだけチェックできます。

ただし，選択されたコントロールの種類がボタン，またはファイル参照ボタンの場合には「標準のボタン」の設定内容は変更できません。

また，選択されたコントロールの種類がエディットコントロールの場合には「コマンド選択フィールド」の設定内容は変更できません。

フォント

フォントを一括変更する場合にチェックし，フォントダイアログからフォントの情報を指定します。

フォント名

現在選択されているフォント名を表示します。

スタイル

現在選択されているフォントのスタイルを表示します。

サイズ

現在選択されているフォントのサイズを表示します。

取り消し線

取り消し線の指定の有無を表示します。

下線

下線の指定の有無を表示します。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［一括変更］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

各項目の初期値には最初に選択されたコントロールの内容が設定されます。

すべての項目がチェックされていない場合には，［OK］ボタンはグレーアウトされて表示されます。

4.4.40　グリッドの設定ダイアログ

メニューフォーム上でグリッドを表示させる場合に，グリッドの間隔を設定するダイアログです。

［グリッドの設定］ダイアログは，［編集］－［レイアウト］－［グリッドの設定］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［グリッドの設定］ダイアログでは，次の項目を設定できます。

グリッドを使用する

グリッドを使用する場合にチェックします。

グリッドの間隔

幅・高さ

グリッドの幅と高さをピクセル単位で指定します。

1～100の範囲で指定してください。デフォルトでは「8」が指定されています。

マージン

マージンをピクセル単位で設定します。

0～100の範囲で指定してください。デフォルトでは「10」が指定されています。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［グリッドの設定］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.41　タブオーダの設定ダイアログ

タブの移動順序を設定するダイアログです。

［タブオーダの設定］ダイアログは，［編集］－［レイアウト］－［タブオーダの設定］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(1)　ダイアログの項目

［タブオーダの設定］ダイアログでは，次の項目を設定できます。

フィールド名

メニューフォーム上にあるフィールドのフィールド名が表示されます。

表示されているフィールド名の上から順番にタブが移動します。

上に移動

選択したフィールドのタブの移動順序が，一つ上に設定されます。

下に移動

選択したフィールドのタブの移動順序が，一つ下に設定されます。

座標位置でソート

タブの移動順序が，メニューフォーム上にあるフィールドの座標位置によって，画面の左上から右下の順序となるように設定されます。

(2)　ダイアログでの操作

［OK］ボタンを選択すると，指定した内容が設定されて［タブオーダの設定］ダイアログが閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

4.4.42　メニューフォームの印刷情報ダイアログ

作成したメニューフォームの内容の印刷情報を設定するダイアログです。

［メニューフォームの印刷情報］ダイアログは，［ファイル］－［メニューフォームの印刷］を選択すると表示されます。

＜この項の構成＞

(1)　ダイアログの項目

(2)　ダイアログでの操作

(3)　処理詳細

(1)　ダイアログの項目

［メニューフォームの印刷情報］ダイアログでは，次の項目を設定できます。

使用するプリンタ

使用するプリンタ名が表示されます。

プリンタを変更するには，［設定］ボタンを選択します。

デフォルトでは，通常使うプリンタが設定されています。

フォント名

印刷に使用するフォント名が表示されます。

フォントを変更するには，［フォント］ボタンを選択します。

デフォルトでは「FixedSys」が設定されています。

サイズ

印刷に使用するフォントのサイズが表示されます。

フォントのサイズを変更するには，［フォント］ボタンを選択します。

デフォルトでは「10」が設定されています。

印刷項目

ヘッダ情報

ヘッダ情報を印刷する場合にチェックします。

印刷される内容は次のとおりです。

メニュー情報ファイル名

メニューフォーム名

更新日付（yyyy/mm/dd/ HH:MM:SSの形式※）

印刷日付（yyyy/mm/dd/ HH:MM:SSの形式※）

ページ
※ yyyy:西暦， mm:月， dd:日， HH:時， MM:分， SS:秒を意味します。

メニューイメージ

メニューフォームのテスト表示イメージを印刷する場合にチェックします。

用紙の横幅中央に印刷します。用紙に収まらない場合は，縮小して印刷します。

メニューフォームプロパティ

メニューフォームのプロパティを印刷する場合にチェックします。

コントロールプロパティ

コントロールのプロパティを印刷する場合にチェックします。

タブオーダ

タブオーダを印刷する場合にチェックします。

コマンドプロパティ

コマンドプロパティを印刷する場合にチェックします。

デフォルトではすべての項目がチェックされています。

印刷範囲

すべてのメニューフォームを印刷

すべてのメニューフォームの内容を印刷する場合に選択します。

現在のメニューフォームを印刷

現在，選択されているメニューフォームの内容を印刷する場合に選択します。

メニューフォームが選択されていない場合は「現在のメニューフォームを印刷」はグレーアウトされて選択できません。

デフォルトでは「すべてのメニューフォームを印刷」が選択されています。

項目毎に改ページする

「印刷項目」で選択した項目ごとに改ページをする場合にチェックします。

デフォルトではチェックされていません。

(2)　ダイアログでの操作

［印刷実行］ボタンを選択すると，指定した内容が設定されて印刷を実行します。印刷終了後に［メニューフォームの印刷情報］ダイアログを閉じます。

［キャンセル］ボタンを選択すると，内容を変更しないでダイアログを閉じます。

(3)　処理詳細

メニューフォームがない場合には，［ファイル］－［メニューフォームの印刷］はグレーアウトされて選択できません。

5.　トラブルへの対処方法

この章では，JP1/Scriptで発生するトラブルの種類と，その対処方法について説明します。

＜この章の構成＞

5.1　対処の手順

5.2　トラブルシューティング

5.3　ログ情報

5.4　トラブル発生時に採取が必要な資料

5.5　資料の採取方法

5.6　バックアップとリカバリー

5.1　対処の手順

JP1/Scriptでトラブルが発生した場合の対処の手順を次に示します。

現象の確認

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。

また，JP1/Script使用時のトラブルシューティングについては，「5.2　トラブルシューティング」を参照してください。JP1/Scriptが出力するログ情報については，「5.3　ログ情報」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「5.4　トラブル発生時に採取が必要な資料」，および「5.5　資料の採取方法」を参照して必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

5.2　トラブルシューティング

ここでは，JP1/Script使用時のトラブルシューティングについて説明します。JP1/Scriptを使用しているときにトラブルが発生した場合，まず，この節で説明している現象が発生していないか確認してください。

＜この節の構成＞

5.2.1　スクリプト実行時のトラブルと対処方法

5.2.2　コマンド実行時のトラブルと対処方法

5.2.3　トレースビューア実行時のトラブルと対処方法

5.2.4　プロセスビューア実行時のトラブルと対処方法

5.2.1　スクリプト実行時のトラブルと対処方法

スクリプト実行時のトラブルと対処方法を表5-1に示します。

表5-1　スクリプト実行時のトラブルと対処方法

トラブルの種類 | 要因 | 対処方法
スクリプト実行中にトレース情報を出力する領域やコマンドを処理する領域がボリューム上に確保できない。 | ボリューム上に十分な空き領域がない。 | JP1/Scriptのマネージャ，またはエクスプローラなどで不要なファイルを削除して，空き領域を確保する。
トレースファイルの出力先や作業フォルダに別のボリュームを指定する。
スクリプトを実行すると「アプリケーションを正しく初期化できませんでした。」や終了コード「99」でスクリプトの実行が失敗する。 | スクリプト実行時に必要なメモリが不足している。 | メモリを増設する，またはページファイルのサイズを大きくする。ページファイルのサイズを大きくしてもメモリ不足が発生する場合は，他のアプリケーションを終了させて，空き容量を増やす。
JP1/Scriptサービスから実行している場合，サービスアカウントを他のサービスで使用していないアカウントに変更する。
スクリプトを実行すると「ファイルが壊れているか，またはファイルの形式が異なります」となる。 | 指定したファイルに誤りがある。 | 指定したファイルに誤りがないか確認する。
前回の実行中に異常終了している場合は，ファイルが正しく保存されていない可能性がある。 | JP1/Scriptのマネージャ，またはエクスプローラなどでファイルを削除する。
スクリプトファイルが実行中のままとなる。 | JP1/AJSなどのサービスプログラムから起動して，実行スクリプト内でメッセージボックスやウィンドウなどの対話操作が必要な処理を動作させている。 | JP1/AJSなどのサービスプログラムから起動して対話操作をする場合は，NetExecコマンドを使ってログオン空間でスクリプトを実行する。
Execコマンド，またはNetExecコマンドで呼び出したプログラムがループしている。 | 実行プログラムに誤りがないか調査する。
トレース管理ファイル（SPTLOGDB.SPB）が破壊されている。 | エクスプローラなどでトレース管理ファイルを削除する。
ユーザプログラムからスクリプトを実行すると終了コード「19」となる。 | スクリプトで文法エラーが発生している。 | JP1/Scriptのマネージャ，またはScriptエディタから実行して，エラー内容を確認する。
スクリプトエンジンのバージョンが古いバージョンになっていないか確認する。
スクリプトの実行がエラーになる。 | スクリプトファイルの実行中にエラーを検出した。 | JP1/Scriptのトレースビューアを起動してエラーの内容を確認する。
スクリプトの実行速度が遅くなる。 | 同時に実行するスクリプトの数が多過ぎる。 | 同時に実行するスクリプトの数を減らす。
トレース管理ファイル（SPTLOGDB.SPB）の容量が肥大化している。 | スクリプトが動作していない状況でトレース管理ファイル（SPTLOGDB.SPB）を削除して再実行する。Messageコマンドでユニークなファイル名称を持ったユーザトレースファイルを大量に作成している場合は，MessageコマンドではなくTextOpen/TextWrite/TextCloseコマンドでトレースファイルを作成する。
スクリプト実行が，メモリ不足で異常終了（例：スクリプト実行が終了コード「20」で異常終了する）したり，コマンド実行がメモリ不足でエラー（例：Copyコマンドで「メモリ不足が発生しました」となる）になる。 | トレース管理ファイル（SPTLOGDB.SPB）の容量が肥大化している。 | スクリプトが動作していない状況でトレース管理ファイル（SPTLOGDB.SPB）を削除して再実行する。Messageコマンドでユニークなファイル名称を持ったユーザトレースファイルを大量に作成している場合は，MessageコマンドではなくTextOpen/TextWrite/TextCloseコマンドでトレースファイルを作成する。

5.2.2　コマンド実行時のトラブルと対処方法

コマンド実行時のトラブルと対処方法を表5-2に示します。

表5-2　コマンド実行時のトラブルと対処方法

トラブルの種類
要因
対処方法

NetExecコマンドを実行すると「サーバが接続要求に対して応答しません。」となる。
接続先コンピュータにJP1/Scriptがインストールされていない。
接続先コンピュータにJP1/Scriptをインストールして，Windowsを再起動する。

ログオン空間で実行している場合，接続先コンピュータ上でScriptランチャまたはScriptランチャサービスが起動されていない。
ScriptランチャまたはScriptランチャサービスを起動する。

サービス空間で実行している場合，接続先コンピュータ上でJP1/Scriptサービスが起動されていない。
JP1/Scriptサービスを起動する。

接続先コンピュータに論理ホスト名（論理IPアドレス）を指定し，論理ホスト上でフェールオーバーが発生した。
接続先コンピュータ論理ホスト名（論理IPアドレス）ではなく，物理ホスト名（物理IPアドレス）を指定する。

接続先コンピュータに論理ホスト名を指定する場合は，クラスタにJP1/Scriptを登録する。

NetExecコマンドを実行すると「ユーザ名を認識できないか，またはパスワードが誤っています。」となる。
起動のタイプが「ログオン」のスクリプト自動起動でスクリプトを実行している，JP1/Scriptのマネージャから実行している，またはスクリプトを直接実行している場合，Windowsにログオンしたユーザアカウントが接続先コンピュータ上に存在しない。または，Guestアカウントが無効になっている。
接続先コンピュータでGuestアカウントが無効になっていないか確認する。

Windowsにログオンしたユーザアカウントが接続先コンピュータ上に存在しているか確認する。

起動のタイプが「サービス」のスクリプト自動起動から実行している場合，JP1/Scriptサービスに設定したユーザアカウントが接続先コンピュータ上に存在しない。または，Guestアカウントが無効になっている。
接続先コンピュータでGuestアカウントが無効になっていないか確認する。

JP1/Scriptサービスに設定したユーザアカウントが接続先コンピュータ上に存在しているか確認する。

JP1/AJSのサービスプログラムから実行している場合，スクリプトを実行するJP1ユーザにマッピングされたOSユーザのアカウントが接続先コンピュータ上に存在しない。または，Guestアカウントが無効になっている。
接続先コンピュータでGuestアカウントが無効になっていないか確認する。

スクリプトを実行するJP1ユーザにマッピングされたOSユーザのアカウントが接続先コンピュータ上に存在しているかを確認する。

JP1/AJS以外のサービスプログラムから実行している場合，各サービスアカウントに設定したユーザアカウントが接続先コンピュータ上に存在しない。または，Guestアカウントが無効になっている。
接続先コンピュータでGuestアカウントが無効になっていないか確認する。

各プログラムのサービスに設定したユーザアカウントが接続先コンピュータ上に存在しているか確認する。

NetExecコマンドを実行すると「サーバがScriptランチャサービスの開始パラメータのログオンユーザでログオンされていません。」となる。
Scriptランチャサービスのログオン空間で実行している場合，開始パラメータで指定したログオンユーザでログオンしていない。
開始パラメータで指定したログオンユーザでログオンする。

NetExecコマンドを実行すると「NetExecコマンドの実行ユーザは呼び出し先コンピュータで実行許可されていません。」となる。
NetExecコマンドの実行を許可されていないユーザでNetExecコマンドを実行した。
接続先コンピュータでNetExecコマンドの実行を許可されているユーザを確認する。

NetExecコマンドを実行すると「アクセスは拒否されました。ファイルの属性，またはセキュリティを見直してください。」となる。
スクリプトの自動起動，または上位などのサービスプログラムから実行している場合，サービスアカウントにローカルシステムアカウントを設定している。
スクリプトの自動起動，または上位などのサービスプログラムから実行している場合，そのサービスアカウントに接続先コンピュータ上に存在しているユーザアカウントを設定する。

SetGV，GetGV，DeleteGV，またはNetExecコマンドを実行すると「このコマンドの実行は許可されていません。」となる。
接続先コンピュータで各コマンドのクライアントでの実行を許可しない設定になっている。
接続先コンピュータのJP1/Scriptのマネージャで各コマンドのクライアントでの実行を許可する設定になっているか確認する。

Exec，NetExec，またはCallSptコマンドを実行後，予約変数_EXEC_RTN_に予測しないコードが設定される。
起動した実行ファイルに異常が発生した。
起動した実行ファイルを単体で実行して異常が無いか，実行ファイルが_EXEC_RTN_に設定されたリターンコードを返さないか確認する。
実行ファイルでアプリケーションエラーが発生した場合，-1073741819​（16進C0000005​）などの値が設定される。

Beepコマンドを実行すると「0002:システムは指定されたファイルを見つけることができません。」などのエラーとなる。
OS，ハードウェアの制約のため。
IMEventMessageコマンドなどを使用した代替手段で対処する。詳細は「8.14.3　Beep（スピーカからビープ音を鳴らす）」の注意事項を参照のこと。

Beepコマンドを実行してもビープ音が鳴らない。

5.2.3　トレースビューア実行時のトラブルと対処方法

トレースビューア実行時のトラブルと対処方法を表5-3に示します。

表5-3　トレースビューア実行時のトラブルと対処方法

トラブルの種類 | 要因 | 対処方法
トレースビューアで他コンピュータに接続すると「トレースビューアサーバが起動されていません。または，応答がありません。」となる。 | 接続先コンピュータにJP1/Scriptがインストールされていない。 | 接続先コンピュータにJP1/Scriptをインストールして，Windowsを再起動する。
接続先コンピュータでJP1/Scriptサービスが起動されていない。 | 接続先コンピュータでJP1/Scriptサービスを起動する。
接続先コンピュータに論理ホスト名（論理IPアドレス）を指定し，論理ホスト上でフェールオーバーが発生した。 | 接続先コンピュータに論理ホスト名（論理IPアドレス）ではなく，物理ホスト名（物理IPアドレス）を指定する。
接続先コンピュータに論理ホスト名を指定する場合は，クラスタにJP1/Scriptを登録する。

5.2.4　プロセスビューア実行時のトラブルと対処方法

プロセスビューア実行時のトラブルと対処方法を表5-4に示します。

表5-4　プロセスビューア実行時のトラブルと対処方法

トラブルの種類 | 要因 | 対処方法
プロセスビューアで他コンピュータに接続すると「サーバが接続要求に対して応答しません。」となる。 | 接続先コンピュータにJP1/Scriptがインストールされていない。 | 接続先コンピュータにJP1/Scriptをインストールして，Windowsを再起動する。
接続先コンピュータでJP1/Scriptサービスが起動されていない。 | 接続先コンピュータでJP1/Scriptサービスを起動する。
接続先コンピュータに論理ホスト名（論理IPアドレス）を指定し，論理ホスト上でフェールオーバーが発生した。 | 接続先コンピュータに論理ホスト名（論理IPアドレス）ではなく，物理ホスト名（物理IPアドレス）を指定する。
接続先コンピュータに論理ホスト名を指定する場合は，クラスタにJP1/Scriptを登録する。
プロセスビューアで他コンピュータに接続すると「サーバが接続要求に対して拒否の応答をしました。」となる。 | 接続先コンピュータでプロセスビューアを受け付けない設定になっている。 | 接続先コンピュータのJP1/Scriptのマネージャでプロセスビューアを受け付ける設定になっているか確認する。

5.3　ログ情報

JP1/Scriptでトラブルが発生した場合，ログ情報を確認して対処方法を検討します。JP1/Scriptで出力されるログ情報には次の7種類があります。

解析トレースファイル
解析トレースファイルを出力する場合だけ出力されます。

実行トレースファイル
実行トレースファイルを出力する場合だけ出力されます。

ユーザトレースファイル
Messageコマンドで第一引数にTarget_Fileを指定している場合だけ出力されます。

サーバトレースファイル
SetGV，GetGV，DeleteGV，NetExecコマンドで他コンピュータを指定した場合だけ出力されます。

NetExecエラーログファイル
NetExecコマンドを実行した場合だけ出力されます。

イベントログ
イベントログを出力する場合だけ出力されます。

保守ログファイル
スクリプトの実行，JP1/Scriptサービス，JP1/Scriptランチャサービス，およびScriptランチャでエラーを検出した場合だけ出力されます。

ここでは，7種類のログ情報について説明します。

＜この節の構成＞

5.3.1　ログ情報の種類

5.3.2　ログファイルおよびディレクトリ一覧

5.3.1　ログ情報の種類

＜この項の構成＞

(1)　解析トレースファイル

(2)　実行トレースファイル

(3)　ユーザトレースファイル

(4)　サーバトレースファイル

(5)　NetExecエラーログファイル

(6)　イベントログ

(7)　保守ログファイル

(1)　解析トレースファイル

解析トレースファイルとは，コマンドの解析結果を出力するログ情報のことです。

設定方法については，「4.1.12　コマンドラインの設定ダイアログ」，および「6.2　コマンドラインに関する規則」を参照してください。また，出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

(2)　実行トレースファイル

実行トレースファイルとは，コマンドの実行結果を出力するログ情報のことです。実行トレースファイルには出力レベルがあり，出力レベルによって出力されるログ情報が異なります。設定方法については，「4.1.12　コマンドラインの設定ダイアログ」，および「6.2　コマンドラインに関する規則」を参照してください。また，出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

(3)　ユーザトレースファイル

ユーザトレースファイルとは，Messageコマンドの第一引数にTarget_Fileを指定して出力するログ情報のことです。設定方法については，「8.6.2　Message （ファイル／ウィンドウにテキストを出力する）」を参照してください。また，出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

(4)　サーバトレースファイル

サーバトレースファイルとは，SetGV，GetGV，DeleteGV，およびNetExecコマンドで他コンピュータ名を指定した場合，サーバ上でコマンドを実行した結果を出力するログ情報のことです。設定方法については，「4.1.22　オプション（サーバ情報）ダイアログ」を参照してください。また，出力形式については，「付録A　Scriptトレースのファイル出力形式」を参照してください。

(5)　NetExecエラーログファイル

NetExecエラーログファイルとは，NetExecコマンド実行時に発生したエラーを出力するログ情報のことです。NetExecエラーログファイルについては，「付録A　Scriptトレースのファイル出力形式」を参照してください。

(6)　イベントログ

イベントログとは，システムの状態やトラブルを通知するログ情報のことです。Windowsのイベントビューアで参照することができます。設定方法については，「4.1.12　コマンドラインの設定ダイアログ」，および「6.2　コマンドラインに関する規則」を参照してください。

(7)　保守ログファイル

保守ログファイルとは，JP1/Scriptの各種プログラム内でWindowsが提供する機能を呼び出した際に発生したエラーの詳細情報や発生時の状況を記録したファイルです。各種トレースファイル，ログファイル，およびイベントログを参照しても障害の原因を究明できず，サポートセンターにお問い合わせいただくことになった場合は，保守ログファイルを送付してください。保守ログファイルの設定方法については，「付録D　保守ログファイル」を参照してください。なお，出力される情報の形式は公開していません。

5.3.2　ログファイルおよびディレクトリ一覧

ここでは，JP1/Scriptから出力されるログ情報について，ログの出力元，ログファイル名，およびディスク使用量を表5-5に示します。

表5-5　ログの出力元，ログファイル名，およびディスク使用量

ログ情報の種類
ログファイル名
ディスク使用量（KB）

解析トレースファイル
スクリプト実行フォルダ※1¥スクリプトファイル名.SPA
154※2

実行トレースファイル
スクリプト実行フォルダ※1¥スクリプトファイル名.SPX
154※2

ユーザトレースファイル
MessageコマンドのOutputNameに指定したファイルパス
154※2

サーバトレースファイル
インストール先フォルダ※3¥Data ※4¥SPTSVTRC.SPY
204

NetExecエラーログファイル
インストール先フォルダ※3¥Log¥STXNetExec_Client¥※5
STXNetExec_C_xx※6.log
10※7

インストール先フォルダ※3¥Log¥STXNetExec_Server¥※5
STXNetExec_S_xx ※6.log
10※7

保守ログファイル
インストール先フォルダ※3¥Log¥Maintenance¥※8XXXX_プロセス識別子.log※9
4,032※10

注※1

出力先フォルダは変更できます。設定方法については，「4.1.10　実行環境の設定（トレース情報）ダイアログ」，または「4.1.25　オプション（複数起動）ダイアログ」を参照してください。

注※2

デフォルト値です。ディスク使用量については「1.4.2　ファイルの容量」を参照してください。

注※3

Windows Vista以降のOSの場合，システムドライブの¥ProgramData¥Hitachi¥Scriptフォルダ下に作成されます。

注※4

出力先フォルダは変更できます。設定方法については，「4.1.28　オプション（クラスタ環境）ダイアログ」を参照してください。

注※5

出力先フォルダは変更できます。設定方法については，「8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）」を参照してください。なお，STXNetExec_ClientフォルダはNetExecコマンドを実行したクライアント側，STXNetExec_ServerフォルダはNetExecコマンドで指定したサーバコンピュータ側に作成されます。

注※6

xxは01～30までの数値です。

注※7

一つのファイルの上限値。ファイルは最大30ファイル作成されるので，最大で約300KBを必要とします。

注※8

出力先フォルダは変更できます。設定方法については，「付録D　保守ログファイル」を参照してください。

注※9

ファイル名は保守ログファイルを出力するプログラムによって異なります。ファイル名の詳細については，「付録D　保守ログファイル」を参照してください。

注※10

デフォルト値で出力した場合の最大値です。ファイルサイズの詳細については，「付録D　保守ログファイル」を参照してください。

5.4　トラブル発生時に採取が必要な資料

「5.2　トラブルシューティング」に示した対処をしてもトラブルを解決できなかった場合，トラブルの要因を調べるための資料を採取し，システム管理者に連絡する必要があります。この節では，トラブル発生時に採取が必要な資料について説明します。

＜この節の構成＞

5.4.1　OSの情報

5.4.2　JP1/Scriptの情報

5.4.3　オペレーション内容

5.4.4　画面上の情報

5.4.1　OSの情報

トラブル発生時に採取が必要なOSの情報を表5-6に示します。

表5-6　トラブル発生時に採取が必要なOSの情報

情報の種類
概要
デフォルトのファイル名
採取方法

イベントログ
（アプリケーションログ）
Windowsイベントログ
－
イベントビューアからログファイル保存

イベントログ
（システムログ）

OS情報
システム情報
－
「5.5.2　OSシステム情報の採取」を参照のこと

ダンプ情報 ※¹
ワトソンログファイル ※2

システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥drwtsn32.log ※3

システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥user.dump ※3

－

プロセスダンプ ※⁴
－
Microsoft(R)サポート技術情報を参照してください。

注※1

アプリケーションエラーが発生した場合に採取してください。

注※2

Windows XP，またはWindows Server 2003の場合に採取してください。

注※3

別のフォルダにログファイルが出力されるように設定している場合は，該当するフォルダから資料を採取してください。

注※4

スクリプトプロセス（SPTXE.EXE）が実行中のままとなった場合に採取してください。

5.4.2　JP1/Scriptの情報

JP1/Scriptに関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

トラブル発生時に採取が必要なJP1/Scriptの情報を表5-7に示します。

表5-7　トラブル発生時に採取が必要なJP1/Scriptの情報

情報の種類
概要
格納場所

スクリプトファイル
スクリプト実行時のスクリプトソース
スクリプト実行フォルダ¥スクリプトファイル名.SPT

スクリプト実行環境ファイル
スクリプト実行時の環境が設定されているファイル
スクリプト実行フォルダ¥スクリプトファイル名.SPV

モニタリング情報ファイル
モニタリング実行時の情報が設定されているファイル
スクリプト実行フォルダ¥スクリプトファイル名.SPD

メニューファイル
Menuコマンド実行時のメニューファイル
メニューファイル名.SPN

解析トレースファイル
スクリプト実行時の解析トレースファイル
スクリプト実行フォルダ¥スクリプトファイル名.SPA

実行トレースファイル
スクリプト実行時の実行トレースファイル
スクリプト実行フォルダ¥スクリプトファイル名.SPX

ユーザトレースファイル
Messageコマンド実行時のトレースファイル
MessageコマンドのOutputNameに指定したファイルパス

サーバトレースファイル
NetExec，SetGV，GetGV，DeleteGVコマンドで他コンピュータを指定した場合に出力されるサーバ上の実行結果ログ
インストール先フォルダ※¥Data¥SPTSVTRC.SPY

NetExecエラーログファイル
NetExecコマンド実行時のクライアントとサーバ上に出力されるエラー情報
インストール先フォルダ※¥Log¥STXNetExec_Client¥STXNetExec_C_xx.log

インストール先フォルダ※¥Log¥STXNetExec_Server¥STXNetExec_S_xx.log

自動起動情報ファイル
自動起動情報を格納したファイル

Windows XP（全ユーザ共通）の場合：

インストール先フォルダ¥Data¥SPTLNCH.SPH

Windows XP（ユーザごと）の場合：

インストール先フォルダ¥Data¥現在のユーザ名¥SPTLNCH.SPH

Windows Vista以降のOS（全ユーザ共通）の場合：

システムドライブ¥ProgramData¥Hitachi¥Script¥Data¥SPTLNCH.SPH

Windows Vista以降のOS（ユーザごと）の場合：

システムドライブ¥ProgramData¥Hitachi¥Script¥Data¥現在のユーザ名¥SPTLNCH.SPH

サーバ環境ファイル
サーバ環境が設定されているファイル
インストール先フォルダ※¥Data¥SPTSV.SPS

トレース管理ファイル
トレースファイルを管理するファイル
インストール先フォルダ※¥Data¥SPTLOGDB.SPB

グローバル変数ファイル
グローバル変数が保存されたファイル
インストール先フォルダ※¥Data¥SPTGV.SPG

レジストリ情報
JP1/Scriptのレジストリ情報
HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥配下

保守ログファイル
エラーの詳細情報やそのときの状況を記録した情報
インストール先フォルダ※¥Log¥Maintenance¥XXXX_プロセス識別子.log

その他
スクリプト処理で扱っているiniファイルやスクリプト処理で作成しているログファイルなど
－

注※

Windows Vista以降のOSの場合，システムドライブの¥ProgramData¥Hitachi¥Scriptフォルダ下に作成されます。

5.4.3　オペレーション内容

トラブル発生時のオペレーション内容で必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名など）

再現性の有無

5.4.4　画面上の情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（画面全体）

プロセスビューアのハードコピー（画面全体）

タスクマネージャのSPTXEプロセスのハードコピー（［表示］－［列の選択］で［スレッドの数］をチェックし，スレッド数も採取してください）

5.5　資料の採取方法

トラブルが発生したときに資料を採取する方法を次に示します。

＜この節の構成＞

5.5.1　資料採取ツール

5.5.2　OSシステム情報の採取

5.5.3　ダンプ情報

5.5.4　JP1/Scriptの資料採取

5.5.5　Windowsイベントログの採取

5.5.1　資料採取ツール

＜この項の構成＞

(1)　資料採取ツールの準備

(2)　資料採取ツールの実行

(3)　資料採取ツールで採取する情報

(1)　資料採取ツールの準備

資料採取ツールはインストール先フォルダのToolsフォルダ下のSptrasファイルになります。エクスプローラなどを使ってSptrasファイルを任意のフォルダに複写してください。次に，複写先のファイルの拡張子を「.bat」に変更してください。なお，インストール先フォルダとDataフォルダについては，Sptrasファイル中の説明に従ってエディタで編集する必要があります。

ログの出力先などを変更している場合も，Sptrasファイルに記載されている説明に従ってファイルの内容を変更してください。

(2)　資料採取ツールの実行

資料採取ツールを実行します。次にツールの実行例を示します。

c:¥>c:¥temp¥Sptras.bat

資料採取ツールの実行結果は，デフォルトでは %TEMP%¥jp1script フォルダ下に出力されます。このフォルダ下を採取してください。バッチファイルの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので「y」で応答してください。

注意

資料採取ツールは，スクリプトファイルを実行していない時にバッチファイルを実行してください。Scriptプロセスビューアで実行しているスクリプトファイルを確認できます。また，資料採取ツールが終了するまでスクリプトを実行しないように注意してください。

(3)　資料採取ツールで採取する情報

資料採取ツールで採取する情報，情報の出力先のフォルダ名，またはファイル名を次の表に示します。

表5-8　資料採取ツールで採取する情報と情報の出力先の対応

資料採取ツールで採取する情報 | 情報の出力先
JP1/Scriptのインストール先フォルダ配下のファイルリスト | FILELIST.txt
hostsファイル | hosts
servicesファイル | services
JP1/Scriptのレジストリ情報 | REGDATA.DAT
OSバージョン，Windowsの環境変数情報，IPコンフィギュレーション情報など | OSINFO.TXT
JP1/Scriptのインストール先フォルダ配下すべて | Backup（フォルダ）
保守ログファイル | Backup¥MaintenanceLog（フォルダ）

5.5.2　OSシステム情報の採取

Windows XPの場合
［コンピュータの管理］の［システム情報］の内容，または［アクセサリ］－［システムツール］－［システム情報］の内容

Windows Server 2003の場合
［アクセサリ］－［システムツール］－［システム情報］の内容

5.5.3　ダンプ情報

アプリケーションエラーが発生した場合は，「5.4.1　OSの情報」に示すダンプ情報を採取してください。

5.5.4　JP1/Scriptの資料採取

トラブルが発生したときは，次のファイルを採取してください。

トラブルが発生したスクリプトファイル（拡張子：SPT）およびそのスクリプトファイルの実行環境ファイル（拡張子：SPV）

モニタリング情報ファイル（拡張子：SPD）

メニューファイル（拡張子：SPN）

解析トレースファイル（拡張子：SPA）

実行トレースファイル（拡張子：SPX）

ユーザトレースファイル（Messageコマンドで出力したファイル）

スクリプトファイル中で処理しているファイル（iniファイル，TextOpenコマンドに指定しているファイルなど）

保守ログファイル（拡張子：LOG）

5.5.5　Windowsイベントログの採取

Windowsの［イベントビューア］ウィンドウで，Windowsイベントログ（アプリケーションログ／システムログ）をイベント形式とテキスト形式でそれぞれファイルに保存してください。

5.6　バックアップとリカバリー

JP1/Scriptで扱うファイルや動作環境情報のバックアップとリカバリーについて説明します。

＜この節の構成＞

5.6.1　JP1/Scriptで扱うファイルのバックアップとリカバリー

5.6.2　動作環境情報のバックアップとリカバリー

5.6.1　JP1/Scriptで扱うファイルのバックアップとリカバリー

バックアップ対象ファイルを表5-9に示します。バックアップとリカバリーは必要に応じて利用者が実施してください。バックアップは，JP1/Scriptサービス，Scriptランチャ，およびScriptランチャサービスを停止してから実施してください。フォルダやファイルのバックアップ時にこれらが起動していた場合，排他エラーが発生するおそれがあります。

なお，スクリプトファイル以外のファイルは，スクリプトの定義後または実行後に作成されるため，存在しない場合があります。

表5-9　バックアップ対象ファイル

項番 | ファイル名 | ファイル名または拡張子 | ファイルの所在
1 | スクリプトファイル | .SPT | 任意のフォルダ。ユーザが作成する。
2 | 実行環境ファイル | .SPV | スクリプト実行フォルダ。スクリプトの定義後または実行後に作成される。
3 | メニュー情報ファイル | .SPN
4 | モニタリング情報ファイル | .SPD
5 | 解析トレースファイル | .SPA
6 | 実行トレースファイル | .SPX
7 | ユーザトレースファイル | .TXTなど | MessageコマンドのOutputNameに指定したファイルパス。
8 | サーバトレースファイル | SPTSVTRC.SPY | インストール先フォルダ¥Data フォルダ下。※1 ※2スクリプトの定義後または実行後に作成される。
9 | トレース管理ファイル | SPTLOGDB.SPB
10 | サーバ環境ファイル | SPTSV.SPS
11 | グローバル変数ファイル | SPTGV.SPG
12 | 自動起動情報ファイル | SPTLNCH.SPH | インストール先フォルダ¥Data フォルダ下。※1 ※3スクリプトの定義後または実行後に作成される。
13 | 実行環境構文ファイル | .SPU | 実行環境ファイルと同じフォルダまたはtoDirNameで指定したフォルダ。実行環境ファイルコンバータを使用しない場合は存在しない。

注※1

Scriptマネージャの［ツール］－［オプション］－［クラスタ環境］で管理ファイルの出力先が変更されている場合，変更先のフォルダ下に作成されます。

注※2

Windows Vista以降のOSの場合，システムドライブの ¥ProgramData¥Hitachi¥Script¥Dataフォルダ下に作成されます。

注※3

Windows XPの場合，インストール先フォルダ¥Data フォルダの下のフォルダ下にも作成されます。

Windows Vista以降のOSの場合，システムドライブの ¥ProgramData¥Hitachi¥Script¥Dataフォルダ下と，その下のフォルダ下に作成されます。詳細は，「5.4.2 JP1/Scriptの情報」を参照してください。

5.6.2　動作環境情報のバックアップとリカバリー

Scriptマネージャの［ツール］－［オプション］で設定した内容
Scriptマネージャの［ツール］－［オプション］ダイアログで設定した内容は，「サーバ情報」以外はレジストリに書き込まれる内容なのでバックアップは利用者が記録し，その内容をダイアログで設定することでリカバリーできます。

JP1/Scriptサービスのアカウント
バックアップはJP1/Scriptサービスのアカウントを利用者が記録し，その内容を再設定することでリカバリーできます。

その他
利用者がレジストリに設定した内容は，その内容を再設定することでリカバリーできます。

6.　JP1/Scriptの規則

JP1/Scriptでは，ステートメント，基本コマンド，および特殊コマンドを使用して，スクリプトを作成します。この章では，スクリプトに関する規則，およびコマンドラインに関する規則について説明します。

＜この章の構成＞

6.1　スクリプトに関する規則

6.2　コマンドラインに関する規則

6.1　スクリプトに関する規則

ここでは，コマンドを使用してスクリプトを作成する場合に，知っておいていただきたいスクリプトに関する規則を，次に示す項目に分けて説明します。

変数の名前付け規則

利用できる変数の個数と容量

変数名として扱えないキーワード

予約変数

配列変数

定数

数字の記述規則

文字列の記述規則

演算規則

演算の優先順位

コーディング規則

JP1/Scriptの終了コード

JP1/Scriptのイベントログ

＜この節の構成＞

6.1.1　変数の名前付け規則

6.1.2　利用できる変数の個数と容量

6.1.3　変数名として扱えないキーワード

6.1.4　予約変数

6.1.5　配列変数

6.1.6　定数

6.1.7　数字の記述規則

6.1.8　文字列の記述規則

6.1.9　演算規則

6.1.10　演算の優先順位

6.1.11　コーディング規則

6.1.12　JP1/Scriptの終了コード

6.1.13　JP1/Scriptのイベントログ

6.1.14　JP1/Scriptで発行するJP1イベント

6.1.1　変数の名前付け規則

JP1/Scriptの変数の名前付け規則は次のとおりです。

変数名の先頭文字は，必ず半角の英字（A～Z，a～z），または全角文字でなければなりません。先頭以外の文字には，半角の英字，数字，アンダースコア（_），および全角文字を使用できます。

変数名は，32バイト以内でなければなりません。33バイト以上指定した場合は，33バイト以降は無視されます。全角文字を32バイト目に指定した場合は，32バイト目も無視されます。

変数名，およびキーワードの大文字と小文字は区別されません。

変数名は2行以上にわたって記述することはできません。

キーワードを変数名に使用することはできません。

変数宣言を行った適用範囲内で，同じ変数名を複数使用できます。

プロシージャ※名は変数の名前付け規則に従います。ただし，プロシージャ名と変数名に同じ名前を設定することはできません。

注※

プロシージャとは，実行時に一つの単位として処理されるコマンドの集まりのことをいいます。JP1/Scriptでは，FunctionステートメントとSubステートメントで定義された一連の処理がこれに該当します。「サブルーチン」と同意語です。

6.1.2　利用できる変数の個数と容量

JP1/Scriptで利用できる変数の個数と容量は次のとおりです。

一つのプロシージャで使用できる変数は，1,024個までです。

プロシージャの外部で使用できる変数は，1,024個までです（ただし，予約変数，および位置変数は含まれません）。

変数に格納できる容量は，最大1,024バイトです。1,024バイト以降のデータは無視されます。

6.1.3　変数名として扱えないキーワード

変数名として扱えないキーワード（JP1/Scriptの予約語）を，表6-1に示します。

表6-1　変数名として扱えないキーワード

見出し
変数名として扱えないキーワード

A
Abort，AbortAll，AbortRetryIgnore，Abs※，AddStr，After，Alert，Alertness，AllDq，AllGV，Alt，And，Anyway，Append，AppliModal，ApplicationModal，Array※，Asc※，AscB※，AscW※，Atn※，ATTR_ARCHIVE，ATTR_COMPRESSED，ATTR_HIDDEN，ATTR_NORMAL，ATTR_OFF，ATTR_OFFLINE，ATTR_ON，ATTR_READONLY，ATTR_SUBDIR，ATTR_SYSTEM，ATTR_TEMPORARY，AuditFailure，AuditSuccess

B
Backup，Beep，Before，BitmapHide，BitmapShow，
Boolean※，ByRef※，Byte，ByVal※

C
CalcDate，CalcTime，Call，CallDll，CallSpt，Cancel，CancelStartUp，CancelUserErr，Case，CatFiles，CBool※，CByte※，CDate※，CDbl※，CDROM，CheckDirName，CheckDriveType，Chr※，ChrB※，ChrW※，Cint※，Clear※，CLng※，Close，Command，CompDate，CompTime，Continue，Copy，Cos※，Create，CreateObject※，Critical，CSng※，CStr※，Ctrl，Ctrl_Alt，
Currency※，Cur_Desktop，Cur_Program，Cur_Startmenu，Cur_Startup

D
Date，DateSerial※，DateValue※，Delete，DeleteGV，Day，DayU，Debug，DeleteDir，DeleteFile，DeleteGroup，DeleteShortcut，DependG，DependM，Description※，Destroy，Dim，DISABLE，DispName，Do，Double※

E
Each※，Else，ElseIf，Emergence，Emergency，Empty，End，Enter，EntryStartUp，Equal，Eqv※，Erase※，Err，Errctl，Error，ErrSkip，ErrSkip2，Esc，Ex，Exclamation，ExclDir，Exec，EXEC_RUNNING，EXEC_STOPPED，Exit，ExitWindows，Exp※，Explicit※

F
False，FileTime，Fix※，FIXED，For，Force，Format，FreeExt，Function，F1，F2，F3，F4，F5，F6，F7，F8，F9，F10，F11，F12

G
GetArrayCount，GetDateCount，GetDiskFreeSpace，GetEnv，GetEnvironment，GetErrorMessage，GetExecStatus，GetFileAttr，GetFileAttribute，GetFileSize，GetFIleTime，GetGV，GetPath，GetProcessCount，GetProcessInfo，GetServiceName，GetTextPosition，GetTimeCount，GetVerInfo，GetVersionInfo，GetVolLabel，GetVolumeLabel，Goto，Group

H
HelpContext※，HelpFile※，Hex※，HIDE，HKEY_CLASSES_ROOT，HKEY_CURRENT_USER，HKEY_LOCAL_MACHINE，HKEY_USERS，Hour，HourU

I
If，IfEmpty，Ignore，IMEventMessage，Imp※，InArray，Info，Information，IniRead，IniWrite，InputBox，InputLine，InStr，InStrB※，Int※，Integer※，Is※，IsArray※，IsDate※，IsDef，IsDefine，IsEmpty，IsEmptyDir，IsEmptyGroup，IsEmptyReg，IsExistDir，IsExistFile，IsExistRegKey，IsExistService，IsFileAttr，IsFileAttribute，IsLeapYear，IsLower，IsMultiChar，IsNew，IsNull※，IsNumeric，IsObject※，IsSingleChar，IsUpper，IsWriteableDir

J
JOBCancel，JOBHold，JOBSubmit，JOBWait

K
KB

L
LBound※，LCase，Lcl_Desktop，Lcl_Program，Lcl_Startmenu，Lcl_Startup，Left，LeftB※，Len，LenB※，Log※，Logoff，Logon，LOGON_FAILED，Long※，Loop，Ltrim

M
MakeDir，MakeGroup，MakePath，MakeShortcut，Max，MB，Menu，Message，MessageBox，MessageEventLog，Mid，MidB※，Min，Minus，Minute，MinuteU，Mod，Mod=，Modify，Month，MonthU，Move

N
Name，NeedDq，NetExec，Next，No，NOCHANGE，None，NoOverwrite，NoReplace，Normal，Not，NotEqual，Nothing※，Notice，Now※，Null※，Number※

O
Object※，Oct※，OK，OKCancel，On，Option※，Or，Overwrite，OverwriteOnly

P
Password，Path，Pause，Pile，Plus，Poweroff，Preserve※，Private※，ProcessEnv，Public※

Q
Question

R
Raise※，RAMDISK，Randomize※，ReadOnly，ReadWrite，Reboot，ReDim※，REG_BINARY，RegDelete，RegDeleteKey，REG_DWORD，REG_DWORD_BIG_ENDIAN，REG_EXPAND_SZ，REG_LINK，REG_MULTI_SZ，REG_NONE，RegRead，REG_RESOURCE_LIST，REG_SZ，RegWrite，REMOTE，REMOVABLE，Release，Rem，Remove，Rename，Replace，ResetStandardFile，ResetStdFile，Restart，Resume※，Retry，RetryCancel，Right，RightB※，Rnd※，Rtrim

S
Second，SecondU，Security，Select，SplitFile，SeparateStr，SeparateStrCount，Service，ServiceChange，ServiceContinue，SERVICE_AUTO_START，SERVICE_BOOT_START，SERVICE_CONTINUE_PENDING，ServiceControl，SERVICE_CONTROL_CONTINUE，SERVICE_CONTROL_PAUSE，SERVICE_CONTROL_STOP，ServiceCreate，ServiceDelete，SERVICE_DEMAND_START，SERVICE_DISABLED，SERVICE_ERROR_CRITICAL，SERVICE_ERROR_IGNORE，SERVICE_ERROR_NORMAL，SERVICE_ERROR_SEVERE，SERVICE_FILE_SYSTEM_DRIVER，ServiceGetValue，SERVICE_KERNEL_DRIVER，ServicePause，SERVICE_PAUSE，SERVICE_PAUSE_PENDING，ServiceQuery，ServiceRefer，SERVICE_RUNNING，ServiceSetValue，ServiceStart，SERVICE_START_PENDING，ServiceStop，SERVICE_STOPPED，SERVICE_STOP_PENDING，SERVICE_SYSTEM_START，SERVICE_WIN32_OWN_PROCESS，SERVICE_WIN32_SHARE_PROCESS，Set※，SetEnv，SetEnvironment，SetFileAttr，SetFileAttribute，SetFileTime，SetGV，SetPath， SetStandardFile，SetStdFile，SetVolLabel， Shutdown，SetVolumeLabel，Shift，Shift_Alt，Shift_Ctrl，Shift_Ctrl_Alt，Sgn※，Sin※，Single※，Skip，Sleep，Source※，Space，SplitPath，Sqr※，Start，StartName，StdError，StdInput，StdOutput，Step，Stop，Str，StrComp※，String，StringJ，Sub，SubDirToo，Submit，Syntax※，Sysmodal※，SystemEnv，SystemModal

T
Tan※，Target_DispClear，Target_DispOff，Target_DispOn，Target_File，Target_SPAFile，Target_SPXFile，TempDir，TempFile，TerminateProcess，TextClose，TextFileReplace，TextOnly，TextOpen，TextRead，TextSeek，TextWrite，Then，Time，TimeSerial※，TimeValue※，To，ToBegin，ToEnd，Trace，Trim，True，Twice，Type，TypeOf※

U
UBound※，UCase，UnSubmit，Until，Update，UserEnv，UserErr

V
Val※，Variant※，VarType※，Version，VersionUp

W
Wait，WaitAll，WaitForExec，Warning，Weekday，
Wend※，While，WriteOnly

X
Xor※

Y
Year，Yes，YesNo，YesNoCancel

記号
＾，＾=，-，-=，*，*=，/，/=，￥，￥=，+，+=，&，&=，?，=，<>，<，>，<=，>=

注※

これらのキーワードは，今後のエンハンスで順次サポートする予定のため，予備として確保してあります。ご使用にならないでください。

6.1.4　予約変数

JP1/Scriptには，特定のデータ（システム情報，およびコマンドの戻り値）を参照できる「予約変数」が用意されています。

予約変数の種類と意味を表6-2に示します。

表6-2　予約変数一覧

分類
予約変数
意味

システム予約変数
_ALLRIGHT_
アドミニストレータ権限がある場合はYESになり，権限がない場合はEmpty値になります。

_BIN_
実行中のスクリプトファイルの作業フォルダ名です。末尾に￥が付きます。

_COMP_
スクリプトファイルを実行しているコンピュータ名です。

_DOMAIN_
ログオンしているドメイン名です。

_OS_
OSの種類とバージョンです。

Windows XPの場合：WIN_NT5.1

Windows Server 2003の場合：WIN_NT5.2

Windows VistaまたはWindows Server 2008の場合：WIN_NT6.0

Windows 7またはWindows Server 2008 R2の場合：WIN_NT6.1

_OS_PLATFORM_
OSの種類です。

WIN_NT

_OS_REVISION_
OSのマイナーバージョンです。

Windows Vista，またはWindows Server 2008の場合：0

Windows XP，Windows 7，またはWindows Server 2008 R2の場合：1

Windows Server 2003の場合：2

_OS_VERSION_
OSのメジャーバージョンです。

Windows XP，またはWindows Server 2003の場合：5

Windows Vista，Windows 7，Windows Server 2008，またはWindows Server 2008 R2の場合：6

_SCF_
実行中のスクリプトファイルのフォルダ名です。末尾に￥が付きます。

_SCF_FIL_
実行中のスクリプトファイルのファイル名です。拡張子は付きません。

_SCF_EXT_
スクリプトファイルの拡張子（.SPT）です。

_SNF_EXT_
メニュー情報ファイルの拡張子（.SPN）です。

_SVF_EXT_
実行環境ファイルの拡張子（.SPV）です。

_SDF_EXT_
モニタリング情報ファイルの拡張子（.SPD）です。

_SYS_
MS-DOSの起動フォルダ名です。末尾に￥が付きます。

_TEMP_
一時ファイル用のフォルダ名です。末尾に￥が付きます。

_USER_
現在のシステムにログオンしているユーザ名です。

_WIN_
Windowsフォルダ名です。末尾に￥が付きます。

_WINSYS_
Windowsドライバが存在するフォルダ名です。末尾に￥が付きます。

プロセス予約変数
_PROC_ID_
実行中のスクリプトのプロセス識別子です。

_ARGV_
%1以降の位置変数を格納した配列変数です。%0は含みません。_ARGV_（n）の形式で参照（nは1からの数字）できます。

_ARGV_CNT_
%1以降の位置変数の合計数です。%0は含みません。

コマンド戻り値予約変数
_COPY_RTN_
Copyコマンドの実行結果です。

_COPY_CNT_
Copyコマンドでコピーしたファイルの数です。

_COPY_SKIP_CNT_
Copyコマンドでコピーしなかったファイルの数です。

_COPY_SKIP2_CNT_
CopyコマンドのErrSkip2指定で無視されたファイルの数です。

_EXEC_RTN_
Exec，NetExec，またはCallSptコマンドの戻り値です。符号付きの数値です。

_EXEC_ID_
Exec，またはNetExecコマンドの実行ファイル識別子です。ただし，FlagにFalseを設定した場合（呼び出したプログラムの終了指定がなしの場合）にだけ，有効になります。

_JOB_RTN_
ジョブ操作系コマンドの戻り値です。

_MSG_RTN_
InputBox，またはMessageBoxコマンドの戻り値です。

_DLL_RTN_
CallDllコマンドの外部関数の戻り値です。

_FORM_TERM_KEY_
画面（メニューフォーム）を終了させた要因です。

_FORM_TERM_CMDNO_
コマンドを実行して終了したときのコマンド番号です。

_FORM_MODIFY_KEY_
画面（メニューフォーム）終了キーのモディファイキーです。

_FORM_FIELD_NAME_
最後にフォーカスがあったメニュー名です。

_RTN_
エラー詳細コードです。符号付きの数値です。
コマンドの実行結果が設定されます。ただし，コマンドの実行結果が特定の値（文字列操作コマンドなど）の場合は，予約変数_RTN_には常に0（ゼロ）が設定されます。また，エラー詳細コードが示すエラー原因は，トレースファイルに出力されるエラーメッセージの内容となります。

_RTNxx_
CallDllコマンドの戻り値（xxは00からの数字）です。

_SVC_RTN_
サービス操作系コマンドの戻り値です。

文字コード予約変数
_NL_
改行文字です。

_TAB_
タブ文字です。

エラー詳細コード予約変数
_NO_ERR_
エラーはありません。

_ERR_EOF_
ファイルの終わりに達しました。

_ERR_TIMEOUT_
タイムアウト時間を経過しました。

_ERR_FILE_
ファイルが見つかりません。

_ERR_PATH_
パスが見つかりません。

_ERR_ACCESS_
アクセスが拒否されました。

_ERR_PROTECT_
書き込みが禁止されています。

_ERR_READY_
デバイスが準備できていません。

_ERR_EXCLUSIVE_
ファイルは他でアクセス中です。

_ERR_SVR_CONNECT_
サーバが接続要求に応答しません。

_ERR_SVR_TIMEOUT_
サーバからの応答待ちでタイムアウトエラーが発生しました。

_ERR_SVR_RECEIVEDATA_
サーバからデータ受信中にエラーが発生しました。

_ERR_SVR_NODATA_
サーバとの送受信中の無通信時間が許容時間を超えました。

_ERR_FILE_SIZE_
取得した値が変数の上限値を超えているため，値を変数に格納できません。

_ERR_NOT_LARGE_FILE_
指定したファイルの容量が制限値を超えています。

_ERR_FILE_POSITION_
読み書き開始位置が2,147,483,647を超えています。

_ERR_SERVICE_NOT_BEGIN_
JP1/Scriptサービスが実行中の状態になっていません。

6.1.5　配列変数

配列変数のインデックス番号は1から始まります。一次元配列変数のインデックス番号は要素を表します。二次元配列変数の1番目のインデックスは行要素を表し，2番目のインデックス番号は列要素を表します。

次に二次元配列変数「T（5，6）」のデータ構造例を示します。

＜この項の構成＞

(1)　配列変数の記述規則

(2)　配列変数のデータ構造例

(1)　配列変数の記述規則

配列変数の記述規則を次に示します。

配列変数名は変数の名前付け規則に従います。

配列変数の要素（二次元配列の場合は，行要素，および列要素）を表すインデックス番号は1から始まります。また，「（ ）」，または「[ ]」で囲んで指定します。

配列変数の宣言時にインデックス番号を指定する場合は，配列変数の要素数は固定となります。インデックス番号を指定しない場合は，配列変数の要素数は可変となります。

配列変数の次元数は，一次元，および二次元まで定義できます。

配列変数の要素数の上限は，一つの配列変数につき65,536個，一つのスクリプトファイルにつき131,072個です。

一度宣言した配列変数の次元数は変更できません。

（例）

Dim A ( 5 )

Dim A ( 5 ，10 ) ←（エラー）次元数は変更できない。

一度宣言した配列変数の次元数が等しい場合は，要素数を変更できます。また，要素数が固定な配列変数から可変な配列変数へ，または可変な配列変数から固定な配列変数へ変更できます。変更した場合，今までの設定値はEmpty値となります。

（例）

Dim A ( 10 )

Dim A ( 5 ) ←要素数を変更できる。

Dim A ( ) ←可変な要素数に変更できる。

非配列変数から配列変数へ，または配列変数から非配列変数への再定義はできません。

（例）

Dim A

Dim A ( ) ←（エラー）Aは非配列変数として定義されているため再定義できない。

代入文で配列変数のすべての要素を一括して代入することができます。ただし，左辺と右辺の配列変数の要素数が異なる場合，一括して代入することはできません。

（例）

Dim A ( 5 ) ，B ( ) ，C ( 10 )

For cnt = 1 To 5

A ( cnt ) = Time

Next

B = A ←Aのすべての要素を一括してBに代入できる。

C = B ←（エラー）BとCの要素数が異なるため一括して代入できない。

代入文で配列変数の一つの行要素だけを一括して代入することができます。ただし，一つの列要素だけを一括して代入することはできません。

（例）

Dim A ( 2 ， 5 ) ，B ( )

For cnt = 1 To 5

A ( 1 ， cnt ) = Time

Next

B = A ( 1 ) ←Aの第1行目の要素を一括してBに代入できる。

比較文で配列変数のすべての要素が等しいかどうかを判定することができます。ただし，大小比較はできません。

（例1）

Dim A ( 5 ) ，B ( 5 )

:

If A = B Then ←AとBが等しいかどうかを比較できる。

（例2）

Dim A ( 5 ) ，B ( 5 )

:

If A < B Then ←（エラー）AとBの大小比較はできない。

要素数が可変な配列変数で値が未設定な中間の要素に対し代入を行った場合，先頭から中間の要素までの未設定であった要素はEmpty値になります。

（例1）

Dim A ( )

A ( 1 ) = Time

A ( 5 ) = Time ←A ( 2 ) から A ( 4 ) までの要素はEmpty値になる。

（例2）

Dim A ( ， )

A ( 2 ， 5 ) = Time ←A ( 1 ， 1 ) と A ( 2 ， 1 ) から A ( 2 ， 4 ) の要素はEmpty値になる。

（例3）

Dim A ( 2 ， )

A ( 2 ， 5 ) = Time ←A ( 2 ， 1 ) から A ( 2 ， 4 ) の要素はEmpty値になる。

（例4）

Dim A ( ， 5 )

A ( 2 ， 5 ) = Time ←A ( 1 ， 1 ) から A ( 1 ， 5 ) と A ( 2 ， 1 ) から A ( 2 ， 4 ) の要素はEmpty値になる。

(2)　配列変数のデータ構造例

配列変数のデータ構造例を次に示します。

一次元の配列変数の場合，インデックス番号は要素を表します。

（例）

Dim A ( 5 ) と宣言した場合

下図のような五つ分の要素が割り当てられます。

二次元の配列変数の場合，一番目のインデックス番号は行要素を，二番目のインデックス番号は列要素を表します。

（例1）

Dim B ( 1 ， 5 ) と宣言した場合

下図のような1行5列分の要素が割り当てられます。

（例2）

Dim C ( 3 ， 4 ) と宣言した場合

下図のような3行4列分の要素が割り当てられます。

6.1.6　定数

JP1/Scriptで特別な意味を持つ定数の種類と意味を，表6-3に示します。

表6-3　定数一覧

定数 | 意味
Empty | 空の値（""）を示します。
True | 真（0以外）の値を示します。
False | 偽（0）の値を示します。

6.1.7　数字の記述規則

数字の記述規則を次に示します。

「0」，「＋0」，「－0」は同値とみなします。

「0」だけが連続している数字は「0」とみなします。

扱える数字は整数だけです。

コンマ（，）の有無は，数字をダブルクォーテーション（"）で囲んだ場合には区別されません。
例えば，"10,000"と10000は同値とみなします。

数字の先頭の「+」の有無は区別されません。例えば，600と+600は同値とみなします。

扱える数値は，-2,147,483,647～2,147,483,647の範囲です。

数字をダブルクォーテーション（"）で囲んでも文字列としては扱われません。例えば，"10000"と10000は同値とみなします。文字列として扱うにはStrコマンドを使用してください。

6.1.8　文字列の記述規則

文字列の記述規則を次に示します。

数値以外の文字列を記述する場合はダブルクォーテーション（"）で囲みます。

変数，組み込み定数をダブルクォーテーション（"）で囲むと文字列として扱われます。ただし，組み込み定数を指定するコマンドの引数に指定された場合は，組み込み定数として扱われます。

扱える文字列の長さは最大1,024文字です。

何も囲んでいないダブルクォーテーション（"）はEmpty値とみなします。

ダブルクォーテーション（"）で囲まれている数値にコンマ（，）以外の文字列が含まれると文字列として扱われます。

6.1.9　演算規則

スクリプトの演算規則を次に示します。

（ ）内の演算は，最も内側のものから行われます。

変数は，基本的に文字列型として扱われますが，数字だけで構成されている文字列同士の演算の場合は数字として扱われ，演算が行われます。

単項演算子は「＋」，「－」だけです。

6.1.10　演算の優先順位

演算の優先順位を表6-4に示します。

表6-4　演算の優先順位

優先度
演算子
内容

高い
↑
↓
低い
＾
指数演算

+，－
単項演算子

*，/，￥，Mod
乗算，除算，整数除算，剰余演算

+，－
加算，減算

&
文字列連結

=，<>，<，<=，>，>=
比較演算

Not
論理否定

And
論理積

Or
論理和

6.1.11　コーディング規則

JP1/Scriptのコーディング規則を次に示します。

1文（ステートメントを除く）が複数行にわたるときは，アンダースコア（_）を文の最後に記述します。アンダースコアは，前に1個以上の半角スペースを入れてから記述します。なお，引数を伴うコマンド文で引数を括弧で囲んである場合は，アンダースコアを記述する必要はありません。

（例）引数を括弧で囲む場合

Command (A,B,C,
        D,E,F)

（例）引数を括弧で囲まない場合

Command A,B,C,  _
       D,E,F

コマンド名を，複数行にわたって記述することはできません。

コマンドの大文字と小文字は区別されません。

1行に記述できるスクリプトは最大10,240バイトです。10,240バイトを超えた部分のスクリプトは無視されます。

スクリプトに記述できる文字列は最大1,024バイトです。1,024バイトを超えた部分のスクリプトは無視されます。

コマンドの引数の記述は，以下の形式のうちのどれかで記述します。引数が複数個存在する場合は，「，」（コンマ），またはスペースで区切ります。

（例）引数の記述（△：スペース）

Command(A)
Command△(A)
Command△A
Command(A,B)
Command△(A,B)
Command△A△B
Command△A,B

コマンド，または関数の引数に，引数を伴うコマンド，または関数を記述する場合には，引数として記述したコマンド，または関数の引数を，必ず括弧で囲まなくてはなりません。

（例）必ず括弧で囲む場合の記述

Command( Function( A,B,C),D,E)
Command Function( A,B,C),D,E
Command Function( A,B,C)D△E

演算子の左辺または右辺に，引数を伴うコマンドまたは関数を記述する場合は，引数を必ず括弧で囲まなくてはなりません。

（例）M=Command(A,B,C)＋Function(D)

スクリプトを実行させるスクリプトエンジンのバージョンを指定するときには，各スクリプトファイルの先頭に，#FileVersion=VVRR（VV：JP1/Scriptのバージョン，RR：JP1/Scriptのリビジョン）と記述しなければなりません。この記述がない場合，または存在しないバージョンが指定された場合は，マネージャウィンドウの［オプション（互換性情報）の設定］ダイアログで設定されたバージョンで，スクリプトファイルが実行されます。なお，新規にスクリプトファイルを作成するときには，先頭にスクリプトエンジンのバージョンを自動的に挿入するかどうかを，マネージャウィンドウの［新規作成］ダイアログで指定できます。

（例）#FileVersion = 0700

また，スクリプトエンジンのバージョンは，インストールされているJP1/Scriptのバージョンと同じである必要はありません。
指定したスクリプトエンジンのバージョンの文法規則を適用して，スクリプトファイルを実行できます。
例えば，JP1/Scriptのバージョンが06-00で"Callspt"をFunctionプロシージャ名として使用していた場合，06-71以降へバージョンアップしても#FileVersionが「0600」のままであれば，スクリプトファイルは変更しないで実行できます。#FileVersionを「0671」へ変更すると，実行結果が不正となります。

GoTo文やOn Error文などの制御の分岐先は，ラベル名の直後にコロン（：）を付加したものを指定しなければなりません。

（例）LabelName:

文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"をそれぞれ対応するコントロールコードに変換しない場合は，スクリプトファイルの先頭に，#Option = NOCHANGEと記述しなければなりません（ただし，#FileVersion = VVRRが指定されている場合はその下の行に記述しなければなりません）。この記述がない場合には文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"はそれぞれ対応するコントロールコードに変換されます。（"¥r"は復帰，"¥n"は改行と復帰，"¥t"はタブ，"¥¥"は一つの"¥"に変換）
なお，#Option = NOCHANGEの記述があっても，スクリプトエンジンの実行バージョンが0500以前のものであれば，無条件に文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"をそれぞれ対応するコントロールコードに変換します。

（例）

  #FileVersion = 0700
  #Option = NOCHANGE
  MessageBox( "C:¥¥WkDir¥¥Script.SPT" )

  [メッセージボックスに出力される文字列]
    C:¥¥WkDir¥¥Script.SPT

（例）

  #FileVersion = 0700
  MessageBox( "C:¥¥WkDir¥¥Script.SPT" )

  [メッセージボックスに出力される文字列]
    C:¥WkDir¥Script.SPT

次のコマンドの場合，文字列中に含まれる"&"文字は表示されないでその次の文字が下線付きで表示されます。文字列中に含まれる"&"文字をそのまま表示させる場合は，スクリプトファイルの先頭に，#Option = NOPREFIXと記述してください。#Option = NOCHANGEの記述がある場合は，#Option = NOCHANGE，NOPREFIXとコンマで区切って指定します。（指定は順不同です。ただし，#FileVersion = VVRRが指定されている場合はその下の行に記述してください。）

Messageコマンドでウィンドウ出力の場合のメッセージ

InputBoxコマンドでメッセージとテキストボックスのキャプション

なお，スクリプトエンジンの実行バージョンが0520より前のものである場合，#Option = NOPREFIXの記述があるときでも，文字列中に含まれる"&"文字は表示されないでその次の文字が下線付きで表示されます。"&"文字を表示する場合は"&&"のように記述してください。

（例）

  #FileVersion = 0700
  #Option = NOCHANGE,NOPREFIX
  Message( Target_DispOn,"Display","Client&Server" )

  [ウィンドウに出力される文字列]
    Client&Server

（例）

  #FileVersion = 0700
  Message( Target_DispOn,"Display","Client&Server" )

  [ウィンドウに出力される文字列]
    ClientServer

n個のダブルクォーテーション（"）を文字としてそのまま表す場合は，文字列中に（n＊2）個のダブルクォーテーションを指定します。

（例）

   MessageBox( "Error code:""99""" )

  [メッセージボックスに出力される文字列]
    Error  code:"99"

6.1.12　JP1/Scriptの終了コード

スクリプト実行の終了コードには，基本的にExitコマンド，またはExitWindowsコマンドで指定された値が返されます。これらのコマンド，またはこれらのコマンドの引数を省略した場合，終了コードには「0」が返されます。ただし，スクリプト実行がエラーになった場合，JP1/Scriptの終了コードが返されることもあります。

終了コードとしてレジストリに設定されている値を，表6-5に示します。なお，設定されているレジストリは次のとおりです。

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX¥ExitCode

表6-5　レジストリに設定されている終了コード

値名 | デフォルト値 | 意味
AlreadyRun | 16 | 指定されたスクリプトファイルは既に起動されています。
Terminate | 17 | JP1/Scriptのプロセスを強制終了しました。
TimeOut | 18 | 打ち切り時間を経過したためJP1/Scriptのプロセスを終了しました。
GrammarError | 19 | 文法エラーが発生しました。
ExAbortError | 20 | JP1/Scriptのプロセスを中断する実行エラーが発生しました。（メモリ不足，未定義の変数を参照しているエラー，プロシージャが見つからないエラー，ステートメントで発生するエラーなど）
Error | 99 | JP1/Scriptのプロセス開始前にエラーが発生しました。（指定されたスクリプトファイルが見つからないエラーなど）
| 21～32 | 将来の予備

注意

ExitコマンドやExitWindowsコマンドで終了コードを指定する場合は，JP1/Scriptの終了コードを重複しないように注意してください。

例えば，ExitコマンドやExitWindowsコマンドの終了コードに，「19」（表6-5のレジストリの値名「GrammarError」のデフォルト値）を指定した場合，スクリプトの実行が正常終了しても，イベントログに「スクリプトの実行を終了しました。文法エラーがありました。（スクリプトファイル名）」が出力されます。

6.1.13　JP1/Scriptのイベントログ

JP1/Scriptでは状況に応じてイベントログを出力します。また，ユーザ側でもMessageEventLogコマンドを使ってイベントログの出力を指定することができます。

出力されるイベントIDとイベントログ，および内容を，表6-6に示します。なお，出力されるソースは「JP1/Script」です。

表6-6　イベントIDとイベントログ

イベントID
種類
イベントログ
出力される内容※¹

1
情報
スクリプト実行開始時の情報ログ
スクリプトの実行を開始しました。（スクリプトファイル名）

2
情報
スクリプト実行終了時の情報ログ
スクリプトの実行を終了しました。（スクリプトファイル名）

3
※2
MessageEventLogコマンドを使ったユーザ指定のログ
MessageEventLogコマンドで指定されたメッセージ

4
情報
Scriptランチャ実行時情報ログ
ターミナルサービスのクライアントではScriptランチャは起動されません。

警告
JP1/Scriptサービス，Scriptランチャサービス，またはScriptランチャ実行時の警告ログ
警告メッセージ(エラーメッセージ)

エラー
JP1/Scriptサービス，Scriptランチャサービス，またはScriptランチャ実行時のエラーログ
JP1/Scriptのインストールに失敗している可能性があります。JP1/Scriptをインストールし直してください。

自動起動情報ファイルの内容が不正です。自動起動情報ファイルを再作成してください。（自動起動情報ファイル名）

既にScriptランチャサービスが起動されています。Scriptランチャは起動できません。

既にScriptランチャが起動されています。Scriptランチャサービスは起動できません。

Scriptランチャサービスの開始アカウントがローカルシステムアカウントではありません。Scriptランチャサービスは起動できません。

Scriptランチャサービスの開始パラメータにログオンユーザ名が指定されていません。Scriptランチャサービスは起動できません。

NetExecコマンド制限ポリシーファイルの内容に不正があるため，ScriptランチャサービスのNetExecスレッドを開始できませんでした。
NetExecコマンド制限ポリシーファイルを再作成してからScriptランチャサービスを再起動してください。
（ファイル名）

発生したエラーのエラーメッセージ

5
警告
ExitWindowsコマンド実行時の警告ログ
ExitWindows（コマンドで指定されたシャットダウン操作の種別）コマンドが発行されました。（スクリプトファイル名）

ExitWindowsコマンドの実行に失敗しました。（関数名，エラーコード）

6
警告
JP1/IM，またはJP1/Baseへのイベント発行失敗時の警告ログ
JP1/Integrated Managerの関数でエラーが発生しました。（JP1/IMまたはJP1/Baseの関数名::JP1/IMまたはJP1/Baseの関数のエラー状態コード）

7
情報
TerminateProcessコマンド実行時の情報ログ
TerminateProcess（Id=コマンドで指定されたプロセスID）コマンドが発行されました。（スクリプトファイル名）

8※³
情報
JP1/Scriptサービス，Scriptランチャサービス，およびScriptランチャの実行開始，および実行終了時の情報ログ
Scriptランチャを開始します。（日付　時刻　システム起動時からの経過時間）

Scriptランチャを終了します。（日付　時刻　システム起動時からの経過時間）

ScriptランチャのNetExecスレッドを開始します。（日付　時刻　システム起動時からの経過時間）

ScriptランチャのNetExecスレッドを終了します。（日付　時刻　システム起動時からの経過時間）

Script終了制御ランチャが実行されました。（日付　時刻　システム起動時からの経過時間）

JP1/Scriptサービスを開始します。（日付　時刻　システム起動時からの経過時間）

JP1/Scriptサービスを終了します。（日付　時刻　システム起動時からの経過時間）

JP1/ScriptサービスのNetExecスレッドを開始します。（日付　時刻　システム起動時からの経過時間）

JP1/ScriptサービスのNetExecスレッド（NetExecコマンド実行ユーザ制限付き）を開始します。（日付　時刻　システム起動時からの経過時間）

JP1/ScriptサービスのNetExecスレッドを終了します。（日付　時刻　システム起動時からの経過時間）

JP1/Scriptファイルマッピングオブジェクト制御スレッドを開始します。（日付　時刻　システム起動時からの経過時間）

JP1/Scriptファイルマッピングオブジェクト制御スレッドを終了します。（日付　時刻　システム起動時からの経過時間）

Scriptランチャサービスを開始します。
（日付　時刻　システム起動時からの経過時間）（実行アカウント名）

Scriptランチャサービスを終了します。
（日付　時刻　システム起動時からの経過時間）（実行アカウント名）

ScriptランチャサービスのNetExecスレッドを開始します。（日付　時刻　システム起動時からの経過時間）

ScriptランチャサービスのNetExecスレッド（NetExecコマンド実行ユーザ制限付き）を開始します。（日付　時刻　システム起動時からの経過時間）

ScriptランチャサービスのNetExecスレッドを終了します。（日付　時刻　システム起動時からの経過時間）

16
エラー
複数スクリプト起動時のエラーログ
指定されたスクリプトファイルは既に起動されています。（スクリプトファイル名）

17
警告
スクリプト強制終了時の警告ログ
JP1/Scriptのプロセスを強制終了しました。（スクリプトファイル名）

18
警告
打ち切り時間経過によるスクリプト終了時の警告ログ
打ち切り時間を経過したためJP1/Scriptのプロセスを終了しました。（スクリプトファイル名）

19
情報
文法エラーによるスクリプト終了時の情報ログ
スクリプトの実行を終了しました。文法エラーがありました。（スクリプトファイル名）

96
エラー
スクリプト実行開始時，JP1/Scriptサービスの状態が実行中以外だったときのエラーログ
JP1/Scriptサービスの状態が実行中以外のため，解析／実行トレースに実行結果が出力されません。またMessage/EntryStartUp/CancelStartUp/グローバル変数操作コマンドの実行がエラーになります。JP1/Scriptサービスを開始してから実行してください。（スクリプトファイル名）

98※4
エラー
解析トレース，および実行トレース未出力時（/SPALV(0)，または/SPXLV(0)指定時）のエラーログ
ユーザ名 ：スクリプト実行時のユーザ名
スクリプトファイル名：スクリプトファイル名
次のようなエラーがありました。
エラーの行位置 行目;発生したエラーのエラーメッセージ

99
エラー
スクリプト実行開始時のエラーログ
発生したエラーのエラーメッセージ

注※1

斜体になっている部分はログごとに内容が変わる埋め字を示しています。また日付はyyyy/mm/dd，時刻はhh:mm:ss.ss，システム起動時からの経過時間はミリ秒で表示します。

注※2

MessageEventLogコマンドで指定したイベントの種類です。

注※3

このイベントログの出力を抑止する場合は，次に示すレジストリキーの値を次のように設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script¥SPTF¥SPV

〔値名〕

CommandLine

〔値のデータタイプ〕

REG_SZ

〔値〕

/NOEVLOG(8)

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注※4

このエラーをイベントログに出力する場合は，次に示すレジストリキーの値を次のように設定してください。

〔レジストリキー〕

HKEY_CURRENT_USER¥SOFTWARE¥HITACHI¥JP1/Script¥SPTX

〔値名〕

ErrorEventLog

〔値のデータタイプ〕

REG_DWORD

〔値〕

1：イベントログに出力する

1以外：イベントログに出力しない

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

これらのイベントログのうち，ログの種類がエラー以外のイベントログは，出力を抑止することができます。出力抑止を指定する場合は，「6.2.2(4)　/NOEVLOG（または/noevlog）」を参照してください。

6.1.14　JP1/Scriptで発行するJP1イベント

JP1/Scriptで発行するJP1イベントを表6-7に示します。

表6-7　JP1/Scriptが発行するJP1イベント

イベントID | 重大度 | イベントの内容 | 発行契機 | 出力する情報（表6-8参照）
00003B00※ | 情報 | スクリプトの開始／終了イベント | スクリプト実行の開始時，および終了時 | C1～C5,C8,C9
00003B01 | エラー | メモリアクセスエラー | メモリアクセスエラー発生時 | C1～C5,C8
00003B03 | ユーザ指定値 | IMEventMessageコマンドによるイベント | IMEventMessageコマンド実行時 | C1～C9
00003B09※ | 情報 | コマンド正常終了時イベント | コマンドの正常終了時 | C1～C5,C8,C9
00003B10※ | エラー | コマンドエラー終了時イベント | コマンドの解析エラー終了時 | C1～C5,C8,C9
00003B11※ | エラー | コマンドエラー終了時イベント | コマンドの実行エラー終了時 | C1～C5,C8,C9

注※　マネージャの［ツール］－［オプション］で表示される［オプション］ダイアログの［JP1/IM］タブで表示をする指定を行った場合に，発行されます。

表6-8　出力する情報

記号 | 出力する情報
C1 | 重大度
C2 | ユーザ名
C3 | PP名
C4 | 登録タイプ名
C5 | 登録名
C6 | 事象種別
C7 | 開始時刻
C8 | 終了時刻
C9 | 終了コード

6.2　コマンドラインに関する規則

ここでは，スクリプトファイルを実行するときの，コマンドラインの指定方法について説明します。

［実行環境（起動情報）の設定］ダイアログボックスのコマンドラインの指定は，次の場合に必要です。

スクリプトファイルの実行にパラメタが必要な場合

解析トレースファイルの出力の有無（デフォルトは出力する）を指定する場合

実行トレースファイルの出力の有無（デフォルトは出力する），および出力レベルを指定する場合

イベントログの出力抑止（デフォルトは出力する）を指定する場合

＜この節の構成＞

6.2.1　コマンドラインの形式

6.2.2　コマンドラインのパラメタの説明

6.2.3　コマンドラインの記述規則

6.2.4　注意事項

6.2.1　コマンドラインの形式

コマンドラインの形式は次の3通りがあります。

＜この項の構成＞

(1)　スクリプトファイルの［実行環境の設定］ダイアログボックスでコマンドラインを指定する場合

(2)　ExecコマンドやNetExecコマンドからパラメタを指定してスクリプトファイルを呼び出す場合

(3)　ユーザプログラムなどから実行形式（SPTXE.EXE）でコマンドラインを指定してスクリプトファイルを実行する場合

(1)　スクリプトファイルの［実行環境の設定］ダイアログボックスでコマンドラインを指定する場合

[パラメタ…]　[/SPALV(n)]　[/SPXLV(n)]　[/NOEVLOG[(n[,n]…)]]

この場合，スクリプトファイルは先に選択されているので，コマンドラインでスクリプトファイル名を指定する必要はありません。

コマンドラインに指定したパラメタは位置変数に格納されます。

なお，位置変数については「付録G　用語解説」を参照してください。

(2)　ExecコマンドやNetExecコマンドからパラメタを指定してスクリプトファイルを呼び出す場合

Exec　(スクリプトファイル名,終了待ちの有無[,"パラメタ"…][,"/SPALV(n)"][,"/SPXLV(n)"][,"/NOEVLOG[(n[,n]…)]"])

コマンドラインに指定したパラメタは位置変数に格納されます。

なお，位置変数については「付録G　用語解説」を参照してください。

(3)　ユーザプログラムなどから実行形式（SPTXE.EXE）でコマンドラインを指定してスクリプトファイルを実行する場合

SPTXE.EXE　スクリプトファイル名　[パラメタ…]　[/SPALV(n)]　[/SPXLV(n)]　[/NOEVLOG[(n[,n]…)]]

コマンドラインに指定したパラメタは位置変数に格納されます。

なお，位置変数については「付録G　用語解説」を参照してください。

6.2.2　コマンドラインのパラメタの説明

＜この項の構成＞

(1)　パラメタ

(2)　/SPALV（n）（または/spalv（n））

(3)　/SPXLV（n）（または/spxlv（n））

(4)　/NOEVLOG（または/noevlog）

(1)　パラメタ

コマンドラインに指定したパラメタは，スクリプトファイルで扱う位置変数%n（nは正の整数）に格納されます。

%0はスクリプトファイル名（フルパス），%1は第1パラメタ（%nは第nパラメタ）となります。

複数のパラメタを指定する場合は，コマンドラインの記述規則に従ってください。コマンドラインの記述規則については，「6.2.3　コマンドラインの記述規則」を参照してください。

以下の例で使用しているフォルダ名のProgram　Filesは間に空白を含んでいます。

（例1）

スクリプトファイルの［実行環境の設定］ダイアログボックスでコマンドラインを指定する場合

〔ダイアログのコマンドラインの指定形式〕

ABC　123　"C:¥Program　Files¥"

〔各位置変数に設定される値〕

%0：スクリプトファイル名
%1：ABC
%2：123
%3：C:¥Program　Files¥

（例2）

ExecコマンドやNetExecコマンドからパラメタを指定してスクリプトファイルを呼び出す場合

〔コマンドラインの指定形式〕

Exec　("C:¥Temp¥Test.SPT",True,"ABC","123","""C:¥Program　Files¥""")

〔各位置変数に設定される値〕

%0：C:¥Temp¥Test.SPT
%1：ABC
%2：123
%3：C:¥Program　Files¥

（例3）

ユーザプログラムなどから実行形式（SPTXE.EXE）でコマンドラインを指定してスクリプトファイルを実行する場合

〔ユーザプログラムの指定形式〕

SPTXE.EXE　C:¥Temp¥Test.SPT　ABC　123　"C:¥Program　Files¥"

〔各位置変数に設定される値〕

%0：C:¥Temp¥Test.SPT
%1：ABC
%2：123
%3：C:¥Program　Files¥

(2)　/SPALV（n）（または/spalv（n））

解析トレースファイルの出力の有無を指定します。このパラメタの指定を省略すると，解析トレースファイルが出力されます。nには0以上の整数を入力します。デフォルトは0以外です。

nの値が0の場合：解析トレースファイルを出力しない。

nの値が0以外の場合：解析トレースファイルを出力する。

（例）

解析トレースファイルの出力を抑止したい場合

SPTXE.EXE　 C:¥Temp¥Test.SPT　 ABC　 123　 "C:¥Program　Files¥"　 /SPALV(0)

(3)　/SPXLV（n）（または/spxlv（n））

実行トレースファイルの出力の有無，および出力レベルを指定します。このパラメタの指定を省略すると，実行トレースファイルにエラー時の結果だけが出力されます。nには0から3の整数を入力します。デフォルトは1です。2，または3を指定した場合は，出力する情報量が多くなるため，スクリプトファイルの実行性能が劣化します。

nの値が0の場合：実行トレースファイルが出力されない。

nの値が1の場合：実行トレースファイルにエラー時の結果だけが出力される。

nの値が2の場合：実行トレースファイルに正常時の結果も出力される。

nの値が3の場合：実行トレースファイルに，コマンド開始時刻と終了時刻も出力される。

（例）

実行トレースファイルに，コマンド開始時刻と終了時刻も出力させる場合

SPTXE.EXE　 C:¥Temp¥Test.SPT　 ABC　 123　 "C:¥Program　Files¥"　 /SPXLV(3)

(4)　/NOEVLOG（または/noevlog）

イベントログを出力させたくない場合に指定します。このパラメタの指定を省略すると，すべてのイベントログが出力されます。イベントログの種類については，「6.1.13　JP1/Scriptのイベントログ」を参照してください。

このパラメタの指定を省略すると，すべてのイベントログが出力されます。

/NOEVLOGまたは/noevlog

ログの種類がエラーの場合にだけログを出力する。

/NOEVLOG(n,n,…)または/noevlog(n,n,…)

nで指定したイベントIDのログは出力しない。nには複数のイベントIDを順不同で指定できる。複数のイベントIDをコンマで区切って指定する。

（例）

イベントIDが3（MessageEventLogコマンドを使ったユーザ指定）のログの出力を抑止したい場合

SPTXE.EXE　 C:¥Temp¥Test.SPT　 ABC　 123　 "C:¥Program　Files¥"　 /NOEVLOG(3)

6.2.3　コマンドラインの記述規則

コマンドラインを記述するときの規則を，次に説明します。

複数のパラメタを指定する場合は，空白で区切ってください。

区切りではない空白を含むパラメタを指定する場合は，パラメタ全体をダブルクォーテーション（"）で囲んでください。

コマンドラインに指定できるパラメタは254個までです。それ以降の指定は無視されます。

パラメタに指定できる文字数は半角文字で1,024文字以内です。それ以降の文字は無視されます。

なお，1個目と2個目の規則はExecコマンドやNetExecコマンドからスクリプトファイル以外の実行ファイルを呼び出すときにも該当します。

6.2.4　注意事項

コマンドラインを指定するときの注意事項について，次に示します。

指定したコマンドラインの値はスクリプトファイル単位で有効ですが，実行コンピュータのすべてのスクリプトファイルに対して有効にしたい場合は，次のレジストリにコマンドラインの値を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥SPTF¥SPV

〔値名〕

CommandLine

〔値のデータタイプ〕

REG_SZ

〔値〕

コマンドラインの値

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

ダイアログとレジストリの両方にコマンドラインを指定している場合は，両方の指定が有効になります。ただし，ダイアログに"/SPXLV(3)"，レジストリに"/SPXLV(0)"のように，同じパラメタに異なる指定をしている場合はダイアログの指定が優先されます。

JP1/Scriptサービス，Scriptランチャ，およびScriptランチャサービスのイベントログの出力を抑止する場合は，実行環境ファイルのコマンドラインではなく，上記レジストリに/NOEVLOG，または/NOEVLOG(4)を指定してください。

実行環境の設定（起動情報）ダイアログ，または実行環境（コマンドライン）の設定ダイアログのコマンドラインに/NOEVLOG，または/NOEVLOG(n，n，…)が指定された場合，/SPALV(n)や/SPXLV(n)と異なり位置変数として扱われます。位置変数として扱わない場合は，次のレジストリの値に1を設定してください。
なお，ユーザプログラムなどから実行形式（SPTXE.EXE）でスクリプトファイルを実行する場合のコマンドライン，またはレジストリのCommandLineのNOEVLOG，または/NOEVLOG(n，n，…)は，次のレジストリ値に関係なく，位置変数として扱われません。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥SPTX

〔値名〕

NoEvLog_Opt

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：/NOEVLOG，または/NOEVLOG(n,n,…)を位置変数として扱う（初期値）

1：/NOEVLOG，または/NOEVLOG(n,n,…)を位置変数として扱わない

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

n個のダブルクォーテーション（"）を文字としてそのままパラメタに含める場合は，（n*2）個のダブルクォーテーション（"）を指定して，パラメタ全体をダブルクォーテーション（"）で囲みます。
このとき，次のレジストリに1を設定してください。※
なお，NetExecコマンドを使用する場合，呼び出すコンピュータ上のレジストリにも1を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥SPTX

〔値名〕

DQString_Opt

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）を指定し，パラメタ全体をダブルクォーテーション（"）で囲む指定が無効になる（初期値）

1：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）を指定し，パラメタ全体をダブルクォーテーション（"）で囲む指定が有効になる

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

上記のレジストリに1以外を設定した場合，スクリプトファイルの実行形式によって，指定するダブルクォーテーション（"）の数が異なります。

ユーザプログラムなどから実行形式（SPTXE.EXE）でコマンドラインを指定してスクリプトファイルを実行する場合
（n*4）個のダブルクォーテーション（"）とパラメタ全体を囲むダブルクォーテーション（"）で指定します。
　（例）パラメタ文字列にa"bを指定する
　　SPTXE.EXE　SPT.spt　"a""""b"

Execコマンドからパラメタを指定してスクリプトファイルを呼び出す場合
（（（n*4）*2） + 2）個のダブルクォーテーション（"）とパラメタ全体を囲むダブルクォーテーション（"）で指定します。
　（例）パラメタ文字列にa"bを指定する
　　Exec(_SCF_+"ABC.SPT", True ,"a""""""""""b")

NetExecコマンドからパラメタを指定してスクリプトファイルを呼び出す場合
（（（（n*4）*2）*2）*2）個のダブルクォーテーション（"）とパラメタ全体を囲む15個のダブルクォーテーション（"）で指定します。
　（例）パラメタ文字列にa"bを指定する
　　NetExec ( comp1,_TEMP_+"NETWORK.SPT" ,True , ,False , _
　　, """""""""""""""a""""""""""""""""""""""""""""""""b""""""""""""""")

注※

このレジストリを設定しない場合，指定方法が複雑になりますので，新規のシステム開発時などは，この設定をすることをお勧めします。

コマンドラインのパラメタの指定が，スクリプト起動時とスクリプトの実行環境ファイルの両方にある場合，両方の指定が有効になります。この場合，スクリプト起動時のコマンドラインのパラメタが先，実行環境ファイルのコマンドラインのパラメタが後になります。

7.　ステートメント

この章では，スクリプトを作成するときに使用できるステートメントについて説明します。

＜この章の構成＞

7.1　ステートメント一覧

7.1　ステートメント一覧

スクリプトを作成するときに使用できる，ステートメントの一覧を表7-1に示します。なお，ステートメントの後ろに続く括弧内の数字は，対象バージョンを表します（括弧がないものは，01-00からサポートしています）。

表7-1　ステートメント一覧

ステートメント | 意味
= | 右辺の値を左辺の変数に代入します。
Do...Loop（05-10以降） | 指定した条件が真（True）である間，または条件が真（True）になるまで，一連のステートメントを繰り返します。
For...Next | 指定した回数だけ，一連のステートメントを繰り返します。
For...End For | 指定したフォルダ内のすべてのファイルに対して，一連のステートメントを繰り返します。
If..Then..Else | 式の値に基づいて，条件付きの実行をします。
Select Case | 条件式の値に従って，複数のステートメントブロックのどれかを実行します。
While...End | 指定した条件が真（True）である間，一連のステートメントの実行を繰り返します。
Function | Functionプロシージャの名前，引数を宣言し，Functionプロシージャの始まりを示します。FunctionステートメントとEnd Functionステートメントで囲まれた一連のステートメントをFunctionプロシージャとして定義します。
Sub | Subプロシージャの名前，引数を宣言し，Subプロシージャの始まりを示します。SubステートメントとEnd Subステートメントで囲まれた一連のステートメントをSubプロシージャとして定義します。
Call | Subプロシージャ，およびFunctionプロシージャに制御を渡します。
Exit xx | While...Endループ，For...Nextループ，For...End Forループ，Do...Loopループ，Functionプロシージャ，またはSubプロシージャから抜け出します。
Goto（05-00以降） | 指定したラベルに処理を分岐させます。
Continue（05-00以降） | While...Endループ，For...Nextループ，For...End Forループ，Do...Loopループの先頭に戻ります。
On Error（05-00以降） | エラー発生時に，指定したラベルに制御を移すステートメントです。なお，エラーが発生しても指定したラベルに制御を移動しないようにすることもできます。

＜この節の構成＞

7.1.1　=

7.1.2　Do...Loop

7.1.3　For...Next

7.1.4　For...End For

7.1.5　If...Then...Else

7.1.6　Select Case

7.1.7　While...End

7.1.8　Function

7.1.9　Sub

7.1.10　Call

7.1.11　Exit xx

7.1.12　GoTo

7.1.13　Continue

7.1.14　On Error

7.1.1　=

機能

右辺の値を左辺の変数に代入します。

形式

Result = Expression

指定項目

Result

値を受け取る変数名を指定します。

Expression

任意の式を指定します。

説明

式Expressionの値を変数Resultに代入します。

式Expressionの値がEmpty値のときは，変数ResultにはEmpty値が代入されます。Dimコマンドで宣言していない変数に値を代入した場合は，自動的に変数を割り当てて値を代入します。

例

' 変数result1には"ABCDE"が格納される。
result1 = "ABCDE"

' 変数result2には200が格納される。
result2 = 50 + 150

' 変数result3には現在の日付が格納される。
result3 = Date

対象バージョン

JP1/Script 01-00以降

7.1.2　Do...Loop

機能

指定した条件が真（True）である間，または条件が真（True）になるまで，一連のステートメントを繰り返し実行するフロー制御ステートメントです。

形式

Do
〔Statements〕
〔Exit Do〕
〔Statements〕
Loop〔｛While | Until｝ Condition〕

指定項目

Statements

Conditoinが真（True）である間，またはConditoinが真（True）になるまで繰り返し実行される一つ，または複数のステートメントを指定します。複数のステートメントを記述する場合は，ステートメントごとに改行します。

Condition

真（True），または偽（False）を評価する条件式を指定します。

説明

キーワードWhileが記述されている間はConditionが真（True）である間，一連のステートメントが繰り返し実行され，キーワードUntilが記述されている場合はConditionが真（True）になるまで，一連のステートメントが繰り返し実行されます。

Exit Doステートメントは，制御構造Do ...Loop内だけで使われ，Conditionで指定した以外の条件でDo ...Loopを終了させることができます。Exit Doステートメントは，Do ...Loop内の任意の場所に何回でも指定できます。Exit Doは条件の評価（例えばIf...Thenステートメントなど）とともに使われることが多く，Loopステートメントの直後のステートメントに制御を渡します。

Do ...Loopステートメントはネスト（入れ子）構造にできます。つまり，Do ...Loopの内部に別のDo ...Loopを記述できます。ネスト構造の場合にExit Doが実行されると，そのExit Doを囲んでいる最も内側のループから抜け出します。

Do ...Loopステートメントは後判定の制御構造で，While...Endステートメントとは異なり，一連のステートメントが必ず一度は実行されます。一連のステートメントが実行される前に条件の判定を行いたい場合は， While...Endステートメントを使用してください。

例

' Reverseは文字列を反転した値を返す。
' resultには"EDCBA"が格納される。
result = Reverse ( "ABCDE" )
MessageBox ( result )

Function  Reverse ( chrValue )
 Dim  chrString ,chrLength
 cnt = 0
 chrLength = Len ( chrValue )
 Do
     chrString = chrString + Mid ( chrValue ,chrLength - cnt , 1 )
     cnt = cnt + 1
 Loop While ( cnt < chrLength )
 Reverse = chrString
End Function

対象バージョン

JP1/Script 05-10以降

7.1.3　For...Next

機能

指定した回数だけ，一連のステートメントを繰り返すフロー制御ステートメントです。

形式

For  Counter = Start  To  End  〔Step Step〕
 〔Statements〕
 〔Exit For〕
 〔Statements〕
Next

指定項目

Counter

ループカウンタに使う数値を格納する変数を指定します。変数の名前付け規則に従って名前を付けます。この変数には，配列変数や配列変数の一要素は指定できません。

Start

Counterの初期値を指定します。

End

Counterの最終値を指定します。

Step

ループを繰り返すごとにCounterに加算される値を指定します。Stepを省略すると，ループを繰り返すごとにCounterに1が加算されます。Counterには正の数，または負の数を指定できます。Stepで指定した値によりループの実行は次のように制御されます。

値 | 実行条件
正の数または0 | Counter ≦ End
負の数 | Counter ≧ End

Statements

ループ内で実行される一連のステートメントを指定します。ForとNextの間にこれらのステートメントを記述します。ここに記述したステートメントは，For...Nextで指定した回数だけ実行されます。Statementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

説明

プログラムの実行がループに移り，ループ内の一連のステートメントがすべて実行されると，Stepの値がCounterに加算されます。この時点でループの実行条件が成立している場合は，ループ内のステートメントが再び実行されます。ループの実行条件が不成立の場合は，ループから抜け出してNextステートメントの次のステートメントに制御が移ります。

Exit Forステートメントは，制御構造For...NextとFor...End Forループ内だけで使用できます。Exit Forステートメントを使用すると，指定した回数以外の条件でFor...Nextループを終了させることができます。Exit Forステートメントは，For...Nextループ内の任意の位置で何回でも指定できます。Exit Forステートメントは，条件の評価（例えば If...Thenステートメントなど）とともに使われることが多く，Nextの直後のステートメントに制御を渡します。

For...Nextループはネスト（入れ子）構造にすることができます。つまり，For...Nextループの内部に別のFor...Nextループを入れることができます。ループをネスト（入れ子）させる場合は，それぞれのCounterに別の変数名を指定してください。

例

For  I = 1  To  10
   For  J = 1  To  10
     For  K = 1  To  10
       :
     Next
   Next
Next

対象バージョン

JP1/Script 01-00以降

7.1.4　For...End For

機能

指定したフォルダ内のすべてのファイルに対して，一連のステートメントを繰り返すフロー制御ステートメントです。

形式

For  VarName = Filemask  Do
 〔Statements〕
 〔Exit For〕
 〔Statements〕
End〔For〕

指定項目

VarName

ファイル名を格納する変数名を指定します。変数の名前付け規則に従って名前を付けます。配列変数や配列変数の一要素は指定できません。

Filemask

検索対象のファイル名をフルパスで指定します。ファイル名にはワイルドカードを含めることもできます。フルパス名は，ダブルクォーテーションで囲んでください。

Statements

ループ内で実行される一連のステートメントを指定します。ForとEnd Forの間にこれらのステートメントを記述します。ここに記述したステートメントは，For...End Forで指定したパスに該当するファイルが見付からなくなるまで繰り返されます。

Statementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

説明

指定したフォルダ内のすべてのファイルに対して，一連のステートメントを繰り返します。指定したパスに該当するファイルが見付からなくなった時， End Forステートメントの次のステートメントに制御が移ります。

Exit Forステートメントは，制御構造For...End ForとFor...Nextループ内だけで使用できます。Exit Forステートメントを使用すると，直ちにFor...End Forループを終了させることができます。Exit Forステートメントは，For...End Forループ内の任意の位置で何回でも指定できます。

For...End Forループはネスト（入れ子）構造にすることができます。つまり，For...End Forループの内部に別のFor...End Forループを入れることができます。ループをネスト（入れ子）させる場合は，それぞれのVarNameに別の変数名を指定してください。

Filemaskに "*.*"を指定した場合，VarNameには "."，".." 以外のファイル名が格納されます。

補足

For…End Forループのファイルの検索は，システムが互換性のために保存しているMS-DOSファイル形式に変換した短いファイル名も対象になります。

For…End Forループのファイル検索順序は保証していません。

例

' 実行フォルダ下のスクリプトファイルを別フォルダにバックアップする。
Dim  path1 ,bkupDir
bkupDir = _BIN_+"BKUP¥"
MakeDir ( bkupDir )

' スクリプトファイルを検索
For  path1 = _BIN_+"*.SPT"  Do
 ' フォルダは無視
 If  IsExistDir ( _BIN_+path1 ) = False  Then
   ' 別フォルダにバックアップ
   Copy ( _BIN_+path1 ,bkupDir+path1 )
 End If
End For

対象バージョン

JP1/Script 01-00以降

7.1.5　If...Then...Else

機能

式の値に基づいて，条件付きの実行を行うフロー制御ステートメントです。

形式1

If  Condition  Then
  〔Statements〕
〔Else
  〔ElseStatements〕〕
End〔If〕

形式2

If  Condition  Then
 〔Statements〕
〔ElseIf  Condition-n  Then
 〔ElseifStatements〕〕...
〔Else
 〔ElseStatements〕〕
End〔If〕

指定項目

Condition

真（True）か偽（False）を評価する条件式。

Statements

Conditionが真（True）の場合，実行される文です。

Statementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

Condition-n

引数Conditionに同じ。

ElseifStatements

Condition-nが真（True）の場合に実行される一連のステートメントを指定します。

ElseifStatementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

ElseStatements

Else以前に定義されている条件（ConditionまたはCondition-n）がどれも真（True）でない場合に実行される一連のステートメントを指定します。

ElseStatementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

説明

最初にConditionが評価されます。Conditionが真（True）の場合，Thenに続くステートメントが実行されます。Conditionが偽（False）の場合，「形式1」ではElse節がある場合 Else節が実行されます。「形式2」ではElseIfで指定した条件（Condition-n）が評価されます。どちらかの条件が真（True）の場合，対応するThenに続くステートメントが実行されます。ElseIfで指定された条件式がどちらも偽（False）の場合（または，ElseIf 節がないとき）は，Elseに続くステートメントが実行されます。Then，またはElseに続くステートメントの実行が終わると，Endの次のステートメントからプログラムの実行が続けられます。

Else節とElseIf節はどちらも必要に応じて定義します。また，「形式2」のIfでは，ElseIf節は幾つでも指定できます。ただし，Else節の後ろにElseIf節を指定することはできません。また，Ifはネスト（入れ子）構造にすることができます。

対象バージョン

JP1/Script 01-00以降

7.1.6　Select Case

機能

条件式の値に従って，複数のステートメントブロックのどれかを実行させるフロー制御ステートメントです。

形式

Select Case  TestExpression
〔Case  ExpressionList-n
 〔Statements-n〕〕...
〔Case Else
 〔ElseStatements〕〕
End〔Select〕

指定項目

TestExpression

任意の条件式を指定します。

ExpressionList-n

Case節を記述する場合は必ず指定します。一つ，または複数の式をコンマ（ ， ）で区切って指定します。

Statements-n

TestExpressionがExpressionList-nのどれかと一致するとき，一致したStatements-nのステートメントが実行されます。Statements-nには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

ElseStatements

TestExpressionがどのCase節とも一致しないとき，ElseStatementsのステートメントが実行されます。ElseStatementsには複数の文を記述できます。複数の文を記述する場合は，文ごとに改行します。

説明

TestExpressionがCase節のどちらかの式ExpressionListに一致すると，次のCase節，またはEnd SelectステートメントまでのStatementsが実行されます。ブロックの実行が終わると，制御はEnd Selectステートメントの次のステートメントに移ります。TestExpressionが複数のCase節に一致するときは，最初に一致したCase節に続くステートメントだけが実行されます。

Case Else節は，TestExpressionがどのCase節のExpressionListにも一致しなかったときに実行するステートメントElseStatementsを指定します。Case Elseステートメントは必ずしも必要ではありませんが，予測できないTestExpressionの値を処理するために，Select CaseブロックにCase Elseステートメントを記述することを推奨します。Case節の式ExpressionListがTestExpressionと一致しない場合でCase Elseステートメントが指定されていないときは，End Selectステートメントの次のステートメントから実行が続けられます。

Select Caseステートメントは，ネスト（入れ子）構造にすることができます。このとき，各Select Caseステートメントには，それぞれ対応するEnd Selectステートメントが必要です。

例

' 引数Resultを判定しメッセージを組み立て，"Result.txt"に出力する。
Sub LogOutput ( Result )
 Dim MessageText
 Select Case Result
 Case "OK"
   MessageText = " 正常終了しました。 " & "Status=[" & Result & "]"
 Case "NG"
   MessageText = " 異常終了しました。 " & "Status=[" & Result & "]"
 Case Else
   MessageText = " 予期せぬエラーが発生しました。 " & _
                   "Status=[" & Result & "]"
 End Select
 Message ( Target_File ,_SCF_+"Result.txt" ,MessageText _
         ,128 ,1024 )
End Sub

対象バージョン

JP1/Script 01-00以降

7.1.7　While...End

機能

指定した条件が真（True）である間，一連のステートメントの実行を繰り返すフロー制御ステートメントです。

形式

While  Condition
 〔Statements〕
 〔Exit While〕
End〔While〕

指定項目

Condition

真（True），または偽（False）を評価する条件式を指定します。

Statements

Conditionが真（True）の間に実行する一つ，または複数のステートメントを指定します。複数のステートメントを記述する場合は，ステートメントごとに改行します。

説明

Conditionが真（True）の場合は，Endステートメントに達するまで，Statements内のすべてのステートメントが実行されます。実行がEndステートメントに達すると，制御は再びWhileステートメントに戻り，Condition が評価されます。Conditionが真（True）の間，この処理が繰り返されます。真（True）でない場合は，Endステートメントの次のステートメントに制御が移ります。

Exit Whileステートメントは，制御構造While...Endループ内だけで使用できます。Exit Whileステートメントを使用すると，指定した以外の条件でWhile...Endループを終了させることができます。Exit Whileステートメントは，While...Endループ内の任意の位置で何回でも指定できます。

While...Endループは，任意のレベルでネスト（入れ子）構造にすることができます。Endステートメントは最後に実行された Whileステートメントに対応します。

例

' 二次元の配列変数の全要素の中から指定のデータを検索する。
Dim array1( , )
Dim line
:
(配列変数array1への値格納処理)
:
line = 0
allCnt = GetArrayCount ( array1 )
While  line < allCnt
   buff = InArray ( array1( line + 1 ) ,"1999" ,1 ,False )
   If 0 < buff Then
       Exit While
   End If
   line = line + 1
End while

対象バージョン

JP1/Script 01-00以降

7.1.8　Function

機能

Functionプロシージャの名前，引数を宣言し，Functionプロシージャの始まりを示します。FunctionステートメントとEnd Functionステートメントで囲まれた一連のステートメントをFunctionプロシージャとして定義します。

形式

Function  Name〔(ArgList)〕
 〔Statements〕
 〔Name = Expression〕
 〔Exit Function〕
 〔Statements〕
 〔Name = Expression〕
End〔Function〕

指定項目

Name

定義するFunctionプロシージャの名前を指定します。変数の名前付け規則に従って名前を付けます。

ArgList

Functionプロシージャを呼び出すときに，Functionプロシージャに渡す引数を表す変数のリストを指定します。複数の変数を指定する場合はコンマ（ ， ）で区切ります。引数がある場合には，引数を必ずカッコで囲んでください。

Statements

Functionプロシージャ内で実行される一連のステートメントを指定します。

Expression

Functionプロシージャの戻り値を指定します。

説明

Functionプロシージャはパブリックプロシージャなので，スクリプト内の他のすべてのプロシージャからも参照できます。

実行可能なコードはすべてプロシージャ内に記述する必要があります。 また，Function プロシージャを他のFunctionプロシージャ，またはSubプロシージャの中で定義することはできません。

Exit Functionステートメントは，Functionプロシージャを直ちに終了します。プログラムの実行は，そのFunctionプロシージャを呼び出したステートメントの次のステートメントから継続されます。Exit Functionステートメントは，Functionプロシージャ内の任意の位置で何回でも指定できます。

Functionプロシージャの呼び出し方法については，Callステートメントを参照してください。

Functionプロシージャから値を返すには，値をFunctionプロシージャ名Nameに代入してください。Nameへの代入は，Functionプロシージャ内の任意の場所で必要に応じて何回でも行うことができます。Nameに値を代入しない場合は，既定の戻り値が返されます。既定の戻り値は，長さ0の文字列（""）です。

Functionプロシージャで使う変数には，Functionプロシージャ内で明示的に宣言される変数と，それ以外の変数の2種類があります。プロシージャ内でDimコマンドなどを使用して明示的に宣言された変数は，そのプロシージャの中だけで有効なローカル変数になります。プロシージャ内で明示的に宣言しないで使われている変数も，そのプロシージャの外部のさらに上のレベルで明示的に宣言されていないかぎりは，ローカル変数となります。Functionプロシージャ内のローカル変数の値は，プロシージャの実行が終了すると破棄されます。

プロシージャ内で明示的に宣言していない変数をプロシージャ内で使うことはできますが，その変数と同じ名前の変数などがスクリプトレベルで定義されている場合，その変数はグローバルな変数として扱われます。

例

' 入力データを比較し，昇順に表示します。
Dim compnum1,compnum2
InputBox ( "比較する数値を入力してください。","データ入力", _
       100, 100, compnum1, "数値1" ,compnum2, "数値2" )

If NumberCompare( compnum1 , compnum2) <> True Then
  lower = compnum2
  upper = compnum1
Else
  lower = compnum1
  upper = compnum2
End If
Messagebox( "lower=[" & lower & "] , upper=[" & upper & "]" )

Function NumberCompare(p1, p2)
  NumberCompare =True
  Dim lower,upper
  lower = p1
  upper = p2
  If lower > upper Then
      NumberCompare = False
      Exit Function
  End If
End Function

対象バージョン

JP1/Script 01-00以降

7.1.9　Sub

機能

Subプロシージャの名前，引数を宣言し，Subプロシージャの始まりを示します。SubステートメントとEnd Subステートメントで囲まれた一連のステートメントをSubプロシージャとして定義します。

形式

Sub  Name〔(ArgList)〕
 〔Statements〕
 〔Exit Sub〕
 〔Statements〕
End〔Sub〕

指定項目

Name

定義するSubプロシージャの名前を指定します。変数の名前付け規則に従って名前を付けます。

ArgList

Subプロシージャを呼び出すときに，Subプロシージャに渡す引数を表す変数のリストを指定します。複数の変数を指定するときは，コンマ（ ， ）で区切ります。引数がある場合には，引数を必ずカッコで囲んでください。

Statements

Subプロシージャ内で実行される，一連のステートメントを指定します。

説明

Subプロシージャはパブリックプロシージャなので，スクリプト内の他のすべてのプロシージャからも参照できます。

実行可能なコードはすべてプロシージャ内に記述する必要があります。また，Subプロシージャを他のSubプロシージャ，Functionプロシージャの中で定義することはできません。

Exit Subステートメントは，Subプロシージャを直ちに終了します。プログラムの実行は，そのSubプロシージャを呼び出したステートメントの次のステートメントから継続されます。Exit Subステートメントは，Subプロシージャ内の任意の場所に必要に応じて幾つでも指定できます。

Subプロシージャは値を返さないため，Subプロシージャ名を式，ステートメント，およびコマンドの中に記述できません。

Subプロシージャを呼び出すには，プロシージャ名の後ろに引数リストを付けて指定します。Subプロシージャの呼び出し方法については，Callステートメントを参照してください。

Subプロシージャで使う変数には，Subプロシージャ内で明示的に宣言される変数と，それ以外の変数の 2 種類があります。プロシージャ内でDimコマンドなどを使用して明示的に宣言された変数は，そのプロシージャの中だけで有効なローカル変数になります。プロシージャ内で明示的に宣言しないで使われている変数も，そのプロシージャの外部のさらに上のレベルで明示的に宣言されていないかぎりは，ローカル変数となります。Subプロシージャ内のローカル変数の値は，プロシージャの実行が終了すると破棄されます。

プロシージャ内で明示的に宣言されていない変数をプロシージャ内で使うことはできますが，その変数と同じ名前の変数などがスクリプトレベルで定義されている場合，その変数はグローバルな変数として扱われます。

例

' メッセージダイアログを表示する
' SubプロシージャOperateMessageをCALLする。
Dim Task
Task = "file update"

Call OperateMessage("Start")
          :
Call OperateMessage("Stop")

Sub OperateMessage(status)
   Dim stamp
   stamp = Date + " " + Time
   MessageBox( "［" & status & "］" & Task & " at " & stamp)
End Sub

対象バージョン

JP1/Script 01-00以降

7.1.10　Call

機能

Subプロシージャ，およびFunctionプロシージャに制御を渡すフロー制御ステートメントです。

形式

〔Call〕Name〔(ArgumentList)〕

指定項目

Call

省略可能なキーワードです。

Name

呼び出すプロシージャの名前を指定します。

ArgumentList

プロシージャに引き渡す変数リスト，または式のどちらかを指定します。ArgumentListを複数指定するときは，コンマ（，）で区切ります。

説明

プロシージャを呼び出すとき，キーワードCallは省略できます。引数を必要とするプロシージャを呼び出す場合は，ArgumentListをカッコで囲んでも囲まなくてもかまいません。ただし，プロシージャを他のプロシージャやコマンドの引数として呼び出したり，式の途中で呼び出したりする場合には，引数を必ずカッコで囲んでください。キーワードCallを省略しないでプロシージャを呼び出す場合，呼び出したプロシージャの戻り値を取得できません。プロシージャの戻り値を取得する場合は，キーワードCallを省略してプロシージャを呼び出してください。

FunctionプロシージャとSubプロシージャで同じ名前が定義されている場合，Functionプロシージャを優先して呼び出します。

例

Call  MyProc ( 0 )  または  MyProc 0

対象バージョン

JP1/Script 01-00以降

7.1.11　Exit xx

機能

While...Endループ，For...Nextループ，For...End Forループ，Do...Loopループ，Functionプロシージャ，またはSubプロシージャから抜け出すためのフロー制御ステートメントです。

形式

Exit While

Exit For

Exit Do

Exit Function

Exit Sub

説明

各Exitステートメントの機能は次のとおりです。

Exit While

While...Endループを抜け出し，Endステートメントの次のステートメントに制御を移します。While...Endステートメントの中だけで使用できます。While...Endステートメントがネスト（入れ子）構造になっている場合は，Exit Whileのあるループの一つ外側のループに制御を移します。

Exit For

For...Nextループを抜け出し，Nextステートメントの次のステートメントに制御を移します。For...NextとFor...End Forループの中だけで使用できます。For...Next，またはFor...End Forループがネスト（入れ子）構造になっている場合は，Exit Forステートメントが含まれているループの一つ外側のループに制御を移します。

Exit Do （05-10以降）

Do...Loopループを抜け出し，Loopステートメントの次のステートメントに制御を移します。 Do...Loopステートメントの中だけで使用できます。Do...Loopステートメントがネスト（入れ子）構造になっている場合は，Exit Doステートメントのあるループの一つ外側のループに制御を移します。

Exit Function

このステートメントのあるFunctionプロシージャを直ちに抜け出ます。制御はFunctionプロシージャを呼び出したステートメントの次のステートメントに移ります。

Exit Sub

このステートメントのあるSubプロシージャを直ちに抜け出ます。制御はSubプロシージャを呼び出したステートメントの次のステートメントに移ります。

対象バージョン

JP1/Script 01-00以降

7.1.12　GoTo

機能

指定したラベルに無条件に分岐するステートメントです。

形式

GoTo  LabelName

指定項目

LabelName

分岐先のラベル名を指定します。ラベル名には変数の名前付け規則に準じた名前を指定します。

説明

指定されたラベル先に実行の制御を移し，ラベルの次の行から実行が再開されます。ラベル名にスクリプトレベルまたはプロシージャレベルで同じ名前が複数個指定されている場合，文法エラーになります。

分岐先のラベルは任意の位置に記述できますが，GoToステートメントがプロシージャの内部で指定されている場合，分岐先は同じプロシージャの内部に存在しなければなりません。

例

If  Exec ("NOTEPAD.EXE" ,True ,"Loging.txt" ) = False Then
 GoTo  ErrorExit   ' ErrorExitへ制御を移す。
End
:
ErrorExit:          ' ここから処理を行う。
:

対象バージョン

JP1/Script 05-00以降

7.1.13　Continue

機能

While...Endループ，For...Nextループ，For...End Forループ，Do...Loopループの先頭に戻るためのフロー制御ステートメントです。

形式

Continue

説明

While...Endループ，For...Nextループ， For...End Forループ，Do...Loopループの中でだけ記述することができます。それ以外の位置で記述した場合は文法エラーとなります。

ContinueステートメントはWhile...Endループ，For...Nextループ，For...End Forループ，Do...Loopループ内の任意の位置で何回でも指定できます。

While...Endループ，For...Nextループ，For...End Forループ，Do...Loopループがネスト（入れ子）構造になっている場合は，Continueステートメントを含んでいる最も内側のループの先頭に制御を移します。

例

For  I = 1  To  10
 For  J = 1  To  10   ' Continueからここに戻る。
     :
    Continue
     :
 Next
Next

対象バージョン

JP1/Script 05-00以降

7.1.14　On Error

機能

エラー発生時に，指定したラベルに制御を移すステートメントです。エラー発生時に，指定したラベルに制御を移さないようにすることもできます。

形式

On Error GoTo  LabelName

指定項目

LabelName

分岐先のラベル名を指定します。ラベル名には変数の名前付け規則に準じた名前を指定します。

エラー発生時に指定したラベルに制御を移さないようにするには，LabelNameに0を指定します。

説明

On Errorステートメントは，ラベルの次の行から始まるエラー発生時の処理を有効にします。実行時にエラーが発生すると，ここで設定した分岐先に制御が移り，処理が実行されます。ただし，構文エラーが発生した場合には設定した分岐先には制御が移りません。分岐先のラベルはOn Errorステートメントと同じプロシージャ内に存在しなければなりません。

On Error GoTo 0を指定しなければ，ラベルの次の行から始まるエラー発生時の処理はプロシージャの終了まで有効になります。

補足

On Errorステートメントで指定したラベルに分岐する場合は，基本的に，実行エラーになりうるステートメントやコマンドが実行エラーとなったときです。

ただし，例外として以下の場合は実行エラーとなっても分岐しません。

TextReadコマンドで「ファイルの終わりに達した」のエラー時

WaitForExecコマンドで「タイムアウト時間を経過した」のエラー時

また，IsDefineコマンドやIsExistFileコマンドのように実行エラーになりえないコマンドはコマンドの戻り値にかかわらず分岐しません。

例

On Error GoTo ErrHandler '以降エラー発生時にラベルの次の行に制御が移る
 Copy ( InDir+"CTL3D32.DLL" ,OutDir+"CTL3D32.DLL" ,VersionUp )
   :
 On Error GoTo 0  '以降エラー発生時にラベルの次の行に制御を移さない
   :

ErrHandler:        'エラー発生時の分岐先
   :

対象バージョン

JP1/Script 05-00以降

8.　基本コマンド

この章では，スクリプトを作成するときに使用できる基本コマンドについて説明します。

＜この章の構成＞

8.1　基本コマンド一覧

8.2　変数操作コマンド

8.3　文字列操作コマンド

8.4　日付操作コマンド

8.5　ファイル・フォルダ操作コマンド

8.6　メッセージ出力コマンド

8.7　メニュー呼び出しコマンド

8.8　演算処理コマンド

8.9　チェック処理コマンド

8.10　外部プログラム呼び出しコマンド

8.11　自動起動処理コマンド

8.12　JP1呼び出しコマンド

8.13　コメントコマンド

8.14　その他のコマンド

8.1　基本コマンド一覧

スクリプトを作成するときに使用できる，基本コマンドの一覧を表8-1に示します。なお，コマンド欄の括弧内の数字は，対象バージョンを表します（括弧がないものは，01-00からサポートしています）。

表8-1　基本コマンド一覧

分類
コマンド
意味

変数操作
Dim
変数を宣言してメモリ領域を割り当てます。

Dim（配列）（06-00以降）
配列変数を宣言してメモリ領域を割り当てます。

SetEnvironmentまたはSetEnv
環境変数を設定します。

GetEnvironmentまたはGetEnv
環境変数を取得します。

SetGV
自PC，およびネットワーク上の他PCのグローバル変数を設定します。

GetGV
自PC，およびネットワーク上の他PCのグローバル変数を取得します。

DeleteGV（06-00以降）
自PC，およびネットワーク上の他PCのグローバル変数を削除します。

GetArrayCount（06-00以降）
配列変数の要素数（二次元配列の場合は行数または列数）を取得します。

文字列操作
InStr（05-00以降）
文字列の中から指定された文字列を検索し，最初に見つかった文字位置（先頭からその位置までの文字数）を返します。

InArray（06-00以降）
配列変数の要素の中から指定された文字列を検索し，最初に見つかったインデックス番号を返します。

Len
文字列の文字数を返します。

Lcase
文字列の半角英字の大文字を小文字に変換します。

Ucase
文字列の半角英字の小文字を大文字に変換します。

Left
文字列の左端から指定された文字数分の文字列を返します。

Mid
文字列から指定された文字数分の文字列を返します。

Right
文字列の右端から指定された文字数分の文字列を返します。

Space
指定された数の半角スペースからなる文字列を返します。

Ltrim（05-00以降）
文字列から先頭のスペースを削除した文字列を返します。

Rtrim（05-00以降）
文字列から末尾のスペースを削除した文字列を返します。

Trim（05-00以降）
文字列から先頭，および末尾のスペースを削除した文字列を返します。

+（文字列連結）
二つの式に対して文字列連結を行います。

&（文字列連結）（06-00以降）
二つの式に対して文字列連結を行います。

&=（文字列連結）（06-51以降）
変数と式の値に対して文字列連結を行い，連結した文字列を変数に代入します。

AddStr（05-00以降）
指定した二つ以上の文字列に対して，指定した区切り文字を挿入し連結した文字列を返します。

SeparateStrCount（05-00以降）
指定した区切り文字によって分割された文字列の数を返します。

SeparateStr（05-00以降）
指定した区切り文字によって分割された文字列を返します。

Str（05-20以降）
指定した値を文字列で返します。

Format（05-20以降）
指定した値を書式化した文字列で返します。

IsLower（06-00以降）
文字列が半角英字の小文字かどうかを調べ，結果を真（True）または偽（False）で返します。

IsUpper（06-00以降）
文字列が半角英字の大文字かどうかを調べ，結果を真（True），または偽（False）で返します。

IsSingleChar（06-00以降）
文字列が半角文字かどうかを調べ，結果を真（True），または偽（False）で返します。

IsMultiChar（06-00以降）
文字列が全角文字かどうかを調べ，結果を真（True），または偽（False）で返します。

日付操作
Date
現在の日付を返します。

Time
現在の時刻を返します。

Year
指定された日付の年を表す値を，4桁の数値で返します。

Month
指定された日付の月を表す値を，1～12の範囲の2桁の数値で返します。

Day
指定された日付の日を表す値を，1～31の範囲の2桁の数値で返します。

Weekday
指定された日付の曜日を表す値を，1（日曜）～7（土曜）の範囲の1桁の数値，または曜日を表す文字列で返します。

Hour
指定された時刻の時を表す値を，0～23の範囲の2桁の数値で返します。

Minute
指定された時刻の分を表す値を，0～59の範囲の2桁の数値で返します。

Second
指定された時刻の秒を表す値を，0～59の範囲の2桁の数値で返します。

CalcDate（05-20以降）
指定した日付に，指定した値を加算，または減算した結果（日付）を返します。

CompDate（05-20以降）
指定した二つの日付を比較し，結果を真（True），または偽（False）で返します。

GetDateCount（05-20以降）
指定した二つの日付の経過日数を返します。

CalcTime（05-20以降）
指定した時刻に，指定した値を加算，および減算した結果（時刻）を返します。

CompTime（05-20以降）
指定した二つの時刻を比較し，結果を真（True），または偽（False）で返します。

GetTimeCount（05-20以降）
指定した二つの時刻の経過時間を返します。

IsLeapYear（05-20以降）
指定した西暦がうるう年かどうかを調べ，結果を真（True），または偽（False）で返します。

ファイル・フォルダ操作
IniRead
初期化ファイルから値を読み込みます。

IniWrite
初期化ファイルの値を設定します。

TextFileReplace
テキストファイルの中の特定の文字列を置き換えます。

TextOpen（05-00以降）
テキスト形式ファイルをオープンします。

TextClose（05-00以降）
テキスト形式ファイルをクローズします。

TextRead（05-00以降）
テキスト形式ファイルの1行分のデータを読み込みます。

TextWrite（05-00以降）
テキスト形式ファイルにデータを書き込みます。

TextSeek（05-00以降）
テキスト形式ファイルのデータの読み書き開始位置を移動します。

GetTextPosition（05-00以降）
テキスト形式ファイルの現在の読み書き開始位置を返します。

MakeDir
フォルダを作成します。

DeleteDir
フォルダを削除します。

DeleteFile
ファイルを削除します。

Rename
ファイル名を変更します。

TempDir
一時フォルダを取得します。

TempFile
一時ファイル名を取得します。

SetFileAttributeまたはSetFileAttr
ファイルの属性を設定します。

GetFileAttributeまたはGetFileAttr（06-00以降）
ファイルの属性を取得します。

SetFileTime（05-10以降）
ファイルに日付と時刻を設定します。

GetFileTime（05-10以降）
ファイルの日付と時刻を取得します。

GetFileSize（06-00以降）
ファイルの容量を取得します。

GetVersionInfoまたはGetVerInfo（06-00以降）
ファイルのバージョン情報を取得します。

SplitFile（05-10以降）
指定したサイズでファイルを分割します。

CatFiles（05-10以降）
複数のファイルを一つに統合します。

SetStandardFileまたはSetStdFile（05-10以降）
Execコマンドで呼び出すプロセスの標準入力，標準出力，および標準エラーファイルを設定します。

ResetStandardFileまたはResetStdFile（05-10以降）
Execコマンドで呼び出すプロセスの標準入力，標準出力，および標準エラーファイルを解除します。

SplitPath
フルパスを解析します。

MakePath
フルパスを作成します。

SetPath
実行フォルダのパスを設定します。

GetPath
実行フォルダのパスを取得します。

SetVolumeLabelまたはSetVolLabel（05-10以降）
ディスクのボリュームラベルを設定します。

GetVolumeLabelまたはGetVolLabel（05-10以降）
ディスクのボリュームラベルを取得します。

GetDiskFreeSpace（05-10以降）
ディスクの空き容量を取得します。

Copy
ファイルをコピーします。

メッセージ出力
InputBox
ダイアログボックスにメッセージとテキストボックスを表示し，テキストが入力されるか，またはボタンがクリックされると，テキストボックスの内容を返します。

Message
ファイル，またはウィンドウへ指定されたテキストを出力します。また，テキストを出力したウィンドウを消去します。

MessageBox
ダイアログボックスに指定されたメッセージを表示します。ボタンやアイコンの付加を指定できます。ボタンを付加する場合，ボタンがクリックされるのを待って，どのボタンがクリックされたのかを示す値を返します。

MessageEventLog（01-01以降）
イベントビューアのアプリケーションログにメッセージを出力します。

IMEventMessage（05-20以降）
JP1/IM，またはJP1/Baseへイベントを発行します。JP1/IM のイベントコンソールの機能については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

メニュー呼び出し
Menu（05-20以降）
ユーザ定義の画面（メニューフォーム）を表示します。

演算処理
＋演算子（加算）
二つの数値の和を求めます。

＋=演算子（加算）（06-51以降）
変数と式の値の和を求め，結果を変数に代入します。

－演算子（減算）
二つの数値の差を求めます。数式の符号を反転した値を指定します。

－=演算子（減算）（06-51以降）
変数と式の値の差を求め，結果を変数に代入します。

Mod演算子（剰余演算）
二つの数値の除算を行い，その剰余を返します。

Mod=演算子（剰余演算）（06-51以降）
変数と式の値の除算を行い，その剰余を変数に代入します。

*演算子（乗算）
二つの数値の積を求めます。

*=演算子（乗算）（06-51以降）
変数と式の値の積を求め，結果を変数に代入します。

/演算子（除算）
二つの数値の商を計算し，結果を整数で返します。

/=演算子（除算）（06-51以降）
変数と式の値の商を計算し，結果を整数で変数に代入します。

￥演算子（整数除算）
二つの数値の商を計算し，結果を整数で返します。

￥=演算子（整数除算）（06-51以降）
変数と式の値の商を計算し，結果を整数で変数に代入します。

^演算子（べき乗）（06-00以降）
二つの数値のべき乗を求めます。

^=演算子（べき乗）（06-51以降）
変数と式の値のべき乗を求め，結果を変数に代入します。

比較演算子（=，<>，<，<=，>，>=）
二つの式を比較します。

論理積（And）
二つの式の論理積を求めます。

論理和（Or）
二つの式の論理和を求めます。

論理否定（Not）（06-00以降）
式の論理否定を求めます。

チェック処理
IsEmpty
変数がEmpty値かどうかを調べ，結果を真（True）または偽（False）で返します。

IsDefineまたはIsDef
変数が定義されているかどうかを調べ，結果を真（True），または偽（False）で返します。

IsNumeric（01-01以降）
値が数値として評価できるかどうかを調べ，結果を真（True），または偽（False）で返します。

IsEmptyDir
フォルダの中身が空かどうかをチェックし，結果を真（True），または偽（False）で返します。

IsExistDir
フォルダが存在するかどうかをチェックし，結果を真（True），または偽（False）で返します。

IsExistFile
ファイルが存在するかどうかをチェックし，結果を真（True），または偽（False）で返します。

IsWriteableDir
フォルダが書き込み可能かどうかをチェックし，結果を真（True），または偽（False）で返します。

IsFileAttributeまたはIsFileAttr
ファイルの属性が指定された属性か，どうかをチェックし，結果を真（True），または偽（False）で返します。

IsNew（05-10以降）
二つのファイルのバージョン情報，またはファイル日付の新旧を比較し，結果を真（True），または偽（False）で返します。

CheckDirName
フォルダの末尾（¥）かどうかをチェックします。

CheckDriveType
ドライブの種類をチェックします。

外部プログラム呼び出し
Exec※1
実行ファイルを呼び出します。複数パラメタの指定が可能です。

NetExec（05-00以降）※1
自PC，およびネットワーク上の他のPC上の実行ファイルを呼び出します。複数パラメタの指定が可能です。

WaitForExec（01-01以降）
Exec，およびNetExecコマンドで呼び出した実行ファイルの終了待ちや強制終了を行います。

GetExecStatus（06-00以降）
Exec，およびNetExecコマンドで呼び出した実行ファイルの現在の実行状態を取得します。

CallSpt（06-71以降）※1
現在のプロセスがSPTファイルをプロシージャのように呼び出します。複数パラメタの指定が可能です。

自動起動処理
EntryStartUp（05-10以降）
スクリプトファイルを自動起動に登録します。

CancelStartUp（05-10以降）
スクリプトファイルの自動起動の登録を解除します。

JP1呼び出し※2
JOBSubmit
JP1のキューサーバに対してスクリプトを登録します。

JOBWait
JOBSubmitコマンドで登録したジョブが終了するのを待ちます。

JOBHold
JOBSubmitコマンドで登録したジョブを保留，または保留解除にします。

JOBCancel
JOBSubmitコマンドで登録したジョブをキャンセルします。

コメント
Remまたは「′」（シングル引用符）
プログラム内にコメントを記述するときに指定します。

その他
Sleep
指定された時間，処理を中断します。

Alert
トレースビューアのステータスに，警告・警告解除を知らせます。

Beep
スピーカからビープ音を鳴らします。
使用する場合は，「1.7(4)　Beepコマンドについて」，および「8.14.3　Beep（スピーカからビープ音を鳴らす）」の注意事項を参照してください。

Exit
スクリプトの実行を終了します。

GetErrorMessage（01-01以降）
指定されたエラー詳細コードのエラーメッセージを返します。

注※1　Exec，NetExec，およびCallSptコマンドの違いを表8-2に示します。

表8-2　Exec，NetExec，およびCallSptコマンドの違い

コマンド
呼び出せる実行ファイル
呼び出した実行ファイルの終了待ち
呼び出された外部ファイルのプロセス
用途

特徴
プロセス環境変数

Exec
EXEファイル，
BATファイル，
COMファイル，
SPTファイル，
CMDファイル，
関連付けられたファイル
終了待ちをするかしないかを指定できます。
新しいプロセスで実行されます。
呼び出し側のコピーを継承するので，呼び出し側の値は認識できるが，それを更新しても呼び出し側では反映されません。
実行ファイルを呼び出す場合

NetExec
EXEファイル，
BATファイル，
COMファイル，
SPTファイル，
CMDファイル，
関連付けられたファイル
終了待ちをするかしないかを指定できます。
新しいプロセスで実行されます。
呼び出し元のプロセス環境変数を呼び出し先に継承しません。そのため，呼び出し元で設定した値を参照できません。
他のコンピュータで実行ファイルを呼び出す場合や，実行する空間をサービスかログオンかを指定して実行ファイルを呼び出す場合

CallSpt
SPTファイル
指定できません（常に終了待ちとなります）。
現在のプロセスで実行されます。
呼び出し側と共有するため，参照できます。また，更新した値を呼び出し側で参照できます。
現在の処理の一部として実行ファイルを呼び出す場合

注※2　Windows Vista以降のOSでは，JP1呼び出しコマンドをサポートしていません。

8.2　変数操作コマンド

＜この節の構成＞

8.2.1　Dim （変数を宣言しメモリ領域を割り当てる）

8.2.2　Dim（配列） （配列変数を宣言しメモリ領域を割り当てる）

8.2.3　SetEnvironmentまたはSetEnv （環境変数を設定する）

8.2.4　GetEnvironmentまたはGetEnv （環境変数を取得する）

8.2.5　SetGV （グローバル変数を設定する）

8.2.6　GetGV （グローバル変数を取得する）

8.2.7　DeleteGV （グローバル変数を削除する）

8.2.8　GetArrayCount （配列変数の要素数を取得する）

8.2.1　Dim （変数を宣言しメモリ領域を割り当てる）

機能

変数を宣言してメモリ領域を割り当てます。

形式

Dim VarName 〔, VarName , …〕

指定項目

VarName

定義する変数名を指定します。変数の名前付け規則に従って名前を付けます。

説明

このコマンドを使ってスクリプトレベルで宣言した変数は，宣言したスクリプト内のすべてのプロシージャから参照できます。プロシージャレベルで宣言した変数は，宣言したプロシージャ内だけで参照できます。

ただし，スクリプト，またはプロシージャのDo...Loop，For...Next，For...End For，While...Endループ内で変数の宣言，または宣言していない変数への代入により割り当てた変数はループ内だけで参照できます。

Dimコマンドで宣言していない変数に値を代入した場合は，自動的に変数を宣言して，メモリ領域を割り当て，値を代入します。

変数の宣言時には，変数はEmpty値になります。

対象バージョン

JP1/Script 01-00以降

8.2.2　Dim（配列） （配列変数を宣言しメモリ領域を割り当てる）

機能

配列変数を宣言してメモリ領域を割り当てます。

形式

Dim VarName ( 〔Number1〕 〔, Number2〕 ) 〔, VarName ( 〔Number1〕 〔, Number2〕 ) , …〕
Dim VarName ［ 〔Number1〕 〔, Number2〕 ］ 〔, VarName ［ 〔Number1〕 〔, Number2〕 ］ , …〕

指定項目

VarName

定義する配列変数の変数名を指定します。変数の名前付け規則に従って名前を付けます。

Number1

配列変数の要素数（二次元配列の場合は行要素数）を数値，または値を格納した変数で指定します。

省略した場合，要素数は可変となります。

Number2

二次元配列の列要素数を数値，または値を格納した変数で指定します。

省略した場合，要素数は可変となります。

説明

このコマンドを使ってスクリプトレベルで宣言した配列変数は，宣言したスクリプト内のすべてのプロシージャから参照できます。プロシージャレベルで宣言した配列変数は，宣言したプロシージャ内だけで参照できます。

ただし，スクリプトレベル，またはプロシージャレベルのDo...Loop，For...Next，For...End For，While...Endループ内で配列変数の宣言により割り当てた配列変数はループ内だけで参照できます。

配列変数の宣言時には，配列変数のすべての要素はEmpty値になります。

例

' 二次元の固定な配列変数table1の宣言
Dim  table1( 5 ,6 )

' 一次元の固定な配列変数table2から一次元の可変な配列変数table3への
' 一括代入
Dim  table2( 6 ) ,table3( )
For  i = 1 To 6
 table2( i ) = Time( )
Next
table3 = table2

' 一次元の固定な配列変数table4と配列変数table5の比較
Dim  table4( 6 ) ,table5( 6 )
 :
If  table4 = table5  Then
 :
' 次のような大小比較はできないため,実行エラーになる。
If  table4 <= table5  Then
 :

対象バージョン

JP1/Script 06-00以降

8.2.3　SetEnvironmentまたはSetEnv （環境変数を設定する）

機能

環境変数を設定します。

形式

SetEnvironment ( Type , EnvironmentName 〔, Value〕 )
SetEnv ( Type , EnvironmentName 〔, Value〕 )

指定項目

Type

設定する環境変数がシステム環境変数かユーザ環境変数か，または現在のプロセスの環境変数かを指定します。

この値は次のどれかになります。

値
意味

SystemEnv
システム環境変数
設定する環境変数はコマンド実行後のシステム再起動後から有効になります。ただし，GetEnvironmentコマンドではコマンド実行後から取得できます。

UserEnv
ユーザ環境変数
設定する環境変数はコマンド実行後のシステム再起動後から有効になります。ただし，GetEnvironmentコマンドではコマンド実行後から取得できます。

ProcessEnv
現在のプロセスの環境変数
設定する環境変数はコマンド実行後の現在のプロセス内で有効になります。

SystemEnvを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

EnvironmentName

設定する環境変数名を文字列，または値を格納した変数名で指定します。

Value

設定する値を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，長さ0の文字列（""）を仮定します。

この値に展開前の環境変数への参照（"%PATH%"など）を含んでいてもそのままの値で設定します。

例えばValueで指定された値が"%PATH%;C:¥Data"の場合，"%PATH%;C:¥Data"を設定します。しかし，この環境変数を参照するときに，システムは%PATH%の部分を環境変数PATHの現在の値に置き換えた値で取得します。ただし，プロセス環境変数の場合，現在の値に置き換えられませんので例1のようにしてください。環境変数PATHが見つからない場合"%PATH%"の部分はそのままで取得します。

説明

指定された環境変数に指定された値を設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定された環境変数が存在しない場合は，新規に環境変数を作成し値を設定します。環境変数が存在する場合は，指定された値で更新します。

例1

' プロセス環境変数PATHに"C:¥ABC¥"を追加する
Dim buff1
buff1 = GetEnvironment ( ProcessEnv ,"PATH" )
SetEnvironment ( ProcessEnv ,"PATH" ,buff1 & ";C:¥ABC¥" )
Exec ( "ABC.EXE" ,True )

例2

' システム環境変数APP_PATHにシステム環境変数PATHを設定する
SetEnvironment ( SystemEnv ,"APP_PATH" ,"%PATH%" )

対象バージョン

JP1/Script 01-00以降

8.2.4　GetEnvironmentまたはGetEnv （環境変数を取得する）

機能

環境変数を取得します。

形式

GetEnvironment ( Type , EnvironmentName 〔, Option〕 )
GetEnv ( Type , EnvironmentName 〔, Option〕 )

指定項目

Type

取得する環境変数がシステム環境変数かユーザ環境変数か，または現在のプロセスの環境変数かを指定します。

この値は次のどれかになります。

値 | 意味
SystemEnv | システム環境変数
UserEnv | ユーザ環境変数
ProcessEnv | 現在のプロセスの環境変数

EnvironmentName

取得する環境変数を文字列，または値を格納した変数名で指定します。

Option （05-20以降）

オプションを指定します。

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

値 | 意味
Expand | 取得する値に展開前の環境変数への参照（"%PATH%" など）を含む場合，展開した値で取得します。

説明

指定された環境変数を取得し，値をコマンドの実行結果として返します。

指定された環境変数が存在しない場合は，長さ0の文字列（""）を返します。

注意

取得する環境変数の値が，長さ1,025バイト以上の文字列の場合，コマンドの実行結果として返される値は1,024バイト目までです。1,025バイト目以降は無視されます。

例

' 環境変数pathの値が"C:¥Winnt"の場合,変数buff1と変数buff2
' には"C:¥Winnt"が格納される。
Dim  buff1 ,buff2
buff1 = GetEnvironment ( SystemEnv ,"path" )
buff2 = GetEnvironment ( SystemEnv ,"path" ,Expand )

' 環境変数pathの値が"%SystemRoot%"で 環境変数SystemRoot
' の値が"C:¥Winnt"の場合,
' 変数buff3には"%SystemRoot%"が,変数buff4には"C:¥Winnt"が
'格納される。
Dim  buff3 ,buff4
buff3 = GetEnvironment ( SystemEnv ,"path" )
buff4 = GetEnvironment ( SystemEnv ,"path" ,Expand )

対象バージョン

JP1/Script 01-00以降

8.2.5　SetGV （グローバル変数を設定する）

機能

グローバル変数を設定します。

JP1/Script 05-00以降では，他のコンピュータ上のグローバル変数も設定できます。

形式

SetGV ( GlobalName , 〔Value〕 〔, CompName〕 )

指定項目

GlobalName

設定するグローバル変数を文字列，または値を格納した変数名で指定します。

Value

設定する値を文字列，数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，長さ0の文字列（""）を仮定します。

CompName （05-00以降）

設定するグローバル変数が存在するコンピュータのコンピュータ名を文字列，または値を格納した変数名で指定します。

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

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

説明

指定されたグローバル変数に指定された値を設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，新規にグローバル変数を作成し値を設定します。グローバル変数が存在する場合は，指定された値で更新します。

CompNameに他のコンピュータを指定し，「グローバル変数（GlobalName）」，および「設定する値（Value）」にn個のダブルクォーテーション（"）を文字としてそのまま含めるには，「グローバル変数（GlobalName）」には（n*4）個，「設定する値（Value）」には（n*8）個のダブルクォーテーション（"）を指定しなければなりません。

ただし，次のレジストリの値に1を設定した場合は，（n*2）個のダブルクォーテーション（"）を指定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

ParseDQ

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が無効となる（初期値）

1：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が有効となる

なお，〔値〕に1と2（SeparateStrCount，SeparateStrコマンドを参照）の両方を指定する場合は3を指定してください。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

補足

このコマンドは，インストール先フォルダの"DATA"フォルダ下に，グローバル変数ファイル（SPTGV.SPG）を作成します。ただし，JP1/Script 06-51以降では，マネージャの［ツール］－［オプション（クラスタ環境）］ダイアログで管理ファイルの出力先が変更されている場合，指定されたフォルダ下にグローバル変数ファイルを作成します。このファイルはスクリプトの実行が終了しても残りますので，グローバル変数を初期化する場合は，ファイルを削除してください。

また，CompNameに他のコンピュータを指定する場合，LAN環境下での動作だけを保証しています。ファイアウォールには対応していません。

例

' 自コンピュータ上のグローバル変数を設定する。
SetGV ( "Debug_Mode" ,True )

' コンピュータ"SOP4A065 ( SCRIPT ) "上のグローバル変数を設定する。
SetGV ( "Debug_Mode" ,True ,"SOP4A065 ( SCRIPT ) " )

対象バージョン

JP1/Script 01-00以降

8.2.6　GetGV （グローバル変数を取得する）

機能

グローバル変数を取得します。

JP1/Script 05-00以降では，他のコンピュータ上のグローバル変数も取得できます。

形式

GetGV ( GlobalName 〔, CompName〕 )

指定項目

GlobalName

取得するグローバル変数を文字列，または値を格納した変数名で指定します。

CompName （05-00以降）

取得するグローバル変数が存在するコンピュータのコンピュータ名を文字列，または値を格納した変数名で指定します。

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

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

説明

指定されたグローバル変数を取得し，値をコマンドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，長さ0の文字列（"）を返します。

CompNameに他のコンピュータを指定し，「グローバル変数（GlobalName）」にn個のダブルクォーテーション（"）を文字としてそのまま含めるには，（n*4）個のダブルクォーテーション（"）を指定しなければなりません。ただし，次のレジストリの値に1を設定した場合は，（n*2）個のダブルクォーテーション（"）を指定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

ParseDQ

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が無効となる（初期値）

1：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が有効となる

なお，〔値〕に1と2（SeparateStrCount，SeparateStrコマンドを参照）の両方を指定する場合は3を指定してください。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

補足

CompNameに他のコンピュータを指定する場合，LAN環境下での動作だけを保証しています。ファイアウォールには対応していません。

例

' 自コンピュータ上のグローバル変数を取得し,レジストリを操作する。
If  GetGV ( "Debug_Mode" ) = True  Then
 Dbflag = "DebugFlag"
 RegWrite ( HKEY_CURRENT_USER   _
          , "Software¥Hitachi¥Script¥Option" , Dbflag , True )
End
' コンピュータ"SOP4A065 ( SCRIPT ) "上のグローバル変数を取得し,
' 更新する。
If  GetGV ( "Debug_Mode" ,"SOP4A065 ( SCRIPT ) " ) = True  Then
   SetGV ( "Debug_Mode" ,False ,"SOP4A065 ( SCRIPT ) " )
End

対象バージョン

JP1/Script 01-00以降

8.2.7　DeleteGV （グローバル変数を削除する）

機能

グローバル変数を削除します。

他のコンピュータ上のグローバル変数も削除できます。

形式

DeleteGV ( GlobalName 〔, CompName〕 )

指定項目

GlobalName

削除するグローバル変数を文字列，または値を格納した変数名で指定します。

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

値 | 意味
AllGV | すべてのグローバル変数を削除します。ただし，グローバル変数ファイル（SPTGV.SPG）は残ります。

CompName

削除するグローバル変数が存在するコンピュータのコンピュータ名を文字列，または値を格納した変数名で指定します。

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

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

説明

指定されたグローバル変数を削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，何もしないで常に真（True）を返します。

CompNameに他のコンピュータを指定し，「グローバル変数（GlobalName）」にn個のダブルクォーテーション（"）を文字としてそのまま含めるには，（n*4）個のダブルクォーテーション（"）を指定しなければなりません。ただし，次のレジストリの値に1を設定した場合は，（n*2）個のダブルクォーテーション（"）を指定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

ParseDQ

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が無効となる（初期値）

1：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が有効となる

なお，〔値〕に1と2（SeparateStrCount，SeparateStrコマンドを参照）の両方を指定する場合は3を指定してください。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

補足

CompNameに他のコンピュータを指定する場合，LAN環境下での動作だけを保証しています。ファイアウォールには対応していません。

例

'自コンピュータ上のグローバル変数をすべて削除する。
DeleteGV ( AllGV )

'コンピュータ"SOP4A065(SCRIPT)"上のグローバル変数"prm01"を削除する。
SetGV ( "prm01" ,10 ,"SOP4A065 ( SCRIPT ) " )
Exec ( _SCF_+"ABC.SPT" ,True )
DeleteGV ( "prm01" ,"SOP4A065 ( SCRIPT ) " )

対象バージョン

JP1/Script 06-00以降

8.2.8　GetArrayCount （配列変数の要素数を取得する）

機能

配列変数の要素数（二次元配列の場合は行数または列数）を取得します。

形式

GetArrayCount ( ArrayName )

指定項目

ArrayName

配列変数を変数名で指定します。

説明

指定された配列変数の要素数（二次元配列の場合は行数または列数）を取得します。

コマンドが正常に実行された場合は要素数（二次元配列の場合は行数または列数）を，エラーが発生した場合は長さ0の文字列（""）を，コマンドの実行結果として返します。

指定された配列変数が可変である場合は，すでに設定された要素数（二次元配列の場合は行数または列数）を返します。

例

' ［一次元の固定な配列変数Aの場合］
' 変数result1には要素数10が格納される。
Dim  A( 10 )
result1 = GetArrayCount ( A )

'［二次元の固定な配列変数Bの場合］
' 変数result2と変数result3には列数10が,変数result4には
' 行数5が格納される。
Dim  B( 5 ,10 )
result2 = GetArrayCount ( B( 1 ) )
result3 = GetArrayCount ( B( 5 ) )
result4 = GetArrayCount ( B )

' ［二次元の可変な配列変数Cの場合］
' 変数result5には列数1が,変数result6には列数7が,変数result7
' には行数2が格納される。
Dim  C( , )
C( 2 ,1 ) = "SUN"
C( 2 ,2 ) = "MON"
C( 2 ,3 ) = "TUE"
C( 2 ,4 ) = "WED"
C( 2 ,5 ) = "THU"
C( 2 ,6 ) = "FRI"
C( 2 ,7 ) = "SAT"
result5 = GetArrayCount ( C( 1 ) )
result6 = GetArrayCount ( C( 2 ) )
result7 = GetArrayCount ( C )

対象バージョン

JP1/Script 06-00以降

8.3　文字列操作コマンド

＜この節の構成＞

8.3.1　InStr （文字列を検索し文字位置を返す）

8.3.2　InArray （配列変数の要素から文字列を検索し，インデックス番号を返す）

8.3.3　Len （文字列の文字数を返す）

8.3.4　LCase （半角アルファベットの大文字を小文字に変換する）

8.3.5　UCase （半角アルファベットの小文字を大文字に変換する）

8.3.6　Left （左端から指定した文字数分の文字列を返す）

8.3.7　Mid （指定した文字数分の文字列を返す）

8.3.8　Right （右端から指定した文字数分の文字列を返す）

8.3.9　Space （半角スペースからなる文字列を返す）

8.3.10　LTrim （先頭のスペースを削除した文字列を返す）

8.3.11　RTrim （末尾のスペースを削除した文字列を返す）

8.3.12　Trim （先頭および末尾のスペースを削除した文字列を返す）

8.3.13　文字列連結（+） （文字列連結を行う）

8.3.14　文字列連結（&） （文字列連結を行う）

8.3.15　文字列連結（&=） （変数と式の文字列連結を行う）

8.3.16　AddStr （指定した連結文字で文字列連結を行う）

8.3.17　SeparateStrCount （文字列分割を行い，分割文字列の数を返す）

8.3.18　SeparateStr （文字列分割を行い，分割文字列を返す）

8.3.19　Str （値を文字列で返す）

8.3.20　Format （値を書式化した文字列を返す）

8.3.21　IsLower （半角アルファベットの小文字かどうかを調べる）

8.3.22　IsUpper （半角アルファベットの大文字かどうかを調べる）

8.3.23　IsSingleChar （半角文字かどうかを調べる）

8.3.24　IsMultiChar （全角文字かどうかを調べる）

8.3.1　InStr （文字列を検索し文字位置を返す）

機能

指定された文字列の中から指定された文字列を検索し，最初に見つかった文字位置（先頭からその位置までの文字数）を返します。

形式

InStr ( String , SearchStr , 〔Start〕 〔, Compare〕 )

指定項目

String

検索対象となる文字列を文字列，または値を格納した変数名で指定します。

この値が長さ0の文字列（""）の場合は，0を返します。

SearchStr

検索する文字列を文字列，または値を格納した変数名で指定します。

この値が長さ0の文字列（""）の場合は，0を返します。

Start

Stringで指定した文字列の先頭を1として，どの位置から検索開始するかを先頭からの文字数で指定します。

この値がStringで指定した文字列の文字数を超える場合は，0を返します。

この値は省略できます。省略した場合，1を仮定します。

Compare

文字列の比較方法を指定します。

この値は次のどれかになります。

値 | 意味
真（True） | 半角文字も全角文字も大文字と小文字を区別して比較します。
偽（False） | 半角文字も全角文字も大文字と小文字を区別しないで比較します。
Twice | 半角文字の大文字と小文字は区別しないで全角文字の大文字と小文字は区別して比較します。

この値は省略できます。省略した場合，Twiceを仮定します。

説明

指定された文字列の中から指定された文字列を検索し，最初に見つかった文字位置（先頭からその位置までの文字数）を返します。

全角文字も半角文字も同じ1文字となります。

指定された文字列が見つからない場合は，0を返します。

例

' 変数point1には6が格納される。
Dim  point1
point1 = InStr ( "ファイルをABC順にならべる" ,"abc" ,3 ,False )

対象バージョン

JP1/Script 05-00以降

8.3.2　InArray （配列変数の要素から文字列を検索し，インデックス番号を返す）

機能

指定された配列変数の要素の中から指定された文字列を検索し，最初に見つかったインデックス番号を返します。

形式

InArray ( ArrayName , SearchStr , 〔Start〕 〔, Compare〕 )

指定項目

ArrayName

検索対象となる配列変数を変数名で指定します。

この配列変数の要素数が0の場合は，0を返します。

SearchStr

検索する文字列を文字列，または値を格納した変数名で指定します。

この値が長さ0の文字列（""）の場合は，0を返します。

Start

ArrayNameで指定した配列変数のどの位置から検索開始するかをインデックス番号の数値，または値を格納した変数名で指定します。

この値がArrayNameで指定した配列変数の要素数を超える場合は，0を返します。

この値は省略できます。省略した場合，先頭の要素を仮定します。

Compare

文字列の比較方法を指定します。

この値は次のどれかになります。

値 | 意味
真（True） | 半角文字も全角文字も大文字と小文字を区別して比較します。
偽（False） | 半角文字も全角文字も大文字と小文字を区別しないで比較します。
Twice | 半角文字の大文字と小文字は区別しないで全角文字の大文字と小文字は区別して比較します。

この値は省略できます。省略した場合，Twiceを仮定します。

説明

指定された配列変数の要素の中から指定された文字列を検索し，最初に見つかったインデックス番号（1から始まる数値）を返します。

指定された文字列が見つからない場合は，0を返します。

例1

' 下図のように値を格納した配列変数closeDayから指定のデータを検索する。

Dim  closeDay( 3 ,12 )
   :
（配列変数closeDayへの値格納処理）
   :
monthName = "March"
buff = InArray ( closeDay( 1 ) ,monthName ,1 ,False )
If  buff > 0  Then
 firstDay = closeDay( 2 ,buff )
 MessageBox ( monthName+"の第1定休日は"+firstDay+"です。" )
End If

例2

' 二次元の配列変数の全要素の中から指定のデータを検索する。
Dim  array1( , )
   :
(配列変数array1への値格納処理)
   :
allCnt = GetArrayCount ( array1 )
For  line = 1 To allCnt
 buff = InArray ( array1( line ) ,"1999" ,1 ,False )
 If  0 < buff  Then
   Exit For
 End If
Next

対象バージョン

JP1/Script 06-00以降

8.3.3　Len （文字列の文字数を返す）

機能

文字列の文字数を返します。

形式

Len ( String )

指定項目

String

文字列，または値を格納した変数名を指定します。

説明

指定された文字列の文字数，または指定された変数に格納された文字列の文字数を返します。

全角文字も半角文字も同じ1文字となります。

例

' 変数length1には6が格納される。
Dim  length1
length1 = Len ( "ABCDEF" )

' 変数length2には4が格納される。
Dim  length2
length2 = Len ( "ファイル" )

対象バージョン

JP1/Script 01-00以降

8.3.4　LCase （半角アルファベットの大文字を小文字に変換する）

機能

文字列の半角アルファベットの大文字を小文字に変換し，変換した文字列を返します。

形式

LCase ( String )

指定項目

String

文字列，または値を格納した変数名を指定します。

説明

指定された文字列の半角アルファベットの大文字を小文字に変換し，変換した文字列を返します。

指定された文字列の大文字だけが小文字に変換されます。大文字の半角アルファベット以外の文字は影響を受けません。

例

' 変数string1には "abcdef" が格納される。
Dim  string1
string1 = LCase ( "abcDEF" )

対象バージョン

JP1/Script 01-00以降

8.3.5　UCase （半角アルファベットの小文字を大文字に変換する）

機能

文字列の半角アルファベットの小文字を大文字に変換し，変換した文字列を返します。

形式

UCase ( String )

指定項目

String

文字列，または値を格納した変数名を指定します。

説明

指定された文字列の半角アルファベットの小文字を大文字に変換し，変換した文字列を返します。

指定された文字列の小文字だけが大文字に変換されます。小文字の半角アルファベット以外の文字は影響を受けません。

例

' 変数string1には "ABCDEF" が格納される。
Dim  string1
string1 = UCase ( "abcDEF" )

対象バージョン

JP1/Script 01-00以降

8.3.6　Left （左端から指定した文字数分の文字列を返す）

機能

文字列の左端から指定された文字数分の文字列を返します。

形式

Left ( String , Length )

指定項目

String

文字列，または値を格納した変数名を指定します。

Length

Stringで指定した文字列から取り出す文字数を数値，または値を格納した変数名で指定します。

この値に0を指定した場合は，長さ0の文字列（""）を返します。また，Stringで指定した文字列全体の文字数以上の値を指定した場合は，Stringで指定した文字列全体を返します。

説明

指定された文字列の左端から指定された文字数分の文字列を返します。

全角文字も半角文字も同じ1文字となります。

文字列の文字数を調べるには，Lenコマンドを使用します。

例

' 変数string1には "ABCD" が格納される。
Dim  string1
string1 = Left ( "ABCDEFGH" ,4 )

' 変数string2には "ABC順" が格納される。
Dim  string2
string2 = Left ( "ABC順にならべる",4 )

対象バージョン

JP1/Script 01-00以降

8.3.7　Mid （指定した文字数分の文字列を返す）

機能

文字列の中間から指定された文字数分の文字列を返します。

形式

Mid ( String , Start 〔, Length〕 )

指定項目

String

文字列，または値を格納した変数名を指定します。

Start

Stringで指定した文字列の先頭の位置を1として，どの位置から文字列を取り出すかを先頭からの文字数で指定します。

この値がStringで指定した文字列の文字数を超える場合は，長さ0の文字列（""）を返します。

Length

取り出す文字数を数値，または値を格納した変数名で指定します。

この値を省略した場合，または文字列内にこの値より短い文字数しかない場合には，Startから後のすべての文字列が返されます。

説明

指定された文字列の中間から指定された文字数分の文字列を返します。

全角文字も半角文字も同じ1文字となります。

文字列の文字数を調べるには，Lenコマンドを使用します。

例

' 変数string1には "CDEFG" が格納される。
Dim  string1
string1 = Mid ( "ABCDEFGH" ,3 ,5 )

' 変数string2には "C順になら" が格納される。
Dim  string2
string2 = Mid ( "ABC順にならべる" ,3 ,5 )

対象バージョン

JP1/Script 01-00以降

8.3.8　Right （右端から指定した文字数分の文字列を返す）

機能

文字列の右端から指定された文字数分の文字列を返します。

形式

Right ( String , Length )

指定項目

String

文字列，または値を格納した変数名を指定します。

Length

Stringで指定した文字列から取り出す文字数を，数値，または値を格納した変数名で指定します。

この値に0を指定した場合は，長さ0の文字列（""）を返します。また，Stringで指定した文字列全体の文字数以上の値を指定した場合は，Stringで指定した文字列全体を返します。

説明

指定された文字列の右端から指定された文字数分の文字列を返します。

全角文字も半角文字も同じ1文字となります。

文字列の文字数を調べるには，Lenコマンドを使用します。

例

' 変数string1には "EFGH" が格納される。
Dim  string1
string1 = Right ( "ABCDEFGH" ,4 )

' 変数string2には "ならべる" が格納される。
Dim  string2
string2 = Right ( "ABC順にならべる" ,4 )

対象バージョン

JP1/Script 01-00以降

8.3.9　Space （半角スペースからなる文字列を返す）

機能

指定された数の半角スペースからなる文字列を返します。

形式

Space ( Number )

指定項目

Number

スペースの数を数値，または値を格納した変数名で指定します。指定できる値の範囲は，0から1,024までです。0を指定した場合は，長さ0の文字列（""）を返します。また，1,024より大きい値を指定した場合は，1,024を仮定します。

説明

指定された数の半角スペースからなる文字列を返します。

例

' 変数string1には "   " (半角スペース3文字)が格納される。
Dim  string1
string1 = Space ( 3 )

対象バージョン

JP1/Script 01-00以降

8.3.10　LTrim （先頭のスペースを削除した文字列を返す）

機能

文字列から先頭のスペースを削除した文字列を返します。

形式

LTrim ( String 〔, Option〕 )

指定項目

String

文字列，または値を格納した変数名を指定します。

文字列の先頭にスペースが見つからない場合は，Stringで指定した文字列全体を返します。

Option

オプションを指定します。

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

値 | 意味
Twice | 全角スペースも削除します。

説明

オプションが省略された場合，指定された文字列から先頭の半角スペースを削除した文字列を返します。

オプションにTwiceが指定されている場合は，半角スペースだけでなく全角スペースも削除します。

例

' 変数string1には"ABC DEFG   "が格納される。
Dim  string1
string1 = LTrim ( "   ABC DEFG   " ,Twice )

対象バージョン

JP1/Script 05-00以降

8.3.11　RTrim （末尾のスペースを削除した文字列を返す）

機能

文字列から末尾のスペースを削除した文字列を返します。

形式

RTrim ( String 〔, Option〕 )

指定項目

String

文字列，または値を格納した変数名を指定します。

文字列の末尾にスペースが見つからない場合は，Stringで指定した文字列全体を返します。

Option

オプションを指定します。

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

値 | 意味
Twice | 全角スペースも削除します。

説明

オプションが省略された場合，指定された文字列から末尾の半角スペースを削除した文字列を返します。

オプションにTwiceが指定されている場合は，半角スペースだけでなく全角スペースも削除します。

例

' 変数string1には"   ABC DEFG"が格納される。
Dim  string1
string1 = RTrim ( "   ABC DEFG   " ,Twice )

対象バージョン

JP1/Script 05-00以降

8.3.12　Trim （先頭および末尾のスペースを削除した文字列を返す）

機能

文字列から先頭，および末尾のスペースを削除した文字列を返します。

形式

Trim ( String 〔, Option〕 )

指定項目

String

文字列，または値を格納した変数名を指定します。

文字列の先頭，および末尾にスペースが見つからない場合は，Stringで指定した文字列全体を返します。

Option

オプションを指定します。

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

値 | 意味
Twice | 全角スペースも削除します。

説明

オプションが省略された場合，指定された文字列から先頭，および末尾の半角スペースを削除した文字列を返します。

オプションにTwiceが指定されている場合は，半角スペースだけでなく全角スペースも削除します。

例

' 変数string1と変数string2と変数string3には"ABC DEFG"が格納される。
Dim  string1 ,string2 ,string3
string1 = Trim ( "   ABC DEFG   " ,Twice )
string2 = Trim ( "      ABC DEFG" ,Twice )
string3 = Trim ( "ABC DEFG      " ,Twice )

対象バージョン

JP1/Script 05-00以降

8.3.13　文字列連結（+） （文字列連結を行う）

機能

二つの式に対して文字列の連結を行います。

形式

Result = Expression1 + Expression2

指定項目

Result

結果を受け取る変数名を指定します。

Expression1

任意の式を指定します。

Expression2

任意の式を指定します。

説明

式の内部処理形式により，+ 演算子の動作は次のように異なります。

条件 | 行われる演算
両方の式が文字 | 文字列連結
両方の式が数値 | 加算
両方の式が数値だけからなる文字列 | 加算※
一方の式が数値， 他方が文字列 | 文字列連結
一方の式が文字列， 他方が数値だけからなる文字列 | 文字列連結
一方の式が数値， 他方が数値だけからなる文字列 | 加算

両方の式がEmpty値のときは，演算結果Resultは数値0になります。ただし，一方の式だけがEmpty値のときは，他方の式がそのまま演算結果Resultとして返されます。

注※

文字列連結の場合は，& 演算子を使用してください。

補足

ResultとExpression1が同じ変数である場合，+= 演算子を使用して書き換えることができます。

例

' 変数result1には"ABCDEF"が格納される。
result1 = "ABC" + "DEF"

' 変数result2には12が格納される。
result2 = 7 + 5

対象バージョン

JP1/Script 01-00以降

8.3.14　文字列連結（&） （文字列連結を行う）

機能

二つの式に対して文字列連結を行います。

形式

Result = Expression1 & Expression2

指定項目

Result

結果を受け取る変数名を指定します。

Expression1

任意の式を指定します。

Expression2

任意の式を指定します。

説明

式の内部処理形式により，& 演算子の動作は次のようになります。

条件 | 行われる演算
両方の式が文字 | 文字列連結
両方の式が数値 | 文字列連結
両方の式が数値だけからなる文字列 | 文字列連結
一方の式が数値， 他方が文字列 | 文字列連結
一方の式が文字列， 他方が数値だけからなる文字列 | 文字列連結
一方の式が数値， 他方が数値だけからなる文字列 | 文字列連結

両方の式がEmpty値のときは，演算結果Resultは長さ0の文字列（""）になります。ただし，一方の式だけがEmpty値のときは，他方の式がそのまま演算結果Resultとして返されます。

補足

ResultとExpression1が同じ変数である場合，&= 演算子を使用して書き換えることができます。

例

' 変数result1には"ABCDEF"が格納される。
result1 = "ABC" & "DEF"

' 変数result2には75が格納される。
result2 = 7 & 5

対象バージョン

JP1/Script 06-00以降

8.3.15　文字列連結（&=） （変数と式の文字列連結を行う）

機能

変数の値と式の値に対して文字列連結を行い，連結した文字列を変数に代入します。

形式

Result &= Expression

指定項目

Result

結果を受け取る変数名を指定します。

Expression

任意の式を指定します。

説明

&= 演算子は変数Resultと式Expressionのすべての値を文字列とみなして文字列連結を行います。

両方の値がEmpty値のときは，変数ResultにはEmpty値が代入されます。変数ResultがEmpty値，または未定義のときは，式Expressionの値がそのまま変数Resultに代入されます。式Expressionの値がEmpty値のときは，変数Resultの値は変わりません。

例

' 変数result1には"ABCDEF"が格納される。
result1 = "ABC"
result1 &= "DEF"

' 変数result2には"01"が格納される。
result2 = 0
result2 &= 1

' 変数result3には"100"が格納される。
Dim  result3
result3 &= 100

対象バージョン

JP1/Script 06-51以降

8.3.16　AddStr （指定した連結文字で文字列連結を行う）

機能

指定された二つ以上の文字列に対して，指定された連結文字で区切った文字列連結を行い，連結した文字列を返します。

形式

AddStr ( 〔SeparateChar〕 , 〔Option〕 , String1 , String2 〔, String3 , …〕 )

指定項目

SeparateChar

連結文字を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，連結文字を挿入しません。

Option

オプションを指定します。

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

値 | 意味
NeedDq | String1～5で指定された文字列中に連結文字とみなされるコンマ，タブ，スペースを含んでいるときだけ文字列をダブルクォーテーションで囲みます。
AllDq | String1～5で指定された文字列を無条件にダブルクォーテーションで囲みます。

この値は省略できます。省略した場合，NeedDqを仮定します。

String1～5

連結する文字列を文字列，または値を格納した変数名で指定します。文字列は最大五つ指定できます。

説明

指定された複数の文字列に対して，指定された連結文字で区切った文字列連結を行い，連結した文字列を返します。連結した文字列の文字数が半角文字で1,024文字を超える場合，1,024文字で切り捨てられます。

例

' 変数string1には""コード  291" 価格 "3,000""が格納される。
Dim  string1
string1 = AddStr ( " " , ,"コード  291" ,"価格" ,"3,000" )

' 変数string2には""コード  291" "価格" "3,000""が格納される。
Dim  string2
string2 = AddStr ( " " ,AllDq ,"コード  291" ,"価格" ,"3,000" )

対象バージョン

JP1/Script 05-00以降

8.3.17　SeparateStrCount （文字列分割を行い，分割文字列の数を返す）

機能

指定された文字列に対して，指定された区切り文字で文字列分割を行い，分割した文字列の数を返します。

形式

SeparateStrCount ( String , SeparateChar )

指定項目

String

分割する文字列を文字列，または値を格納した変数名で指定します。

SeparateChar

区切り文字を文字列，または値を格納した変数名で指定します。

説明

指定された文字列に対して，指定された区切り文字で文字列分割を行い，分割した文字列の数を返します。

区切り文字が見つからないため分割できない場合は，1を返します。

区切り文字がStringの先頭や末尾にある場合は，その区切り文字の直前や直後に長さ0の文字列（""）があるものとして分割した文字列の数を返します。

また，Stringで指定した文字列が長さ0の文字列（""）である場合は，0を返します。

分割した文字列を取得するには，SeparateStrコマンドを使用します。

「分割する文字列」にn個のダブルクォーテーション（"）を文字としてそのまま含めるには，（n*8）個のダブルクォーテーション（"）を指定しなければなりません。

ただし，次のレジストリの値に2を設定した場合は，（n*2）個のダブルクォーテーション（"）を指定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

ParseDQ

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が無効となる（初期値）

2：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が有効となる

なお，〔値〕に1（SetGV，GetGV，DeleteGVコマンドを参照）と2の両方を指定する場合は3を指定してください。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' 変数count1には3が格納される。
Dim  count1
count1 = SeparateStrCount ( "JP1  Script  01-00,01-01" ,"  " )

' 変数count2には3が格納される。
Dim  count2 ,param
param  = """コード  100""  価格  300"
count2 = SeparateStrCount ( param ,"  " )

' 変数count3には4が格納される。
Dim  count3
count3 = SeparateStrCount ( "コード100;コード200;コード300;" ,";" )

対象バージョン

JP1/Script 05-00以降

8.3.18　SeparateStr （文字列分割を行い，分割文字列を返す）

機能

指定された文字列に対して，指定された区切り文字で文字列分割を行い，分割した文字列を返します。

形式

SeparateStr ( String , SeparateChar 〔, Position〕 )

指定項目

String

分割する文字列を文字列，または値を格納した変数名で指定します。

SeparateChar

区切り文字を文字列，または値を格納した変数名で指定します。

Position

分割した文字列の並びの先頭を1として，どの位置の文字列を取り出すかを先頭からの文字列位置で指定します。区切り文字は含みません。この値が分割した文字列の数よりも大きい場合は，長さ0の文字列（""）が返されます。

この値は省略できます。省略した場合，1を仮定します。

説明

指定された文字列に対して，指定された区切り文字で文字列分割を行い，指定された位置の分割した文字列を返します。

区切り文字が2文字以上連続している場合に分割した文字列は長さ0の文字列（""）になります。

分割した文字列の数を取得するには，SeparateStrCountコマンドを使用します。

「分割する文字列」にn個のダブルクォーテーション（"）を文字としてそのまま含めるには，（n*8）個のダブルクォーテーション（"）を指定しなければなりません。

ただし，次のレジストリの値に2を設定した場合は，（n*2）個のダブルクォーテーション（"）を指定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX

〔値名〕

ParseDQ

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が無効となる（初期値）

2：パラメタ文字列にn個のダブルクォーテーション（"）を含む場合，（n*2）個のダブルクォーテーション（"）の指定が有効となる

なお，〔値〕に1（SetGV，GetGV，DeleteGVコマンドを参照）と2の両方を指定する場合は3を指定してください。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' 変数string1には"01-00,01-01"が格納される。
Dim  string1
string1 = SeparateStr ( "JP1  Script  01-00,01-01" ,"  " ,3 )

' 変数string2には長さ0の文字列""が格納される。
Dim  string2
string2 = SeparateStr ( "JP1,Script,01-00,,01-01" ,"," ,4 )

対象バージョン

JP1/Script 05-00以降

8.3.19　Str （値を文字列で返す）

機能

指定された数値を文字列で返します。

形式

Str ( Number )

指定項目

Number

文字列に変換する数値，または値を格納した変数名で指定します。

この値に文字列を指定した場合は，Numberで指定した値をそのまま返します。

説明

指定された数値を文字列で返します。

例

' 変数string1には2が格納される。
Dim  string1
string1 = 1 + 2 - 1

' 変数string2には"12-1"が格納される。
Dim  string2
string2 = Str ( 1 ) + Str ( 2 ) + Str ( -1 )

' 変数string3には11が格納される。
Dim  string3
string3 = Str ( 1 ) + 2 - 1

対象バージョン

JP1/Script 05-20以降

8.3.20　Format （値を書式化した文字列を返す）

機能

指定された値を書式化した文字列で返します。

形式

Format ( Form , Arg1 〔, Arg2 , …〕 )

指定項目

Form

Arg1～32で指定された値をどのように書式化するかを文字列，または値を格納した変数名で指定します。

Formの中身の文字はそのまま表され，書式化の指示の始まりは % で指定します。

この値は次のような指定の組み合わせになります。

指定
意味

%d
数値を10進数で表す

%x
数値を16進数（小文字）で表す

%X
数値を16進数（大文字）で表す

%o
数値を8進数で表す

%s
文字列をそのまま表す

%c
1文字をそのまま表す
なお，全角文字も半角文字も同じ1文字となる。また，Arg1～32で指定された書式化する値が2文字以上の場合でも，先頭の1文字だけ表す。

%5d ， %10s など
書式化する値の最大桁数を指定する

%05d
書式化する値の最大桁数を指定する場合に，最大桁数に満たないときは前ゼロで埋める

%-5d ， %-10s など
値を左詰で表す

なお，%を書式化の指示の始まりではなく，文字として表す場合は %% と指定します。

Arg1～32

書式化する値を文字列，数値，または値を格納した変数名で指定します。Formで指定された書式の順に複数の値を指定できます。

説明

指定された値を書式化した文字列で返します。

例

' グローバル変数seqNoの値を前ゼロ5桁の10進数に変換して，
' パラメタとして実行ファイルABC.EXEへ渡す。
' 例えば，seqNoの値が"1"の場合は，パラメタ"00001"を渡す。
Dim  numID ,strID
numID = GetGV ( "seqNo" )
If  IsEmpty ( numID )  Then
 numID = 1
End If

strID = Format ( "%05d" ,numID )
Exec ( _SCF_+"ABC.EXE" ,True ,strID )

対象バージョン

JP1/Script 05-20以降

8.3.21　IsLower （半角アルファベットの小文字かどうかを調べる）

機能

指定された文字列が半角アルファベットの小文字かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsLower ( String )

指定項目

String

調べる文字列，または値を格納した変数名を指定します。

この値に長さ0の文字列（""）を指定した場合は，偽（False）を返します。

説明

指定された文字列のすべての文字が半角アルファベットの小文字かどうかを調べ，結果をコマンドの実行結果として返します。すべての文字が半角アルファベットの小文字である場合は真（True）を，それ以外の場合は偽（False）を返します。

例1

' グローバル変数Levelの値が半角アルファベットの
' "a"または"A"のどちらかをチェックする。
Dim  buff
buff = GetGV ( "Level" )
If  buff = "A"  Then
 If  IsLower ( buff )  Then
   MessageBox ( "Level ：Small A." )
 Else
   MessageBox ( "Level ：Large A." )
 End If
End If

例2

' ローカル変数buffに格納された文字列が
' 半角アルファベットの小文字かどうかをチェックする。
Dim buff
buff =  "script"
If IsLower ( buff ) Then
 MessageBox ( "すべての文字が半角アルファベットの小文字である。" )
Else
 MessageBox ( "半角アルファベットの小文字以外の文字が含まれている" )
End If

対象バージョン

JP1/Script 06-00以降

8.3.22　IsUpper （半角アルファベットの大文字かどうかを調べる）

機能

指定された文字列が半角アルファベットの大文字かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsUpper ( String )

指定項目

String

調べる文字列，または値を格納した変数名を指定します。

この値に長さ0の文字列（""）を指定した場合は，偽（False）を返します。

説明

指定された文字列のすべての文字が半角アルファベットの大文字かどうかを調べ，結果をコマンドの実行結果として返します。すべての文字が半角アルファベットの大文字である場合は真（True）を，それ以外の場合は偽（False）を返します。

例1

' グローバル変数Levelの値が半角アルファベットの
' "A"または"a"のどちらかをチェックする。
Dim  buff
buff = GetGV ( "Level" )
If  buff = "A"  Then
 If IsUpper ( buff ) Then
   MessageBox ( "Level ： Large A." )
 Else
   MessageBox ( "Level ： Small A." )
 End If
End If

例2

' ローカル変数buffに格納された文字列が
' 半角アルファベットの大文字かどうかをチェックする。
Dim buff
buff = "SCRIPT"
If IsUpper ( buff ) Then
   MessageBox ( "すべての文字が半角アルファベットの大文字である。" )
Else
   MessageBox ( "半角アルファベットの大文字以外の文字が含まれている。" )
End If

対象バージョン

JP1/Script 06-00以降

8.3.23　IsSingleChar （半角文字かどうかを調べる）

機能

指定された文字列が半角文字かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsSingleChar ( String )

指定項目

String

調べる文字列，または値を格納した変数名を指定します。

この値に長さ0の文字列（""）を指定した場合は，偽（False）を返します。

説明

指定された文字列のすべての文字が半角文字かどうかを調べ，結果をコマンドの実行結果として返します。すべての文字が半角文字である場合は真（True）を，それ以外の場合は偽（False）を返します。

例1

' グローバル変数seqNoの値を判定し，半角文字の場合は"#"，
' 全角文字の場合は"項番"に続けて表示する。
Dim  buff
buff = GetGV ( "seqNo" )
If  IsSingleChar ( buff )  Then
 MessageBox ( "#" + buff )
Else
 MessageBox ( "項番" + buff )
End If

例2

' ローカル変数buffに格納された文字列が半角文字かどうかをチェックする。
Dim  buff
buff = "JP1/Script"
If  IsSingleChar ( buff )  Then
 MessageBox ( "すべての文字が半角文字である。" )
Else
 MessageBox ( "半角文字以外の文字が含まれている。" )
End If

対象バージョン

JP1/Script 06-00以降

8.3.24　IsMultiChar （全角文字かどうかを調べる）

機能

指定された文字列が全角文字かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsMultiChar ( String )

指定項目

String

調べる文字列，または値を格納した変数名を指定します。

この値に長さ0の文字列（""）を指定した場合は，偽（False）を返します。

説明

指定された文字列のすべての文字が全角文字かどうかを調べ，結果をコマンドの実行結果として返します。すべての文字が全角文字である場合は真（True）を，それ以外の場合は偽（False）を返します。

例1

' グローバル変数seqNoの値を判定し，全角文字の場合は"項番"，
' 半角文字の場合は"#"に続けて表示する。
Dim  buff
buff = GetGV ( "seqNo" )
If  IsMultiChar ( buff )  Then
 MessageBox ( "項番" + buff )
Else
 MessageBox ( "#" + buff )
End If

例2

' ローカル変数buffに格納された文字列が全角文字かどうかをチェックする。
Dim buff
buff = "ＪＰ１／ＳＣＲＩＰＴ"
If IsMultiChar ( buff ) Then
   MessageBox ( "すべての文字が全角文字である。" )
Else
   MessageBox ( "全角文字以外の文字が含まれている。" )
End If

対象バージョン

JP1/Script 06-00以降

8.4　日付操作コマンド

＜この節の構成＞

8.4.1　Date （現在の日付を返す）

8.4.2　Time （現在の時刻を返す）

8.4.3　Year （指定された日付の年を返す）

8.4.4　Month （指定された日付の月を返す）

8.4.5　Day （指定された日付の日を返す）

8.4.6　Weekday （指定された日付の曜日を返す）

8.4.7　Hour （指定された時刻の時を返す）

8.4.8　Minute （指定された時刻の分を返す）

8.4.9　Second （指定された時刻の秒を返す）

8.4.10　CalcDate （指定された日付に加算減算を行う）

8.4.11　CompDate （二つの日付を比較する）

8.4.12　GetDateCount （二つの日付の経過日数を取得する）

8.4.13　CalcTime （指定された時刻に加算減算を行う）

8.4.14　CompTime （二つの時刻を比較する）

8.4.15　GetTimeCount （二つの時刻の経過時間を取得する）

8.4.16　IsLeapYear （うるう年かどうかを調べる）

8.4.1　Date （現在の日付を返す）

機能

現在の日付を返します。

形式

Date

このコマンドに引数はありません。

説明

現在の日付をyyyy/mm/ddの形式で返します。

対象バージョン

JP1/Script 01-00以降

8.4.2　Time （現在の時刻を返す）

機能

現在の時刻を返します。

形式

Time

このコマンドに引数はありません。

説明

現在の時刻をhh:mm:ssの形式で返します。

対象バージョン

JP1/Script 01-00以降

8.4.3　Year （指定された日付の年を返す）

機能

指定された日付の年を表す値を4桁の数値で返します。

形式

Year ( 〔Date〕 )

指定項目

Date

日付をyyyy/mm/ddの形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。例えば，1999/12/32（実在しない日付）を指定した場合，2000/01/01（実在する日付）に置き換えて，2000を返します。

この値は省略できます。省略した場合，現在の日付を仮定します。

説明

指定された日付の年を表す値を4桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.4　Month （指定された日付の月を返す）

機能

指定された日付の月を表す値を1～12の範囲の1～2桁の数値で返します。

形式

Month ( 〔Date〕 )

指定項目

Date

日付をyyyy/mm/ddの形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えて，1を返します。

この値は省略できます。省略した場合，現在の日付を仮定します。

説明

指定された日付の月を表す値を1～12の範囲の1～2桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.5　Day （指定された日付の日を返す）

機能

指定された日付の日を表す値を1～31の範囲の1～2桁の数値で返します。

形式

Day ( 〔Date〕 )

指定項目

Date

日付をyyyy/mm/ddの形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えて，2を返します。

この値は省略できます。省略した場合，現在の日付を仮定します。

説明

指定された日付の日を表す値を1～31の範囲の1～2桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.6　Weekday （指定された日付の曜日を返す）

機能

指定された日付の曜日を表す値を1（日曜）～7（土曜）の範囲の1桁の数値，または曜日を表す文字列で返します。

形式

Weekday ( 〔Date〕 〔, Option〕 )

指定項目

Date

日付をyyyy/mm/ddの形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。

例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えて，1（日曜）を返します。

この値は省略できます。省略した場合，現在の日付を仮定します。

Option

オプションを指定します。

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

値 | 意味
String | 曜日を表す値をアルファベットの文字列で返します。
StringJ | 曜日を表す値を日本語の文字列で返します。

説明

オプションが省略された場合，指定された日付の曜日を表す値を1（日曜）～7（土曜）の範囲の1桁の数値で返します。

この場合，コマンドは次のどれかの値を返します。

値 | 内容
1 | 日曜
2 | 月曜
3 | 火曜
4 | 水曜
5 | 木曜
6 | 金曜
7 | 土曜

オプションが指定されている場合，指定された日付の曜日を表す値を文字列で返します。

この場合，コマンドは次のどれかの値を返します。

Stringを指定 | StringJを指定 | 内容
"SUN" | "日" | 日曜
"MON" | "月" | 月曜
"TUE" | "火" | 火曜
"WED" | "水" | 水曜
"THU" | "木" | 木曜
"FRI" | "金" | 金曜
"SAT" | "土" | 土曜

対象バージョン

JP1/Script 01-00以降

8.4.7　Hour （指定された時刻の時を返す）

機能

指定された時刻の時を表す値を0～23の範囲の1～2桁の数値で返します。

形式

Hour ( 〔Time〕 )

指定項目

Time

時刻をhh:mm:ssの形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。

例えば，19:61:00（実在しない時刻）を指定した場合，20:01:00（実在する時刻）と置き換えて，20を返します。

この値は省略できます。省略した場合，現在の時刻を仮定します。

説明

指定された時刻の時を表す値を0～23の範囲の1～2桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.8　Minute （指定された時刻の分を返す）

機能

指定された時刻の分を表す値を0～59の範囲の1～2桁の数値で返します。

形式

Minute ( 〔Time〕 )

指定項目

Time

時刻をhh:mm:ssの形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。実在する時刻を置き換えて結果を返します。

例えば，19:61:00（実在しない時刻）を指定した場合，20:01:00（実在する時刻）と置き換えて，1を返します。

この値は省略できます。省略した場合，現在の時刻を仮定します。

説明

指定された時刻の分を表す値を0～59の範囲の1～2桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.9　Second （指定された時刻の秒を返す）

機能

指定された時刻の秒を表す値を0～59の範囲の1～2桁の数値で返します。

形式

Second ( 〔Time〕 )

指定項目

Time

時刻をhh:mm:ssの形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。実在する時刻を置き換えて結果を返します。

例えば，19:00:65（実在しない時刻）を指定した場合，19:01:05（実在する時刻）と置き換えて，5を返します。

この値は省略できます。省略した場合，現在の時刻を仮定します。

説明

指定された時刻の秒を表す値を0～59の範囲の1～2桁の数値で返します。

対象バージョン

JP1/Script 01-00以降

8.4.10　CalcDate （指定された日付に加算減算を行う）

機能

指定された年数，月数，日数を，指定された日付に足したり，指定された日付から引いたりして求めた日付を返します。

形式

CalcDate ( Date , Calc , 〔Years〕 , 〔Months〕 〔, Days〕 )

指定項目

Date

日付を yyyy/mm/dd の形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。

例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えます。

Calc

演算方法を指定します。

この値は，次のどれかになります。

値 | 意味
Minus | Dateで指定された日付から，Years，Months，Days で指定された年数，月数，日数を引いた日付を返します。（減算）
Plus | Dateで指定された日付に，Years，Months，Days で指定された年数，月数，日数を足した日付を返します。（加算）

Years

年数を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

Months

月数を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

Days

日数を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

説明

指定された年数，月数，日数を，指定された日付に足したり，指定された日付から引いたりして求め，yyyy/mm/dd の形式で日付を返します。

求めた日付が存在しない日付になった場合，その日付以降の存在する日付を返します。例えば，求めた日付が1999/02/29（存在しない日付）になった場合，1999/03/01（存在する日付）を返します。

エラーが発生した場合は，長さ0の文字列（""）を返します。

例

' 本日から10日前の日付を表示する。
Dim  result1
result1 = CalcDate ( Date() ,Minus , , ,10 )
MessageBox ( "今日から10日前は"+result1+"です。" )

対象バージョン

JP1/Script 05-20以降

8.4.11　CompDate （二つの日付を比較する）

機能

指定された二つの日付を比較して，結果を真（True），または偽（False）で返します。

形式

CompDate ( Date1 , Comp , Date2 )

指定項目

Date1

比較する一方の日付を yyyy/mm/dd の形式で指定します。yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。

例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えます。

Comp

比較方法を指定します。

この値は，次のどれかになります。

値 | 意味
Equal | 等しい（ = ）
NotEqual | 等しくない（ < > ）
Before | Date1より，Date2の方が前の日付である（ > ）
After | Date1より，Date2の方が後の日付である（ < ）

Date2

比較するもう一方の日付をyyyy/mm/ddの形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。また，mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合は，実在する日付に置き換えます。

説明

二つの日付をCompで指定された方法で比較し，結果をコマンドの実行結果として返します。比較結果がCompで指定した値と一致する場合は真（True）を，それ以外の場合は偽（False）を返します。

エラーが発生した場合は，長さ0の文字列（""）を返します。

例

' 30日以上前に作成された一時フォルダ下のファイルを削除する。
Dim  fileName ,delDate ,creDate
delDate = CalcDate ( Date() ,Minus ,0 ,0 ,29 )

For  fileName = _TEMP_+"*.*"  Do
 GetFileTime ( _TEMP_+fileName ,creDate , ,Create )

 If  CompDate ( creDate ,After ,deldate ) = True  Then
   DeleteFile ( _TEMP_+fileName )
 End If
End For

対象バージョン

JP1/Script 05-20以降

8.4.12　GetDateCount （二つの日付の経過日数を取得する）

機能

指定された二つの日付の経過日数を取得します。

形式

GetDateCount ( StartDate , EndDate 〔, UnitofDate〕 )

指定項目

StartDate

経過日数を求めるときの開始日付を yyyy/mm/dd の形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合はエラーになりません。実在する日付に置き換えて結果を返します。

例えば，1999/12/33（実在しない日付）を指定した場合，2000/01/02（実在する日付）に置き換えます。

EndDate

経過日数を求めるときの終了日付を yyyy/mm/dd の形式で指定します。

yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。また，mmに不正な値を指定した場合はエラーになりますが，ddに不正な値を指定した場合は，実在する日付に置き換えます。

UnitofDate

取得する経過日数の単位を指定します。

この値には，次のどれかを指定します。

値
意味

YearU
年の単位で取得します。
例えば，開始日付が1998/4/1で，終了日付が1999/4/1である場合は1になり，終了日付が1999/3/1である場合は0になります。

MonthU
月の単位で取得します。
例えば，開始日付が1998/4/10，終了日付が1998/5/10である場合は1になり，終了日付が1998/5/9である場合は0になります。

DayU
日の単位で取得します。

この値は省略できます。省略した場合，DayUを仮定します。

説明

指定された二つの日付の経過日数を取得し，コマンドの実行結果として返します。StartDateで指定された日付がEndDateで指定された日付よりもあとの日付である場合，経過日数は負の値になります。

例

' 1998年4月1日から1999年3月31日までの経過日数を年,月,日の単位で求める。
Dim  date1 ,date2 ,yBuff ,mBuff ,dBuff
date1 = "1998/4/1"
date2 = "1999/3/31"

' yBuffには0,mBuffには11,dBuffには364が格納される。
yBuff = GetDateCount ( date1 ,date2 ,YearU )
mBuff = GetDateCount ( date1 ,date2 ,MonthU )
dBuff = GetDateCount ( date1 ,date2 ,DayU )

対象バージョン

JP1/Script 05-20以降

8.4.13　CalcTime （指定された時刻に加算減算を行う）

機能

指定された時刻に，指定された時，分，または秒を足したり引いたりした時刻を返します。

形式

CalcTime ( Time , Calc , 〔Hours〕 , 〔Minutes〕 , 〔Seconds〕 〔, DaysBuff〕 )

指定項目

Time

時刻を hh:mm:ss の形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。実在する時刻に置き換えます。

例えば，19:00:65（実在しない時刻）を指定した場合，19:01:05（実在する時刻）と置き換えます。

Calc

演算方法を指定します。

この値には，次のどれかを指定します。

値 | 意味
Minus | Timeで指定された時刻から，Hours，Minutes，Secondsで指定された時，分，秒を引いた日付を返します。（減算）
Plus | Timeで指定された時刻に，Hours，Minutes，Secondsで指定された時，分，秒を足した日付を返します。（加算）

Hours

時を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

Minutes

分を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

Seconds

秒を0以上の数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

DaysBuff

求めた時刻がTimeで指定された時刻から日をまたがった場合，またがった日を受け取る変数名を指定します。必要がない場合は省略します。

日のまたがりが無い場合，0を返します。

説明

指定された時刻に，指定された時，分，または秒を足したり引いたりした時刻を求め，求めた時刻を hh:mm:ss の形式で返します。

エラーが発生した場合は，長さ0の文字列（""）を返します。

例

' スクリプトファイルを現在の時刻から7時間45分後に自動起動するように
' 登録する。
Dim  resTime ,resdate ,daysBuff
resTime = CalcTime ( Time() ,Plus ,7 ,45 , ,daysBuff )
resDate = CalcDate ( Date() , Plus , , ,daysBuff )
EntryStartUp ( _SCF_+"ABC.SPT" , , ,resTime , ,Day(resDate) )

対象バージョン

JP1/Script 05-20以降

8.4.14　CompTime （二つの時刻を比較する）

機能

指定された二つの時刻を比較して，結果を真（True），または偽（False）で返します。

形式

CompTime ( Time1 , Comp , Time2 )

指定項目

Time1

比較する一方の時刻を hh:mm:ss の形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。実在する時刻に置き換えます。

例えば，19:00:65（実在しない時刻）を指定した場合，19:01:05（実在する時刻）と置き換えます。

Comp

比較方法を指定します。

この値は，次のどれかになります。

値 | 意味
Equal | 等しい（ = ）
NotEqual | 等しくない（ <> ）
Before | Time1より，Time2の方が前の時刻である（ > ）
After | Time1より，Time2の方が後の時刻である（ < ）

Time2

比較するもう一方の日付を hh:mm:ss の形式で指定します。

mmとssに不正な値を指定した場合は，実在する時刻に置き換えます。

説明

二つの時刻をCompで指定された方法で比較し，結果をコマンドの実行結果として返します。比較結果がCompで指定された値と一致する場合は真（True）を，それ以外の場合は偽（False）を返します。

エラーが発生した場合は，長さ0の文字列（""）を返します。

例

' 作成時間が今日の午前中のファイルを削除する。
Dim  fileName ,creDate ,creTime

For  fileName = _TEMP_+"*.*"  Do
 GetFileTime ( _TEMP_+fileName ,creDate ,creTime ,Create )
 If  CompDate ( creDate ,Equal ,Date() )  Then
   If  CompTime ( creTime ,After ,"12:00:00" ) = True  Then
     DeleteFile ( _TEMP_+fileName )
   End If
 End If
End For

対象バージョン

JP1/Script 05-20以降

8.4.15　GetTimeCount （二つの時刻の経過時間を取得する）

機能

指定された二つの時刻の経過時間を取得します。

形式

GetTimeCount ( StartTime , EndTime 〔, UnitofTime〕 )

指定項目

StartTime

経過時間を求めるときの開始時刻を hh:mm:ss の形式で指定します。

hhに不正な値を指定した場合はエラーになりますが，mmとssに不正な値を指定した場合はエラーになりません。実在する時刻に置き換えます。

例えば，19:00:65（実在しない時刻）を指定した場合，19:01:05（実在する時刻）と置き換えます。

EndTime

経過時間を求めるときの終了時刻を hh:mm:ss の形式で指定します。

mmとssに不正な値を指定した場合は，実在する時刻に置き換えます。

UnitofTime

取得する経過時間の単位を指定します。

この値には，次のどれかを指定します。

値
意味

HourU
時の単位で取得します。
例えば，開始時刻が9:00:00で，終了時刻が10:00:00である場合は1になり，終了時刻が9:59:59である場合は0になります。

MinuteU
分の単位で取得します。
例えば，開始時刻が9:10:00，終了時刻が9:11:00である場合は1になり，終了時刻が9:10:59である場合は0になります。

SecondU
秒の単位で取得します。

この値は省略できます。省略した場合，SecondUを仮定します。

説明

指定された二つの時刻の経過時間を取得し，コマンドの実行結果として返します。StartTimeで指定され時刻がEndTimeで指定された時刻よりも後の時刻である場合，経過時間は負の値になります。

例

' 9:10:30から10:09:20までの経過時間を時,分,秒の単位で求める。
Dim  time1 ,time2 ,hBuff ,mBuff ,sBuff
time1 = "9:10:30"
time2 = "10:09:20"

' hBuffには0,mBuffには58,sBuffには3530が格納される。
hBuff = GetTimeCount ( time1 ,time2 ,HourU )
mBuff = GetTimeCount ( time1 ,time2 ,MinuteU )
sBuff = GetTimeCount ( time1 ,time2 ,SecondU )

対象バージョン

JP1/Script 05-20以降

8.4.16　IsLeapYear （うるう年かどうかを調べる）

機能

指定された西暦年がうるう年かどうかを調べ，結果を真（True），または偽（False）で返します。

形式

IsLeapYear ( Year )

指定項目

Year

西暦年を数値，または値を格納した変数名で指定します。

西暦年に0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

説明

指定された西暦年がうるう年かどうかを調べ，結果をコマンドの実行結果として返します。うるう年である場合には真（True）を，うるう年でない場合には偽（False）を返します。

例

' 今年がうるう年かどうかを調べる。
Dim  nowYear
nowYear = Year ( Date() )
If  IsLeapYear ( nowYear ) Then
 MessageBox ( "今年はうるう年です。" )
Else
 MessageBox ( "今年はうるう年ではありません。" )
End If

対象バージョン

JP1/Script 05-20以降

8.5　ファイル・フォルダ操作コマンド

＜この節の構成＞

8.5.1　IniRead （初期化ファイルから値を読み込む）

8.5.2　IniWrite （初期化ファイルに値を登録する）

8.5.3　TextFileReplace （テキストファイルの文字列を置き換える）

8.5.4　TextOpen （テキストファイルをオープンする）

8.5.5　TextClose （テキストファイルをクローズする）

8.5.6　TextRead （テキストファイルから1行分のデータを読み込む）

8.5.7　TextWrite （テキストファイルにデータを書き込む）

8.5.8　TextSeek （読み書き開始位置を先頭または末尾に移動する）

8.5.9　GetTextPosition （読み書きの開始位置を返す）

8.5.10　MakeDir （フォルダを作成する）

8.5.11　DeleteDir （フォルダを削除する）

8.5.12　DeleteFile （ファイルを削除する）

8.5.13　Rename （ファイル名を変更する）

8.5.14　TempDir （一時フォルダを取得する）

8.5.15　TempFile （一時ファイル名を作成する）

8.5.16　SetFileAttributeまたはSetFileAttr （フォルダ／ファイルの属性を設定する）

8.5.17　GetFileAttributeまたはGetFileAttr （フォルダ／ファイルの属性を取得する）

8.5.18　SetFileTime （ファイルの日付と時刻を設定する）

8.5.19　GetFileTime （ファイルの日付と時刻を取得する）

8.5.20　GetFileSize （ファイルの容量を取得する）

8.5.21　GetVersionInfoまたはGetVerInfo （ファイルのバージョン情報を取得する）

8.5.22　SplitFile （ファイルを分割する）

8.5.23　CatFiles （ファイルを統合する）

8.5.24　SetStandardFileまたはSetStdFile （標準入力・出力・エラーファイルを設定する）

8.5.25　ResetStandardFileまたはResetStdFile （標準入力・出力・エラーファイルを解除する）

8.5.26　SplitPath （フルパスを解析する）

8.5.27　MakePath （フルパスを作成する）

8.5.28　SetPath （実行フォルダのパスを設定する）

8.5.29　GetPath （実行フォルダのパスを取得する）

8.5.30　SetVolumeLabelまたはSetVolLabel （ボリュームラベルを設定する）

8.5.31　GetVolumeLabelまたはGetVolLabel （ボリュームラベルを取得する）

8.5.32　GetDiskFreeSpace （ディスク空き容量を取得する）

8.5.33　Copy （ファイルをコピーする）

8.5.1　IniRead （初期化ファイルから値を読み込む）

機能

初期化ファイル（.INIファイル）から値を読み込みます。

形式

IniRead ( FilePath , SectionName , ValueBuff , EntryName )

指定項目

FilePath

初期化ファイル名のフルパスを文字列，または値を格納した変数名で指定します。

SectionName

セクション名を文字列，または値を格納した変数名で指定します。

ValueBuff

読み込まれた値を受け取る変数名を指定します。

EntryName

エントリ名を文字列，数値，または値を格納した変数名で指定します。

説明

指定された初期化ファイル（.INIファイル）の特定のセクションから，エントリされている値を読み込み，指定された変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

FilePathで指定された初期化ファイル，またはSectionNameで指定された初期化ファイルの特定のセクションが存在しない場合は，ValueBuffで指定された変数に長さ0 の文字列（""）を格納し，コマンドの実行結果に真（True）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下の初期化ファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

エントリされている値が1,025バイト以上の場合，変数には1,024バイトまでしか格納されません。値が1,025バイト以上のエントリを読み込まないようにしてください。

例

起動フォルダ下の初期化ファイル"ABC.INI"の内容が次のような場合,

以下のスクリプトで内容が読み込める。

; ABC.INI
[Files]
File01=Readme.txt
File02=Abc.exe

' スクリプトファイル
' 1行目で変数file1に"Readme.txt"が格納される。
' 2行目で変数file2に"Abc.exe"が格納される。
Dim  file1 ,file2
IniRead ( _BIN_+"ABC.INI" ,"Files" ,file1 ,"File01" )
IniRead ( _BIN_+"ABC.INI" ,"Files" ,file2 ,"File02" )

対象バージョン

JP1/Script 01-00以降

8.5.2　IniWrite （初期化ファイルに値を登録する）

機能

初期化ファイル（.INIファイル）に値を登録します。

形式

IniWrite ( FilePath , SectionName , EntryName , Value )

指定項目

FilePath

初期化ファイル名のフルパスを文字列，または値を格納した変数名で指定します。

SectionName

セクション名を文字列，または値を格納した変数名で指定します。

EntryName

エントリ名を文字列，数値，または値を格納した変数名で指定します。

Value

登録する値を文字列，数値，または値を格納した変数名で指定します。

説明

指定された初期化ファイルの特定のセクションに値を登録します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

FilePathで指定された初期化ファイルが存在しない場合は，ファイルを新規作成します。また，SectionNameで指定された初期化ファイルの特定のセクションが存在しない場合は，セクションを新規作成します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下の初期化ファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

初期化ファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

次のようなスクリプトでWindowsフォルダ下の初期化ファイル"ABC.INI"に情報を書き込める。

' スクリプトファイル
IniWrite ( _WIN_+"ABC.INI" ,"Files" ,"File01" ,"Readme.txt")
IniWrite ( _WIN_+"ABC.INI" ,"Files" ,"File02" ,"Abc.exe")

; ABC.INI
[Files]
File01 = Readme.txt
File02 = Abc.exe

対象バージョン

JP1/Script 01-00以降

8.5.3　TextFileReplace （テキストファイルの文字列を置き換える）

機能

テキストファイルの中の特定の文字列を置き換えます。

形式

TextFileReplace ( FileName , OldText , NewText 〔, ReplaceCntBuff〕 )

指定項目

FileName

テキストファイル名を文字列，または値を格納した変数名で指定します。

ファイル名の拡張子が省略された場合，自動的に拡張子（.TXT）を付加します。ただし，ファイル名の末尾が拡張子のピリオド（ . ）である場合，JP1/Script 06-00以降では，拡張子のないファイル名とみなします。

OldText

変更前文字列を文字列，または値を格納した変数名で指定します。

NewText

変更後文字列を文字列，または値を格納した変数名で指定します。

ReplaceCntBuff （06-00以降）

置き換えた文字列の数を受け取る変数名を指定します。必要がない場合は省略します。

説明

指定された変更前文字列をテキストファイルから検索し，別の文字列に置き換えます。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

ラージファイルには，使用できません。ファイル分割（SplitFile）から，使用してください。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

変換前文字列に改行コードを指定してもファイル中の改行コードは変換後文字列に変換されません。

例

ABC.TXTファイルに対して，次のTextFileReplaceコマンドを実行する。

TextFileReplace ( _BIN_+"ABC.TXT" ,"テスト" ,"test" )

[実行前のABC.TXTファイルの内容]

**********
**テスト**
**********

[実行後のABC.TXTファイルの内容]

**********
**test**
**********

対象バージョン

JP1/Script 01-00以降

8.5.4　TextOpen （テキストファイルをオープンする）

機能

テキスト形式ファイルをオープンします。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

TextOpen ( FilePath 〔, Mode〕 )

指定項目

FilePath

テキスト形式ファイル名のフルパスを文字列，または値を格納した変数名で指定します。

ファイル名の拡張子が省略された場合，自動的に拡張子（.TXT）を付加します。ただし，ファイル名の末尾が拡張子のピリオド（ . ）である場合，JP1/Script 06-00以降では，拡張子のないファイル名とみなします。

Mode

ファイルオープン時の動作を指定します。

この値は次のどれかになります。

値 | 意味
Create | ファイルを無条件に作成
ReadOnly | ファイルを読み込みモードでオープン
WriteOnly | ファイルを書き込みモードでオープン
ReadWrite | ファイルを読み書きモードでオープン

ModeにReadOnlyを指定した場合は共用モードで，Cretate，WriteOnly，およびReadWriteを指定した場合は排他モードでオープンします。

この値は省略できます。省略した場合，Createを仮定します。

説明

指定されたテキスト形式ファイルをオープンします。コマンドが正常に実行された場合はファイル識別子を，エラーが発生した場合は0を，コマンドの実行結果として返します。

またコマンドが正常に実行された場合は，現在の読み書き開始位置は先頭の0になります。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

テキスト形式ファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' Loging.txtを読み込み，その内容をダイアログボックスに表示する。
Dim  file1
file1 = TextOpen ( _BIN_+"Loging.txt" ,ReadOnly )
If  file1 = 0  Then
 MessageBox ( _BIN_+"Loging.txtのオープンに失敗" ,OK )
Else
 Dim  buff1
 If  TextRead ( file1 ,buff1 )  Then
   MessageBox ( buff1,OK )
 End

 TextClose ( file1 )
End

対象バージョン

JP1/Script 05-00以降

8.5.5　TextClose （テキストファイルをクローズする）

機能

テキスト形式ファイルをクローズします。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

TextClose ( 〔FileId〕 )

指定項目

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

この値は省略できます。省略，または0の場合，オープン中のファイルをすべてクローズします。

説明

指定されたファイル識別子のテキスト形式ファイルをクローズします。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

' Loging.txtを読み込み，その内容をBackup.txtに書き込む。
Dim  file1 ,file2
file1 = TextOpen ( _BIN_+"Loging.txt" ,ReadOnly )
If  file1 = 0  Then
 MessageBox ( _BIN_+"Loging.txtのオープンに失敗" ,OK )
 Exit
End
file2 = TextOpen ( _TEMP_+"Backup.txt" ,Create )
If  file2 = 0  Then
 MessageBox ( _TEMP_+"Backup.txtのオープンに失敗" ,OK )
 TextClose ( file1 )
 Exit
End

Dim  buff1
If  TextRead ( file1 ,buff1 )  Then
 TextWrite ( file2 ,buff1 )
End
TextClose ( file1 )
TextClose ( file2 )

対象バージョン

JP1/Script 05-00以降

8.5.6　TextRead （テキストファイルから1行分のデータを読み込む）

機能

テキスト形式ファイルから1行分のデータを読み込みます。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

TextRead ( FileId , Buff )

指定項目

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

なお，TextOpenコマンドのファイルオープン時の動作には，WriteOnly（ファイルを書き込みモードでオープン）以外を指定してください。

Buff

読み込まれた1行分のデータを受け取る変数名を指定します。受け取るデータの文字数が半角文字で1,024文字を超える場合，1,024文字で切り捨てられます。

説明

指定されたファイル識別子のテキスト形式ファイルの現在の読み書き開始位置から1行分のデータを読み込み，指定された変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

コマンドの実行結果が真（True）の場合は，読み書き開始位置は次行になります。

また，ファイルの終わりに達した場合はコマンドの実行結果に偽（False）を返し，_RTN_予約変数には_ERR_EOF_予約変数と等しい値が設定されます。しかし，On Errorステートメントで指定したラベルには分岐しません。

注意

TextReadコマンドでファイルの終わりに達した場合，JP1/Scriptではコマンド実行時に異常が発生した場合と同じようにエラーとして処理します。したがって，スクリプト処理が正常終了した場合でも，実行トレースログにはエラーとして記録されます。また，トレースビューア上での表示が異常終了となるので，TextReadコマンドのEOF検出でのエラーは無視してください。

また，TextReadコマンドで読み込まれた1行分のデータを受け取る変数には，直前まで格納していた値が格納されているので，EOF検出後に変数内容が未設定になる状態を期待する処理は作り込まないでください。

例

' 実行フォルダ下のテキストファイル"Loging.txt"の内容を,
' 以下のスクリプトで1行づつ読込み内容を表示する。

Dim  file1 ,buff1 ,readRtn

On Error GoTo ErrorBranch
 file1 = TextOpen ( _BIN_+"Loging.txt" ,ReadOnly )
 TextRead ( file1 ,buff1 )
 readRtn = _RTN_
 While  readRtn <> _ERR_EOF_
   MessageBox ( buff1 )
   TextRead ( file1 ,buff1 )
   readRtn = _RTN_
 End

TextClose ( file1 )
Exit ( 0 )

ErrorBranch:
 MessageBox ( _BIN_+"Loging.txtのファイル操作失敗" ,OK )
 TextClose ( file1 )
 Exit ( -1 )

対象バージョン

JP1/Script 05-00以降

8.5.7　TextWrite （テキストファイルにデータを書き込む）

機能

テキスト形式ファイルにデータを書き込みます。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

TextWrite ( FileId , Data , 〔NewLine〕 〔, Position〕 )

指定項目

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

なお，TextOpenコマンドのファイルオープン時の動作には，ReadOnly（ファイルを読み込みモードでオープン）以外を指定してください。

Data

書き込むデータを文字列，または値を格納した変数名で指定します。

NewLine

データを書き込んだ後に改行をするときには真（True）を，改行をしないときには偽（False）を指定します。

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

Position

ファイルの先頭を0とした読み書き開始位置を数値，または値を格納した変数名で指定します。指定できる値は0～2,147,483,647（単位：バイト）です。

この値は省略できます。省略した場合，現在の読み書き開始位置を仮定します。

ラージファイルの場合，2GB以上の位置を指定して書き込むことはできません。

説明

指定されたファイル識別子のテキスト形式ファイルに対して，データを現在の読み書き開始位置，または指定された読み書き開始位置から書き込みます。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

読み書き開始位置は，コマンドの実行結果が真（True）でNewLineに真（True）が指定してある場合は次行になり，NewLineに偽（False）が指定してある場合は書き込んだデータの直後になります。

注意

すでに存在するファイルに対してTextOpenコマンドのModeにWriteOnly，またはReadWriteを指定し，TextWriteコマンドを実行した場合，TextWriteコマンドは，単純に指定された文字数分の上書きを行います。したがって，出力する文字数（改行コードを含む）が既存ファイルより少ない場合，少ない文字数分，オープン前の内容がファイルに残ります。

例

実行フォルダ下のテキストファイル"Loging.txt"を作成する。

スクリプトファイル

 Dim  file1
 file1 = TextOpen ( _BIN_+"Loging.txt" ,Create )
 If  file1 = 0  Then
   MessageBox ( _BIN_+"Loging.txtのオープンに失敗" ,OK )
 Else
   TextWrite ( file1 ,"<< " + _COMP_ + " / " +  _USER_ + " >>" )
   TextWrite ( file1 , Date + " " + Time + " " ,False )
   TextWrite ( file1 ,"スクリプト実行開始" )
   TextClose ( file1)
 End

実行結果(Loging.txtの内容)

 << COMP01 / USER01 >>
 2011/08/31 11:57:22 スクリプト実行開始

対象バージョン

JP1/Script 05-00以降

8.5.8　TextSeek （読み書き開始位置を先頭または末尾に移動する）

機能

テキスト形式ファイルの読み書き開始位置をファイルの先頭，または最後に移動します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

TextSeek ( FileId 〔, Point〕 )

指定項目

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

なお，TextOpenコマンドのファイルオープン時の動作には，WriteOnly（ファイルを書き込みモードでオープン）以外を指定してください。

Point

読み書き開始位置を指定します。

この値は次のどれかになります。

値 | 意味
ToBegin | ファイルの先頭に移動します。
ToEnd | ファイルの最後に移動します。

この値は省略できます。省略した場合，ToBeginを仮定します。

説明

指定されたファイル識別子のテキスト形式ファイルに対して，読み書き開始位置を指定された位置に移動します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

' 実行フォルダ下のテキストファイル"Loging.txt"の
' 最後に"** END OF FILE **"と書き込む。
Dim  file1
file1 = TextOpen ( _BIN_+"Loging.txt" ,ReadWrite )
If  file1 = 0  Then
 MessageBox ( _BIN_+"Loging.txtのオープンに失敗" ,OK )
Else
 If  TextSeek ( file1 ,ToEnd )  Then
   TextWrite ( file1 ,"** END OF FILE **" ,False )
 End
 TextClose ( file1 )
End

対象バージョン

JP1/Script 05-00以降

8.5.9　GetTextPosition （読み書きの開始位置を返す）

機能

テキスト形式ファイルの現在の読み書き開始位置を返します。

形式

GetTextPosition ( FileId )

指定項目

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

説明

指定されたファイル識別子のテキスト形式ファイルの現在の読み書き開始位置を，先頭を0とした値をバイト単位で取得します。コマンドが正常に実行された場合は現在の読み書き開始位置を，エラーが発生した場合は長さ0の文字列（""）を，コマンドの実行結果として返します。

読み書き開始位置が2,147,483,647を超える場合は，エラーとなります。

例

' 実行フォルダ下のテキストファイル"Loging.txt"内の文字列
' "開始"を"スクリプト実行開始"に書き換える。
Dim  file1
file1 = TextOpen ( _BIN_+"Loging.txt" ,ReadWrite )
If  file1 = 0  Then
 MessageBox ( _BIN_+"Loging.txtのオープンに失敗" ,OK )
Else
 Dim  line ,position ,buff
 For  line = 1 To 10
   ' 読み書き開始位置を取得する
   position = GetTextPosition ( file1 )
   If  TextRead ( file1 ,buff )  Then
     If  buff = "開始"  Then
       ' 取得した読み書き開始位置に上書きする
       TextWrite ( file1 ,"スクリプト実行開始" ,True ,position )
     End
   Else
     Exit For
   End
 Next
 TextClose ( file1 )
End

対象バージョン

JP1/Script 05-00以降

8.5.10　MakeDir （フォルダを作成する）

機能

フォルダを作成します。

形式

MakeDir ( DirPath )

指定項目

DirPath

作成するフォルダパスを文字列，または値を格納した変数名で指定します。

説明

指定されたフォルダを作成します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定されたフォルダまでのパスが存在しない場合でも，途中のパスを作成してフォルダを作成します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

作成するフォルダにアクセス権限を設定できます。指定されたフォルダまでのパスがない場合，途中のパスの作成にも適用されます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' Windowsフォルダ下に"HITACHI"フォルダを作成する。
MakeDir ( _WIN_+"HITACHI" )

対象バージョン

JP1/Script 01-00以降

8.5.11　DeleteDir （フォルダを削除する）

機能

フォルダを削除します。

形式

DeleteDir ( DirPath 〔, Option〕 )

指定項目

DirPath

削除するフォルダパスを文字列，または値を格納した変数名で指定します。

Option （06-00以降）

オプションを指定します。

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

値
意味

Anyway
フォルダの中身が空の場合も空でない場合も中身ごとフォルダを削除します。

IfEmpty
フォルダの中身が空の場合はフォルダを削除し，空でない場合はフォルダを削除しません。
なお，フォルダを削除しなかった場合，偽（False）をコマンドの実行結果として返します。

この値は省略できます。省略した場合，Anywayを仮定しますので注意が必要です。

説明

指定されたフォルダを削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

また，指定されたフォルダが存在しない場合は，常に真（True）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

オプションにIfEmptyの指定がない場合，フォルダの中身が空ではなくても，中身ごとフォルダを削除してしまいます。使用する場合は十分に注意してください。

例

' Windowsフォルダ下の"HITACHI"フォルダを無条件に削除する。
DeleteDir ( _WIN_+"HITACHI" )

' Windowsフォルダ下の"HITACHI"フォルダ下が空であれば削除する。
DeleteDir ( _WIN_+"HITACHI" ,IfEmpty )

対象バージョン

JP1/Script 01-00以降

8.5.12　DeleteFile （ファイルを削除する）

機能

ファイルを削除します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

DeleteFile ( PathName 〔, Option〕 )

指定項目

PathName

削除するフォルダ，またはファイルのフルパスを文字列，または値を格納した変数名で指定します。ファイル名にワイルドカードを指定することもできます。

Option （05-10以降）

オプションを指定します。

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

値 | 意味
ExclDir | PathNameで指定されたフォルダ下のファイルだけを削除し，フォルダは残します。

説明

指定されたフォルダ，またはファイルを削除します。オプションが省略された場合，フォルダの中身が空ではなくても，中身ごとフォルダを削除します。オプションにExclDirが指定されている場合は，指定されたフォルダ下のファイルだけを削除します。

コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

ただし，「指定されたファイルが見つからない」（_ERR_FILE_予約変数と等しい値），または「指定されたネットワーク名またはパスが見つからない」（_ERR_PATH_予約変数と等しい値）のエラーが発生した場合は，常に真（True）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

OSのファイルシステムでは，次のファイル名が使用されます。

ユーザが任意の文字列を指定したロングファイル名

OSが自動的に生成するショートファイル名（8.3形式）

そのため，JP1/Scriptで，ファイル名にワイルドカードを指定した場合，OSが自動的に生成するショートファイル名も対象になります。また，ファイル名にワイルドカードを指定しない場合，該当ファイルのショートファイル名と同一パスに存在する別ファイルのショートファイル名とが合致し，意図しないファイルが対象になるときがありますのでご注意ください。

例

' 一時フォルダ下のファイル"tempfile.tmp"を削除する。
DeleteFile ( _TEMP_+"tempfile.tmp" )

' 一時フォルダ下の拡張子が".tmp"であるファイルを削除する。
DeleteFile ( _TEMP_+"*.tmp" )

' 一時フォルダ下のすべてのファイルを削除し,一時フォルダは残す。
DeleteFile ( _TEMP_ ,ExclDir )

対象バージョン

JP1/Script 01-00以降

8.5.13　Rename （ファイル名を変更する）

機能

ファイル名を変更します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

Rename ( OldName , 〔NewName〕 〔, Method〕 )

指定項目

OldName

変更前ファイル名またはフォルダ名を文字列，または値を格納した変数名で指定します。

NewName

変更後ファイル名またはフォルダ名を文字列，または値を格納した変数名で指定します。なお，変更前ファイル名またはフォルダ名をフルパスで指定した場合，変更後ファイル名またはフォルダ名もフルパスで指定してください。

この値を省略し，変更方法MethodにRebootを指定した場合，ファイルは削除されます。

Method

変更方法を指定します。

この値は次のどれかになります。

値 | 意味
Replace | NewNameで指定された名称のファイルがすでに存在する場合もファイルを置き換えます。
NoReplace（06-00以降） | NewNameで指定された名称のファイルがすでに存在する場合はエラーになります。
Reboot | システムの再起動後にファイルを置き換えます。
FreeExt | 拡張子を.000～.999のうち，空いているものに変更します。このオプション使用時は，変更後ファイル名を指定しても無視されます。また，このオプションはCopyコマンドのPileオプションと異なって，拡張子が.000～.999のファイルがすでに存在している場合，内容がまったく同じものがあるときはOldNameで指定された変更前ファイルを削除するだけとなります。

この値は省略できます。省略した場合，Replaceが仮定されます。

Rebootを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

説明

OldNameで指定されたファイルをNewNameのファイル名に変更します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

NewNameを省略，または長さ0の文字列（""）を指定し，変更方法MethodにRebootを指定するとファイルは削除されます。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' ファイル名を変更する。
Dim  outDir1
outDir1 = _BIN_
Rename ( outDir1+"DEFAULT.DAT" ,outDir1+"DEFAULT.000" ,FreeExt )
Rename ( _TEMP_+"WORK.DAT" ,outDir1+"DEFAULT.DAT" )

' 自分自身のコピーを作り,元のファイルを削除する。
' (普通には削除できないため)
Copy ( _BIN_+"ABC.EXE" ,_BIN_+"XYZ.EXE" ,Overwrite )
Rename ( _BIN_+"ABC.EXE" ,"" ,Reboot )

対象バージョン

JP1/Script 01-00以降

8.5.14　TempDir （一時フォルダを取得する）

機能

一時フォルダを取得します。

形式

TempDir ( DirNameBuff )

指定項目

DirNameBuff

一時フォルダを受け取る変数名を指定します。

説明

システムの一時フォルダを取得し，変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

フォルダ名の後ろには（¥）が付加されます。

対象バージョン

JP1/Script 01-00以降

8.5.15　TempFile （一時ファイル名を作成する）

機能

一時ファイル名を作成します。

形式

TempFile ( FileNameBuff , 〔Prefix〕 〔, DirName〕 )

指定項目

FileNameBuff

作成した一時ファイル名を受け取る変数名を指定します。

Prefix

プレフィックスを文字列，または値を格納した変数名で指定します。プレフィックスは先頭の3文字が有効となります。

この値は省略できます。省略した場合，"STX"が仮定されます。

DirName

一時ファイルを作成するフォルダ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，システムの一時フォルダを仮定します。

説明

一時ファイル名をDirNameで指定したフォルダにpre<16進文字列>.TMPで作成します。

pre：Prefixに指定した文字

<16進文字列>：システム時刻に基づいて生成された16進文字（1～FFFF）

コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

このコマンドは，作成されたファイル名でファイルサイズ0バイトのファイルを実際に作成します。なお，作成されたファイルは自動的に削除されることはありません。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 一時ファイル名を作成して，作成した一時ファイルに
' "MODEM.INF"をコピーする。
Dim  bkupFileName ,outDir1
outDir1 = _TEMP_
' プレフィックス"BUP"で一時ファイル名を作成する。
TempFile ( bkupFileName ,"BUP" ,outDir1 )
Copy ( outDir1+"MODEM.INF" ,bkupFileName )

対象バージョン

JP1/Script 01-00以降

8.5.16　SetFileAttributeまたはSetFileAttr （フォルダ／ファイルの属性を設定する）

機能

フォルダ，またはファイルの属性を設定します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

SetFileAttribute ( PathName , Attribute1 〔, Attribute2 , …〕 )
SetFileAttr ( PathName , Attribute1 〔, Attribute2 , …〕 )

指定項目

PathName

設定するフォルダ，またはファイルのフルパスを文字列，または値を格納した変数名で指定します。

Attribute1～8

設定する属性を指定します。複数の属性を指定できます。

ただし，ATTR_NORMALは単独で指定した場合にだけ有効です。

この値は次のようになります。

値
意味

ATTR_READONLY
読み込み専用ファイル

ATTR_HIDDEN
隠しファイル

ATTR_ARCHIVE
アーカイブファイル

ATTR_SYSTEM
システムファイル

ATTR_TEMPORARY
一時ファイル
ただし，PathNameにフォルダを指定した場合は，この属性は指定できません。

ATTR_NORMAL
すべての属性を取り除きます。この属性は，単独で指定したときだけ有効です。

PathNameで指定されたフォルダ，またはファイルに対して，Attribute1～8で指定された属性だけを操作する場合，次のどれかを指定します。

値 | 意味
ATTR_ON （05-10以降） | Attribute1～8で指定された属性だけを追加します。
ATTR_OFF （05-10以降） | Attribute1～8で指定された属性だけを取り除きます。

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

説明

指定されたフォルダ，またはファイルに指定された属性を設定します。複数の属性を設定できます。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

フォルダ，またはファイルの複数の属性を取得するには，GetFileAttributeコマンドを，フォルダ，またはファイルの一つの属性をチェックするには，IsFileAttributeコマンドを使用します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，フォルダ下のフォルダ，またはフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' ファイルのアーカイブ属性を取り除いておき,ファイル操作後にアーカイブ属性を
' チェックして,ファイルが更新されているかどうかを判定する。
Dim  file1
file1 = "C:¥TEMP¥loging.tmp"
If  IsFileAttribute ( file1 ,ATTR_ARCHIVE ) = True  Then
 SetFileAttribute ( file1 ,ATTR_ARCHIVE ,ATTR_OFF )
End
   :
（ファイル操作）
   :
If  IsFileAttribute ( file1 ,ATTR_ARCHIVE ) = True  Then
 MessageBox ( file1+"は更新されました。" )
Else
 MessageBox ( file1+"は更新されませんでした。" )
End

対象バージョン

JP1/Script 01-00以降

8.5.17　GetFileAttributeまたはGetFileAttr （フォルダ／ファイルの属性を取得する）

機能

フォルダ，またはファイルの属性を取得します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

GetFileAttribute ( PathName , AttrArrayBuff )
GetFileAttr ( PathName , AttrArrayBuff )

指定項目

PathName

取得するフォルダ，またはファイルのフルパスを文字列，または値を格納した変数名で指定します。

AttrArrayBuff

取得する属性を受け取る要素数が可変な一次元の配列変数の変数名を指定します。

格納される値は次のようになります。

値 | 意味
ATTR_READONLY | 読み込み専用ファイル
ATTR_HIDDEN | 隠しファイル
ATTR_ARCHIVE | アーカイブファイル
ATTR_SUBDIR | サブディレクトリ
ATTR_SYSTEM | システムファイル
ATTR_TEMPORARY | 一時ファイル
ATTR_COMPRESSED | 圧縮ファイル
ATTR_NORMAL | ファイルには，特に属性はありません。

格納後，配列変数の要素数は属性の数に置き換わります。

説明

指定されたフォルダ，またはファイルに指定された属性を取得します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

フォルダ，またはファイルの属性を設定するには，SetFileAttributeコマンドを，フォルダ，またはファイルの一つの属性をチェックするには，IsFileAttributeコマンドを使用します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，フォルダ下のフォルダ，またはフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 実行フォルダ下の一時ファイルを削除する。
Dim  file_attr( )
For  file = _SCF_+"*.*"  Do
 ' ファイル属性を取得
 GetFileAttribute ( file ,file_attr )
 aryCnt = GetArrayCount ( file_attr )
 ' 属性を格納した配列変数から一時ファイル属性を検索
   For  i = 1 To aryCnt
     If  file_attr( i ) = ATTR_TEMPORARY  Then
       ' ファイル削除
       DeleteFile ( file , ExclDir )
       Exit For
     End If
   Next
End For

対象バージョン

JP1/Script 06-00以降

8.5.18　SetFileTime （ファイルの日付と時刻を設定する）

機能

ファイルの日付と時刻を設定します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

SetFileTime ( PathName , 〔Date〕 , 〔Time〕 〔, Type〕 )

指定項目

PathName

設定するファイルのフルパスを文字列，または値を格納した変数名で指定します。

Date

設定する日付をyyyy/mm/ddの形式の文字列，または値を格納した変数名で指定します。yyyyに0～69の範囲の数値を指定すると，2000～2069と読み替えられます。

Time

設定する時刻をhh:mm:ssの形式の文字列，または値を格納した変数名で指定します。

Type

設定するファイル日付の種別を指定します。

この値は次のどちらかになります。

値 | 意味
Create | 作成日付
Update | 更新日付

この値は省略できます。省略した場合，Updateを仮定します。

説明

指定されたファイルに日付と時刻を設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

なお，指定されたファイルがFATシステムのファイルである場合，1980年1月1日から2107年12月31日までの日付しか設定できません。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

Dim  file1
file1 = _SCF_+"User.txt"
If  IsFileAttr ( file1 ,ATTR_ARCHIVE )  Then
 SetFileAttr ( file1 ,ATTR_ARCHIVE ,ATTR_OFF )
 SetFileTime ( file1 ,Date() ,Time() ,Update )
End If

対象バージョン

JP1/Script 05-10以降

8.5.19　GetFileTime （ファイルの日付と時刻を取得する）

機能

ファイルの日付と時刻を取得します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

GetFileTime ( PathName , 〔DateBuff〕 , 〔TimeBuff〕 〔, Type〕 )

指定項目

PathName

取得するファイルのフルパスを文字列，または値を格納した変数名で指定します。

DateBuff

日付を受け取る変数名を指定します。日付はyyyy/mm/ddの形式で返します。必要がない場合は省略します。

TimeBuff

時刻を受け取る変数名を指定します。時刻はhh:mm:ssの形式で返します。必要がない場合は省略します。

Type

取得するファイル日付の種別を指定します。

この値は次のどちらかになります。

値 | 意味
Create | 作成日付
Update | 更新日付

この値は省略できます。省略した場合，Updateを仮定します。

説明

指定されたファイルの日付と時刻を取得します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

Dim  file1 ,file2 ,dateBuff ,timeBuff
file1 = _SCF_+"User.txt"
file2 = _SCF_+"UserBkup.txt"
If  GetFileTime ( file1 ,dateBuff ,timeBuff ,Create ) = True  Then
 SetFileTime ( file2 ,dateBuff ,timeBuff ,Create )
End

対象バージョン

JP1/Script 05-10以降

8.5.20　GetFileSize （ファイルの容量を取得する）

機能

ファイルの容量を取得します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

GetFileSize ( PathName 〔, UnitofByte〕 )

指定項目

PathName

取得するファイルのフルパスを文字列，または値を格納した変数名で指定します。

UnitofByte

取得する容量の単位を指定します。

この値は次のどれかになります。

値 | 意味
Byte | バイト
KB | キロバイト
MB | メガバイト

UnitofByteにKB，またはMBが指定された場合，切り上げた値を返します。例えば，UnitofByteにKBが指定され，容量が1キロバイトに満たない場合は，1を返します。

この値は省略できます。省略した場合，Byteを仮定します。

ラージファイルでも指定された容量の単位に変換した結果が，JP1/Scriptで扱える数値の上限値2,147,483,647を超えると，エラーとなります。

説明

指定されたファイルの容量を取得し，コマンドの実行結果として返します。

エラーが発生した場合は，0を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' コピー元ファイルの容量を調べ,コピー先ディスクに書き込める
' 空き容量があればファイルをコピーする。
Dim  path1 ,path2 ,fileSz ,freeSz
path1 = _SCF_+"Bkup.txt"
path2 = "A:"
fileSz = GetFileSize ( path1 )
freeSz = GetDiskFreeSpace ( path2 ,KB )
If  ( freeSz * 1024 ) >= fileSz  Then
 Copy ( path1 ,path2 )
End If

対象バージョン

JP1/Script 06-00以降

8.5.21　GetVersionInfoまたはGetVerInfo （ファイルのバージョン情報を取得する）

機能

ファイルのバージョン情報を取得します。

形式

GetVersionInfo ( PathName , 〔Version1Buff〕 , 〔Version2Buff〕 , 〔DescriptionBuff〕 , 〔LegalCopyrightBuff〕 , 〔CompanyNameBuff〕 , 〔OriginalFilenameBuff〕 , 〔ProductVersionBuff〕 , 〔ProductNameBuff〕 〔, InternalNameBuff〕 )
GetVerInfo ( PathName , 〔Version1Buff〕 , 〔Version2Buff〕 , 〔DescriptionBuff〕 , 〔LegalCopyrightBuff〕 , 〔CompanyNameBuff〕 , 〔OriginalFilenameBuff〕 , 〔ProductVersionBuff〕 , 〔ProductNameBuff〕 〔, InternalNameBuff〕 )

指定項目

PathName

取得するファイルのフルパスを文字列，または値を格納した変数名で指定します。

Version1Buff

9999.9999.9999.9999の形式のファイルバージョンを受け取る変数名を指定します。必要がない場合は省略します。

ファイルバージョンは9999.9999.9999.9999の形式の文字列（9999は前ゼロ4桁の数字列）で返します。

Version2Buff

ファイルバージョンを受け取る変数名を指定します。必要がない場合は省略します。

ファイルバージョンは文字列で返します。

DescriptionBuff

説明を受け取る変数名を指定します。必要がない場合は省略します。

LegalCopyrightBuff

著作権を受け取る変数名を指定します。必要がない場合は省略します。

CompanyNameBuff

会社名を受け取る変数名を指定します。必要がない場合は省略します。

OriginalFilenameBuff

正式ファイル名を受け取る変数名を指定します。必要がない場合は省略します。

ProductVersionBuff

製品バージョンを受け取る変数名を指定します。必要がない場合は省略します。

ProductNameBuff

製品名を受け取る変数名を指定します。必要がない場合は省略します。

InternalNameBuff

内部名を受け取る変数名を指定します。必要がない場合は省略します。

説明

指定されたファイルのバージョン情報を取得し，各変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）をコマンドの実行結果として返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' ファイルバージョンを比較する。
Dim  path1 ,ver1 ,ver2
path1 = "C:¥Program Files¥Hitachi¥Script¥Bin¥SPTXE.EXE"
ver0520 = "0005.0020.0000.0000"
GetVersionInfo ( path1 , ver1 , ver2)
If  ver0520 < ver1  Then
 MessageBox ( ver0520 + "よりも新しい。" + _NL_ + _
             "ファイルバージョン：" + ver2 )
End If

対象バージョン

JP1/Script 06-00以降

8.5.22　SplitFile （ファイルを分割する）

機能

ファイルを指定されたサイズで分割します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

SplitFile ( FilePath , SplitSize , 〔DirPath〕 , 〔Option〕 〔, SplitCnt〕 )

指定項目

FilePath

分割するファイルのフルパスを文字列，または値を格納した変数名で指定します。

SplitSize

分割するサイズを数値，または値を格納した変数名で指定します。サイズはバイト単位で指定します。

ラージファイルでも，分割するサイズの最大値は，2,147,483,647バイトです。

DirPath

分割したファイルを格納するフォルダ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，FilePathで指定されたファイルが存在するフォルダを仮定します。

Option

オプションを指定します。

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

値 | 意味
Delete | ファイルを分割後，FilePathで指定されたファイルを削除します。

SplitCnt

分割したファイル数を受け取る変数名を指定します。必要がない場合は省略します。

説明

指定されたファイルを指定されたサイズで分割し，分割したファイルを指定されたフォルダに格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

分割したファイルのファイル名はFilePathで指定されたファイル名の末尾に拡張子.XXX（XXXは001からの数字で，999を超えた場合1000からの数字）を付加した値になります。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイル，またはフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

分割したファイルにアクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' ファイル"C:¥FDCOPY.TXT"を1.44MBのFDに格納できるように
'分割して,FDに格納する。
' (参考)1.44MBのFD = 1423KB = 1423 * 1024B
'       1.25MBのFD = 1221KB = 1221 * 1024B
'        720KBのFD =  713KB =  713 * 1024B
'        640KBのFD =  640KB =  640 * 1024B
Dim  file1 ,size1 ,splCnt ,filePath
file1 = "FDCOPY.TXT"
size1 = 1423 * 1024
SplitFile ( "C:¥"+file1 ,size1 ,_TEMP_ , ,splCnt )

Dim  cnt1

' 分割したファイル数分，FDを作成する
For  cnt1 = 1 To splCnt
 filePath = _TEMP_+file1
 Select Case  Len ( cnt1 )
   Case 1
     filePath = filePath+".00"+cnt1
   Case 2
     filePath = filePath+".0"+cnt1
   Case Else
     filePath = filePath+"."+cnt1
 End Select

 ' 一時ファイルをFDへコピー
 Copy ( filePath ,"A:¥" ,Overwrite )
 If  splCnt - cnt1 <= 0  Then
   MessageBox ( "FDへの複写が終了しました。" ,OK )
   Exit For
 End
 MessageBox ( cnt1+1+"枚目のFDに交換してください。" ,OKCancel )
 If  _MSG_RTN_ = Cancel  Then
   Exit For
 End
Next

対象バージョン

JP1/Script 05-10以降

8.5.23　CatFiles （ファイルを統合する）

機能

ファイルを統合します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

CatFiles ( PathName , 〔Option〕 , FilePath1 , 〔FilePath2〕 〔, FilePath3 , …〕 )

指定項目

PathName

統合したファイルを格納するフォルダ名，またはファイル名を，文字列，または値を格納した変数名で，指定します。指定したファイル名がすでに存在している場合は上書きします。

Option

オプションを指定します。

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

値 | 意味
Delete | ファイルを統合後，FilePathnで指定されたファイルを削除します。

FilePathn

統合するファイルのフルパスを文字列，または値を格納した変数名で指定します。ファイル名にワイルドカードを指定することもできます。

ファイル名は最大10個指定でき，指定した順序で統合します。

JP1/Script 06-00以降では，複数のファイルのフルパスの文字列を一つずつ格納した一次元の配列変数を変数名で指定することもできます。この場合は，11個以上のファイル名を指定することができます。

ファイル名にワイルドカードが指定された場合は，該当するファイル名を昇順にソートして統合します。

説明

指定したファイルを統合し，統合したファイルを指定されたフォルダに格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイル，またはフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

統合したファイルを格納するファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

OSのファイルシステムでは，次のファイル名が使用されます。

ユーザが任意の文字列を指定したロングファイル名

OSが自動的に生成するショートファイル名（8.3形式）

そのため，JP1/Scriptで，ファイル名にワイルドカードを指定した場合，OSが自動的に生成するショートファイル名も対象になります。また，ファイル名にワイルドカードを指定しない場合，該当ファイルのショートファイル名と同一パスに存在する別ファイルのショートファイル名とが合致し，意図しないファイルが対象になるときがありますのでご注意ください。

例

' FDに格納されたファイル"A:¥FDCOPY.TXT.*"を統合して,
' "C:¥SCRIPT¥FDCOPY.TXT"を作成する。
Dim  dir1 ,file1
dir1 = "C:¥SCRIPT¥"
file1 = "FDCOPY.TXT"
CatFiles ( dir1+file1 , ,"A:¥"+file1+"*" )

対象バージョン

JP1/Script 05-10以降

8.5.24　SetStandardFileまたはSetStdFile （標準入力・出力・エラーファイルを設定する）

機能

Execコマンドで呼び出すプロセスの標準入力，標準出力，および標準エラーファイルをオープンして設定します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

SetStandardFile ( FilePath , Type 〔, Mode〕 )
SetStdFile ( FilePath ,Type 〔, Mode〕 )

指定項目

FilePath

設定するファイルのフルパスを文字列，または値を格納した変数名で指定します。

Type

設定するファイルの種別を指定します。

この値は次のどれかになります。

値 | 意味
StdInput | 標準入力
StdOutput | 標準出力
StdError | 標準エラー

Mode

Typeで指定されたファイルの種別がStdOutput，またはStdErrorの場合，ファイル作成時の動作を指定します。

この値は次のどれかになります。

値 | 意味
Create | 新規モード
Append | 追加モード

この値は省略できます。省略した場合，Appendを仮定します。

TypeにStdInputを指定した場合は，この値は無効になります。

説明

このコマンドを実行した後のExecコマンドで呼び出すプロセスの標準入力，標準出力，および標準エラーファイルをオープンして設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

設定されたファイルはResetStandardFileコマンドが実行されるまで有効になり，オープンされたままです。

なお，このコマンドで設定したファイルはNetExecコマンドでは有効になりません。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

設定するファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

標準入力，標準出力，および標準エラーのうち1種類でも設定した場合に，Execコマンドで実行するプロセスが正常に実行されないことがあります。その場合は，空のファイルを用意し，標準入力，標準出力，および標準エラーの3種類すべてを設定してください。

例

' Backup.BAT実行時の標準出力，標準エラー出力をそれぞれ
' BatOut.TXT，BatErr.TXTに書き込む
SetStandardFile ( _SCF_+"BatOut.TXT" ,StdOutput ,Create )
SetStandardFile ( _SCF_+"BatErr.TXT" ,StdError )
If  Exec ( _SCF_+"Backup.BAT" ,True )  Then
 MessageBox ( "Execコマンド 成功！" )
Else
 MessageBox ( "Execコマンド 失敗！" )
End
ResetStandardFile ( StdOutput )
ResetStandardFile ( StdError )

対象バージョン

JP1/Script 05-10以降

8.5.25　ResetStandardFileまたはResetStdFile （標準入力・出力・エラーファイルを解除する）

機能

Execコマンドで呼び出すプロセスの標準入力，標準出力，および標準エラーファイルをクローズして解除します。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

ResetStandardFile ( 〔Type〕 )
ResetStdFile ( 〔Type〕 )

指定項目

Type

設定を解除するファイルの種別を指定します。

この値は次のどれかになります。

値 | 意味
StdInput | 標準入力
StdOutput | 標準出力
StdError | 標準エラー

この値は省略できます。省略した場合，設定されているすべてのファイルを解除します。

説明

SetStandardFileコマンドで設定されたプロセスの標準入力，標準出力，および標準エラーファイルをクローズして解除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

SetStandardFile ( _SCF_+"BatOut1.TXT" ,StdOutput )
SetStandardFile ( _SCF_+"BatErr.TXT" ,StdError )
Exec ( _SCF_+"Backup.BAT" ,True )

ResetStandardFile ( StdOutput )
SetStandardFile ( _SCF_+"BatOut2.TXT" ,StdOutput )
Exec ( _SCF_+"Build.BAT" ,True )

対象バージョン

JP1/Script 05-10以降

8.5.26　SplitPath （フルパスを解析する）

機能

フルパスを解析します。

形式

SplitPath ( FullPath , 〔DrvNameBuff〕 , 〔DirNameBuff 〕 , 〔LblNameBuff〕 〔, ExtNameBuff〕 )

指定項目

FullPath

解析するフルパスを文字列，または値を格納した変数名で指定します。

DrvNameBuff

ドライブ名を受け取る変数名を指定します。必要がない場合は省略します。

DirNameBuff

フォルダ名を受け取る変数名を指定します。必要がない場合は省略します。

LblNameBuff

ファイル名を受け取る変数名を指定します。必要がない場合は省略します。

ExtNameBuff

拡張子を受け取る変数名を指定します。必要がない場合は省略します。

説明

与えられたフルパスを，ドライブ名，フォルダ名，ファイル名，拡張子に分解して各変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

ドライブ名にはコロン（ : ）が付加されます。フォルダ名には前後に円記号（¥）が付加されます。拡張子にはピリオド（ . ）が付加されます。

例

Dim  drv1 ,dir1 ,lbl1 ,ext1
SplitPath ( "C:¥WINDOWS¥WINFILE.EXE" ,drv1 ,dir1 ,lbl1 ,ext1 )
 ↓
 drv1  C:
 dir1  ¥WINDOWS¥
 lbl1  WINFILE
 ext1  .EXE

対象バージョン

JP1/Script 01-00以降

8.5.27　MakePath （フルパスを作成する）

機能

フルパスを作成します。

形式

MakePath ( FullPathBuff , DrvName , DirName , LblName , ExtName )

指定項目

FullPathBuff

作成したフルパスを受け取る変数名を指定します。

DrvName

ドライブ名を文字列，または値を格納した変数名で指定します。

DirName

フォルダ名を文字列，または値を格納した変数名で指定します。

LblName

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

ExtName

拡張子を文字列，または値を格納した変数名で指定します。

説明

ドライブ名，フォルダ名，ファイル名，拡張子を結合してフルパスを作成し，変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

ドライブ名のコロン（ : ）を省略しても自動的に付加されます。フォルダ名の前後の円記号（¥）を省略しても自動的に付加されます。拡張子のピリオド（ . ）を省略しても自動的に付加されます。

例

' OriginalFileに格納されているファイル名を解析し，
' 拡張子を".BAK"に変更したフルパスをBackupFileに作成する。
Dim  OriginalFile ,BackupFile ,Drv ,Dir ,Lbl ,Ext
OriginalFile = _SCF_ + "TEST.SPT"
SplitPath ( OriginalFile ,Drv ,Dir ,Lbl ,Ext )
MakePath ( BackupFile ,Drv ,Dir ,Lbl ,".BAK" )

対象バージョン

JP1/Script 01-00以降

8.5.28　SetPath （実行フォルダのパスを設定する）

機能

実行フォルダのパスを設定します。

形式

SetPath ( 〔DirPath〕 )

指定項目

DirPath

設定するフォルダパスを文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，カレントフォルダ（作業フォルダ）を仮定します。

説明

指定されたフォルダパスをカレントフォルダ（作業フォルダ）のパスに設定します。_BIN_予約変数も指定されたフォルダパスに変更されます。

コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定されたフォルダパスが存在しない場合は，カレントフォルダ（作業フォルダ）のパスを変更しないで，常に偽（False）を返します。

例

' 実行ファイル"ABC.EXE"のカレントフォルダを設定し実行する。
' カレントフォルダは，引数で指定された「OutDir」フォルダに
' ファイルが存在した場合，「OutDir」フォルダとする。
' 「OutDir」フォルダにファイルが存在しなかった場合，
' 実行中のスクリプトファイルのフォルダとする。
OutDir = %1
If IsEmptyDir ( OutDir ) = False Then
 SetPath ( OutDir )
 Exec ( "ABC.EXE" ,True )
 SetPath
Else
 Exec ( _SCF_+"ABC.EXE" ,True )
End

対象バージョン

JP1/Script 01-00以降

8.5.29　GetPath （実行フォルダのパスを取得する）

機能

実行フォルダのパスを取得します。

形式

GetPath

このコマンドに引数はありません。

説明

現在の実行フォルダのパスを取得し，値をコマンドの実行結果として返します。

実行フォルダがルートフォルダの場合を除き，フォルダ名の末尾には（¥）は付加されません。フォルダ名の末尾に（¥）を付加する場合は，次のレジストリに値を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥Software¥Hitachi¥JP1/Script¥SPTX

〔値名〕

GetPath_Opt

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：末尾に（¥）を付加しない（初期値）

1：末尾に（¥）を付加する

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' "Script.ini"が存在した場合，
' カレントフォルダ下の"BKUP"フォルダへコピーする。
outDir = GetPath + "¥BKUP¥"
If IsExistFile( "Script.ini" ) Then
Copy ( "Script.ini" , outDir )
End

対象バージョン

JP1/Script 01-00以降

8.5.30　SetVolumeLabelまたはSetVolLabel （ボリュームラベルを設定する）

機能

ディスクのボリュームラベルを設定します。

形式

SetVolumeLabel ( DiskName 〔, LabelName〕 )
SetVolLabel ( DiskName 〔, LabelName〕 )

指定項目

DiskName

ディスクのボリュームを文字列，または値を格納した変数名で指定します。ディスクのコロン（ : ）は省略してもかまいません。

LabelName

設定するボリュームラベル名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，長さ0の文字列（""）を仮定します。

説明

ディスクのボリュームラベルを設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

補足

Windows Vista以降のOSでは，管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

Dim  drvName ,volName
drvName = "E:"
volName = GetVolumeLabel ( drvName )
If  volName = Empty  Then
 SetVolumeLabel ( drvName ,"Script共有ドライブ" )
End

対象バージョン

JP1/Script 05-10以降

8.5.31　GetVolumeLabelまたはGetVolLabel （ボリュームラベルを取得する）

機能

ディスクのボリュームラベルを取得します。

形式

GetVolumeLabel ( DiskName 〔, FileSystemBuff〕 )
GetVolLabel ( DiskName 〔, FileSystemBuff〕 )

指定項目

DiskName

取得するディスクのボリュームを文字列，または値を格納した変数名で指定します。ディスクのコロン（ : ）は省略してもかまいません。

FileSystemBuff

ファイルシステム名（FAT， HPFS， NTFSなど）を受け取る変数名を指定します。必要がない場合は省略します。

説明

指定されたディスクのボリュームラベルを取得し，コマンドの実行結果として返します。

指定されたディスクが存在しない場合は，長さ0の文字列（""）を返します。

例

Dim  volName ,fileSystem
volName = GetVolumeLabel ( "E:" ,fileSystem )

対象バージョン

JP1/Script 05-10以降

8.5.32　GetDiskFreeSpace （ディスク空き容量を取得する）

機能

ディスクの空き容量を取得します。

形式

GetDiskFreeSpace ( DiskName 〔, UnitofByte〕 )

指定項目

DiskName

取得するディスクのボリュームを文字列，または値を格納した変数名で指定します。ディスクのコロン（:）は省略してもかまいません。

UnitofByte

取得する容量の単位を指定します。

この値は次のどれかになります。

値 | 意味
KB | キロバイト
MB | メガバイト

空き容量は切り捨てた値を返します。例えば，UnitofByteにMBが指定され，容量が1メガバイトに満たない場合は，0を返します。

この値は省略できます。省略した場合，KBを仮定します。

説明

指定されたディスクの空き容量を取得し，コマンドの実行結果として返します。

エラーが発生した場合は，0を返します。

例

Dim  MBsize, Bsize
MBsize = GetDiskFreeSpace ( "A:" ,MB )
Bsize = MBsize * 1024 *1024
MessageBox ( "FDの空き容量は"+ Bsize +"バイトです。" )

対象バージョン

JP1/Script 05-10以降

8.5.33　Copy （ファイルをコピーする）

機能

ファイルをコピーします。

JP1/Script 07-50以降では，ラージファイルが使用できます。

形式

Copy ( OldFileName , NewPathName , 〔Option1〕 , 〔Option2〕 , 〔Option3〕 , 〔Option4〕 , 〔Option5〕 , 〔ExceptFileName〕 , 〔Option6〕 〔, Option7〕)

指定項目

OldFileName

コピー元（移動元）ファイル名を文字列，または値を格納した変数名で指定します。

指定されたファイル名の最後の文字がアンダースコア（_）の場合，COMPRESSコマンドで圧縮されたファイルとみなし，展開しながらコピーします。ただし，NewPathNameでコピー先ファイル名の指定がないかぎり，ファイル名は変更しません。最後の文字はアンダースコア（_）のままです。ファイル名にワイルドカードを指定することもできます。

NewPathName

コピー先（移動先）フォルダ名，またはファイル名を，文字列，または値を格納した変数名で指定します。

Option1～5

コピーオプションを指定します。

複数のコピーオプションを指定できます。

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

値
意味

VersionUp
新しいファイルだけを上書きします。
バージョン情報を比較し，バージョン情報が取得できない場合は，ファイルの日付で新旧を比較します。

Overwrite
すべて上書きします。

NoOverwrite （05-10以降）
コピー先フォルダにすでに存在するファイルはコピーしません。

OverwriteOnly （05-10以降）
コピー先フォルダに存在するファイルだけをコピーします。

Pile
既存のファイルは拡張子を.000～.999のうち空いているものに変更して残し，コピーします。

Backup （05-10以降）
アーカイブ属性の付いたファイルだけをコピーし，コピー後にコピー元ファイルのアーカイブ属性をクリアします

Move （05-10以降）
ファイルを移動します。コピーは行いません。
これ以外のVersionup，Overwrite，NoOverwriteとともに指定でき，移動先フォルダにすでにファイルが存在する場合はともに指定されたオプションに従って移動します。

SubDirToo （05-10以降）
下位のフォルダまで，その構造を保ったままコピーします。ファイルが存在しない下位のフォルダはコピーしません。これ以外のオプションとともに指定できます。

Trace（05-10以降）
コピーしたファイル名を実行トレースファイルに出力します。これ以外のオプションと同時に指定できます。

ErrSkip（05-10以降）
コピー元ファイルの排他エラーやアクセスエラーが発生しても無視してコピーを続行します。これ以外のオプションと同時に指定できます。

この値は省略できます。省略した場合，Overwriteを仮定します。

ExceptFileName （05-10以降）

OldFileNameで指定したファイル名の中でコピー（移動）の対象にしないファイルがある場合，そのファイル名を文字列，または値を格納した変数名で指定します。

複数のファイル名を指定する場合は，セミコロン（;）で区切った文字列，または値を格納した変数名で指定します。

JP1/Script 06-00以降では，複数のファイル名の文字列を一つずつ格納した一次元の配列変数を変数名で指定することもできます。

ファイル名にワイルドカードを指定することもできます。

Option6～7 （06-51以降）

コピーオプションを指定します。

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

値
意味

Security
ファイルにセキュリティ情報がある場合，セキュリティ情報もコピーします。これ以外のオプションと同時に指定できます。

ErrSkip2
（06-71以降）
コピー先ファイルの排他エラーやアクセスエラーが発生しても無視してコピーを続行します。
無視したファイルの数は_COPY_SKIP2_CNT_予約変数に格納します。
これ以外のオプションと同時に指定できます。

Securityを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3　コマンドの動作」を参照してください。

説明

指定されたコピーオプションでファイルをコピーします。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

コピーの結果は_COPY_RTN_予約変数に格納されます。格納される値は次のどれかになります。

値 | 意味
Overwrite | ファイルのバージョンをチェックしないでコピーした。
VersionUp | ファイルのバージョンをチェックしてコピーした。
Pile | 既存ファイルの拡張子を変更して残しコピーした。
Backup （05-10以降） | アーカイブ属性の付いたファイルだけをコピーし，アーカイブ属性をクリアした。
Move （05-10以降） | ファイルを移動した。
Skip | ファイルをコピーしなかった。

コピーしたファイルの数は_COPY_CNT_予約変数に格納されます。コピーしなかったファイルの数は_COPY_SKIP_CNT_予約変数に格納されます。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイル，またはフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

コピー先のファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。ただし，Option6～7のコピーオプションに「Security」が指定されている場合は，アクセス権限を設定できません。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

OSのファイルシステムでは，次のファイル名が使用されます。

ユーザが任意の文字列を指定したロングファイル名

OSが自動的に生成するショートファイル名（8.3形式）

そのため，JP1/Scriptで，ファイル名にワイルドカードを指定した場合，OSが自動的に生成するショートファイル名も対象になります。また，ファイル名にワイルドカードを指定しない場合，該当ファイルのショートファイル名と同一パスに存在する別ファイルのショートファイル名とが合致し，意図しないファイルが対象になるときがありますのでご注意ください。

例

Dim  inDir ,outDir
inDir  = _SCF_+"Inst¥"
outDir = _SCF_+"Inst_Backup¥"
Copy ( inDir+"CTL3D32.DLL" ,outDir+"CTL3D32.DLL" ,VersionUp )
Copy ( inDir+"SCRIPT.EX_" ,outDir+" SCRIPT.EXE" ,Overwrite )
Copy ( inDir+"SCR*.*" ,outDir )
Copy ( inDir+"*" ,outDir ,Backup ,ErrSkip , , ,  _
,inDir+"*.EXE;"+inDir+"*.DLL" )

対象バージョン

JP1/Script 01-00以降

8.6　メッセージ出力コマンド

＜この節の構成＞

8.6.1　InputBox （メッセージとテキストボックスを表示する）

8.6.2　Message （ファイル／ウィンドウにテキストを出力する）

8.6.3　MessageBox （ダイアログボックスにメッセージを表示する）

8.6.4　MessageEventLog （イベントビューアにメッセージを出力する）

8.6.5　IMEventMessage （JP1/IMまたはJP1/Baseにイベントを発行する）

8.6.1　InputBox （メッセージとテキストボックスを表示する）

機能

ダイアログボックスにメッセージとテキストボックスを表示します。テキストが入力されるか，ボタンがクリックされるとテキストボックスの内容を返します。

形式

InputBox ( 〔Text〕 , 〔Title〕 , 〔xPos〕 , 〔yPos〕 , InputBuff1 , 〔Caption1〕 , 〔InputBuff2〕 , 〔Caption2〕 , … )

指定項目

Text

ダイアログボックス内にメッセージとして表示する文字列を文字列，または値を格納した変数名で指定します。スクリプトファイルの先頭に「#Option = NOCHANGE」の記述がない場合，メッセージの文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"はそれぞれ対応するコントロールコードとして処理されます。

コントロールコードについては，「6.1.11 コーディング規則」を参照してください。

Title

メッセージボックスのタイトルバーに表示するタイトルを文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，"JP1/Script InputBox"が表示されます。

xPos

画面の左端からダイアログボックスの左端までの水平方向の距離を数値，または値を格納した変数名で指定します。距離は左端を0としたピクセル単位で指定します。この値を省略すると，ダイアログボックスは水平方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

yPos

画面の上端からダイアログボックスの上端までの垂直方向の距離を数値，または値を格納した変数名で指定します。距離は上端を0としたピクセル単位で指定します。この値を省略すると，ダイアログボックスは垂直方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

InputBuff1～4

テキストボックスに入力された文字列を格納する変数名を指定します。テキストボックスは最大4個指定できます。この変数にあらかじめ値を設定しておくと初期値としてテキストボックスに表示することができます。テキストボックスに何も入力されなかった場合は，長さ0の文字列（""）を格納します。

Caption1～4

InputBuff1～4で指定したテキストボックスのキャプションを文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で40文字以内です。

この値は省略できます。省略した場合，キャプションは表示されません。

説明

指定されたパラメタでメッセージとテキストボックスを表示します。テキストボックスは最大4個指定できます。

コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

メッセージボックスには「OK」ボタンと「キャンセル」ボタンが付加されます。「OK」ボタン，またはEnterキーが押されると，テキストボックスの内容を返します。「キャンセル」ボタンが押された場合は，長さ0の文字列（""）を返します。

入力されたボタンの値は_MSG_RTN_予約変数に格納されます。格納される値は次のどれかになります。

値 | 入力されたボタン
OK | [OK]
CANCEL | [キャンセル]

補足

スクリプトをサービスで起動する場合は，このコマンドは使用できません。使用すると実行エラーになります。

例

Dim  compName
Dim  userName
InputBox ( "会社名と氏名を入力してください。","データ登録",100,100, _
          compName, "会社名" ,userName, "氏名" )

表示例

対象バージョン

JP1/Script 01-00以降

8.6.2　Message （ファイル／ウィンドウにテキストを出力する）

機能

ファイル，またはウィンドウにテキストを出力します。

また，出力したウィンドウやテキストを消去します。

ウィンドウ出力については，JP1/Script 01-01からサポートしています。

形式

Message ( Target , 〔OutputName〕 , 〔Text〕 , 〔LineLength〕 , 〔MaxLines〕 , 〔xPos〕 〔, yPos〕 )

指定項目

Target

テキストの出力先を指定します。

この値は次のどれかになります。

値 | 意味
Target_File | ファイルに出力します。
Target_DispOn （01-01以降） | ウィンドウに出力します。
Target_DispClear （01-01以降） | ウィンドウに表示しているメッセージテキストを消去します。
Target_DispOff （01-01以降） | 表示しているウィンドウを消去します。
Target_SPAFile （05-20以降） | 実行中スクリプトの解析トレースファイルに出力します。
Target_SPXFile （05-20以降） | 実行中スクリプトの実行トレースファイルに出力します。

OutputName

TargetにTarget_Fileを指定した場合
出力先ファイルのフルパスを文字列，または値を格納した変数名で指定します。ファイル名の拡張子が省略された場合，自動的に拡張子（.TXT）を付加します。ただし，ファイル名の末尾が拡張子のピリオド（ . ）である場合，JP1/Script 06-00以降では，拡張子のないファイル名とみなします。

TargetにTarget_DispOn，Target_DispClear，Target_DispOffを指定した場合
ウィンドウのタイトル名を文字列，または値を格納した変数名で指定します。

TargetにTarget_SPAFile，Target_SPXFileを指定した場合
実行中スクリプトの各トレースファイルが出力先ファイルになるため，この値は省略できます。値を省略しないで指定した場合，この値をウィンドウタイトル名とみなし各トレースファイルとウィンドウの両方に出力します。

Text

TargetにTarget_File，Target_DispOn，Target_SPAFile，Target_SPXFileを指定した場合
出力するメッセージテキストを文字列，または値を格納した変数名で指定します。スクリプトファイルの先頭に「#Option = NOCHANGE」の記述がない場合，メッセージテキストの文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"はそれぞれ対応するコントロールコードとして処理されます。
コントロールコードについては，「6.1.11 コーディング規則」を参照してください。

TargetにTarget_DispClear，Target_DispOffを指定した場合
この値は無効になります。

LineLength

TargetにTarget_Fileを指定した場合
出力するメッセージテキストの1行の長さを数値，または値を格納した変数名で指定します。メッセージテキストに含まれる"¥r"，"¥n"は除いた値を指定します。
この値はOutputNameで指定されたファイル名に対して，初めてMessageコマンドを実行するときに指定します。2回目以降のMessageコマンドを実行するときにLineLengthの値が変更された場合，1行の長さを変更してOutputNameで指定されたファイルを新しく作成します。
指定できる値の範囲は，128～1,024です。
この値は省略できます。省略した場合，実行環境ファイルで定義されたユーザトレース情報の最大列数を仮定します。
省略してユーザトレース情報が存在しない場合は，150を仮定します。

TargetにTarget_DispOn，Target_DispClear，Target_DispOffを指定した場合
この値は無効になります。

TargetにTarget_SPAFile，Target_SPXFileを指定した場合
この値は無効になり，実行環境ファイルで定義されたトレース情報の最大列数を仮定します。

MaxLines

TargetにTarget_Fileを指定した場合
出力するメッセージテキストの最大行数を数値，または値を格納した変数名で指定します。
この値はLineLengthと同様に，OutputNameで指定されたファイル名に対して，初めてMessageコマンドを実行するときに指定します。2回目以降のMessageコマンドを実行するときにMaxLinesの値が変更された場合，最大行数を変更してOutputNameで指定されたファイルを新しく作成します。
指定できる値の範囲は，100～9,999です。
この値は省略できます。省略した場合，実行環境ファイルで定義されたユーザトレース情報の最大行数を仮定します。
省略してユーザトレース情報が存在しない場合は，1,024を仮定します。

TargetにTarget_DispOn，Target_DispClear，Target_DispOffを指定した場合
この値は無効になります。

TargetにTarget_SPAFile，Target_SPXFileを指定した場合
この値は無効になり，実行環境ファイルで定義されたトレース情報の最大行数を仮定します。

xPos

TargetにTarget_DispOn，Target_DispClearを指定した場合，およびTargetにTarget_SPAFile※1，またはTarget_SPXFile※1を指定してウィンドウにも出力する場合
画面の左端からウィンドウの左端までの水平方向の距離を数値，または値を格納した変数名で指定します。
距離は左端を0としたピクセル単位で指定します。
この値を省略すると，ウィンドウは水平方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

TargetにTarget_File，Target_DispOffを指定した場合，およびTargetにTarget_SPAFile※2，またはTarget_SPXFile※2を指定してウィンドウには出力しない場合
この値は無効になります。

yPos

TargetにTarget_DispOn，Target_DispClearを指定した場合，およびTargetにTarget_SPAFile※1，またはTarget_SPXFile※1を指定してウィンドウにも出力する場合
画面の上端からウィンドウの上端までの垂直方向の距離を数値，または値を格納した変数名で指定します。
距離は上端を0としたピクセル単位で指定します。
この値を省略すると，ウィンドウは垂直方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

TargetにTarget_File，Target_DispOffを指定した場合，およびTargetにTarget_SPAFile※2，またはTarget_SPXFile※2を指定してウィンドウには出力しない場合
この値は無効になります。

注※1　OutputNameに値を指定した場合。

注※2　OutputNameの値を省略した場合。

説明

指定されたファイル，またはウィンドウに指定されたメッセージテキストを出力します。

また，出力したウィンドウの消去，テキストメッセージの消去をします。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

補足

スクリプトをサービスで起動する場合は，このコマンドのウィンドウ出力は使用できません。使用すると実行エラーになります。

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

Target_Fileで指定したファイルを新規に作成する場合に，アクセス権限を設定できます。設定するアクセス権限は，あらかじめ次に示すレジストリキーに設定しておいてください。

〔レジストリキー〕

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

〔値名〕

SecurityAttributesSucceed

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：設定しない

1：「上位フォルダのアクセス権を継承する」を設定する。

2：「Everyone：フルコントロール」を設定する。

値が設定されていない場合や上記以外の値が設定された場合は，デフォルトの0を仮定します。

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

実行環境で複数起動の指定をしたスクリプト中に，Target_SPAFile，またはTarget_SPXFileを指定したMessageコマンドがあり，そのスクリプトファイルを同時に複数実行した場合，同一の解析トレースファイル，または実行トレースファイルにメッセージを出力します。このため，ファイルに排他制御がかかり，実行性能が低下することがありますので注意が必要です。また，Target_Fileで出力するファイル名が固定の場合も同様です。

Messageコマンドで出力するファイルはJP1/Cm2/Extensible AgentやJP1/Baseのログファイルトラップ機能の対象にはなりません。

Target_Fileで作成したファイルをファイル・フォルダ操作コマンドや他のアプリケーションでテキスト出力しないでください。その後のMessageコマンドの出力結果が保証されません。

MessageコマンドでTarget_Fileを指定して，ユニークなファイル名称を持ったユーザトレースファイルを大量に作成する場合，トレース管理ファイルの増大によって，スクリプトの実行性能に影響を与える場合があります。また，以下の例のように，メモリ不足のために，スクリプト実行が異常終了したり，コマンド実行がエラーになったりする場合があります。
・スクリプト実行が終了コード「20」で異常終了する。
・Copyコマンドで「メモリ不足が発生しました」となる。
このような場合は，MessageコマンドではなくTextOpen/TextWrite/TextCloseコマンドによってトレースファイルを作成してください。

例

' スクリプト実行の履歴を"Loging.txt"に書き込む。
Message ( Target_File ,_BIN_+"Loging.txt" ,"実行開始" ,30 ,100 )
 :
Message ( Target_File ,_BIN_+"Loging.txt" ,"実行終了" )

' スクリプト実行の履歴状況をディスプレイに表示する。
Message ( Target_DispOn ,"実行状況" ,"開始しました。", , ,100 ,100 )
 :
Message ( Target_DispOn ,"実行状況" ,"終了しました。", , ,100 ,100 )
Sleep ( 3000 )
Message ( Target_DispOff ,"実行状況" )

表示例

対象バージョン

JP1/Script 01-00以降

8.6.3　MessageBox （ダイアログボックスにメッセージを表示する）

機能

ダイアログボックスにメッセージを表示します。メッセージボックスにはボタンやアイコンの付加を指定できます。ボタンがクリックされるのを待って，どのボタンがクリックされたかを示す値を返します。

形式

MessageBox ( Text , 〔Buttons〕 , 〔DefaultBtn〕 , 〔IconStyle〕 , 〔ModalStyle〕 〔, Title〕 )

指定項目

Text

ダイアログボックス内にメッセージとして表示する文字列を文字列，または値を格納した変数名で指定します。スクリプトファイルの先頭に「#Option = NOCHANGE」の記述がない場合，メッセージの文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"はそれぞれ対応するコントロールコードとして処理されます。

コントロールコードについては，「6.1.11 コーディング規則」を参照してください。

Buttons

メッセージボックスに付加するボタンの種類と個数を指定します。

この値は次のどれかになります。

値 | 意味
OK | [OK]ボタンだけを表示します。
OKCancel | [OK]ボタンと[キャンセル]ボタンを表示します。
YesNo | [はい]ボタンと[いいえ]ボタンを表示します。
YesNoCancel | [はい]，[いいえ]，および[キャンセル]の三つのボタンを表示します。
RetryCancel | [再試行]ボタンと[キャンセル]ボタンを表示します。
AbortRetryIgnoreまたはAbort | [中止]，[再試行]，および[無視] の三つのボタンを表示します。

この値は省略できます。省略した場合は，[OK]ボタンだけを表示します。

DefaultBtn

Buttonsで指定されたボタンのなかでどのボタンが標準ボタンになるかを指定します。

この値は次のどれかになります。

値 | 意味
1 | 第1ボタンを標準ボタンにします。
2 | 第2ボタンを標準ボタンにします。
3 | 第3ボタンを標準ボタンにします。

この値は省略できます。省略した場合，1が仮定されます。

IconStyle

メッセージボックスに付加するアイコンのスタイルを指定します。

この値は次のどれかになります。

値 | 意味
ExclamationまたはEx | 感嘆符「!」
InformationまたはInfo | 円の中に「i」の字
Question | 疑問符「?」
Stop | 「STOP」

この値は省略できます。省略した場合，アイコンは表示されません。

ModalStyle

メッセージボックスがモーダルかどうかを指定します。

この値は次のどれかになります。

値 | 意味
ApplicationModalまたはAppliModal | アプリケーションモーダルに設定します。ほかのアプリケーションのウィンドウに移動して作業することはできます。
SystemModalまたはSysModal | システムモーダルに設定します。ユーザがすぐ気付く必要があるような重大なエラーを通知するために使用します。

この値は省略できます。省略した場合，ApplicationModal が仮定されます。

Title

メッセージボックスのタイトルバーに表示するタイトルを文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，"JP1/Script MessageBox" が表示されます。

説明

指定されたパラメタでメッセージボックスを表示します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

入力されたボタンの値は_MSG_RTN_予約変数に格納されます。格納される値は次のどれかになります。

値 | 入力されたボタン
OK | [OK]
CANCEL | [キャンセル]
ABORT | [中止]
RETRY | [再試行]
IGNORE | [無視]
YES | [はい]
NO | [いいえ]

[キャンセル]ボタンが表示されているダイアログボックスでは，Escキーを押すと，[キャンセル]ボタンをクリックしたときと同じ結果になります。

補足

スクリプトをサービスで起動する場合は，このコマンドは使用できません。使用すると実行エラーになります。

例

MessageBox ( "終了してもいいですか?" ,OKCancel , ,Question )
If  _MSG_RTN_ <>CANCEL  Then
 Exit
End

表示例

対象バージョン

JP1/Script 01-00以降

8.6.4　MessageEventLog （イベントビューアにメッセージを出力する）

機能

イベントビューアのアプリケーションログにメッセージを出力します。

形式

MessageEventLog ( Text , 〔LogType〕 〔, Option〕 )

指定項目

Text

イベントビューアのアプリケーションログに出力するメッセージを文字列，または値を格納した変数名で指定します。スクリプトファイルの先頭に「#Option = NOCHANGE」の記述がない場合，メッセージの文字列中に含まれる"¥r"，"¥n"，"¥t"，"¥¥"はそれぞれ対応するコントロールコードとして処理されます。

コントロールコードについては，「6.1.11 コーディング規則」を参照してください。

LogType

出力するメッセージのイベントの種類を指定します。

この値は次のどれかになります。

値 | 意味
Error，またはErr | エラー
Warning | 警告
Information，またはInfo | 情報
AuditSuccess | 成功の監査
AuditFailure | 失敗の監査

この値は省略できます。省略した場合，Informationを仮定します。

Option （06-51以降）

オプションを指定します。

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

値 | 意味
TextOnly | メッセージの先頭にユーザ名と実行したスクリプトファイル名を付加しません。Textで指定されたメッセージだけを出力します。

説明

指定されたパラメタでイベントビューアのアプリケーションログにメッセージを出力します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

このコマンドを使用して出力したイベントログのイベントIDは3になります。

また，イベントログの出力されるメッセージの先頭にはユーザ名と実行したスクリプトファイル名が付加されます。オプションにTextOnlyが指定されている場合は付加しません。

なお，実行環境ファイルで定義されたコマンドラインやレジストリのコマンドラインに/NOEVLOGや/NOEVLOG(3)などの指定がある場合，この指定にかかわらずコマンドを実行します。

例

If  Exec ( "ABC.EXE" ,True ) = False  Then
 MessageEventLog ( "ABC.EXEの呼び出し失敗" ,Error )
End

対象バージョン

JP1/Script 01-01以降

8.6.5　IMEventMessage （JP1/IMまたはJP1/Baseにイベントを発行する）

機能

JP1/IM，またはJP1/Baseにイベントを発行します。

形式

IMEventMessage ( Text , 〔Severity〕 , 〔UserName〕 , 〔RootObjName〕 , 〔Occurrence〕 , 〔StartDate〕 , 〔StartTime〕 , 〔EndDate〕 , 〔EndTime〕 , 〔ResultCode〕 )

指定項目

Text

JP1/IMのイベントコンソールにイベントとして表示するメッセージを文字列，または値を格納した変数名で指定します。

Severity

イベントの重大度を指定します。

この値は次のどれかになります。

値
意味

EmergencyまたはEmergence
緊急
パニック状態を表します。
注意 EmergencyではなくEmergenceを指定した場合，JP1/IMの自動アクションではJP1イベントとみなされないため動作しません。

Alertness
警戒
即座に修正を必要とする状態を表します。

Critical
致命的
重大なエラーを表します。

Error または Err
アプリケーションでのエラーを表します。

Warning
警告
警告メッセージを表します。

Notice
通知
エラー状態ではないが，特別な処理を必要とすることを表します。

Information または Info
情報
情報メッセージを表します。

Debug
デバッグ
プログラムをデバッグするときに使用する情報を表します。

この値は省略できます。省略した場合，イベントコンソールの重大度の欄には Informationが仮定されます。

UserName

イベントのユーザ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，イベントコンソールのユーザ名の欄は空欄になります。

RootObjName

イベントの登録名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，イベントコンソールの登録名の欄は空欄になります。

Occurrence

イベントの事象種別を指定します。

この値は次のどれかになります。

値 | 意味
Start | 実行開始
End | 実行終了
Create | 定義の作成
Destroy | 定義の削除
Modify | 定義内容の変更
Submit | 実行可能状態への変更
UnSubmit | 実行可能状態からの離脱
Pause | 実行の一時停止
Release | 一時停止の解除
Restart | 再実行の開始

この値は省略できます。省略した場合，イベントコンソールの事象種別の欄は空欄になります。

StartDate

イベントの開始日付を yyyy/mm/dd の形式で指定します。

この値は省略できます。省略した場合，イベントコンソールの開始時刻の欄は空欄になります。

StartTime

イベントの開始時刻を hh:mm:ss の形式で指定します。

この値は省略できます。省略した場合，イベントコンソールの開始時刻の欄は空欄になります。

EndDate

イベントの終了日付を yyyy/mm/dd の形式で指定します。

この値は省略できます。省略した場合，イベントコンソールの終了日付の欄は空欄になります。

EndTime

イベントの終了時刻を hh:mm:ss の形式で指定します。

この値は省略できます。省略した場合，イベントコンソールの終了時刻の欄は空欄になります。

ResultCode

イベントの終了コードを数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，イベントコンソールの終了コードの欄は空欄になります。

説明

指定されたパラメタでJP1/IM，またはJP1/Baseにイベントを発行します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

このコマンドを使用して発行したイベントのイベントIDは 00003B03になります。

また，イベントのプロダクト名は /HITACHI/JP1/SCRIPTに，登録名タイプは PROCESS になります。

補足

JP1/IMのイベントコンソールの拡張属性説明ファイルは，インストール先フォルダの"DATA"フォルダ下に格納されます。ファイル名は，"SCRIPT_BASE.ja"です。

注意

JP1/Baseへイベントを発行する場合，JP1/Scriptは物理的ホストに対してだけ発行しており，論理ホストへの発行はできません。このため，JP1/IMを論理ホスト環境で運用している場合には，JP1/Scriptが発行するJP1イベントは表示されません。表示するには，JP1/Baseの物理ホストの転送設定ファイルにJP1/Scriptで発行するJP1イベントを転送する設定を行ってください。

例

Dim  se_Date ,s_Time ,e_Time ,rtn1
se_Date = Date()
s_Time = Time()
rtn1 = Exec ( _SCF_+"ABC.EXE" ,True )
e_Time = Time()

If  rtn1  Then
 IMEventMessage ( "ABC.EXEは正常終了" , ,_USER_ ,_SCF_FIL_ , _
         End ,se_Date ,s_Time ,se_Date ,e_Time ,_EXEC_RTN_)
Else
 IMEventMessage ( "ABC.EXEはエラー終了" , ,_USER_ ,_SCF_FIL_ , _
        End ,se_Date ,s_Time ,se_Date ,e_Time ,_RTN_)
End

対象バージョン

JP1/Script 05-20以降

8.7　メニュー呼び出しコマンド

＜この節の構成＞

8.7.1　Menu （ユーザ定義のメニューを表示する）

8.7.1　Menu （ユーザ定義のメニューを表示する）

機能

ユーザ定義のメニューを表示します。

形式

Menu ( FormName , 〔SpnFilePath〕 〔, FocusField〕 )

指定項目

FormName

表示するメニューのフォーム名称を，文字列，または値を格納した変数名で指定します。

SpnFilePath

表示するメニューの情報が格納されているメニュー情報ファイルのフルパスを，文字列，または格納した変数名で指定します。

この値は省略できます。省略した場合，実行中のスクリプトファイルのメニュー情報ファイルを仮定します。

CallSptコマンドから呼び出されたスクリプトの実行時は，呼び出されたスクリプトファイルのメニュー情報ファイルを仮定します。

FocusField

メニュー起動時にフォーカスを位置付けるフィールド名称を文字列，または格納した変数名で指定します。

この値は省略できます。省略した場合，メニュー情報ファイルで定義されたフィールドにフォーカスが位置付きます。

説明

ユーザが定義したメニューフォームを表示します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

メニューフォーム終了時に，メニューフォームの終了要因を表す文字列が_FORM_TERM_KEY_予約変数に格納されます。格納される値は次のどれかです。

値 | 意味
Enter | Enterキーが押されて終了しました。
Esc | Escキーが押されて終了しました。
F1～F12 | ファンクションキー（F1～F12）が押されて終了しました。
Command | コマンドを実行して終了しました。
Close | Alt + F4またはクローズボタンが押されて終了しました。
Timeout | 終了監視時間を経過したため終了しました。

メニューの終了要因がCommandである場合，実行したコマンド番号を_FORM_TERM_CMDNO_予約変数に格納します。

また，終了キーのモデファイキーを表す文字列が_FORM_MODIFY_KEY_予約変数に格納されます。格納される値は次のどれかです。

値 | 意味
Shift | Shift キー
Ctrl | Ctrl キー
Alt | Alt キー
Shift_Ctrl | Shift キーと Ctrl キー
Ctrl_Alt | Ctrl キーと Alt キー
Shift_Alt | Shift キーと Alt キー
Shift_Ctrl _Alt | Shift キーと Ctrl キーと Alt キー

また，メニューフォーム終了時にフォーカスの位置付いていたフィールド名を_FORM_FIELD_NAME_予約変数に格納します。

補足

スクリプトをサービスで起動する場合は，このコマンドは使用できません。使用すると実行エラーになります。

Menuコマンドから実行された外部コマンドの終了コードに0以外が返された場合，メッセージボックスを表示します。メッセージボックスを表示しない場合は，次に示すレジストリキーの値に0を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script¥SPTX

〔値名〕

Menu_EmgMsgBox

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：メッセージボックスを表示しない

1：メッセージボックスを表示する

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

例

' メニューがEscキーを押されて終了した場合,スクリプトの実行を中断する。
Menu ( "MyMenu" )
If  _FORM_TERM_KEY_ = "Esc"  Then
 Exit
Else
  :
  :
  :
End

対象バージョン

JP1/Script 05-20以降

8.8　演算処理コマンド

＜この節の構成＞

8.8.1　+演算子（加算） （二つの式の和を求める）

8.8.2　+=演算子（加算） （変数と式の和を変数に代入する）

8.8.3　-演算子（減算・マイナス符号） （二つの数値の差を求める）

8.8.4　-=演算子（減算） （変数と式の差を変数に代入する）

8.8.5　Mod演算子（剰余演算） （二つの数値の剰余を求める）

8.8.6　Mod=演算子（剰余演算） （変数と式の剰余を変数に代入する）

8.8.7　*演算子（乗算） （二つの数値の積を求める）

8.8.8　*=演算子（乗算） （変数と式の積を変数に代入する）

8.8.9　/演算子（除算） （二つの数値の商を求める）

8.8.10　/=演算子（除算） （変数と式の商を変数に代入する）

8.8.11　¥演算子（整数除算） （二つの数値の商を求める）

8.8.12　¥=演算子（整数除算） （変数と式の商を変数に代入する）

8.8.13　^演算子（べき乗） （二つの数値のべき乗を求める）

8.8.14　^=演算子（べき乗） （変数と式のべき乗を変数に代入する）

8.8.15　比較演算子（=，<>，<，<=，>，>=） （二つの式を比較する）

8.8.16　And（論理積） （二つの式の論理積を求める）

8.8.17　Or（論理和） （二つの式の論理和を求める）

8.8.18　Not（論理否定） （式の論理否定を求める）

8.8.1　+演算子（加算） （二つの式の和を求める）

機能

二つの数値の和を求めます。

形式

Result = Expression1 + Expression2

指定項目

Result

二つの数値の和を受け取る変数名を指定します。

Expression1

任意の式を指定します。

Expression2

任意の式を指定します。

説明

式Expression1とExpression2を加算し，その和を演算結果Resultとして返します。

式の内部処理形式により，+ 演算子の動作は次のように異なります。

条件 | 行われる演算
両方の式が文字列 | 文字列連結
両方の式が数値 | 加算
両方の式が数値だけからなる文字列 | 加算
一方の式が数値， 他方が文字列 | 文字列連結
一方の式が文字列， 他方が数値だけからなる文字列 | 文字列連結
一方の式が数値， 他方が数値だけからなる文字列 | 加算

両方の式がEmpty値のとき，演算結果Resultは数値0になります。ただし，一方の式だけがEmpty値のときは，他方の式がそのまま演算結果Resultとして返されます。

補足

ResultとExpression1が同じ変数である場合，+= 演算子を使用して書き換えることができます。

例

' 変数result1には"ABCDEF"が格納される。
result1 = "ABC" + "DEF"

' 変数result2には12が格納される。
result2 = 7 + 5

' 変数result3には"10min."が格納される。
result3 = 10 + "min."

対象バージョン

JP1/Script 01-00以降

8.8.2　+=演算子（加算） （変数と式の和を変数に代入する）

機能

変数の値と式の値を加算し，その和を変数に代入します。

形式

Result += Expression

指定項目

Result

結果を受け取る変数名を指定します。

Expression

任意の式を指定します。

説明

変数Resultの値と式Expressionの値を加算し，その和を演算結果として変数Resultに代入します。

+= 演算子の動作は，+ 演算子の場合と同じで次のようになります。

条件 | 行われる演算
両方の値が文字列 | 文字列連結
両方の値が数値 | 加算
両方の値が数値だけからなる文字列 | 加算
一方の値が数値， 他方が文字列 | 文字列連結
一方の値が文字列， 他方が数値だけからなる文字列 | 文字列連結
一方の値が数値， 他方が数値だけからなる文字列 | 加算

両方の値がEmpty値のときは，変数Resultには数値0が代入されます。変数ResultがEmpty値，または未定義のときは，式Expressionの値がそのまま変数Resultに代入されます。式Expressionの値がEmpty値のときは，変数Resultの値は変わりません。

例

' 変数result1には"ABCDEF"が格納される。
result1 = "ABC"
result1 += "DEF"

' 変数result2には11が格納される。
result2 = 10
result2 += 1

' 変数result3には1が格納される。
Dim  result3
result3 += 1

対象バージョン

JP1/Script 06-51以降

8.8.3　-演算子（減算・マイナス符号） （二つの数値の差を求める）

機能

二つの数値の差を求めます。または，数式の符号を反転した値を指定します。

形式1

Result = Number1 - Number2

形式2

-Number

指定項目

Result

二つの数値の差を受け取る変数名を指定します。

Number

任意の数式を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

形式1では，数式Number1からNumber2を減算し，その差を演算結果Resultとして返します。

形式2では，- 演算子は単項マイナス符号演算子として，式の符号を反転した値を指定するために使用します。

Empty値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，-= 演算子を使用して書き換えることができます。

例

' 変数result1には2が格納される。
result1 = 7 - 5

対象バージョン

JP1/Script 01-00以降

8.8.4　-=演算子（減算） （変数と式の差を変数に代入する）

機能

変数の値から式の値を減算し，その差を変数に代入します。

形式

Result -= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値から数式Numberの値を減算し，その差を演算結果として変数Resultに代入します。

両方の値がEmpty値のときは，変数Resultには数値0が代入されます。変数ResultがEmpty値，または未定義のときは，数式の符号を反転した値-Numberが変数Resultに代入されます。数式Numberの値がEmpty値のときは，変数Resultの値は変わりません。

例

' 変数result1には-1が格納される。
Dim  result1
result1 -= 1

' 変数result2には9が格納される。
result2 = 10
result2 -= 1

対象バージョン

JP1/Script 06-51以降

8.8.5　Mod演算子（剰余演算） （二つの数値の剰余を求める）

機能

二つの数値の除算を行い，その剰余を返します。

形式

Result = Number1 Mod Number2

指定項目

Result

二つの数値の剰余を受け取る変数名を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

数式Number1をNumber2で除算し，その余りを演算結果Resultとして返します。

Empty値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，Mod= 演算子を使用して書き換えることができます。

例

' 変数result1には5が格納される。
result1 = 19 Mod 7

対象バージョン

JP1/Script 01-00以降

8.8.6　Mod=演算子（剰余演算） （変数と式の剰余を変数に代入する）

機能

変数の値を式の値で除算し，その剰余を変数に代入します。

形式

Result Mod= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値を数式Numberの値で除算し，その余りを演算結果として変数Resultに代入します。

Empty値は，0として扱われます。変数ResultがEmpty値，または未定義のときは，0が変数Resultに代入されます。数式Numberの値がEmpty値のときは，0で除算を行うことになるため実行エラーになります。

例

' 変数result1には5が格納される。
result1 = 19
result1 Mod= 7

対象バージョン

JP1/Script 06-51以降

8.8.7　*演算子（乗算） （二つの数値の積を求める）

機能

二つの数値の積を求めます。

形式

Result = Number1 * Number2

指定項目

Result

二つの数値の積を受け取る変数名を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

数式Number1にNumber2を乗算し，その積を演算結果Resultとして返します。

Empty値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，*= 演算子を使用して書き換えることができます。

例

' 変数result1には35が格納される。
result1 = 7 * 5

対象バージョン

JP1/Script 01-00以降

8.8.8　*=演算子（乗算） （変数と式の積を変数に代入する）

機能

変数の値に式の値を乗算し，その積を変数に代入します。

形式

Result *= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値に数式Numberの値を乗算し，その積を演算結果として変数Resultに代入します。

Empty値は，0として扱われます。変数ResultがEmpty値，または未定義のときや数式Numberの値がEmpty値のときは，0が変数Resultに代入されます。

例

' 変数result1には35が格納される。
result1 = 7
result1 *= 5

対象バージョン

JP1/Script 06-51以降

8.8.9　/演算子（除算） （二つの数値の商を求める）

機能

二つの数値の商を計算し，結果を整数で返します（¥演算子と同じ機能です）。

形式

Result = Number1 / Number2

指定項目

Result

二つの数値の商を受け取る変数名を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

数式Number1をNumber2で除算し，その商を演算結果Resultとして整数で返します。

Empty値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，/= 演算子を使用して書き換えることができます。

例

' 変数result1と変数result2には2が格納される。
result1 = 14 / 7
result2 = 19 / 7

対象バージョン

JP1/Script 01-00以降

8.8.10　/=演算子（除算） （変数と式の商を変数に代入する）

機能

変数の値を式の値で除算し，その商を整数で変数に代入します（¥=演算子と同じ機能です）。

形式

Result /= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値を数式Numberの値で除算し，その商を演算結果として整数で変数Resultに代入します。

Empty値は，0として扱われます。変数ResultがEmpty値，または未定義のときは，0が変数Resultに代入されます。数式Numberの値がEmpty値のときは，0で除算を行うことになるため実行エラーになります。

例

' 変数result1と変数result2には2が格納される。
Dim  result1, result2
result1 = 14
result2 = 19
result1 /= 7
result2 /= 7

対象バージョン

JP1/Script 06-51以降

8.8.11　¥演算子（整数除算） （二つの数値の商を求める）

機能

二つの数値の商を計算し，結果を整数で返します（/演算子と同じ機能です）。

形式

Result = Number1 ¥ Number2

指定項目

Result

二つの数値の商を受け取る変数名を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

数式Number1をNumber2で除算し，その商を演算結果Resultとして整数で返します。

Empty 値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，¥= 演算子を使用して書き換えることができます。

例

' 変数result1と変数result2には2が格納される。
result1 = 14 ¥ 7
result2 = 19 ¥ 7

対象バージョン

JP1/Script 01-00以降

8.8.12　¥=演算子（整数除算） （変数と式の商を変数に代入する）

機能

変数の値を式の値で除算し，その商を整数で変数に代入します（/=演算子と同じ機能です）。

形式

Result ¥= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値を数式Numberの値で除算し，その商を演算結果として整数で変数Resultに代入します。

Empty値は，0として扱われます。変数ResultがEmpty値，または未定義のときは，0が変数Resultに代入されます。数式Numberの値がEmpty値のときは，0で除算を行うことになるため実行エラーになります。

例

' 変数result1と変数result2には2が格納される。
Dim  result1, result2
result1 = 14
result2 = 19
result1 ¥= 7
result2 ¥= 7

対象バージョン

JP1/Script 06-51以降

8.8.13　^演算子（べき乗） （二つの数値のべき乗を求める）

機能

二つの数値のべき乗を計算し，結果を整数で返します。

形式

Result = Number1 ^ Number2

指定項目

Result

二つの数値のべき乗を受け取る変数名を指定します。

Number1

任意の数式を指定します。

Number2

任意の数式を指定します。

説明

数式Number1とNumber2のべき乗を計算し，その演算結果をResultに整数で返します。

Empty 値を持つ式は，0として扱われます。

補足

ResultとNumber1が同じ変数である場合，^= 演算子を使用して書き換えることができます。

例

' 変数result1には8が格納される。
result1 = 2 ^ 3

対象バージョン

JP1/Script 06-00以降

8.8.14　^=演算子（べき乗） （変数と式のべき乗を変数に代入する）

機能

変数の値と式の値のべき乗を計算し，結果を整数で変数に代入します。

形式

Result ^= Number

指定項目

Result

結果を受け取る変数名を指定します。

Number

任意の数式を指定します。

説明

変数Resultの値と数式Numberの値のべき乗を計算し，その演算結果を整数で変数Resultに代入します。

Empty値は，0として扱われます。変数ResultがEmpty値，または未定義のときは，0が変数Resultに代入されます。数式Numberの値がEmpty値のときは，0でべき乗を計算することになるため常に1になります。

例

' 変数result1には8が格納される。
result1 = 2
result1 ^= 3

対象バージョン

JP1/Script 06-51以降

8.8.15　比較演算子（=，<>，<，<=，>，>=） （二つの式を比較する）

機能

二つの式の比較を行います。

形式

Result = Expression1 Comparisonoperator Expression2

指定項目

Result

結果を受け取る変数名を指定します。

Expression1

任意の式を指定します。

Expression2

任意の式を指定します。

Comparisonoperator

任意の比較演算子を指定します。

説明

二つの式の比較を行います。

各比較演算子の演算結果Resultが，真（True），偽（False）となる条件を，次に示します。

= （等しい）

真となる条件 Expression1 = Expression2

偽となる条件 Expression1 <> Expression2

<> （等しくない）

真となる条件 Expression1 <> Expression2

偽となる条件 Expression1 = Expression2

< （より小さい）

真となる条件 Expression1 < Expression2

偽となる条件 Expression1 >= Expression2

<= （以下）

真となる条件 Expression1 <= Expression2

偽となる条件 Expression1 > Expression2

> （より大きい）

真となる条件 Expression1 > Expression2

偽となる条件 Expression1 <= Expression2

>= （以上）

真となる条件 Expression1 >= Expression2

偽となる条件 Expression1 < Expression2

保持しているデータ型によってどのような比較が行われるか，または比較結果がどうなるかを次に示します。

条件 | 行われる演算
両方の式が数値データ型 | 数値比較
両方の式が文字列型 | 文字列比較※
一方の式が数値データ型，他方の式が文字列型 | 文字列比較※
一方の式がEmpty値，他方の式が数値データ型 | Empty値を0とみなして数値比較を行います。ただし，等しいかどうかを判定する場合は，0とみなしません。
一方の式がEmpty値，他方の式が文字列型 | Empty値を長さ0の文字列（""）とみなして文字列比較を行います。※
両方の式がEmpty値 | 二つの式は等しいという結果になります。

注※

文字列比較は，辞書式の順序で行います。

なお，半角英字の大文字と小文字は区別しません。

対象バージョン

JP1/Script 01-00以降

8.8.16　And（論理積） （二つの式の論理積を求める）

機能

二つの式の論理積を求めます。

形式

Result = Expression1 And Expression2

指定項目

Result

結果を受け取る変数名を指定します。

Expression1

真（True），または偽（False）を評価する任意の式を指定します。

Expression2

真（True），または偽（False）を評価する任意の式を指定します。

説明

二つの式の論理積を求めます。

演算結果Resultの値は次のようになります。

Expression1 | Expression2 | Result
True | True | True
True | False | False
False | True | False
False | False | False

例

' 変数number1の値が1以上10以下のとき,実行ファイル"Day10.SPT"を
' 呼び出す。
number1 = Day ( )
If  1 <= number1  And  number1 <= 10  Then
 Exec ( "Day10.SPT", True )
End If

対象バージョン

JP1/Script 01-00以降

8.8.17　Or（論理和） （二つの式の論理和を求める）

機能

二つの式の論理和を求めます。

形式

Result = Expression1 Or Expression2

指定項目

Result

結果を受け取る変数名を指定します。

Expression1

真（True），または偽（False）を評価する任意の式を指定します。

Expression2

真（True），または偽（False）を評価する任意の式を指定します。

説明

二つの式の論理和を求めます。

演算結果Resultの値は次のようになります。

Expression1 | Expression2 | Result
True | True | True
True | False | True
False | True | True
False | False | False

例

' 変数number1の値が7以下，または20以上のとき,実行ファイル
' "Backup.BAT"を呼び出す。
number1 = Hour ( )
If  number1 <= 7  Or  20 <= number1  Then
 Exec ( "Backup.BAT", True )
End If

対象バージョン

JP1/Script 01-00以降

8.8.18　Not（論理否定） （式の論理否定を求める）

機能

式の論理否定を求めます。

形式

Result = Not Expression

指定項目

Result

結果を受け取る変数名を指定します。

Expression

真（True），または偽（False）を評価する任意の式を指定します。

説明

式の論理否定を求めます。

演算結果Resultの値は次のようになります。

Expression | Result
True | False
False | True

例

' 変数number1の値が10以下のとき,実行ファイル"Day10.SPT"を呼び出す。
number1 = Day ( )
If  Not  10 < number1  Then
 Exec ( "Day10.SPT", True )
End If

対象バージョン

JP1/Script 06-00以降

8.9　チェック処理コマンド

＜この節の構成＞

8.9.1　IsEmpty （変数がEmpty値かどうかを調べる）

8.9.2　IsDefineまたはIsDef （変数が定義されているかどうかを調べる）

8.9.3　IsNumeric （数値として評価できるかを調べる）

8.9.4　IsEmptyDir （フォルダの中身が空かどうかを調べる）

8.9.5　IsExistDir （フォルダが存在するかどうかを調べる）

8.9.6　IsExistFile （ファイルが存在するかどうかを調べる）

8.9.7　IsWriteableDir （フォルダが書き込み可能かどうかを調べる）

8.9.8　IsFileAttributeまたはIsFileAttr （フォルダ／ファイルの属性を調べる）

8.9.9　IsNew （バージョン情報／ファイル日付の新旧を比較する）

8.9.10　CheckDirName （フォルダ名の末尾が（¥）かどうかを調べる）

8.9.11　CheckDriveType （ドライブの種類を調べる）

8.9.1　IsEmpty （変数がEmpty値かどうかを調べる）

機能

変数がEmpty値かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsEmpty ( VarName )

指定項目

VarName

調べる変数を変数名で指定します。

説明

指定された変数がEmpty値かどうかを調べ，結果をコマンドの実行結果として返します。Empty値の場合は真（True）を，それ以外の場合は偽（False）を返します。

また，指定された変数が定義されていない場合は，常に偽（False）を返します。

例

' _ALLRIGHT_予約変数がEmpty値かどうかを調べる。
If  IsEmpty ( _ALLRIGHT_ )  Then
MessageBox("管理者権限があるIDでログオンし直してください。")
End If

対象バージョン

JP1/Script 01-00以降

8.9.2　IsDefineまたはIsDef （変数が定義されているかどうかを調べる）

機能

変数が定義されているかどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsDefine ( VarName )
IsDef ( VarName )

指定項目

VarName

調べる変数を変数名で指定します。

説明

指定された変数が定義されているかどうかを調べ，結果をコマンドの実行結果として返します。定義されている場合は真（True）を，それ以外の場合は偽（False）を返します。

例

' 位置変数%1が指定されたかどうかで処理を分岐する。
If  IsDefine ( %1 )  Then
 Exec ( "CallProc01.SPT" ,True ,%1 )
Else
 Exec ( "CallProc02.SPT" ,True )
End If

対象バージョン

JP1/Script 01-00以降

8.9.3　IsNumeric （数値として評価できるかを調べる）

機能

値が数値として評価できるかどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsNumeric ( CheckValue )

指定項目

CheckValue

調べる値，または値を格納した変数名を指定します。

説明

指定された値が数値として評価できるかどうかを調べ，結果をコマンドの実行結果として返します。数値として評価できる場合は真（True）を，それ以外の場合は偽（False）を返します。

対象バージョン

JP1/Script 01-01以降

8.9.4　IsEmptyDir （フォルダの中身が空かどうかを調べる）

機能

フォルダの中身が空かどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsEmptyDir ( DirName )

指定項目

DirName

チェックするフォルダ名を文字列，または値を格納した変数名で指定します。

説明

指定されたフォルダの中にファイル，またはフォルダが存在するかどうかをチェックし，結果をコマンドの実行結果として返します。中身が空の場合は真（True）を，それ以外の場合は偽（False）を返します。ただし，指定されたフォルダに対する読み取りのアクセス許可がない場合は，中身が空でなくても真（True）を返します。

また，指定されたフォルダが存在しない場合は，常に偽（False）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，またはフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' "BKUP"フォルダの中身が空かどうかを調べる。
outDir = _SCF_+"BKUP¥"
If  IsExistDir ( outDir ) = True  Then
 If  IsEmptyDir ( outDir ) = True  Then
   MessageBox ( "Empty !" )
 Else
   MessageBox ( "Not Empty !" )
 End
Else
 MessageBox ( "Not Exist !" )
End

対象バージョン

JP1/Script 01-00以降

8.9.5　IsExistDir （フォルダが存在するかどうかを調べる）

機能

フォルダが存在するかどうかを調べ，結果を真（True）か偽（False）で返します。

形式

IsExistDir ( DirName )

指定項目

DirName

チェックするフォルダ名を文字列，または値を格納した変数名で指定します。

説明

指定されたフォルダが存在するかどうかをチェックし，結果をコマンドの実行結果として返します。存在する場合は真（True）を，それ以外の場合は偽（False）を返します。ただし，指定されたフォルダの上位の階層のフォルダに対する読み取りのアクセス許可がない場合は，フォルダが存在しても偽(False)を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，またはフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 実行フォルダ下に"SCRIPT"フォルダが存在しない場合は作成する。
path1 = _BIN_+"SCRIPT"
If  IsExistDir ( path1 ) = False  Then
 MakeDir ( path1 )
End

対象バージョン

JP1/Script 01-00以降

8.9.6　IsExistFile （ファイルが存在するかどうかを調べる）

機能

ファイルが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsExistFile ( FilePath )

指定項目

FilePath

チェックするファイルのフルパスを文字列，または値を格納した変数名で指定します。

説明

指定されたファイルが存在するかどうかをチェックし，結果をコマンドの実行結果として返します。存在する場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

チェックするファイルのファイルパスとして存在するフォルダ名を指定した場合，コマンドの実行結果は真（True）を返します。

また，チェックするファイルのファイルパスとして存在するフォルダに読み取りのアクセス許可がない場合でも，ファイルが存在すれば，コマンドの実行結果は真(True)を返します。

例

path1 = _BIN_+"SCRIPT¥Loging.txt"
If  IsExistFile ( path1 ) = True  Then
 Copy ( path1 ,_TEMP_+"ScpLog.txt" )
 If  _COPY_RTN_ <> Skip  Then
   DeleteFile ( path1 )
 End
End

対象バージョン

JP1/Script 01-00以降

8.9.7　IsWriteableDir （フォルダが書き込み可能かどうかを調べる）

機能

フォルダが書き込み可能かどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsWriteableDir ( DirName )

指定項目

DirName

チェックするフォルダ名を文字列，または値を格納した変数名で指定します。

説明

指定されたフォルダが書き込み可能かどうかをチェックし，結果をコマンドの実行結果として返します。書き込み可能の場合は真（True）を，それ以外の場合は偽（False）を返します。

また，指定されたフォルダが存在しない場合は，常に偽（False）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，またはフォルダ下のフォルダを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' "BKUP"フォルダが書き込み可能かどうかを調べる。
outDir = _SCF_+"BKUP¥"
writeFlag = "NG"
If  IsWriteableDir ( OutDir ) = True  Then
 writeFlag ="OK"
End

対象バージョン

JP1/Script 01-00以降

8.9.8　IsFileAttributeまたはIsFileAttr （フォルダ／ファイルの属性を調べる）

機能

フォルダ，またはファイルの属性が指定された属性かどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsFileAttribute ( PathName , Attribute )
IsFileAttr ( PathName , Attribute )

指定項目

PathName

チェックするフォルダ，またはファイルのフルパスを文字列，または値を格納した変数名で指定します。

Attribute

チェックする属性を指定します。

この値は次のどれかになります。

値 | 意味
ATTR_READONLY | 読み込み専用ファイル
ATTR_HIDDEN | 隠しファイル
ATTR_ARCHIVE | アーカイブファイル
ATTR_SUBDIR | サブディレクトリ
ATTR_SYSTEM | システムファイル
ATTR_TEMPORARY | 一時ファイル
ATTR_COMPRESSED （05-20以降） | 圧縮ファイル

説明

指定されたフォルダ，またはファイルが指定された属性かどうかをチェックし，結果をコマンドの実行結果として返します。指定された属性の場合は真（True）を，それ以外の場合は偽（False）を返します。

フォルダ，またはファイルの属性を設定するには，SetFileAttributeコマンドを，フォルダ，またはファイルの複数の属性を取得するには，GetFileAttributeコマンドを使用します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ，フォルダ下のフォルダ，またはフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' ファイルが一時ファイル属性ならば削除する。
Dim  file1
file1 = "C:¥TEMP¥loging.tmp"
If  IsFileAttribute ( file1 ,ATTR_TEMPORARY ) = True  Then
 DeleteFile ( file1 )
End

対象バージョン

JP1/Script 01-00以降

8.9.9　IsNew （バージョン情報／ファイル日付の新旧を比較する）

機能

二つのファイルのバージョン情報，またはファイル日付の新旧を比較し，結果を真（True）か偽（False）で返します。

形式

IsNew ( PathName1 , PathName2 〔, Option〕 )

指定項目

PathName1

比較する一方のファイルのフルパスを文字列，または値を格納した変数名で指定します。

PathName2

比較するもう一方のファイルのフルパスを文字列，または値を格納した変数名で指定します。

Option

オプションを指定します。

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

値 | 意味
Version | バージョン情報だけで比較します。
FileTime | ファイル日付だけで比較します。

説明

オプションが省略された場合，二つのファイルのバージョン情報を比較し，バージョン情報が取得できない場合はファイルの日付の新旧を比較し，PathName1で指定されたファイルがPathName2で指定されたファイルよりも新しい場合は真（True）を，古い，または等しい場合は偽（False）を，コマンドの実行結果として返します。

オプションが指定されている場合は，各オプションの比較方法で比較します。

エラーが発生した場合は，長さ0の文字列（""）を返します。

補足

Windows Vista以降のOSで，環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' file1とfile2のファイルバージョン情報を比較して，
' file1がfile2より新しい場合，file2のファイルに戻す。
Dim  file1 ,file2
file1 = _SCF_+"TEST.SPT"
file2 = "C:¥BKUP¥TEST.SPT"
If  IsNew ( file1 ,file2 ) = False  Then
 Copy ( file2 ,file1 )
End

対象バージョン

JP1/Script 05-10以降

8.9.10　CheckDirName （フォルダ名の末尾が（¥）かどうかを調べる）

機能

フォルダ名の末尾が（¥）であるかどうかを調べます。

形式

CheckDirName ( DirNameBuff 〔, Option〕 )

指定項目

DirNameBuff

チェックするフォルダ名を格納している変数名を指定します。

Option

オプションを指定します。

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

値 | 意味
Remove | 末尾の（¥）を取り去ります。

説明

オプションが省略された場合，指定された変数に格納されているフォルダパスの末尾の文字を調べ，（¥）以外の文字の場合は，末尾に（¥）を付加します。オプションにRemoveが指定されている場合は，末尾の（¥）を取り去ります。

コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

' フォルダパスが( ¥ )で終わることを保証してからフルパス名を作成
Dim  inDir , outDir
inDir = _TEMP_
outDir = "C:¥Script¥Data"
CheckDirName ( inDir )
CheckDirName ( outDir )
Copy ( inDir+"FILE.DAT" ,outDir+"FILE.DAT" ,Overwrite )

対象バージョン

JP1/Script 01-00以降

8.9.11　CheckDriveType （ドライブの種類を調べる）

機能

ドライブの種類を調べます。

形式

CheckDriveType ( DrvTypeBuff , PathName )

指定項目

DrvTypeBuff

チェックした結果を受け取る変数名を指定します。

格納される値は次のどれかになります。

値 | 意味
REMOVABLE | 交換可能なメディア（FDドライブなど）
FIXED | ハードディスク
REMOTE | LAN/リモートドライブ
CDROM | CD-ROMドライブ
RAMDISK | RAMディスク
"" | 判定できない

PathName

チェックするパス名を文字列，または値を格納した変数名で指定します。

説明

指定されたパスが指すドライブの種類をチェックします。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

Dim  result1
CheckDriveType ( result1 ,"D:¥" )
If  result1 <> CDROM  Then
 MessageBox ( "CD-ROMではありません。" ,OK )
End

対象バージョン

JP1/Script 01-00以降

8.10　外部プログラム呼び出しコマンド

＜この節の構成＞

8.10.1　Exec （自PC上の実行ファイルを呼び出す）

8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）

8.10.3　WaitForExec （実行ファイルの終了待ち／強制終了を行う）

8.10.4　GetExecStatus （実行ファイルの実行状態を取得する）

8.10.5　CallSpt （複数パラメタ指定でSPTファイルを呼び出す）

8.10.1　Exec （自PC上の実行ファイルを呼び出す）

機能

複数パラメタ指定で実行ファイル（EXEファイル，BATファイル，COMファイル，SPTファイル，CMDファイル，関連付けられたファイル）を呼び出します。終了待ちの有無を指定できます。

関連付けられたファイルの呼び出しについては，JP1/Script 05-00以降でサポートしています。

形式

Exec ( FileName , Flag 〔, Param1 , Param2 , …〕 )

指定項目

FileName

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

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

実行形式ファイル（.EXE）

MS-DOSバッチファイル（.BAT）

MS-DOS実行形式ファイル（.COM）

JP1/Scriptファイル（.SPT）

コマンドスクリプト（.CMD）

関連付けられたファイル

Flag

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

ただし，Flagに偽（False）が指定され，スクリプト終了時に実行ファイルがまだ終了していない場合は，その時点で実行ファイルが終了するまで待機します。このような終了待ちをしないでスクリプトを終了するには，Exitコマンド（オプションにSkip指定）を使用します。例2を参照してください。

Param1～31

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

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

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

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

なお，パラメタに次の文字列を指定した場合，Execコマンドから実行されるアプリケーション側でのウィンドウ表示時のデフォルトとして扱われます。ただし，ウィンドウの表示/非表示を制御しているアプリケーションや最大化/最小化を制御しているアプリケーションには有効になりません。

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

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

説明

指定された実行ファイルを実行します。

Flagに真（True）が指定された場合は，呼び出したアプリケーションが終了するまで待機し，偽（False）が指定された場合は，アプリケーションが終了するまで待機しないで次のコマンドを処理します。

コマンドが正常に実行された場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。

アプリケーションの終了待ちをし，コマンドの実行結果が真（True）の場合は，実行ファイルの終了コードを_EXEC_RTN_予約変数に符号付きの数値で格納します。終了待ちをしない場合やコマンドの実行結果が偽（False）の場合は，_EXEC_RTN_予約変数には何も格納されません。

また，アプリケーションの終了待ちをしない場合，実行ファイルの識別子を_EXEC_ID_予約変数に格納します。

補足

Execコマンドは，呼び出す実行ファイルの種類が異なると，同等のエラーであってもコマンドの実行結果が異なる場合があります。例えば，存在しないEXEファイルを呼び出した場合は偽（False）を，存在しないSPTファイルを呼び出した場合は真（True）をコマンドの実行結果として返します。
Flagに真（True）が指定され，終了待ちをするExecコマンドが正常終了したかどうかを判定するためには，コマンドの実行結果だけでなく，_EXEC_RTN_予約変数に格納された実行ファイルの終了コードの判定も必要です。例1のような判定方法を推奨します。

Windows Vista以降のOSでは，管理者権限が必要な実行ファイルを実行する場合，OSのユーザアカウント制御ダイアログが表示されるときがあります。詳細は，「1.8.3 コマンドの動作」を参照してください。

Execコマンドで呼び出した実行ファイルの作業フォルダは，スクリプトファイルの作業フォルダと同じフォルダになります。

パラメタ中にダブルクォーテーション（"）を使用する場合，その直前に半角スペースがないときとあるときで，実行ファイルに渡される位置変数の内容が異なります。例3を参照してください。

例1

' スクリプトファイル"ABC.SPT"を呼び出す。
rtn = Exec ( _SCF_+"ABC.SPT", True )
rtnCode = _RTN_

' 実行結果を判定する。
If  rtn = True  Then
 If  _EXEC_RTN_ = 0  Then
      MessageBox  ( "正常終了しました。")
 Else
      MessageBox  ( "異常終了しました。終了コード＝" + _EXEC_RTN_)
      Exit  (_EXEC_RTN_)
 End
Else
   MessageBox  ( "異常終了しました。エラーコード＝" + rtnCode)
   Exit  (rtnCode)
End

例2

' 実行ファイル"ABC.EXE"を終了待ちをしない指定で呼び出す。
rtn1 = Exec ( "ABC.EXE", False )
   :
' ABC.EXEの終了を待たないでスクリプトを終了する。
Exit ( 0, Skip )

例3

1. ダブルクォーテーション（"）の直前に半角スペースがないとき

〔パラメタの指定形式〕

Exec ( "C:¥Temp¥Test.SPT", True, "ABC""XYZ""" )

〔各位置変数に設定される値〕

%0：C:¥Temp¥Test.SPT

%1：ABCXYZ

2. ダブルクォーテーション（"）の直前に半角スペースがあるとき

〔パラメタの指定形式〕（△：半角スペース）

Exec ( "C:¥Temp¥Test.SPT", True, "ABC△""XYZ""" )

〔各位置変数に設定される値〕

%0：C:¥Temp¥Test.SPT

%1：ABC

%2：XYZ

対象バージョン

JP1/Script 01-00以降

8.10.2　NetExec （自PC／他PC上の実行ファイルを呼び出す）

機能

複数パラメタ指定で実行ファイル（EXEファイル，BATファイル，COMファイル，SPTファイル，CMDファイル，関連付けられたファイル）を呼び出します。ほかのコンピュータ上の実行ファイルも呼び出せます。終了待ちの有無を指定できます。

形式

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

指定項目

CompName

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

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

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

注※　呼び出すコンピュータがクラスタシステム環境の場合は，次の値を指定してください。

JP1/Scriptサービスや，ScriptランチャまたはScriptランチャサービスをリソースとして登録しているとき：論理ホスト名，または論理IPアドレスを指定してください。

JP1/Scriptサービスや，ScriptランチャまたはScriptランチャサービスをリソースとして登録していないとき：物理ホスト名，または物理IPアドレスを指定してください。

FileName

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

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

実行形式ファイル（.EXE）

MS-DOSバッチファイル（.BAT）

MS-DOS実行形式ファイル（.COM）

JP1/Scriptスクリプトファイル（.SPT）

コマンドスクリプト（.CMD）

関連付けられたファイル

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

ファイル名だけを指定する場合は，CompNameで指定されたコンピュータの環境変数PATHに呼び出す実行ファイルが格納されているフォルダを設定してください。

Flag

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

ただし，Flagに偽（False）が指定され，スクリプト終了時に実行ファイルがまだ終了していない場合は，その時点で実行ファイルが終了するまで待機します。このような終了待ちをしないでスクリプトを終了するには，Exitコマンド（オプションにSkip指定）を使用します。「8.10.1　Exec（自PC上の実行ファイルを呼び出す）」の例2を参照してください。

ExecDirName

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

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

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

ExecPlace

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

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

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

Option

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

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

値
意味

CopyFile
呼び出し元に存在するスクリプトファイルをCompNameで指定されたコンピュータにコピーして実行します。
この場合，呼び出し先のインストール先フォルダの"DATA"フォルダ※下に呼び出し元コンピュータ名のフォルダを作成し，その下にスクリプトファイルをコピーします。コピーするスクリプトファイルの実行環境ファイル（.SPV）はコピーしません。なお，コピーするスクリプトファイルと同名の実行環境ファイルがスクリプトファイルのコピー先に存在する場合は，コピー時に削除します。
JP1/Script 06-00以降では，コピーするスクリプトファイルと同名のメニュー情報ファイル（.SPN）が存在する場合，メニュー情報ファイルも上記のフォルダ下にコピーします。同名のファイルがコピー先に存在する場合はコピー時に削除します。
このコマンドの実行終了後，コピーしたスクリプトファイル，およびメニュー情報ファイルは削除し，コピーしたスクリプトの実行後に出力される解析トレースファイル，および実行トレースファイルは呼び出し元のスクリプト実行フォルダにコピーして戻します。
オプションにCopyFileを指定した場合は，次の注意事項があります。

実行環境ファイルに設定していた情報がすべて無効になります。そのため，起動したスクリプトファイルでは，実行環境ファイルに設定したコマンドラインは無効となります。

CopyFileを指定して起動するスクリプトファイルの複数起動はできません。

Flagで指定した値にかかわらずコピーしたスクリプトの実行が終了するまでWindowsのログオフやシャットダウンはしないでください。

注※

Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

この値は省略できます。省略した場合，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"パラメタはコマンドラインパラメタとしては渡されません。

説明

指定されたコンピュータ上の実行ファイルを実行します。

Flagに真（True）が指定された場合は，呼び出したアプリケーションが終了するまで待機し，偽（False）が指定された場合は，アプリケーションが終了するまで待機しないで次のコマンドを処理します。

コマンドが正常に実行された場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。

アプリケーションの終了待ちをし，コマンドの実行結果が真（True）の場合は，実行ファイルの終了コードを_EXEC_RTN_予約変数に符号付きの数値で格納します。終了待ちをしない場合やコマンドの実行結果が偽（False）の場合は，_EXEC_RTN_予約変数には何も格納されません。

また，アプリケーションの終了待ちをしない場合，実行ファイルの識別子を_EXEC_ID_予約変数に格納します。

補足1

NetExecコマンドは，呼び出す実行ファイルの種類が異なると，同等のエラーであってもコマンドの実行結果が異なる場合があります。例えば，存在しないEXEファイルを呼び出したときは偽（False）を，存在しないSPTファイルを呼び出したときは真（True）をコマンドの実行結果として返します。

Flagに真（True）が指定され，終了待ちをするNetExecコマンドが正常終了したかどうかを判定するためには，コマンドの実行結果だけでなく，_EXEC_RTN_予約変数に格納された実行ファイルの終了コードの判定も必要です。「8.10.1　Exec（自PC上の実行ファイルを呼び出す）」の例1のような判定方法を推奨します。

また，CompNameにほかのコンピュータを指定する場合，LAN環境下での動作だけを保証しています。WAN環境下などの動作は保障していません。また，ファイアウォールを介しての実行はできません。

JP1/Script 07-00以降では，NetExecコマンド実行時にインストールフォルダの"LOG"フォルダ下"STXNetExec_Client"，および"STXNetExec_Server"フォルダを作成し，エラーが発生した場合，このフォルダ下にエラーログファイルを出力します。

エラーログファイルの出力を抑止する場合は，次に示すレジストリの値に0を設定してください。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX¥

Option

〔値名〕

Net_Trace

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：エラーログファイルを出力しない

1：エラーログファイルを出力する（初期値）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

また，エラーログファイルの出力先ファルダを変更する場合は，次に示すレジストリの値にフォルダ名を指定してください。

〔値名〕

Net_Trace_Directory

〔値のデータタイプ〕

REG_SZ

〔値〕

エラーログファイルの出力先フォルダ（初期値：スクリプトのログフォルダ）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

補足2

Windows Vista以降のOSでは，管理者権限が必要な実行ファイルを実行する場合，OSのユーザアカウント制御ダイアログが表示されるときがあります。詳細は，「1.8.3 コマンドの動作」を参照してください。

NetExecコマンドでは，呼び出し元のプロセス環境変数を呼び出し先に継承しません。そのため，呼び出し元で設定した値を参照できません。

補足3

CompNameに存在しないコンピュータ名を指定した場合やFileNameに存在しない実行ファイル名を指定した場合は，真（True）をコマンドの実行結果として返し，_RTN_予約変数には0が格納されます。

また，次の場合も同様となりますので，注意してください。

実行ファイルのアクセスに失敗した

ネットワークで障害が発生した

JP1/Scriptサービスが停止している

ScriptランチャまたはScriptランチャサービスが起動されていない

補足4

JP1/AJSでは，GUIを表示して入力待ちになるプログラムを直接ジョブとして実行できません。しかし，次のようにJP1/Scriptのスクリプトファイルを経由することで，JP1/AJSからGUIを持つプログラムを実行できます。

GUIを表示するプログラムをNetExecコマンドで呼び出すスクリプトファイルを作成する。このとき，NetExecコマンドのExecPlaceには偽（False）を指定する。

1.で作成したスクリプトファイルをJP1/AJSのジョブから実行する。

例

' コンピュータ"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

対象バージョン

JP1/Script 05-00以降

8.10.3　WaitForExec （実行ファイルの終了待ち／強制終了を行う）

機能

Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの終了待ちや強制終了を行います。

形式

WaitForExec ( 〔Option〕 , 〔ExecId〕 〔, Time〕 )

指定項目

Option

オプションを指定します。

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

値 | 意味
Wait | Exec，およびNetExecコマンドで呼び出した実行ファイルが終了するまで待ちます。
WaitAll | Exec，およびNetExecコマンドで呼び出したすべての実行ファイルが終了するまで待ちます。
Abort | Exec，およびNetExecコマンドで呼び出した実行ファイルを強制終了します。
AbortAll | Exec，およびNetExecコマンドで呼び出したすべての実行ファイルを強制終了します。

この値は省略できます。省略した場合，Waitを仮定します。

ExecId

OptionにWait，またはAbortが指定された場合，Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの識別子を文字列，または値を格納した変数名で指定します。この識別子は，Exec，およびNetExecコマンド実行時に_EXEC_ID_予約変数に格納される値です。

この値は省略できます。省略した場合，現在の_EXEC_ID_予約変数に格納されている値を仮定します。

Time（06-00以降）

待ち時間を0からの数値，または値を格納した変数名で指定します。

OptionにWait，またはWaitAllが指定された場合は，待ち時間に達するまで実行ファイルの終了待ちを行います。

OptionにAbort，またはAbortAllが指定された場合は，待ち時間に達したら強制終了を行います。

待ち時間は秒単位で指定します。必要がない場合は省略します。

なお，Optionの指定にかかわらず，待ち時間に達して終了した場合は真（True）を，待ち時間に達しても終了しない場合は偽（False）をコマンドの実行結果として返し，_RTN_予約変数には_ERR_TIMEOUT_予約変数と等しい値が設定されます。しかし，On Errorステートメントで指定したラベルには分岐しません。

説明

Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの終了待ちや強制終了を行います。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

このコマンドを呼び出した時点で実行ファイルが終了していた場合は，常に真（True）を返します。

例

Dim  exec1_ID ,exec2_ID
If  Exec ( _WIN_+"NOTEPAD.EXE" ,False ,_SCF_+"ABC.SPT" )  Then
 exec1_ID = _EXEC_ID_
 :
End
If  Exec ( _WIN_+"NOTEPAD.EXE" ,False ,_BIN_+"Memo.TXT" )  Then
 exec2_ID = _EXEC_ID_
 :
End

WaitForExec ( Wait ,exec1_ID ) ' 終了するまで待つ。
WaitForExec ( Abort ,exec2_ID ,60 ) ' 60秒後に強制終了する。

対象バージョン

JP1/Script 01-01以降

8.10.4　GetExecStatus （実行ファイルの実行状態を取得する）

機能

Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの現在の実行状態を取得します。

形式

GetExecStatus ( 〔ExecId〕 )

指定項目

ExecId

Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの識別子を文字列，または値を格納した変数名で指定します。この識別子は，Exec，およびNetExecコマンド実行時に_EXEC_ID_予約変数に格納される値です。

この値は省略できます。省略した場合，現在の_EXEC_ID_予約変数に格納されている値を仮定します。

説明

Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルの現在の実行状態を取得します。コマンドが正常に実行された場合は実行状態を，エラーが発生した場合は長さ0の文字列（""）を，コマンドの実行結果として返します。

実行状態として返される値は次のどれかになります。

値 | 意味
EXEC_RUNNING | 実行ファイルは実行中です。
EXEC_STOPPED | 実行ファイルは実行中ではありません。

例

' Execコマンドから終了待ちをしない指定で呼び出した実行ファイルの処理が
' 終了してから，次のExecコマンドの処理を行う。
Dim  exec1_ID
prm1 = _SCF_+"Result.TXT"
If  Exec ( _SCF_+"Sum.SPT" ,False ,prm1 )  Then
 exec1_ID = _EXEC_ID_
 :
End
While  GetExecStatus ( exec1_ID ) = EXEC_RUNNING
 Sleep ( 100 )
End While
Exec ( _WIN_+"NOTEPAD.EXE" ,True ,prm1)

対象バージョン

JP1/Script 06-00以降

8.10.5　CallSpt （複数パラメタ指定でSPTファイルを呼び出す）

機能

複数パラメタ指定でSPTファイルを呼び出します。Execコマンドと異なり，現在のプロセスと同一のプロセスで実行します。

形式

CallSpt （ SptFileName〔,Param1 ,Param2 , … ,Param31〕）

指定項目

SptFileName

呼び出すJP1/Scriptスクリプトファイル（.SPT）名を文字列，または値を格納した変数名で指定します。ファイル名の拡張子（.SPT）を省略しても自動的に付加して動作します。

Param1～31

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

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

複数のパラメタを一つずつ格納した一次元の配列変数を変数名で指定することもできます。パラメタの記述規則については，「6.2.3 コマンドラインの記述規則」を参照してください。ｎ個のダブルクォーテーション（"）を文字としてそのままパラメタに含める場合は，（ｎ＊2）個のダブルクォーテーションを指定し，パラメタ全体をダブルクォーテーションで囲んでください。

なお，ExecコマンドやNetExecコマンドで特別な意味を持つ”/SPT:HIDE”，”/SPT:MIN”，”/SPT:MAX”パラメタ，および， “/SPALV（n）”，”/SPXLV（n）”，”/NOEVLOG”パラメタを指定してもコマンドラインパラメタとして渡され，文字列として扱われます。特別な意味は持ちません。

説明

指定されたスクリプトファイルを実行します。

Execコマンドと異なり，現在のプロセスと同一のプロセスで実行します。したがって，プロシージャのように現在のプロセスの環境を共有し，プロセス環境変数を更新することができます。

CallSptコマンドを実行するスクリプトファイル（以下「親スクリプト」という）と，SptFileNameで指定されたスクリプトファイル（以下「子スクリプト」という）の間での変数やプロシージャの関係について次に示します。

子スクリプト内でDimコマンドなどを使用して明示的に宣言された変数は，子スクリプトの中だけで有効なローカル変数になります。

子スクリプト内で明示的に宣言しないで使われている変数も，親スクリプトのCallSptコマンドよりも前，または親スクリプトのさらに上のレベルの親スクリプトで定義されていないかぎりは，ローカル変数となります。親スクリプトのCallSptコマンドよりも前，または親スクリプトのさらに上のレベルの親スクリプトで定義されている場合はグローバルな変数として扱われます。

親スクリプト内，または親スクリプトのさらに上のレベルの親スクリプトで定義されているプロシージャは子スクリプト内で使用することができます。

親スクリプトと子スクリプトで同じ名前のプロシージャが定義されている場合，子スクリプト内では子スクリプトで定義されたプロシージャが有効になります。ただし，親スクリプト内のプロシージャがFunctionプロシージャで子スクリプト内のプロシージャがSubプロシージャである場合，親スクリプトのFunctionプロシージャが有効になります。

子スクリプト内で定義されたローカル変数やプロシージャ，子スクリプトの位置変数は，子スクリプトの実行が終了する（＝親スクリプトのCallSptコマンドが終了する）と破棄されます。

子スクリプトを単体で実行する場合，親スクリプトの変数，プロシージャは使用できません。

子スクリプト中の#FileVersionや#Optionの記述，および実行環境ファイル（.SPV）の内容はすべて無視し，親スクリプトの指定で実行します。

コマンドが正常に実行された場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，実行ファイルの終了コードを_EXEC_RTN_予約変数に符号付の数値で格納します。

補足

ほかのコマンドと異なりCallSptコマンドの文法チェックを行った場合は，SptFileNameで指定されたスクリプトファイルの文法チェックも行います。

パラメタに空文字を指定すると，無視されます。パラメタを省略する場合は，明示的な文字列などを呼び出し元から呼び出し先に渡すようにしてください。例2を参照してください。

パラメタに空白を含む文字列を指定すると，パラメタを空白で区切った一つの文字列として呼び出し先に渡します。この場合，空白を含む文字列全体をダブルクォーテーション（"）で囲んでください。ただし，呼び出し先で受け取ったパラメタのダブルクォーテーション（"）を取り除く処理が必要になります。例3を参照してください。

注意

CallSptコマンドで呼び出したスクリプト内でExitコマンドを実行した場合は，CallSptコマンドで呼び出したスクリプトの実行を終了して呼び出し元のスクリプトに戻るだけで，呼び出し元のスクリプトの実行は終了しません。

Execコマンド，またはNetExecコマンドで呼び出した実行ファイルの終了待ちをしない場合に，ExitコマンドのオプションのSkipが有効になります。CallSptコマンドで呼び出したスクリプトファイルからExecコマンド，またはNetExecコマンドで呼び出した実行ファイルが終了するのを待たないでスクリプトを終了するには，CallSptコマンドを実行するスクリプトファイルのExitコマンドのオプションにSkipを指定してください。Execコマンド，またはNetExecコマンドを実行するスクリプトファイルのExitコマンドのオプションにSkipを指定してもスクリプトは終了しません。具体的には例4を参照してください。

例1

' スクリプトファイル"Environment.SPT"を実行し，
' プロセス環境変数を更新・参照する。
Dim Path01
rtn = CallSpt(_SCF_+"Environment.SPT", "Get", "Path01", _
Path01)
     :
rtn = CallSpt(_SCF_+"Environment.SPT", "Set", "Path01", _
_TEMP_)

' Environment.SPTの処理
Select Case  %1
Case  "Set"
  SetEnv(ProcessEnv, %2, %3)
Case  "Get"
  %3 = GetEnv(ProcessEnv, %2)
End Select

例2

次の場合，呼び出し元のスクリプトではCallSptコマンドのNULLパラメタ（空文字""）は無視されます。

位置変数%1には"B"，%2には"D"が格納され呼び出し先のスクリプトに渡されます。

呼び出し元

CallSpt("A.spt", "B", "", "D")

呼び出し先

Parm1 = %1  ' "B"
Parm2 = %2  ' "D"
Parm3 = %3  ' 空文字""

パラメタを省略する場合は，次のように明示的な文字列などを呼び出し元から呼び出し先に渡します。

呼び出し元

Dim C_Parm
If ・・・ Then
   C_Parm="C"
Else
   C_Parm="***NOTPARAMETA***"
End If
CallSpt("A.spt", "B", C_Parm, "D")
     ：

呼び出し先

If %2 <> "***NOTPARAMETA***" Then
   Parm1 = %1 ' "B"
   Parm2 = %2 ' "C"
   Parm3 = %3 ' "D"
Else
   Parm1 = %1 ' "B"
   Parm2 = "" ' 空文字""
   Parm3 = %3 ' "D"
End If

予約変数「_ARGV_CNT_」に呼び出されたときの引数の数が格納されています。引数が省略されていないか確認したい場合は，「_ARGV_CNT_」を使用してチェックしてください。

例3

次の場合，呼び出し元のスクリプトでは位置変数%1に"My"，%2に"Documents"，%3に"Files"が格納されます。

   CallSpt("A.spt", "My Documents", "Files")

パラメタに空白を含む場合は，文字列全体をダブルクォーテーション（"）で囲んで呼び出し先に渡してください。ただし，呼び出し先にはダブルクォーテーション（"）を含んだ文字列が渡されますので，次のように前後のダブルクォーテーション（"）を取り除く処理が必要になります。

呼び出し元

CallSpt("A.spt", """My Documents""", "Files")
     ：

呼び出し先

Dim Parm1
Dim Path1
 Parm1= Mid (%1, 2, Len (%1) - 2)
 Path1 = Parm1 + "¥" + %2
     ：

例4

呼び出し先の実行ファイルの終了を待たないで呼び出し元のスクリプトを終了する。

呼び出し元　SampleA.SPT

' スクリプトファイル"SampleB.SPT"を呼び出す。
CallSpt(_SCF_+"SampleB.SPT")
   :
' SampleC.EXEの終了を待たないでスクリプトを終了する。
Exit(0,Skip)

呼び出し先　SampleB.SPT

' 実行ファイル"SampleC.EXE"を終了待ちをしない指定で呼び出す。
Exec(_SCF_+"SampleC.EXE",False)

対象バージョン

JP1/Script 06-71以降

8.11　自動起動処理コマンド

＜この節の構成＞

8.11.1　EntryStartUp （スクリプトファイルを自動起動に登録する）

8.11.2　CancelStartUp （スクリプトファイルの自動起動の登録を解除する）

8.11.1　EntryStartUp （スクリプトファイルを自動起動に登録する）

機能

スクリプトファイルを自動起動に登録します。

形式

EntryStartUp ( FilePath , 〔MultiExec〕 , 〔ExecType〕 , 〔ExecTime〕 , 〔ExecWeek〕 , 〔ExecDay〕 〔, TerminateTime〕 )

指定項目

FilePath

登録するスクリプトファイルのフルパスを文字列，または値を格納した変数名で指定します。ファイル名の拡張子（.SPT）を省略しても自動的に付加して動作します。

MultiExec

スクリプトファイルの複数起動を許可するかどうかを指定します。複数起動を許可する場合は真（True）を，許可しない場合は偽（False）を指定します。

この値は省略できます。省略した場合，実行環境ファイルで定義された値を仮定します。

ExecType

起動のタイプを指定します。

この値は次のどれかになります。

値 | 意味
Logon | ログオン時に起動
Service | JP1/Scriptのサービス開始時に起動

この値は省略できます。省略した場合，実行環境ファイルで定義された値を仮定します。

ExecTime

起動する時刻を設定する場合，時刻をhh:mm:ssの形式で指定します。ssには必ず00を指定してください。それ以外の値を指定しても00とおきかえて動作します。

起動する時刻の設定をしない場合は，省略します。

ExecWeek

起動する曜日を設定する場合，起動する曜日を表す値を数値，または値を格納した変数名で指定します。

この値は次のどれかになります。

値 | 意味
1 | 日曜
2 | 月曜
3 | 火曜
4 | 水曜
5 | 木曜
6 | 金曜
7 | 土曜

起動する曜日を設定しない場合は，省略します。

ExecDay

起動する日付を設定する場合，日付を数値，または値を格納した変数名で指定します。指定できる値の範囲は1から31までです。

起動する日付を設定しない場合は，省略します。

ExecWeekに値を指定した場合は，無効になります。

TerminateTime

打ち切り時間を数値，または値を格納した変数名で指定します。時間は分単位で指定します。指定できる値の範囲は，0から1,440までです。

この値は省略できます。省略した場合，実行環境ファイルで定義された値を仮定します。

説明

スクリプトファイルを自動起動に登録します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）をコマンドの実行結果として返します。

このコマンドはFilePathで指定されたスクリプトファイルの実行環境ファイル（.SPV）の内容を更新します。実行環境ファイルがない場合は，新しく実行環境ファイルを作成します。

注意

Windows XPの場合，異なるユーザで同じスクリプトに対してログオン空間の自動起動情報を登録した場合，前に登録したユーザの自動起動の条件が無効になり，あとのユーザで登録したときの条件になります。無条件に更新されるので十分注意してください。

例

' D:¥Work¥Script下にあるスクリプトファイルで，実行環境ファイルが存在する
' ものだけを自動起動に登録する。
wkPath = "D:¥Work¥Script¥"
' 拡張子が.SPTのファイル名をFileNameに取得する。
For  FileName = wkPath + "*" + _SCF_EXT_  Do
 ' ファイル名にフォルダ名を連結し,FileNameに設定する。
 FileName = wkPath + FileName
 ' ファイル名の拡張子を.SPVに変更し,FilePathに設定する。
 FilePath = Left ( FileName ,Len ( FileName ) - 4 )+ _SVF_EXT_
 If  IsExistFile ( FilePath ) = True  Then
   EntryStartUp ( FileName )
 End
End For

対象バージョン

JP1/Script 05-10以降

8.11.2　CancelStartUp （スクリプトファイルの自動起動の登録を解除する）

機能

スクリプトファイルの自動起動の登録を解除します。

形式

CancelStartUp ( 〔FilePath〕 )

指定項目

FilePath

登録を解除するスクリプトファイルのフルパスを文字列，または値を格納した変数名で指定します。ファイル名の拡張子（.SPT）を省略しても自動的に付加して動作します。

この値は省略できます。省略した場合，自動起動に登録されているすべてのスクリプトファイルを解除します。

説明

指定されたスクリプトファイルの自動起動の登録を解除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

また，指定されたスクリプトファイルが存在しない場合や指定されたスクリプトファイルの実行環境ファイルが自動起動に登録されていない場合は，常に真（True）を返します。

例

' このスクリプトが起動されてから1時間後に，自動起動に登録されている
' すべてのスクリプトファイルを解除する。
Sleep ( 60 * 60 * 1000 )
CancelStartUp ( )

対象バージョン

JP1/Script 05-10以降

8.12　JP1呼び出しコマンド

＜この節の構成＞

8.12.1　JOBSubmit （キューサーバにスクリプトを登録する）

8.12.2　JOBWait （ジョブの終了を待つ）

8.12.3　JOBHold （ジョブを保留／解除する）

8.12.4　JOBCancel （ジョブをキャンセルする）

8.12.1　JOBSubmit （キューサーバにスクリプトを登録する）

機能

JP1/AJS2，またはJP1/NetBatchのキューサーバに対してスクリプトを登録します。

形式

JOBSubmit (〔DomainName〕, QueSrvName , QueName , UserName , 〔JobName〕 , Priority , FilePath , 〔CommandLine〕 , JobNoBuff 〔, Flag〕 )

指定項目

DomainName

QueSrvNameで指定するキューサーバが参加しているドメイン名，またはワークグループ名を，文字列，または値を格納した変数名で指定します。指定できる文字数は，ドメイン名の最大文字数です。スタンドアロンで運用している場合は省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

QueSrvName

QueNameで指定するキューが作成されているサーバ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，コンピュータ名の最大文字数です。

QueName

ジョブを投入するキュー名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，DomainNameとQueSrvNameとQueNameを合わせて半角文字で65文字以内（全角文字で32文字以内）です。

なお，デフォルトキューは指定できません。

UserName

ジョブを投入するユーザの名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。

なお，JP1/AJS2から起動したスクリプトファイルでJOBSubmitコマンドを実行した場合，ログオンしたユーザの名称に変更されます。

JobName

投入するジョブに付ける名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で32文字以内（全角文字で16文字以内）です。

この値を省略する場合は，長さ0の文字列（""）を指定してください。このように指定するとFilePathで指定したファイル名の先頭32文字がジョブ名として扱われます。

Priority

投入するジョブの実行優先順位を指定します。

この値は次のどれかになります。

値 | 意味
0 | 対話処理と比較して低いことを表します。
1 | 対話処理と同等であることを表します。
2 | 対話処理と比較して高いことを表します。

FilePath

ジョブとして実行するスクリプトファイル名のフルパスを文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で259文字以内（全角文字で129文字以内）です。

スペースを含むフルパスを指定しないでください。指定した場合は，正しく動作しません。

CommandLine

FilePathで指定したファイルに対するパラメタを文字列，または値を格納した変数名で指定します。サブミットするジョブにパラメタが不要な場合は，省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

指定できる文字数は，半角文字で256文字以内（全角文字で128文字以内）です。

JobNoBuff

投入したジョブに割り当てられたジョブ番号を受け取る変数名を指定します。このジョブ番号は，JOBWaitコマンド，JOBHoldコマンド，JOBCancelコマンドで使用します。

Flag（01-01以降）

内部的にJP1/AJS2，またはJP1/Net Batchの関数NetBatchQueueOpen，およびNetBatchQueueCloseを呼び出して指定されたキューの開閉をする場合は真（True）を，呼び出さないでキューの開閉をしない場合は偽（False）を指定します。

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

同じキューに対して，ほかのアプリケーションと並行してこのコマンドを実行する場合，偽（False）を指定することを推奨します。

説明

指定されたキューに対して指定されたスクリプトファイルを登録します。

このコマンドは，内部的にはJP1/AJS2，またはJP1/NetBatchの関数NetBatchQueueOpen，NetBatchJobSubmitWithID，NetBatchJobGetWithID，NetBatchQueueCloseが実行されています。

内部的に呼び出す関数が成功した場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，関数の終了コードを_JOB_RTN_予約変数に格納します。コマンドの実行結果が偽（False）の場合は，_JOB_RTN_予約変数には何も格納されません。

_JOB_RTN_予約変数に格納される値は次のどれかになります。

値
意味

0
正常終了。

1
パラメタに誤りがある。

2
メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。

3
ネットワークに障害が生じた。

4
次のどれかの状態を示す。

指定したキューが存在しない。

キュー名称に誤りがある。

バッチジョブ運用が停止処理中，または停止状態である。

JP1/NetBatchサービスが初期化中である。

キューが閉じられている。

10
JP1/NetBatchの関数NetBatchQueueOpen，またはNetBatchQueueCloseを使用するためのアクセス権がない。
またはキューに投入できるジョブ数の最大値を超えたことによって，キューが強制的に閉じられたため，関数では操作できない。

なお，この値はJP1/NetBatch 02-00の時点での関数の終了コードです。それ以降のJP1/NetBatch，またはJP1/AJS2での関数の終了コードに関しては，JP1/NetBatch，またはJP1/AJS2を参照してください。

例

Dim  rtn1 ,jobNo
rtn1 = JOBSubmit ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,  _
                 "" ,0 ,_BIN_+"SCRIPT.SPT" ,"" ,jobNo )
If  rtn1 = True  And  _JOB_RTN_ <> 0  Then
 MessageBox ( "JOBSubmitで失敗しました！" ,OK , ,Ex )
End

対象バージョン

JP1/Script 01-00以降

8.12.2　JOBWait （ジョブの終了を待つ）

機能

JOBSubmitコマンドで登録したジョブが終了するのを待ちます。

形式

JOBWait ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo , 〔JobNameBuff〕 , 〔ExitCodeBuff〕 , 〔JobSubmitTimeBuff〕 , 〔JobStartTimeBuff〕 , 〔JobEndTimeBuff〕 , 〔FilePathBuff〕 , 〔CommandLineBuff〕 〔, Time〕 )

指定項目

DomainName

QueSrvNameで指定するキューサーバが参加しているドメイン名，またはワークグループ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，ドメイン名の最大文字数です。スタンドアロンで運用している場合は省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

QueSrvName

QueNameで指定するキューが作成されているサーバ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，コンピュータ名の最大文字数です。

QueName

ジョブを投入したキュー名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，DomainNameとQueSrvNameとQueNameを合わせて半角文字で65文字以内（全角文字で32文字以内）です。

UserName

ジョブを投入したユーザの名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。

JobNo

実行を保留，または保留解除するジョブのジョブ番号を数値，または値を格納した変数名で指定します。このジョブ番号は，JOBSubmitコマンドで取得した番号です。

JobNameBuff

ジョブ名称を受け取る変数名を指定します。

この値は省略できます。

ExitCodeBuff

JobNoで指定したジョブの終了コードを受け取る変数名を指定します。

この値は省略できます。

JobSubmitTimeBuff

JobNoで指定したジョブの投入時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。

この値は省略できます。

JobStartTimeBuff

JobNoで指定したジョブの実行が開始された時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。

この値は省略できます。

JobEndTimeBuff

JobNoで指定したジョブの実行が終了した時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。

この値は省略できます。

FilePathBuff

JOBSubmitコマンドで指定したジョブとして実行するスクリプトファイル名のフルパスを受け取る変数名を指定します。

この値は省略できます。

CommandLineBuff

JOBSubmitコマンドで指定したジョブとして実行するファイルに対するパラメタを受け取る変数名を指定します。

この値は省略できます。

Time

ジョブの終了を監視する間隔を数値，または値を格納した変数名で指定します。

間隔はミリ秒単位で指定します。

この値は省略できます。省略した場合，1,000ミリ秒を仮定します。

説明

JOBSubmitコマンドで登録したジョブの実行が終了するのを待ちます。

このコマンドは，内部的にはJP1/AJS2，またはJP1/NetBatchの関数NetBatchJobGetWithIDが実行されています。

内部的に呼び出す関数が成功した場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，関数の終了コードを_JOB_RTN_予約変数に格納します。コマンドの実行結果が偽（False）の場合は，_JOB_RTN_予約変数には何も格納されません。

_JOB_RTN_予約変数に格納される値は次のどれかになります。

値
意味

0
正常終了。

1
パラメタに誤りがある。

2
メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。

3
ネットワークに障害が生じた。

4
次のどれかの状態を示す。

指定したキューが存在しない。

キュー名称に誤りがある。

バッチジョブ運用が停止状態である。

JP1/AJS2，またはJP1/Net Batch サービスが初期化中である。

5
ジョブ番号で指定したジョブが存在しない。

なお，この値はJP1/NetBatch 02-00の時点での関数の終了コードです。それ以降のJP1/NetBatch，またはJP1/AJS2での関数の終了コードに関しては，JP1/NetBatch，またはJP1/AJS2を参照してください。

例

Dim  rtn1 ,jobNo
rtn1 = JOBSubmit ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,  _
                 "" ,0 ,_BIN_+"SCRIPT.SPT" ,"" ,jobNo )
If  rtn1 = True  And  _JOB_RTN_ = 0  Then
 rtn1 = JOBWait ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo )
 If  rtn1 = True  And  _JOB_RTN_ = 0  Then
   MessageBox ( "ジョブの実行は終了しました。" ,OK , ,Information )
 End
End

対象バージョン

JP1/Script 01-00以降

8.12.3　JOBHold （ジョブを保留／解除する）

機能

JOBSubmitコマンドで登録したジョブを保留・保留解除します。

形式

JOBHold ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo , Flag )

指定項目

DomainName

QueSrvNameで指定するキューサーバが参加しているドメイン名，またはワークグループ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，ドメイン名の最大文字数です。スタンドアロンで運用している場合は省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

QueSrvName

QueNameで指定するキューが作成されているサーバ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，コンピュータ名の最大文字数です。

QueName

ジョブを投入したキュー名称を文字列，または値を格納した変数名で指定します。

指定できる文字数は，DomainNameとQueSrvNameとQueNameを合わせて半角文字で65文字以内（全角文字で32文字以内）です。

UserName

ジョブを投入したユーザの名称を文字列，または値を格納した変数名で指定します。

指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。

JobNo

実行を保留，または保留解除するジョブのジョブ番号を数値，または値を格納した変数名で指定します。このジョブ番号は，JOBSubmitコマンドで取得した番号です。

Flag

ジョブの実行を保留するときには真（True）を，ジョブの保留を解除するときには偽（False）を指定します。

説明

JOBSubmitコマンドで登録したジョブの実行を保留，または保留解除します。ジョブが実行待ち状態の場合にだけ，実行を保留できます。またジョブが保留状態の場合にだけ，保留を解除できます。

このコマンドは，内部的にはJP1/AJS2，またはJP1/NetBatchの関数NetBatchJobHoldWithIDが実行されています。

内部的に呼び出す関数が成功した場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，関数の終了コードを_JOB_RTN_予約変数に格納します。コマンドの実行結果が偽（False）の場合は，_JOB_RTN_予約変数には何も格納されません。

_JOB_RTN_予約変数に格納される値は次のどれかになります。

値
意味

0
正常終了。

1
パラメタに誤りがある。

2
メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。

3
ネットワークに障害が生じた。

4
次のどれかの状態を示す。

指定したキューが存在しない。

キュー名称に誤りがある。

バッチジョブ運用が停止状態である。

JP1/AJS2，またはJP1/Net Batchサービスが初期化中である。

5
ジョブ番号で指定したジョブが存在しない。

6
ジョブ番号で指定したジョブは，現在実行中である。

なお，この値はJP1/NetBatch 02-00の時点での関数の終了コードです。それ以降のJP1/NetBatch，またはJP1/AJS2での関数の終了コードに関しては，JP1/NetBatch，またはJP1/AJS2を参照してください。

例

Dim  rtn1 ,jobNo
rtn1 = JOBSubmit ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,  _
                 "" ,0 ,_BIN_+"SCRIPT.SPT" ,"" ,jobNo )
If  rtn1 = True  And  _JOB_RTN_ = 0  Then
 rtn1 = JOBHold ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo ,True )
 If  rtn1 = True  And  _JOB_RTN_ = 0  Then
   MessageBox ( "ジョブの実行を保留しています。" ,OK , ,Information )
 End
End

対象バージョン

JP1/Script 01-00以降

8.12.4　JOBCancel （ジョブをキャンセルする）

機能

JOBSubmitコマンドで登録したジョブをキャンセルします。

形式

JOBCancel ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo )

指定項目

DomainName

QueSrvNameで指定するキューサーバが参加しているドメイン名，またはワークグループ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，ドメイン名の最大文字数です。スタンドアロンで運用している場合は省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

QueSrvName

QueNameで指定するキューが作成されているサーバ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，コンピュータ名の最大文字数です。

QueName

ジョブを投入したキュー名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，DomainNameとQueSrvNameとQueNameを合わせて半角文字で65文字以内（全角文字で32文字以内）です。

UserName

ジョブを投入したユーザの名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。

JobNo

実行をキャンセルするジョブのジョブ番号を数値，または値を格納した変数名で指定します。このジョブ番号は，JOBSubmitコマンドで取得した番号です。

説明

JOBSubmitコマンドで登録したジョブの実行をキャンセルします。ジョブが実行待ち状態の場合だけでなく実行中のジョブもキャンセルできます。

このコマンドは，内部的にはJP1/AJS2，またはJP1/NetBatchの関数NetBatchJobCancelWithIDが実行されています。

内部的に呼び出す関数が成功した場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，関数の終了コードを_JOB_RTN_予約変数に格納します。コマンドの実行結果が偽（False）の場合は，_JOB_RTN_予約変数には何も格納されません。

_JOB_RTN_予約変数に格納される値は次のどれかになります。

値
意味

0
正常終了。

1
パラメタに誤りがある。

2
メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。

3
ネットワークに障害が生じた。

4
次のどれかの状態を示す。
・指定したキューが存在しない。
・キュー名称に誤りがある。
・バッチジョブ運用が停止状態である。
・JP1/AJS2，またはJP1/Net Batchサービスが初期化中である。

5
ジョブ番号で指定したジョブが存在しない。

なお，この値はJP1/NetBatch 02-00の時点での関数の終了コードです。それ以降のJP1/NetBatch，またはJP1/AJS2での関数の終了コードに関しては，JP1/NetBatch，またはJP1/AJS2を参照してください。

例

Dim  rtn1 ,jobNo
rtn1 = JOBSubmit ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,  _
                 "" ,0 ,_BIN_+"SCRIPT.SPT" ,"" ,jobNo )
If  rtn1 = True  And  _JOB_RTN_ = 0  Then
 rtn1 = JOBCancel ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo )
 If  rtn1 = True  And  _JOB_RTN_ = 0  Then
   MessageBox ( "ジョブの実行をキャンセルしました。" ,OK , ,Ex )
 End
End

対象バージョン

JP1/Script 01-00以降

8.13　コメントコマンド

＜この節の構成＞

8.13.1　Remまたは ' （プログラム内にコメントを記述する）

8.13.1　Remまたは ' （プログラム内にコメントを記述する）

機能

プログラム内にコメントを記述するときに指定します。

形式

Rem Comment
' Comment

指定項目

Comment

プログラムをわかりやすくするための説明文（コメント）を記述します。RemとCommentの間には，半角文字で1文字以上のスペースを入力する必要があります。

説明

Remの代わりにクォーテーション（'）を使うことができます。同じ行のほかのステートメント，またはコマンドの後にクォーテーション（'）やRemを記述できます。

例

Rem  ファイルにメッセージを出力する。
Message ( Target_File ,_SCF_+"履歴.TXT" ,"実行開始" )

' ウィンドウにメッセージを出力する。
Message ( Target_DispOn ,"履歴" ,"実行開始" )

対象バージョン

JP1/Script 01-00以降

8.14　その他のコマンド

＜この節の構成＞

8.14.1　Sleep （スクリプトの実行を中断する）

8.14.2　Alert （ユーザエラーを警告／解除する）

8.14.3　Beep （スピーカからビープ音を鳴らす）

8.14.4　Exit （スクリプトを終了する）

8.14.5　GetErrorMessage （エラーメッセージを取得する）

8.14.1　Sleep （スクリプトの実行を中断する）

機能

指定された時間，スクリプトの実行を中断します。

形式

Sleep ( Time )

指定項目

Time

中断する時間を0からの数値，または値を格納した変数名で指定します。

時間はミリ秒単位で指定します。

説明

指定された時間だけスクリプトの実行が中断されます。

例

If  debug = True  Then
 Sleep ( 3000 )
End

対象バージョン

JP1/Script 01-00以降

8.14.2　Alert （ユーザエラーを警告／解除する）

機能

トレースビューアのステータスにユーザエラーを警告・警告解除します。

形式

Alert ( 〔Mode〕 )

指定項目

Mode

トレースビューアのステータスを指定します。

この値は次のどれかになります。

値 | 意味
UserErr （05-10以降） または真（True） | ユーザエラーを警告します。
CancelUserErr （05-10以降） または偽（False） | ユーザエラーの警告を解除し，実行中に戻します。
Normal （05-10以降） | 正常終了に戻します。

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

説明

トレースビューアのステータスにユーザエラーを警告します。また警告を解除し，トレースビューアのステータスを実行中に戻します。

ステータスを正常終了に戻すこともできます。

例

path1 = _BIN_+"Loging.txt"
Message ( Target_File ,path1 ,"実行開始¥n" ,30 ,100 )
 :
 :
Message ( Target_File ,path1 ,"実行終了" )

If  IsExistFile ( path1 )  Then
 Alert ( True )
End

対象バージョン

JP1/Script 01-00以降

8.14.3　Beep （スピーカからビープ音を鳴らす）

機能

指定された時間，スピーカからビープ音を鳴らします。

形式

Beep ( 〔Frequency〕 〔, Time〕 )

指定項目

Frequency

ビープ音の周波数を数値，または値を格納した変数名で指定します。

周波数はヘルツ単位で指定します。指定できる値の範囲は，37から32767までです。

この値は省略できます。省略した場合，440ヘルツを仮定します。

Time

ビープ音の周期を0からの数値，または値を格納した変数名で指定します。

周期はミリ秒単位で指定します。

この値は省略できます。省略した場合，100ミリ秒を仮定します。

説明

スピーカからビープ音を鳴らします。

注意

OS，ハードウェア環境によっては，Beepコマンドを実行してビープ音を鳴らすことができません。また，以下のエラーなどが発生する場合もあります。
0001：ファンクションが間違っています。
0002：システムは指定されたファイルを見つけることができません。
0005：アクセスは拒否されました。ファイルの属性又はセキュリティを見直してください。
1722：RPC サーバーを利用できません

Beepコマンドを使用する場合は，実行環境であらかじめ動作確認をした上で使用してください。ビープ音が鳴らない，またはエラーになる場合は，次に示す方法で対処してください。
(1) IMEventMessageコマンドを実行して，JP1/IMのイベントコンソールにメッセージを表示する。
（例）IMEventMessage( "エラーが発生しました", Error )
(2) サービス空間で実行する場合は，Beepコマンドを実行するスクリプトを作成して，NetExecコマンドのログオン空間指定でBeepコマンドを実行するスクリプトを呼び出してください。ただし，ログオン空間の実行環境でBeep音が鳴ることが前提になります。

例

Beep ( 300 ,200 )

対象バージョン

JP1/Script 01-00以降

8.14.4　Exit （スクリプトを終了する）

機能

スクリプトの実行を終了します。

形式

Exit ( 〔Code〕 〔, Option〕 )

指定項目

Code

終了コードを数値，または値を格納した変数名で指定します。

この値を省略した場合は，0が仮定されます。

Option

オプションを指定します。

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

値 | 意味
Skip | Execコマンド，およびNetExecコマンドで呼び出した実行ファイルが終了するのを待たないでスクリプトを終了します。
AbortまたはStop | Execコマンド，およびNetExecコマンドで呼び出した実行ファイルをスクリプト終了時にすべて強制終了します。

この値は省略できます。省略した場合，スクリプト終了時にExecコマンド，およびNetExecコマンドで呼び出した実行ファイルがすべて終了するまで待ちます。

説明

スクリプトの実行を終了します。

なお，JP1/Scriptの終了コードについては，「6.1.12 JP1/Scriptの終了コード」を参照してください。

注意

CallSptコマンドで呼び出したスクリプト内でExitコマンドを実行した場合は，CallSptコマンドで呼び出したスクリプトの実行を終了して呼び出し元のスクリプトに戻るだけで，呼び出し元のスクリプトの実行は終了しません。

Execコマンド，またはNetExecコマンドで呼び出した実行ファイルの終了待ちをしない場合に，ExitコマンドのオプションのSkipが有効になります。CallSptコマンドで呼び出したスクリプトファイルからExecコマンド，またはNetExecコマンドで呼び出した実行ファイルが終了するのを待たないでスクリプトを終了するには，CallSptコマンドを実行するスクリプトファイルのExitコマンドのオプションにSkipを指定してください。Execコマンド，またはNetExecコマンドを実行するスクリプトファイルのExitコマンドのオプションにSkipを指定してもスクリプトは終了しません。具体的には「8.10.5　CallSpt（複数パラメタ指定でSPTファイルを呼び出す）」の例4を参照してください。

例

MessageBox ( "スクリプトの実行を終了します。" ,OK )
Exit ( 0 )

対象バージョン

JP1/Script 01-00以降

8.14.5　GetErrorMessage （エラーメッセージを取得する）

機能

指定されたエラー詳細コードのエラーメッセージを取得します。

形式

GetErrorMessage ( 〔Code〕 )

指定項目

Code

エラー詳細コードを数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，現在の_RTN_予約変数に格納されている値を仮定します。

説明

指定されたエラー詳細コードのエラーメッセージを取得し，メッセージを実行結果として返します。

また，エラーメッセージの文字数が半角文字で1,024文字を超える場合，1,024文字で切り捨てられます。

例

If  Exec ( _WIN_+"NOTEPAD.EXE" ,True ,_BIN_+"Loging.txt" )  Then
 Exit ( _EXEC_RTN_ )
Else
 Dim  errMsg
 errMsg = GetErrorMessage ( _RTN_ )
 Message ( Target_File ,_BIN_+"ErrLog.txt" ,errMsg )
 Exit ( 1 )
End

対象バージョン

JP1/Script 01-01以降

9.　特殊コマンド

この章では，スクリプトを作成するときに使用できる特殊コマンドについて説明します。

＜この章の構成＞

9.1　特殊コマンド一覧

9.2　レジストリ操作コマンド

9.3　描画・表示処理コマンド

9.4　チェック処理コマンド

9.5　サービス操作コマンド

9.6　外部プログラム呼び出しコマンド

9.7　ショートカット操作コマンド

9.8　プロセス監視コマンド

9.9　その他のコマンド

9.1　特殊コマンド一覧

特殊コマンドは，レジストリ操作，サービス操作など，上級者向けのスクリプトをサポートするためのコマンドです。

スクリプトを作成するときに使用できる，特殊コマンドの一覧を表9-1に示します。なお，コマンド欄の括弧内の数字は，対象バージョンを表します（括弧がないものは，01-00からサポートしています）。

レジストリ操作やサービス操作のコマンドで，製品の非公開情報を使用する場合，十分に注意をした上で実施してください。

表9-1　特殊コマンド一覧

分類 | コマンド | 意味
レジストリ操作 | RegRead | レジストリから値を読み込みます。
RegWrite | レジストリに値を設定します。
RegDelete | レジストリの値を削除します。
RegDeleteKey | レジストリのサブキーを削除します。
画像・表示処理 | BitmapShow（05-00以降） | ビットマップを描画します。
BitmapHide（05-00以降） | ビットマップを消去します。
チェック処理 | IsEmptyReg | レジストリサブキーの中身が空かどうかをチェックし，結果を真（True）か偽（False）で返します。
IsExistRegKey | レジストリサブキーが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。
IsExistService | サービスが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。
IsEmptyGroup（05-20以降） | プログラムグループの中身が空かどうかをチェックし，結果を真（True）か偽（False）で返します。
サービス操作 | ServiceSetValue※ | サービス操作に必要な情報を，サービス情報というオブジェクトとして設定します。
ServiceGetValue | サービス情報に格納されている情報を取得します。
ServiceCreate | サービスを登録します。
ServiceDelete | サービスを削除します。
ServiceStart | 登録しているサービスを開始します。
ServiceStop | 登録しているサービスを停止します。
ServicePause | 登録しているサービスを一時停止します。
ServiceContinue | 一時停止しているサービスを再開します。
ServiceChange | サービスの設定情報を変更します。
ServiceQuery | サービスの設定情報を取得します。
ServiceRefer | サービスの現在の状態を取得します。
ServiceControl | サービスに制御コマンドを送ります。
GetServiceName（05-10以降） | サービスの表示名からサービス名を取得します。
外部プログラム呼び出し | CallDll | DLLファイルを呼び出します。複数パラメタの指定が可能です。
ショートカット操作 | MakeGroup（05-20以降） | プログラムグループを作成します。
DeleteGroup（05-20以降） | プログラムグループを削除します。
MakeShortcut（05-20以降） | ショートカットを作成します。
DeleteShortcut（05-20以降） | ショートカットを削除します。
プロセス監視 | GetProcessCount（05-20以降） | 指定したプロセスの起動数とプロセスIDを取得します。
GetProcessInfo（05-20以降） | 指定したプロセスIDのプロセスの情報を取得します。
TerminateProcess（05-20以降） | 指定したプロセスIDのプロセスを強制終了します。
その他 | ExitWindows（05-10以降） | スクリプトの実行を終了し，Windowsをログオフ，またはシャットダウンします。
SetRetryMode（10-00以降） | 排他エラーリトライ機能を設定します。
ResetRetryMode（10-00以降） | 排他エラーリトライ機能を解除します。
SetTrialOpenMode（10-00以降） | 試行オープン機能を設定します。
ResetTrialOpenMode（10-00以降） | 試行オープン機能を解除します。

注※

サービス操作コマンドを利用する場合，あらかじめServiceSetValueコマンドを使って，必要な情報をサービス情報に設定しておきます。

9.2　レジストリ操作コマンド

＜この節の構成＞

9.2.1　RegRead （レジストリから値を読み込む）

9.2.2　RegWrite （レジストリに値を登録する）

9.2.3　RegDelete （レジストリの値を削除する）

9.2.4　RegDeleteKey （レジストリのサブキーを削除する）

9.2.1　RegRead （レジストリから値を読み込む）

機能

レジストリから値を読み込みます。

形式

RegRead ( RegKey , SubKey , ValueBuff , 〔EntryName〕 , 〔TypeBuff〕 〔, Option〕 )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_LOCAL_MACHINEを指定し，SubKeyの最初のキーにSoftwareを指定した場合，HKEY_CURRENT_USER¥Software¥Classes¥VirtualStore¥Machine¥Software下にリダイレクトされます。リダイレクトされたエントリは優先して読み込まれます。

SubKey

レジストリサブキーを文字列，または値を格納した変数名で指定します。

ValueBuff

読み込んだ値を受け取る変数名を指定します。

EntryName

エントリ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，エントリ名のない値を仮定します。

TypeBuff

型を受け取る変数名を指定します。

この変数に格納される値は次のどれかになります。

REG_BINARY

REG_DWORD

REG_DWORD_BIG_ENDIAN

REG_EXPAND_SZ

REG_LINK

REG_MULTI_SZ

REG_NONE

REG_RESOURCE_LIST

REG_SZ

この値は省略できます。

Option

オプションを指定します。

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

値 | 意味
10 | 値がREG_DWORD型，またはREG_DWORD_BIG_ENDIAN型の場合，読み込んだ値を10進数で返します。
16 | 値がREG_DWORD型，またはREG_DWORD_BIG_ENDIAN型の場合，読み込んだ値を16進数で返します。

この値は省略できます。省略した場合，16を仮定します。

説明

レジストリから値を読み込み，指定された変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

注意

読み込んだレジストリの型がREG_MULTI_SZの場合，先頭行の値だけ変数に格納されます。

読み込むレジストリの値の長さが1,025バイト以上の場合，「0234：データがさらにあります。」のエラーになります。値の長さが1,025バイト以上のレジストリを読み込まないようにしてください。

例

Dim  DBflag
RegRead ( HKEY_LOCAL_MACHINE   _
       ,"Software¥Hitachi¥JP1/Script¥Option" _
       , DBflag ,"Debug" )
If  DBflag = 1  Then
 Exit
End

対象バージョン

JP1/Script 01-00以降

9.2.2　RegWrite （レジストリに値を登録する）

機能

レジストリに値を登録します。

形式

RegWrite ( RegKey , SubKey , 〔EntryName〕 , 〔Value〕 〔, Type〕 )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_CURRENT_USER以外を指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

SubKey

レジストリサブキーを文字列，または値を格納した変数名で指定します。

EntryName

エントリ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，エントリ名のない値を仮定します。

Value

登録する値を文字列，数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，長さ0の文字列，または0を仮定します。

Type

登録する値の型を指定します。

この値は次のどれかになります。

REG_DWORD

REG_DWORD_BIG_ENDIAN

REG_EXPAND_SZ

REG_SZ
この値は省略できます。省略した場合，REG_SZを仮定します。

説明

指定されたレジストリエントリに値を設定します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。エントリが存在しない場合は新規に作成します。

注意

登録する値の型がREG_SZ，またはREG_EXPAND_SZの場合，値として登録できる文字列の最大は1,024バイトです。1,025バイト以上の文字列を指定した場合，1,025バイト以降の文字列は無視されます。

例

RegWrite ( HKEY_CURRENT_USER   _
         ,"Software¥Hitachi¥Script" ,"CurrentVersion"  _
         ,"0100" ,REG_SZ )

対象バージョン

JP1/Script 01-00以降

9.2.3　RegDelete （レジストリの値を削除する）

機能

レジストリの値を削除します。

形式

RegDelete ( RegKey , SubKey , EntryName )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_CURRENT_USER以外を指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

SubKey

レジストリサブキーを文字列，または値を格納した変数名で指定します。

EntryName

削除するエントリ名を文字列，または値を格納した変数名で指定します。

説明

指定されたレジストリのエントリを削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

RegDelete ( HKEY_LOCAL_MACHINE   _
          ,"Software¥Hitachi¥Script" ,"CurrentVersion" )

対象バージョン

JP1/Script 01-00以降

9.2.4　RegDeleteKey （レジストリのサブキーを削除する）

機能

レジストリのサブキーを削除します。

形式

RegDeleteKey ( RegKey , SubKey , DelKey )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

HKEY_CURRENT_USER以外を指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

SubKey

レジストリサブキーを文字列，または値を格納した変数名で指定します。

DelKey

削除キーを文字列，または値を格納した変数名で指定します。

説明

指定されたレジストリサブキー下の削除キーと，そのキーに含まれるすべてのサブキー，およびエントリを削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

例

RegDeleteKey ( HKEY_LOCAL_MACHINE   _
             ,"Software¥Hitachi¥Script" ,"Debug" )

対象バージョン

JP1/Script 01-00以降

9.3　描画・表示処理コマンド

＜この節の構成＞

9.3.1　BitmapShow （ビットマップを表示する）

9.3.2　BitmapHide （ビットマップを消去する）

9.3.1　BitmapShow （ビットマップを表示する）

機能

ビットマップを表示します。

形式

BitmapShow ( BmpFileName , 〔xPos〕 〔, yPos〕 )

指定項目

BmpFileName

表示するビットマップファイルのフルパスを文字列，または値を格納した変数名で指定します。

xPos

画面の左端からビットマップを表示するウィンドウの左端までの水平方向の距離を数値，または値を格納した変数名で指定します。

距離は左端を0としたピクセル単位で指定します。

この値を省略すると，ウィンドウは水平方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

yPos

画面の上端からビットマップを表示するウィンドウの上端までの垂直方向の距離を数値，または値を格納した変数名で指定します。

距離は上端を0としたピクセル単位で指定します。

この値を省略すると，ウィンドウは垂直方向に対して画面の中央の位置に配置されます。また，負の値を指定した場合，0を仮定します。

説明

指定されたビットマップを表示します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

表示したビットマップを消去する場合はBitmapHideコマンドを使用します。

補足

スクリプトをサービスで起動する場合は，このコマンドは使用できません。使用すると実行エラーになります。

Windows Vista以降のOSで環境変数ProgramFiles（通常はシステムドライブのProgram Filesフォルダ），またはWinDir（通常はシステムドライブのWindowsフォルダ）に設定されているフォルダ下のビットマップファイルを指定する場合，注意が必要です。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

bmpFile = _WIN_+"ABC.BMP"
BitmapShow ( bmpFile ,100 ,100 )
Sleep ( 10000 )
BitmapHide ( bmpFile )

対象バージョン

JP1/Script 05-00以降

9.3.2　BitmapHide （ビットマップを消去する）

機能

ビットマップを消去します。

形式

BitmapHide ( BmpFileName )

指定項目

BmpFileName

消去するビットマップファイルのフルパスを文字列，または値を格納した変数名で指定します。

説明

BitmapShowコマンドで表示したビットマップを消去します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

また，指定されたビットマップファイルが表示されていない場合は，常に真（True）を返します。

補足

スクリプトをサービスで起動する場合は，このコマンドは使用できません。使用すると実行エラーになります。

例

bmpFile = _WIN_+"ABC.BMP"
BitmapShow ( bmpFile ,100 ,100 )
Sleep ( 10000 )
BitmapHide ( bmpFile )

対象バージョン

JP1/Script 05-00以降

9.4　チェック処理コマンド

＜この節の構成＞

9.4.1　IsEmptyReg （レジストリサブキーの中身が空かどうかを調べる）

9.4.2　IsExistRegKey （レジストリサブキーが存在するかどうかを調べる）

9.4.3　IsExistService （サービスが存在するかどうかを調べる）

9.4.4　IsEmptyGroup （ショートカットが存在するかどうか調べる）

9.4.1　IsEmptyReg （レジストリサブキーの中身が空かどうかを調べる）

機能

レジストリサブキーの中身が空かどうかをチェックし，結果を真（True）か偽（False）で返します。

チェックの際に例外にするレジストリサブキーを指定できます。

形式

IsEmptyReg ( RegKey , SubKey 〔, ExceptSubKey1 , ExceptSubKey2 , …〕 )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

SubKey

チェックするレジストリサブキーを文字列，または値を格納した変数名で指定します。

ExceptSubKey1～27

チェックのときに例外にするレジストリサブキーがある場合，例外にするレジストリサブキーを文字列，または値を格納した変数名で指定します。

複数のレジストリサブキーを指定できます。

説明

指定されたレジストリサブキーの中にレジストリサブキー，またはエントリが存在するかどうかをチェックし，結果をコマンドの実行結果として返します。中身が空の場合は真（True）を，それ以外の場合は偽（False）を返します。

例外にするレジストリサブキーが指定されている場合は，例外キー以外のレジストリサブキー，またはエントリが存在するかどうかをチェックします。

例

' JP1/Scriptのレジストリサブキーの中身が空かどうかを調べる。
Dim  regKey ,subKey ,isEmp
regKey = HKEY_LOCAL_MACHINE
subKey = "Software¥Hitachi¥JP1/Script"
isEmp = IsEmptyReg( regKey ,subKey ,"PathName" )
If  isEmp = True  Then
 MessageBox( "Empty !" )
Else
 MessageBox ( "Not Empty !" )
End

対象バージョン

JP1/Script 01-00以降

9.4.2　IsExistRegKey （レジストリサブキーが存在するかどうかを調べる）

機能

レジストリサブキーが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsExistRegKey ( RegKey , SubKey )

指定項目

RegKey

レジストリキーを指定します。

この値は次のどれかになります。

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

SubKey

チェックするレジストリサブキーを文字列，または値を格納した変数名で指定します。

説明

指定されたレジストリサブキーが存在するかどうかをチェックし，結果をコマンドの実行結果として返します。存在する場合は真（True）を，それ以外の場合は偽（False）を返します。

例

' JP1/Scriptのレジストリサブキーが存在していたら，
' 中身が空かどうかを調べる。
Dim  regKey ,subKey ,isEmp
regKey = HKEY_LOCAL_MACHINE
subKey = "Software¥Hitachi¥JP1/Script"
If  IsExistRegKey ( regKey ,subKey ) = True  Then
 isEmp = IsEmptyReg( regKey ,subKey)
 If isEmp = True Then
    MessageBox( "Empty !" )
 Else
    MessageBox ( "Not Empty !" )
 End
End

対象バージョン

JP1/Script 01-00以降

9.4.3　IsExistService （サービスが存在するかどうかを調べる）

機能

サービスが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsExistService ( ServiceInfoName )

指定項目

ServiceInfoName

チェックするサービス情報名，またはサービス名を文字列，または値を格納した変数名で指定します。

説明

指定されたサービスが登録されているかどうかをチェックし，結果をコマンドの実行結果として返します。存在する場合は真（True）を，それ以外の場合は偽（False）を返します。

サービス情報名の代わりにサービス名を指定することもできますが，できるだけサービス情報を使ってください。サービス情報とは，サービスに関する情報をカプセル化したオブジェクトのことです。

例

' JP1/Script サービスが存在していたら，サービスを削除する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
If  IsExistService ( "JSService" )  Then
 ServiceDelete ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.4.4　IsEmptyGroup （ショートカットが存在するかどうか調べる）

機能

プログラムグループにショートカットが存在するかどうかをチェックし，結果を真（True）か偽（False）で返します。

形式

IsEmptyGroup ( GroupName 〔, RootType〕 )

指定項目

GroupName

プログラムグループ名を，文字列，または値を格納した変数名で指定します。

RootType

プログラムグループの種類を指定します。

この値は次のどちらかになります。

値 | 意味
Lcl_Program | プログラム（共通グループ）
Cur_Program | プログラム（ユーザ別グループ）

この値は省略できます。省略した場合，Cur_Programを仮定します。

説明

指定されたプログラムグループの中にショートカットが存在するかチェックし，結果をコマンドの実行結果として返します。ショートカットが存在しない場合は真（True）を，存在する場合は偽（False）を返します。

指定されたプログラムグループが存在しない場合は，常に偽（False）を返します。

例

' Windows XPでプログラムグループ"アルファベット"の中に
' ショートカットが存在しない場合は，そのグループを削除する。
If  _OS_ = "WIN_NT5.1"  Then
 If  IsEmptyGroup ( "アルファベット" )  Then
   DeleteGroup ( "アルファベット" )
 End If
End If

対象バージョン

JP1/Script 05-20以降

9.5　サービス操作コマンド

＜この節の構成＞

9.5.1　ServiceSetValue （サービス情報を設定する）

9.5.2　ServiceGetValue （サービスの情報を取得する）

9.5.3　ServiceCreate （サービスを登録する）

9.5.4　ServiceDelete （サービスを削除する）

9.5.5　ServiceStart （サービスを開始する）

9.5.6　ServiceStop （サービスを停止する）

9.5.7　ServicePause （サービスを一時停止する）

9.5.8　ServiceContinue （一時停止のサービスを再開する）

9.5.9　ServiceChange （サービスの設定情報を変更する）

9.5.10　ServiceQuery （サービスの設定情報を取得する）

9.5.11　ServiceRefer （サービスの現在の状態を取得する）

9.5.12　ServiceControl （サービスに制御コマンドを送る）

9.5.13　GetServiceName （サービス表示名からサービス名を取得する）

9.5.1　ServiceSetValue （サービス情報を設定する）

機能

サービス操作に必要な情報をサービス情報というオブジェクトとして設定します。

形式

ServiceSetValue ( ServiceInfoName , Keyword1 :: Value1 , Keyword2 :: Value2 , … )

指定項目

ServiceInfoName

サービス情報名を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で31文字以内です。

Keyword1～11

設定するキーワードを指定します。

Value1～11

設定する値を指定します。

Keyword1～11とValue1～11の区切り文字には（ :: ）を指定してください。

Keyword1～11で指定するキーワード，およびValue1～11で指定する値は次のとおりです。

キーワード
値と意味

Name
サービス名
指定できる文字数は，半角文字で255文字以内です。なお，スラッシュ（/）と円記号（¥）は，サービス名に使用できません。

DispName
表示名
指定できる文字数は，半角文字で255文字以内です。

Type
サービスの種類
SERVICE_WIN32_OWN_PROCESS
サービスが独立したWin32プロセスで動作することを指定します。
SERVICE_WIN32_SHARE_PROCESS
サービスがWin32プロセスを他のサービスと共有することを指定します。
SERVICE_KERNEL_DRIVER
Windowsデバイスドライバであることを指定します。
SERVICE_FILE_SYSTEM_DRIVER
Windowsファイルシステムドライバであることを指定します。

Start
サービスの起動時期
SERVICE_BOOT_START
オペレーティングシステムローダーがデバイスドライバを起動することを指定します。
この値は，Typeで指定されたサービスの種類が次のどちらかのときだけ有効です。

SERVICE_KERNEL_DRIVER

SERVICE_FILE_SYSTEM_DRIVER

SERVICE_SYSTEM_START
IoInitSystem関数がデバイスドライバを起動することを指定します。
この値は，Typeで指定されたサービスの種類が次のどちらかのときだけ有効です。

SERVICE_KERNEL_DRIVER

SERVICE_FILE_SYSTEM_DRIVER

SERVICE_AUTO_START
サービス制御マネージャがシステムの起動時にデバイスドライバやWin32サービスを自動的に起動することを指定します。
SERVICE_DEMAND_START
プロセスがStartService関数を呼び出したときにサービス制御マネージャがデバイスドライバやWin32サービスを起動することを指定します。
SERVICE_DISABLED
デバイスドライバやWin32サービスを起動しないことを指定します。

Errctl
システム起動時にサービスが起動できなかったときのエラーの重大度
SERVICE_ERROR_IGNORE
起動（ブート）プログラムは，エラーを記録して，起動処理を続行します。
SERVICE_ERROR_NORMAL
起動プログラムは，エラーを記録してメッセージボックスポップアップを表示し，起動処理を続行します。
SERVICE_ERROR_SEVERE
起動プログラムはエラーを記録します。
SERVICE_ERROR_CRITICAL
起動プログラムは，可能ならばエラーを記録します。

Path
サービスプログラムのフルパス

Group
サービスが所属するロード順序グループ
サービスがグループに所属しないときは省略してください。

DependG
依存グループ名
このサービスより前に起動しなければならないロード順序グループ名を指定します。

DependM
依存サービス名
このサービスより前に起動しなければならないサービス名を指定します。このサービスが他のサービスに依存しないときは省略してください。

StartName
サービスアカウント名
Typeで指定されたサービスの種類がSERVICE_WIN32_OWN_PROCESSの場合
起動時にサービスプロセスがログオンに使用する"DomainName¥Username"という形式のサービスアカウント名でなければなりません。サービスアカウント名が組み込みドメインに所属するときは，"¥Username"のように指定してください。
Typeで指定されたサービスの種類がSERVICE_WIN32_SHARE_PROCESSの場合
LocalSystem以外のサービスアカウント名を指定することはできません。この値を省略した場合，サービスは"LocalSystem"アカウントでログオンします。その場合，Passwordの値は省略されていなくてはなりません。
Typeで指定されたサービスの種類がSERVICE_KERNEL_DRIVERか，SERVICE_FILE_SYSTEM_DRIVERの場合
この値は，入出力（I/O）システムがデバイスドライバをロードするときに使用するドライバオブジェクトの名前（¥FileSystem¥Rdrや，¥Driver¥Xnsなど）です。この値を省略した場合，I/Oシステムは，サービス名に基づいたデフォルトのオブジェクト名を作成してドライバを起動します。

Password
アカウントのパスワード
Typeで指定されたサービスの種類がSERVICE_WIN32_OWN_PROCESか，SERVICE_WIN32_SHARE_PROCESSの場合
StartNameで指定されたサービスアカウント名のパスワードを指定します。
Typeで指定されたサービスの種類がSERVICE_KERNEL_DRIVERか，SERVICE_FILE_SYSTEM_DRIVERの場合
この値は無視されます。
サービスにパスワードがないときは省略してください。

説明

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

サービス情報とは，サービスに関する情報をカプセル化したオブジェクトのことです。その属性は，上記のキーワードで設定・取得できます。

他のサービス操作コマンドを利用する場合，あらかじめこのコマンドを使って，サービス情報に必要なキーワードの情報を設定しておきます。必要のないキーワードは省略できます。

例

OutDir = "C:¥Program Files¥Hitachi¥Script¥BIN¥"
ServiceSetValue ( "JSService" ,Name::"JP1_Script"   _
                           ,DispName::"JP1/Script"   _
                           ,Type::SERVICE_WIN32_OWN_PROCESS   _
                           ,Start::SERVICE_AUTO_START   _
                           ,Errctl::SERVICE_ERROR_NORMAL   _
                           ,Path::OutDir+"SPTHSV.EXE" )

対象バージョン

JP1/Script 01-00以降

9.5.2　ServiceGetValue （サービスの情報を取得する）

機能

サービス情報に格納されている情報を取得します。

形式

ServiceGetValue ( ServiceInfoName , Keyword1 :: ValueBuff1 , Keyword2 :: ValueBuff2 , … )

指定項目

ServiceInfoName

サービス情報名を文字列，または値を格納した変数名で指定します。

Keyword1～11

キーワードを指定します。

ValueBuff1～11

値を受け取る変数名を指定します。

Keyword1～11で指定するキーワード，およびValueBuff1～11で受け取る値は次のとおりです。

キーワード
値と意味

Name
サービス名

DispName
表示名

Type
サービスの種類
SERVICE_WIN32_OWN_PROCESS
サービスが独立したWin32プロセスで動作することを意味します。
SERVICE_WIN32_SHARE_PROCESS
サービスがWin32プロセスを他のサービスと共有することを意味します。
SERVICE_KERNEL_DRIVER
Windows NTデバイスドライバであることを意味します。
SERVICE_FILE_SYSTEM_DRIVER
Windows NTファイルシステムドライバであることを意味します。

Start
サービスの起動時期
SERVICE_BOOT_START
オペレーティングシステムローダーがデバイスドライバを起動することを意味します。
SERVICE_SYSTEM_START
IoInitSystem関数がデバイスドライバを起動することを意味します。
SERVICE_AUTO_START
サービス制御マネージャがシステムの起動時にデバイスドライバやWin32サービスを自動的に起動することを意味します。
SERVICE_DEMAND_START
プロセスがStartService関数を呼び出したときにサービス制御マネージャがデバイスドライバやWin32サービスを起動することを意味します。
SERVICE_DISABLED
デバイスドライバやWin32サービスを起動しないことを意味します。

Errctl
システム起動時にサービスが起動できなかったときのエラーの重大度
SERVICE_ERROR_IGNORE
起動（ブート）プログラムは，エラーを記録して，起動処理を続行することを意味します。
SERVICE_ERROR_NORMAL
起動プログラムは，エラーを記録してメッセージボックスポップアップを表示し，起動処理を続行することを意味します。
SERVICE_ERROR_SEVERE
起動プログラムはエラーを記録することを意味します。
SERVICE_ERROR_CRITICAL
起動プログラムは，可能ならばエラーを記録することを意味します。

Path
サービスプログラムのフルパス

Group
サービスが所属するロード順序グループ

DependG
依存グループ名

DependM
依存サービス名

StartName
サービスアカウント名

Password
アカウントのパスワード

説明

サービス情報に格納されている情報のうち，必要なキーワードの情報だけを変数に格納します。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

例

' JP1/Script サービスの情報を取得する。
Dim  svDispName ,svType ,svStart ,svErrctl ,svPath
' JP1/Script サービス情報"JSService"を設定する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
' サービス情報"JSService"の設定情報を取得する。
ServiceQuery ( "JSService" )
' サービスの情報"JSService"に格納されている設定情報を変数に取得する。
ServiceGetValue ( "JSService" ,DispName::svDispName   _
                             ,Type::svType   _
                             ,Start::svStart   _
                             ,Errctl::svErrctl   _
                             ,Path::svPath )

対象バージョン

JP1/Script 01-00以降

9.5.3　ServiceCreate （サービスを登録する）

機能

サービスを登録します。

形式

ServiceCreate ( ServiceInfoName )

指定項目

ServiceInfoName

登録するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されている情報を使って，システムにサービスを登録します。

サービスの登録には少なくともキーワードName，DispName，Type，Start，Errctl，Pathの値が指定されている必要があります。これらのキーワードの詳細は「9.5.1　ServiceSetValue （サービス情報を設定する）」を参照してください。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

サービスの登録にはシステム管理者権限のあるユーザでログオンしている必要があります。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' JP1/Script サービスが存在しなかったらサービスを登録する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
If  IsExistService ( "JSService" ) = False  Then
 OutDir = "C:¥Program Files¥Hitachi¥Script¥BIN¥"
 ServiceSetValue ( "JSService" ,Name::"JP1_Script"   _
                    ,DispName::"JP1/Script"   _
                    ,Type::SERVICE_WIN32_OWN_PROCESS   _
                    ,Start::SERVICE_AUTO_START   _
                    ,Errctl::SERVICE_ERROR_NORMAL   _
                    ,Path::OutDir+"SPTHSV.EXE" )
 ServiceCreate ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.4　ServiceDelete （サービスを削除する）

機能

登録されているサービスを削除します。

形式

ServiceDelete ( ServiceInfoName )

指定項目

ServiceInfoName

登録を解除するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されているキーワードNameの値を使って，システムに登録されているサービスを削除します。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

停止中の状態にならないサービスに対してこのコマンドを実行しないでください。このコマンドは，サービスを削除するため指定したサービスに対して停止要求をして，指定したサービスが停止中の状態になり削除できるまで終了しません。

例

' JP1/Script サービスが存在していたらサービスを削除する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
If  IsExistService ( "JSService" )  Then
 ServiceDelete ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.5　ServiceStart （サービスを開始する）

機能

登録されているサービスを開始します。

形式

ServiceStart ( ServiceInfoName )

指定項目

ServiceInfoName

開始するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されているキーワードNameの値を使って，システムに登録されているサービスを開始します。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，アカウント不正のためログオンに失敗しサービスを開始できなかった場合はLOGON_FAILEDを，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

実行中の状態にならないサービスに対してこのコマンドを実行しないでください。このコマンドは，指定したサービスに対して開始要求をして，実行中の状態になるまで終了しません。

例

' JP1/Script サービスが存在しなかったら登録し，サービスを開始する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
If  IsExistService ( "JSService" ) = False  Then
 OutDir = "C:¥Program Files¥Hitachi¥Script¥BIN¥"
 ServiceSetValue ( "JSService" ,Name::"JP1_Script"   _
                    ,DispName::"JP1/Script"   _
                    ,Type::SERVICE_WIN32_OWN_PROCESS   _
                    ,Start::SERVICE_AUTO_START   _
                    ,Errctl::SERVICE_ERROR_NORMAL   _
                    ,Path::OutDir+"SPTHSV.EXE" )
 ServiceCreate ( "JSService" )
End
ServiceStart ( "JSService" )

対象バージョン

JP1/Script 01-00以降

9.5.6　ServiceStop （サービスを停止する）

機能

開始されているサービスを停止します。

形式

ServiceStop ( ServiceInfoName )

指定項目

ServiceInfoName

停止するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されているキーワードNameの値を使って，すでに起動されているサービスを停止します。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

停止中の状態にならないサービスに対してこのコマンドを実行しないでください。このコマンドは，指定したサービスに対して停止要求をして，停止中の状態になるまで終了しません。

例

' 実行中のJP1/Script サービスを停止する。
Dim  svStatus
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
ServiceRefer ("JSService" ,svStatus )
If  svStatus = SERVICE_RUNNING  Then
 ServiceStop ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.7　ServicePause （サービスを一時停止する）

機能

開始されているサービスを一時停止します。

形式

ServicePause ( ServiceInfoName )

指定項目

ServiceInfoName

一時停止するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されているキーワードNameの値を使って，すでに起動されているサービスを一時停止します。

このコマンドは，内部的にはServiceControlコマンドが実行されています。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 実行中のJP1/Script サービスを一時停止する。
Dim  svStatus
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
ServiceRefer ("JSService" ,svStatus )
If  svStatus = SERVICE_RUNNING  Then
 ServicePause ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.8　ServiceContinue （一時停止のサービスを再開する）

機能

一時停止しているサービスを再開します。

形式

ServiceContinue ( ServiceInfoName )

指定項目

ServiceInfoName

再開するサービスのサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されているキーワードNameの値を使って，一時停止しているサービスを再開します。

このコマンドは，内部的にはServiceControlコマンドが実行されています。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 一時停止しているJP1/Script サービスを再開する。
Dim  svStatus
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
ServiceRefer ( "JSService" ,svStatus )
If  svStatus = SERVICE_PAUSED  Then
 ServiceContinue ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.9　ServiceChange （サービスの設定情報を変更する）

機能

サービスの設定情報を変更します。

形式

ServiceChange ( ServiceInfoName )

指定項目

ServiceInfoName

変更内容が格納されたサービス情報名を文字列，または値を格納した変数名で指定します。

説明

サービス情報に格納されている情報を使って，現在のサービスの設定情報を変更します。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' JP1/Script サービスの設定情報(スタートアップの種類)を変更する。
Dim  svStart
' JP1/Script サービス情報"JSService"を設定する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
' サービス情報"JSService"の設定情報を取得する。
ServiceQuery ( "JSService" )
' サービス情報"JSService"に格納されている
' 設定情報（スタートアップの種類）を変数に取得する。
ServiceGetValue ( "JSService" ,Start::svStart )
' サービスの「スタートアップの種類」が「自動」の場合，
' 「手動」に変更する
If  svStart = 3  Or  svStart = SERVICE_AUTO_START  Then
 svStart = SERVICE_DEMAND_START
 ServiceSetValue ( "JSService" ,Start::svStart )
 ServiceChange ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.10　ServiceQuery （サービスの設定情報を取得する）

機能

サービスの設定情報を取得します。

形式

ServiceQuery ( ServiceInfoName )

指定項目

ServiceInfoName

取得するサービス情報名を文字列，または値を格納した変数名で指定します。

説明

現在のサービスの設定情報を取得し，サービス情報に格納します。

情報を取得するサービスのサービス名をあらかじめサービス情報のキーワードNameに設定しておく必要があります。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

例

' JP1/Script サービスの設定情報(サービスの種類)を取得する。
Dim  svType
' JP1/Script サービス情報"JSService"を設定する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
' サービスの情報"JSService"の設定情報を取得する。
ServiceQuery ( "JSService" )
' サービスの情報"JSService"に格納されている
' 設定情報（サービスの種類）を変数に取得する。
ServiceGetValue ("JSService" ,Type::svType )
MessageBox ( "JP1/Scriptサービスの種類："+svType )

対象バージョン

JP1/Script 01-00以降

9.5.11　ServiceRefer （サービスの現在の状態を取得する）

機能

サービスの現在の状態を取得します。

形式

ServiceRefer ( ServiceInfoName , StatusBuff )

指定項目

ServiceInfoName

サービス情報名を文字列，または値を格納した変数名で指定します。

StatusBuff

現在の状態を受け取る変数名を指定します。

この変数に格納される値は次のどれかになります。

値 | 意味
SERVICE_STOPPED | サービスは実行中ではありません。
SERVICE_START_PENDING | サービスは起動中です。
SERVICE_STOP_PENDING | サービスは停止中です。
SERVICE_RUNNING | サービスは実行中です。
SERVICE_CONTINUE_PENDING | サービスの再開は未処理です。
SERVICE_PAUSE_PENDING | サービスの一時停止は未処理です。
SERVICE_PAUSED | サービスは一時停止されています。

説明

現在のサービスの状態を取得し，結果を変数に格納します。

状態を取得するサービスのサービス名をあらかじめサービス情報のキーワードNameに設定しておく必要があります。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

例

' JP1/Script サービスの現在の状態を取得し，サービスを開始する。
Dim  svStatus
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
ServiceRefer ("JSService" ,svStatus )
If  svStatus = SERVICE_STOPPED  Then
 ServiceStart ( "JSService" )
End

対象バージョン

JP1/Script 01-00以降

9.5.12　ServiceControl （サービスに制御コマンドを送る）

機能

サービスに制御コマンドを送ります。

形式

ServiceControl ( ServiceInfoName , Control )

指定項目

ServiceInfoName

サービス情報名を文字列，または値を格納した変数名で指定します。

Control

サービスに送る制御コマンドを指定します。

この値は次のどれかになります。

値
意味

SERVICE_CONTROL_STOP
サービスを停止します。
ServiceStopコマンドと異なり，サービスが開始されていない場合はエラーになります。

SERVICE_CONTROL_PAUSE
サービスを一時停止します。
ServicePauseコマンドと同じ機能です。

SERVICE_CONTROL_CONTINUE
サービスを再開します。
ServiceContinueコマンドと同じ機能です。

説明

サービス情報に格納されているキーワードNameの値を使って，サービスに制御コマンドを送ります。

制御するサービスのサービス名をあらかじめサービス情報のNameに設定しておく必要があります。

コマンドの実行結果は，_SVC_RTN_予約変数に格納します。コマンドの実行が成功した場合は真（True）を，それ以外の場合は偽（False）を返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' JP1/Script サービスを一時停止する。
ServiceSetValue ( "JSService" ,Name::"JP1_Script" )
ServiceControl ( "JSService" ,SERVICE_CONTROL_PAUSE )

対象バージョン

JP1/Script 01-00以降

9.5.13　GetServiceName （サービス表示名からサービス名を取得する）

機能

サービスの表示名からサービス名を取得します。

形式

GetServiceName ( DispName )

指定項目

DispName

サービスの表示名を文字列，または値を格納した変数名で指定します。

説明

指定されたサービスの表示名からサービス名を取得します。コマンドが正常に実行された場合はサービス名を，エラーが発生した場合は長さ0の文字列（""）を，コマンドの実行結果として返します。

例

' 表示名が"JP1/Script"であるサービスを停止する。
svName = GetServiceName ( "JP1/Script" )
If  IsEmpty ( svName ) = False  Then
 ServiceSetValue ( "JSService" ,Name::svName )
 If  IsExistService ( "JSService" )  Then
   ServiceStop ( "JSService" )
 End
End

対象バージョン

JP1/Script 05-10以降

9.6　外部プログラム呼び出しコマンド

＜この節の構成＞

9.6.1　CallDll （DLLファイルを呼び出す）

9.6.1　CallDll （DLLファイルを呼び出す）

機能

DLLファイルを呼び出します。

形式

CallDll ( DllFileName , FunctionName , Param1 , Param2 , … )

指定項目

DllFileName

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

FunctionName

呼び出す外部関数名を，文字列，または値を格納した変数名で指定します。

Param1～32

関数のパラメタを，文字列，または値を格納した変数名で指定します。

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

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

説明

指定されたDLLをロードし，外部関数をコールします。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

外部関数は次のインタフェースにしてください。また，モジュール定義ファイル（.DEF）のEXPORTSセクションに外部参照宣言が必要になります。

宣言

BOOL  WINAPI  MyFunc( HWND hParent, int argc, char * argv[], int * rtnc, char * * rtnv[] );

引数

HWND  hParent;   ' 親ウィンドウのハンドル
int  argc;   ' スクリプトから渡されるパラメタの数
char *  argv[];   ' スクリプトから渡されるパラメタの配列
int *  rtnc;   ' スクリプトに返す文字列の数を格納するポインタ
char * * rtnv[];   ' スクリプトに返す文字列の配列を格納するポインタ

戻り値

外部関数MyFuncの戻り値は_DLL_RTN_予約変数に格納します。_DLL_RTN_予約変数がTrueの場合，引数rtnvに格納されたスクリプトに返す文字列の配列はスクリプト上で_RTNxx_予約変数を使って参照できます。 xxは00から順に引数rtncに格納された数だけ割り振られます。外部関数MyFuncの戻り値がFalseの場合，_RTNxx_予約変数は定義されません。

スクリプトに返す文字列，および文字列配列は，関数終了後も参照できるように，関数のスコープ内のローカルバッファには格納しないでください。

補足

ロードしたDLLファイルは，コマンドの実行終了時にアンロードされます。ロードしたDLLファイルをアンロードしたくない場合は，次に示すレジストリの値に「1」を設定してください。一度ロードしたDLLファイルは，スクリプトの実行が終了するまでアンロードされません。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/Script¥SPTX

〔値名〕

CallDllUnloadMode

〔値のデータタイプ〕

REG_DWORD

〔値〕

0：DLLファイルをアンロードする

1：DLLファイルをアンロードしない

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

注意

DLLファイルをアンロードしない設定にした場合の注意事項を次に示します。

DLLのエントリポイント関数であるDllMain関数は，DLLファイルをロードするときにWindowsシステムから呼び出されて実行されます。したがって，同じDLLファイルを指定したCallDllコマンドを複数回実行する場合は，最初に実行するときはDLLファイルをロードするためDllMain関数が実行されますが，2回目以降の実行のときはDLLファイルをロードしないため，DllMain関数は実行されません。

DLLの中で使用する外部変数は，DLLファイルをロードするときに初期化されます。したがって，同じDLLファイルを指定したCallDllコマンドを複数回実行する場合は，最初に実行するときはDLLファイルをロードするため外部変数が初期化されますが，2回目以降の実行のときはDLLファイルをロードしないため，外部変数が初期化されません。

実体が異なる同一名称のDLLファイルを指定する場合は，絶対パスで指定してください。実体が異なる同一名称のDLLファイルを相対パスで指定している場合，SetPathコマンドで実行フォルダのパスを設定してもWindowsシステムは同じDLLファイルと認識するため，DLLファイルはロードされません。

CallDllコマンドでコールする外部関数を一つにまとめたDLLファイルをできるだけ使用してください。複数の異なるDLLファイルを指定したCallDllコマンドを多用すると，スクリプトの実行プロセス中に多数のDLLファイルをロードすることになるため，メモリ不足が発生するおそれがあります。

例

' TEST.DLLの関数部分(Favorite.c)
#include "windows.h"

#define  FAV_SPORT1 "SKI"
#define  FAV_SPORT2 "BASKETBALL"
#define  FAV_FOOD1  "STEAK"
#define  FAV_FOOD2  "PASTA"
char *  g_ret[2];

BOOL  WINAPI  GetFavorite( HWND hParent, int argc, char * argv[], int * rtnc, char ** rtnv[] )
{
 if (lstrcmp(argv[0], "SPORT") == 0)
 {
   g_ret[0] = FAV_SPORT1;
   g_ret[1] = FAV_SPORT2;
 }
 else if (lstrcmp(argv[0], "FOOD") == 0)
 {
   g_ret[0] = FAV_FOOD1 ;
   g_ret[1] = FAV_FOOD2;
 }

 *rtnc = 2;
 *rtnv = g_ret;

 return ( TRUE );
}

' スクリプト側の処理(abc.SPT)
Dim  Quest
Quest = "SPORT"
CallDll(_BIN_+"TEST.DLL" ,"GetFavorite" ,Quest)
Dim  Msg
Msg = "私の好きな"+Quest+"は"+_RTN00_+"と"+_RTN01_+"です"
MessageBox(Msg ,OK,,Information)
Exit(0)

対象バージョン

JP1/Script 01-00以降

9.7　ショートカット操作コマンド

＜この節の構成＞

9.7.1　MakeGroup （プログラムグループを作成する）

9.7.2　DeleteGroup （プログラムグループを削除する）

9.7.3　MakeShortcut （ショートカットを作成する）

9.7.4　DeleteShortcut （ショートカットを削除する）

9.7.1　MakeGroup （プログラムグループを作成する）

機能

プログラムグループを作成します。

形式

MakeGroup ( GroupName 〔, RootType〕 )

指定項目

GroupName

プログラムグループ名を文字列，または値を格納した変数名で指定します。

Lcl_Programを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

RootType

プログラムグループの種類を指定します。

この値は次のどれかになります。

値 | 意味
Lcl_Program | プログラム（共通グループ）
Cur_Program | プログラム（ユーザ別グループ）

この値は省略できます。省略した場合，Cur_Programを仮定します。

説明

指定されたプログラムグループを作成します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）をコマンドの実行結果として返します。

指定されたプログラムグループがすでに存在している場合，何もしないで，常に真（True）を返します。

例

' Windows XPでプログラムグループ"アルファベット"を作成し,
' そのグループにショートカット"ABC"を登録する。
If  _OS_ = "WIN_NT5.1"  Then
   MakeGroup ( "アルファベット" )
   MakeShortcut ( Cur_Program ,"アルファベット¥ABC",_
   _BIN_+"ABC.SPT" )
End If

対象バージョン

JP1/Script 05-20以降

9.7.2　DeleteGroup （プログラムグループを削除する）

機能

プログラムグループを削除します。

形式

DeleteGroup ( GroupName 〔, RootType〕 )

指定項目

GroupName

プログラムグループ名を文字列，または値を格納した変数名で指定します。

Lcl_Programを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

RootType

プログラムグループの種類を指定します。

この値は次のどちらかになります。

値 | 意味
Lcl_Program | プログラム（共通グループ）
Cur_Program | プログラム（ユーザ別グループ）

この値は省略できます。省略した場合，Cur_Programを仮定します。

説明

指定されたプログラムグループを削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）をコマンドの実行結果として返します。

指定されたプログラムグループが存在しない場合，何もしないで常に真（True）を返します。

例

' Windows XPでプログラムグループ"アルファベット"を削除する。
If  _OS_ = "WIN_NT5.1"  Then
   DeleteGroup ( "アルファベット" )
End If

対象バージョン

JP1/Script 05-20以降

9.7.3　MakeShortcut （ショートカットを作成する）

機能

ショートカットを作成します。

形式

MakeShortcut ( RootPath , SubPath , LinkPath , 〔Param〕 , 〔WorkDirPath〕 , 〔IconPath〕 , 〔IconIndex〕 〔, IconFlag〕 )

指定項目

RootPath

ショートカットの作成場所を指定します。

この値は次のどれかになります。

値 | 意味
None | 現在の実行フォルダ下
Lcl_Desktop | デスクトップ（共通グループ）
Lcl_Startmenu | スタートメニュー（共通グループ）※1
Lcl_Program | プログラム（共通グループ）※2
Lcl_Startup | スタートアップ（共通グループ）※3
Cur_Desktop | デスクトップ（ユーザ別グループ）
Cur_Startmenu | スタートメニュー（ユーザ別グループ）※1
Cur_Program | プログラム（ユーザ別グループ）※2
Cur_Startup | スタートアップ（ユーザ別グループ）※3

注※1　Windowsの［スタート］メニュー

注※2　Windowsの［スタート］－［プログラム］メニュー

注※3　Windowsの［スタート］－［プログラム］－［スタートアップ］メニュー

Lcl_Desktop，Lcl_Startmenu，Lcl_ProgramまたはLcl_Startupを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

SubPath

ショートカット名を，文字列，または値を格納した変数名で指定します。

RootPathで指定されたショートカットの作成場所が Lcl_Program ，または Cur_Program の場合，次のように指定してください。

プログラムグループ¥ショートカット名

LinkPath

ショートカットのリンク先を，文字列，または値を格納した変数名で指定します。

Param

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

WorkDirPath

作業フォルダ名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，LinkPathで指定されたリンク先のフォルダを仮定します。

IconPath

ショートカットに使うアイコンが登録されているアイコンファイル名を文字列，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，LinkPathで指定されたリンク先を仮定します。

IconIndex

IconPathで指定されたアイコンファイル中のアイコンのインデックスを，0から始まる数値または値を格納した変数名で指定します。

この値は省略できます。省略した場合，0を仮定します。

IconFlag

ショートカットを起動したときのウィンドウの表示方法を指定します。

この値は次のどれかになります。

値 | 意味
Normal | 通常のウィンドウ
Min | 最小化（タスクバーのボタン）
Max | 最大化（画面全体）

この値は省略できます。省略した場合，Normalを仮定します。

説明

指定されたショートカットを作成します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）をコマンドの実行結果として返します。

指定された名前のショートカットがすでに存在する場合，そのショートカットは削除され，指定されたパラメタで登録し直します。

例

' Windows XPでスタートアップに"ABC.SPT"を呼び出す
' ショートカットを作成する。
If  _OS_ = "WIN_NT5.1"  Then
    MakeShortcut ( Cur_Startup ,"ABC" ,_BIN_+"ABC.SPT" _
                  , , , _TEMP_ , ,Min )
End If

対象バージョン

JP1/Script 05-20以降

9.7.4　DeleteShortcut （ショートカットを削除する）

機能

ショートカットを削除します。

形式

DeleteShortcut ( RootPath , SubPath )

指定項目

RootPath

ショートカットの存在場所を指定します。

この値は次のどれかになります。

値 | 意味
None | 現在の実行フォルダ下
Lcl_Desktop | デスクトップ（共通グループ）
Lcl_Startmenu | スタートメニュー（共通グループ）※1
Lcl_Program | プログラム（共通グループ）※2
Lcl_Startup | スタートアップ（共通グループ）※3
Cur_Desktop | デスクトップ（ユーザ別グループ）
Cur_Startmenu | スタートメニュー（ユーザ別グループ）※1
Cur_Program | プログラム（ユーザ別グループ）※2
Cur_Startup | スタートアップ（ユーザ別グループ）※3

注※1　Windowsの［スタート］メニュー

注※2　Windowsの［スタート］－［プログラム］メニュー

注※3　Windowsの［スタート］－［プログラム］－［スタートアップ］メニュー

Lcl_Desktop，Lcl_Startmenu，Lcl_ProgramまたはLcl_Startupを指定した場合，Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

SubPath

ショートカット名を，文字列，または値を格納した変数名で指定します。

RootPathで指定されたショートカットの存在場所が Lcl_Program ，または Cur_Program の場合，次のように指定してください。

プログラムグループ¥ショートカット名

説明

指定されたショートカットを削除します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

指定された名前のショートカットが存在しない場合，何もしないで，常に真（True）を返します。

例

' Windows XPでスタートアップからショートカット"ABC"を削除する。
If  _OS_ = "WIN_NT5.1"  Then
 DeleteShortcut ( Cur_Startup ,"ABC" )
End If

対象バージョン

JP1/Script 05-20以降

9.8　プロセス監視コマンド

＜この節の構成＞

9.8.1　GetProcessCount （プロセスの起動数を取得する）

9.8.2　GetProcessInfo （プロセスの情報を取得する）

9.8.3　TerminateProcess （プロセスを強制終了する）

9.8.1　GetProcessCount （プロセスの起動数を取得する）

機能

プロセスの起動数を取得します。

形式

GetProcessCount ( ProcessName 〔, ProcessIdBuff〕 )

指定項目

ProcessName

プロセス名を文字列，または値を格納した変数名で指定します。

プロセス名にはフォルダ名や".EXE"などの拡張子を付けないで指定してください。

ProcessIdBuff

プロセスIDを受け取る変数名を指定します。

JP1/Script 06-00以降では，要素数が可変な一次元の配列変数の変数名を指定することもできます。

必要がない場合は省略します。

ProcessNameで指定されたプロセスが複数起動されている場合は，複数のプロセスIDを起動順にソートして，次のどちらかのように格納します。

ProcessIdBuffに変数が指定された場合は，複数のプロセスIDをセミコロン（;）で区切った文字列にして格納します。

ProcessIdBuffに配列変数が指定された場合は，複数のプロセスIDを先頭の要素から順に一つずつ格納します。格納後，配列変数の要素数はプロセスIDの数に置き換わります。

説明

指定されたプロセスの起動数を取得し，コマンドの実行結果として返します。ProcessIdBuffが指定されている場合はプロセスIDも返します。

指定されたプロセスが起動されていない場合は0を返し，ProcessIdBuffには長さ0の文字列（""）を格納します。エラーが発生した場合は長さ0の文字列（""）を，コマンドの実行結果として返します。

補足

ローカルシステムアカウントで起動したプロセスについては完全な名前が取得できないというWindowsの仕様上の制限によってGetProcessCountコマンドにローカルシステムアカウントで起動した16文字以上のプロセス名（拡張子を含める）を指定して，ローカルシステムアカウント以外のアカウントから実行した場合，該当するプロセスが起動中にもかかわらず，起動数，およびプロセスIDに値が返らないという現象が起こります。
この現象を回避するためには，ProcessNameに拡張子を含めたプロセス名の15文字までの部分を指定してください。詳細は，例2を参照してください。

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

注意

管理者権限でスクリプトファイルを実行してください。

例1

' プロセス"ABC"のプロセスID一覧を作成する。
Dim  pCnt ,pIdBuff ,seppId
pCnt = GetProcessCount ( "ABC" ,pIdBuff )
For  i = 1 To pCnt
 seppId = SeparateStr ( pIdBuff ,";" ,i )
 Message ( Target_File ,_SCF_+"PIDLIST.TXT" ,seppId )
Next

例2

Dim  PLName, Pname, PnameWork, Rc, IdBuff
PLName ="ABCDEFGHIJKL"
Pname = "ABCDEFGHIJKL.exe"
' まず，通常の指定方法（プロセス名を指定）で実行する。
Rc = GetProcessCount(PLName, IdBuff)
' 起動数が0の場合，プロセスがローカルシステムアカウントから
' 起動されている場合を考慮した処理を行う。
If Rc = 0 Then
   If Len(Pname)> 15 Then
       PnameWork = Left(Pname, 15)
   End If
   Rc = GetProcessCount(PnameWork, IdBuff)
End If

対象バージョン

JP1/Script 05-20以降

9.8.2　GetProcessInfo （プロセスの情報を取得する）

機能

指定されたプロセスIDのプロセスの情報を取得します。

形式

GetProcessInfo ( ProcessId , 〔StartTimeBuff〕 〔, ProcessorTimeBuff〕 )

指定項目

ProcessId

プロセスIDを数値，または値を格納した変数名で指定します。

このプロセスIDは，GetProcessCountコマンドで引数に返される値です。

また，JP1/Script 06-00以降では，Exec，およびNetExecコマンド実行時に返される_EXEC_ID_予約変数を指定することができます。この場合，Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルのプロセスの情報を取得します。

StartTimeBuff

プロセスの起動時刻を受け取る変数名を指定します。必要がない場合は省略します。

この変数に格納される値はhh:mm:ssの形式です。

ProcessorTimeBuff

プロセスの稼働時間を受け取る変数名を指定します。必要がない場合は省略します。

この変数に格納される値は秒単位です。

説明

指定されたプロセスIDのプロセスの情報を取得し，各変数に格納します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

補足

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。

例

' 起動中のプロセス"ABC"の情報を取得する。
Dim  pCnt ,pIdBuff ,seppId ,infBuff1 ,infBuff2
pCnt = GetProcessCount ( "ABC" ,pIdBuff )
For  i = 1 To pCnt
 seppId = SeparateStr ( pIdBuff ,";" ,i )
 GetProcessInfo ( seppId ,infBuff1 ,infBuff2 )
  ：
  ：
Next

対象バージョン

JP1/Script 05-20以降

9.8.3　TerminateProcess （プロセスを強制終了する）

機能

指定されたプロセスIDのプロセスを強制終了します。

形式

TerminateProcess ( ProcessId 〔, Code〕 )

指定項目

ProcessId

プロセスIDを数値，または値を格納した変数名で指定します。

このプロセスIDは，GetProcessCountコマンドで引数に返される値です。

また，JP1/Script 06-00以降では，Exec，およびNetExecコマンド実行時に返される_EXEC_ID_予約変数を指定することができます。この場合，Exec，およびNetExecコマンドから終了待ちをしない指定で呼び出した実行ファイルのプロセスを強制終了します。

Code

強制終了するプロセスに対する終了コードを数値，または値を格納した変数名で指定します。

この値を省略した場合は，0が仮定されます。

説明

指定されたプロセスIDのプロセスを強制終了します。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

また，指定されたプロセスIDのプロセスが存在しない場合は，常に真（True）を返します。

補足

このコマンドが実行された場合，イベントビューアのアプリケーションログにイベントログを出力します。イベントログのイベントIDは7になります。
ただし，実行環境で定義されたコマンドラインやレジストリのコマンドラインに/NOEVLOGや/NOEVLOG(7)などの指定がある場合，イベントログの出力を抑止します。

Windows Vista以降のOSでは管理者権限でスクリプトファイルを実行してください。詳細は，「1.8.3 コマンドの動作」を参照してください。また，管理者権限で実行しなかった場合，他ユーザで実行中のプロセスを強制終了できません（スクリプトプロセスは強制終了できます）。

例

' 起動中のプロセス"ABC"のうち最初に起動されたプロセス以外のプロセスを
' 強制終了する。
Dim  pCnt ,pIdBuff ,seppId
pCnt = GetProcessCount ( "ABC" ,pIdBuff )
If  pCnt > 1  Then
 For  i = 2 To pCnt
   seppId = SeparateStr ( pIdBuff ,";" ,i )
   TerminateProcess ( seppId )
 Next
End If

対象バージョン

JP1/Script 05-20以降

9.9　その他のコマンド

＜この節の構成＞

9.9.1　ExitWindows （スクリプトを終了しWindowsをログオフ／パワーオフ／リブートする）

9.9.2　SetRetryMode （排他エラーリトライ機能を設定する）

9.9.3　ResetRetryMode （排他エラーリトライ機能を解除する）

9.9.4　SetTrialOpenMode （試行オープン機能を設定する）

9.9.5　ResetTrialOpenMode （試行オープン機能を解除する）

9.9.1　ExitWindows （スクリプトを終了しWindowsをログオフ／パワーオフ／リブートする）

機能

スクリプトの実行を終了し，Windows をログオフ，パワーオフ，またはリブートします。

形式

ExitWindows ( 〔Code〕 〔, Option1 , Option2〕 )

指定項目

Code

終了コードを数値，または値を格納した変数名で指定します。

この値を省略した場合は，0が仮定されます。

Option1

シャットダウン操作の種別を指定します。

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

値
意味

Logoff
すべてのプロセスをシャットダウン後，カレントユーザをログオフします。

Poweroff，Shutdown
システムをシャットダウンし，電源を切ります。
シャットダウン権限を持っていなければなりません。また，システムがソフトウェアから電源を切る機能をサポートしていなければなりません。
なお，OSの「グループポリシー」にある「Windowsシステムのシャットダウンのときに電源を切らない」の項目の設定によっては，システムをシャットダウンし，電源を切っても安全な状態となります。

Reboot
システムをシャットダウン後，システムを再起動します。
シャットダウン権限を持っていなければなりません。

Force
シャットダウンの通知に応答しないアプリケーションがあっても「アプリケーションが応答しません」というダイアログを表示しないで，プロセスを強制的に終了させます。

この値は省略できます。省略した場合，Logoffを仮定します。

Option2

Option1でForce以外を指定した場合にOption1とともにシャットダウン操作の種別を指定します。

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

値 | 意味
Force | シャットダウンの通知に応答しないアプリケーションがあっても「アプリケーションが応答しません」というダイアログを表示しないで，プロセスを強制的に終了させます。

説明

スクリプトの実行を終了し，指定されたシャットダウン操作の種別でWindowsを終了させます。

なお，JP1/Scriptの終了コードについては，「6.1.12 JP1/Scriptの終了コード」を参照してください。

補足

このコマンドが実行された場合，イベントビューアのアプリケーションログにイベントログを出力します。イベントログのイベントIDは5になります。

ただし，実行環境で定義されたコマンドラインやレジストリのコマンドラインに/NOEVLOGや/NOEVLOG(5)などの指定がある場合，イベントログの出力を抑止します。

注意

他のプログラムやサービスを実行中にExitWindowsコマンドを実行すると，他のプログラムが正常に動作しなくなる危険性があります。

同時期にExitWindowsコマンドを複数回実行すると，Option1に指定した動作が無効になったり，OSが停止したりする場合があります。

JP1/AJS2またはJP1/AJS3から起動するスクリプトファイルでExitWindowsコマンドを実行すると，JP1/AJS2またはJP1/AJS3の環境を壊す場合があります。

次の場合，ExitWindowsコマンドは有効になりません。
・シャットダウン権限が無いアカウントを設定しているサービスからコマンドを実行した場合。
・シャットダウン権限が無いアカウントでログオンしているコンピュータのログオン空間からコマンドを実行した場合。
・コマンドのOption1，またはOption2にForceの指定が無い場合に動作中のアプリケーションがシャットダウンを拒否したとき。ただし，Windows Vista以降のOSではサービスからコマンドを実行した場合，Forceの指定の有無にかかわらず有効になります（Logoffは除く）。
・コマンドのOption1，またはOption2にForceの指定が無く，かつログオンしているコンピュータがロック状態である場合。ただし，Windows Vista以降のOSではサービスからコマンドを実行した場合，Forceの指定の有無にかかわらず有効になります（Logoffは除く）。
・Option1にLogoffを指定して，サービスからコマンドを実行した場合。

例

MessageBox ( "スクリプトの実行を終了し，シャットダウンします。" _
           ,OKCancel )
If  _MSG_RTN_ = OK  Then
 ExitWindows ( 0 ,Shutdown )
Else
 Exit ( 0 )
End

対象バージョン

JP1/Script 05-10以降

9.9.2　SetRetryMode （排他エラーリトライ機能を設定する）

機能

排他エラーリトライ機能を設定します。

形式

SetRetryMode ( Count〔，WaitTime〕)

指定項目

Count

リトライ回数を0から100の数値，または値を格納した変数名で指定します。

0を指定した場合，リトライを解除します。

WaitTime

リトライ待ち時間を100から60,000の数値，または値を格納した変数名で指定します。

リトライ待ち時間はミリ秒単位で指定します。

この値は省略できます。省略した場合，100を仮定します。

説明

排他エラーリトライ機能の対象となるコマンドおよびステートメントで，排他エラーが発生した場合に，指定されたリトライ回数およびリトライ待ち時間でリトライします。

設定されたリトライ回数およびリトライ待ち時間はResetRetryModeコマンドが実行されるまで有効になります。

例

Dim BkupFileName, FileNo
TempFile( BkupFileName, "BUP", _TEMP_ )
Copy( _TEMP + "MODE.INF", BkupFileName )
DeleteFile( _TEMP_ + "MODE.INF" )  ' ディスクの書き込み遅延のおそれあり
SetRetryMode( 5, 100 )  ' リトライ設定
FileNo = TextOpen( _TEMP_ + "MODE.INF", CREATE )
ResetRetryMode  ' リトライ解除
If FileNo = 0 Then
 MessageBox( _TEMP_ + "MODE.INF のオープンに失敗", OK )
 Exit 2
Else
 TextWrite( FileNo, "Mode=ReadOnly" )
End If
TextClose( FileNo )

対象バージョン

JP1/Script 10-00以降

9.9.3　ResetRetryMode （排他エラーリトライ機能を解除する）

機能

排他エラーリトライ機能を解除します。

形式

ResetRetryMode

説明

排他エラーリトライ機能の対象となるコマンドおよびステートメントで，排他エラーが発生した場合のリトライを解除します。

例

Dim BkupFileName, FileNo
TempFile( BkupFileName, "BUP", _TEMP_ )
Copy( _TEMP + "MODE.INF", BkupFileName )
DeleteFile( _TEMP_ + "MODE.INF" )  ' ディスクの書き込み遅延のおそれあり
SetRetryMode( 5, 100 )  ' リトライ設定
FileNo = TextOpen( _TEMP_ + "MODE.INF", CREATE )
ResetRetryMode  ' リトライ解除
If FileNo = 0 Then
 MessageBox( _TEMP_ + "MODE.INF のオープンに失敗", OK )
 Exit 2
Else
 TextWrite( FileNo, "Mode=ReadOnly" )
End If
TextClose( FileNo )

対象バージョン

JP1/Script 10-00以降

9.9.4　SetTrialOpenMode （試行オープン機能を設定する）

機能

試行オープン機能を設定します。

形式

SetTrialOpenMode ( Count〔，WaitTime〕)

指定項目

Count

試行回数を0から100の数値，または値を格納した変数名で指定します。

0を指定した場合，試行オープンを解除します。

WaitTime

試行間隔を100から60,000の数値，または値を格納した変数名で指定します。

試行間隔はミリ秒単位で指定します。

この値は省略できます。省略した場合，100を仮定します。

説明

TextCloseコマンドでのファイルクローズ後の試行オープンで排他エラーが発生した場合に，指定された試行回数および試行間隔で試行オープンします。

設定された試行回数および試行間隔はResetTrialOpenMode コマンドが実行されるまで有効になります。

例

Dim file1, Buff1
file1 = TextOpen( _BIN_ + "Error.log", ReadWrite )
If file1 = 0 Then
 MessageBox( _BIN_ + "Error.log のオープンに失敗", OK )
 Exit 2
End If
TextSeek( file1, ToEnd )
TextWrite( file1, "排他エラーが発生しました。" )
SetTrialOpenMode( 2, 6000 )  ' 試行オープン設定
TextClose( file1 )  ' ディスクの書き込み遅延のおそれあり
ResetTrialOpenMode  ' 試行オープン解除
Exec( "MessageOutput.EXE", True, _BIN_ + "Error.log" )

対象バージョン

JP1/Script 10-00以降

9.9.5　ResetTrialOpenMode （試行オープン機能を解除する）

機能

試行オープン機能を解除します。

形式

ResetTrialOpenMode

説明

TextCloseコマンドでのファイルクローズ後の試行オープンで排他エラーが発生した場合の試行オープンを解除します。

例

Dim file1, Buff1
file1 = TextOpen( _BIN_ + "Error.log", ReadWrite )
If file1 = 0 Then
 MessageBox( _BIN_ + "Error.log のオープンに失敗", OK )
 Exit 2
End If
TextSeek( file1, ToEnd )
TextWrite( file1, "排他エラーが発生しました。" )
SetTrialOpenMode( 2, 6000 )  ' 試行オープン設定
TextClose( file1 )  ' ディスクの書き込み遅延のおそれあり
ResetTrialOpenMode  ' 試行オープン解除
Exec( "MessageOutput.EXE", True, _BIN_ + "Error.log" )

対象バージョン

JP1/Script 10-00以降

10.　スクリプト制御インタフェース

この章では，実行中のスクリプトを制御する，スクリプト制御インタフェース（API）について説明します。

＜この章の構成＞

10.1　スクリプト制御インタフェースとは

10.2　スクリプト制御インタフェース一覧

10.3　スクリプト制御インタフェースの記述例

10.1　スクリプト制御インタフェースとは

スクリプト制御インタフェース（API）とは，実行中のスクリプトを制御するインタフェースです。JP1/Scriptの一部としてインストールされるSPTHL.DLLに含まれ，他のプログラムからWindows APIのLoadLibraryExを使用して呼び出すことができます。

その際，エントリーポイントの実行フラグには，LOAD_WITH_ALTERED_SEARCH_PATHを指定してください。

10.2　スクリプト制御インタフェース一覧

スクリプト制御インタフェースの一覧を次に示します。

コマンド | 意味
SPTHOpen | スクリプト制御マネージャをオープンします。
SPTHClose | スクリプト制御マネージャをクローズします。
SPTHGetErrorMessage | エラーメッセージを取得します。
SPTHTerminate | スクリプト実行を強制終了します。

＜この節の構成＞

10.2.1　SPTHOpen （スクリプト制御マネージャをオープンする）

10.2.2　SPTHClose （スクリプト制御マネージャをクローズする）

10.2.3　SPTHGetErrorMessage （エラーメッセージを取得する）

10.2.4　SPTHTerminate （スクリプト実行を強制終了する）

10.2.1　SPTHOpen （スクリプト制御マネージャをオープンする）

機能

スクリプト制御マネージャをオープンします。

スクリプト制御マネージャとは，スクリプト実行プロセスの制御を行うプログラムです。

プロトタイプ宣言

BOOL  APIENTRY  SPTHOpen
(
     LPCSTR  lpszComputerName ,
     HWND  hWnd ,
     LPHANDLE  lphScript
 )；

引数

lpszComputerName

スクリプトのコンピュータ名を指定します。

この値にNULLを指定した場合，現在のコンピュータ名を仮定します。

hWnd

コール元のウィンドウハンドルを指定します。

lphScript

スクリプト制御ハンドルを受け取る領域のポインタを指定します。

戻り値

成功した場合はTRUEを，失敗した場合はFALSEを返します。拡張エラーコードはGetLastError関数で取得できます。

対象バージョン

JP1/Script 05-00以降

10.2.2　SPTHClose （スクリプト制御マネージャをクローズする）

機能

スクリプト制御マネージャをクローズします。

プロトタイプ宣言

void  APIENTRY  SPTHClose
(
     HANDLE  hScript
 )；

引数

hScript

SPTHOpen関数で受け取ったスクリプト制御ハンドルを指定します。

戻り値

この関数に戻り値はありません。

対象バージョン

JP1/Script 05-00以降

10.2.3　SPTHGetErrorMessage （エラーメッセージを取得する）

機能

エラーメッセージを取得します。

プロトタイプ宣言

DWORD  APIENTRY  SPTHGetErrorMessage
(
     DWORD  dwErrorCode ,
     LPSTR  lpszMessage ,
     DWORD  dwSize
 )；

引数

dwErrorCode

GetLastError関数で取得したエラーコードを指定します。

lpszMessage

エラーメッセージを受け取るバッファのポインタを指定します。

dwSize

エラーメッセージを受け取るバッファのバイト数（’¥0’を含む）を指定します。バッファサイズが不足した場合は，入る部分だけが設定されます。

戻り値

エラーメッセージの長さ（’¥0’を含まない）を返します。

対象バージョン

JP1/Script 05-00以降

10.2.4　SPTHTerminate （スクリプト実行を強制終了する）

機能

スクリプト実行を強制終了します。

プロトタイプ宣言

BOOL  APIENTRY  SPTHTerminate
(
     HANDLE  hScript ,
     LPCSTR  lpszFileName ,
     UINT  uProcessID ,
     DWORD  dwOption
 )；

引数

hScript

SPTHOpen関数で受け取ったスクリプト制御ハンドルを指定します。

lpszFileName

スクリプトファイル名をフルパスで指定します。

この値はSPTHOpen関数で指定したコンピュータから見たファイルパスでなければなりません。

uProcessIDを指定した場合，この値を省略（NULLを指定）することができます。

uProcessID

スクリプトのプロセスIDを指定します。

lpszFileNameを指定した場合，この値を省略（0を指定）することができます。

dwOption

オプションを0，または次の値の組み合わせで指定します。

値 | 意味
SPTH_TERM_CHILD | スクリプトがExecやNetExecコマンドから呼び出した実行ファイルも強制終了する。要求してから3分経過しても実行ファイルが終了しない場合は，Win32 APIのTerminateProcess関数を使用して強制終了する。
SPTH_DQ_FILENAME | IpszFileNameで指定された値の間に空白が含まれているとき，値がダブルクォーテーションで囲まれる場合は，空白もファイル名の一部とみなし，値がダブルクォーテーションで囲まれていない場合は，最後の空白以降の文字列をファイル名とみなす。

説明

成功した場合はTRUEを，失敗した場合はFALSEを返します。拡張エラーコードはGetLastError関数で取得できます。

なお，終了するべきプロセスが存在しなくても（すでに終了していても）この関数は正常終了（TRUEを返す）します。

正常終了した場合でも実際にプロセス終了処理を行ったかどうかはGetLastError関数の戻り値で判定できます。プロセス終了処理を行った場合はNO_ERRORを返し，そうでない場合はそれ以外の値を返します。

備考

lpszFileNameとuProcessIDは，どちらかを省略することができますが，両方を指定した方がより確実に終了するべきスクリプトプロセスを特定することができるため，やむを得ない事情が無い限り両方を指定してください。

なお，複数起動したスクリプトプロセスを終了させる場合は，必ずuProcessIDを指定してください。

この関数によってスクリプトの実行を強制的に終了させた場合，スクリプトプロセスの戻り値は以下で示されるレジストリの値（デフォルトは17）になります。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥SPTX¥ExitCode

〔値名〕

Terminate

〔値のデータタイプ〕

REG_DWORD

〔値〕

スクリプトプロセスの戻り値

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

補足

JP1/AJSから，スクリプトの実行を強制終了する場合，SPTHTerminateを使用しています。詳細は「2.7.2(6) JP1/AJSからのJP1/Scriptの強制終了方法」を参照してください。

対象バージョン

JP1/Script 05-00以降

10.3　スクリプト制御インタフェースの記述例

スクリプト制御インタフェースの記述例を次に示します。

＜例＞

#include <windows.h>
#include <stdio.h>
#include <stdlib.h>
#include "sthapi.h"

BOOL    TerminateScript ( LPCSTR lpszNetName, LPCSTR lpszFileName, UINT uProcessID )
{
   HKEY            hKey;
   LPCSTR          subKey = "SOFTWARE¥¥Hitachi¥¥JP1/Script¥¥PathName";
   char              valueName[32];
   char              value[_MAX_PATH];
   DWORD          valueSize = sizeof ( value ) ;
   HINSTANCE      hAPIInstance;
   tSPTHOpen       pSPTHOpen;
   tSPTHClose       pSPTHClose;
   tSPTHTerminate   pSPTHTerminate;
   HANDLE          hScript;

   // レジストリオープン
   if ( RegOpenKeyEx( HKEY_LOCAL_MACHINE, subKey, 0, KEY_QUERY_VALUE, &hKey ) != ERROR_SUCCESS )
   {
       // エラー処理
       return ( FALSE ) ;
   }

   // "SPTHL.DLL"のパスを取得
   strcpy ( valueName, "Path01" ) ;
   if ( RegQueryValueEx ( hKey, valueName, 0, NULL, ( LPBYTE ) value, &valueSize ) != ERROR_SUCCESS)
   {
       // エラー処理
       return ( FALSE ) ;
   }

   // "SPTHL.DLL"をロード
   strcat ( value, "¥¥SPTHL.DLL" ) ;
   hAPIInstance = LoadLibraryEx (  value, NULL, LOAD_WITH_ALTERED_SEARCH_PATH ) ;
   if ( hAPIInstance == NULL )
   {
       // エラー処理
       return ( FALSE ) ;
   }

   // 各関数のエントリーポイントを取得
   pSPTHOpen      = ( tSPTHOpen )GetProcAddress ( hAPIInstance, "SPTHOpen" ) ;
   pSPTHClose     = ( tSPTHClose ) GetProcAddress ( hAPIInstance, "SPTHClose" ) ;
   pSPTHTerminate = ( tSPTHTerminate ) GetProcAddress ( hAPIInstance, "SPTHTerminate" ) ;

   // オープン
   if ( pSPTHOpen ( lpszNetName, NULL, &hScript ) == FALSE )
   {
       FreeLibrary ( hAPIInstance ) ;
       return ( FALSE ) ;
   }

   // スクリプト実行の強制終了
   if (pSPTHTerminate ( hScript, lpszFileName, uProcessID, SPTH_TERM_CHILD ) == FALSE )
   {
       pSPTHClose ( hScript ) ;
       FreeLibrary ( hAPIInstance );
       return ( FALSE );
   }

   // クローズ
   pSPTHClose ( hScript ) ;

   // APIのインスタンスハンドルを解放する
   FreeLibrary ( hAPIInstance ) ;

   return ( TRUE ) ;
}

11.　スクリプトOLEコントロール

この章では，スクリプトコマンドを実行する，スクリプトOLEコントロールについて説明します。

＜この章の構成＞

11.1　スクリプトOLEコントロールとは

11.2　SPTOコントロール

11.1　スクリプトOLEコントロールとは

スクリプトOLEコントロールとは，スクリプトコマンドを実行するOLEコントロールです。 本OLEコントロール（ SPTO.OCX ）は，JP1/Scriptの一部としてインストールされ，Visual Basicのアプリケーションなどに組み込むことができます。

なお，スクリプトOLEコントロールは，JP1/Script 05-00以降でサポートしています。

11.2　SPTOコントロール

機能

SPTOコントロールはスクリプトコマンドの実行を提供します。

構文

SPTO

プロパティ

RTN
EXECRTN
EXECID
EnableErrorMessage

メソッド

SetGV
GetGV
DeleteGV
Exec

対象バージョン

JP1/Script 05-00以降

＜この節の構成＞

11.2.1　RTNプロパティ （メソッドのエラー詳細コードを返す）

11.2.2　EXECRTNプロパティ （実行ファイルの終了コードを返す）

11.2.3　EXECIDプロパティ （実行ファイルの識別子を返す）

11.2.4　EnableErrorMessageプロパティ （エラーの有無を返す）

11.2.5　SetGVメソッド （グローバル変数を設定する）

11.2.6　GetGVメソッド （グローバル変数を取得する）

11.2.7　DeleteGVメソッド （グローバル変数を削除する）

11.2.8　Execメソッド （実行ファイルを呼び出す）

11.2.1　RTNプロパティ （メソッドのエラー詳細コードを返す）

機能

メソッドのエラー詳細コードを返します。

構文

Object . RTN

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

説明

メソッドのエラー詳細コードを長整数型（long）で返します。

対象バージョン

JP1/Script 05-00以降

11.2.2　EXECRTNプロパティ （実行ファイルの終了コードを返す）

機能

Execメソッド（終了待ちあり）から呼び出した実行ファイルの終了コードを返します。

構文

Object . EXECRTN

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

説明

Execメソッドから呼び出すアプリケーションの終了待ちをし，メソッドの実行結果がTrueの場合，アプリケーションの終了コードを長整数型（long）で格納します。終了待ちをしない場合やメソッドの実行結果がFalseの場合は何も格納されません。

対象バージョン

JP1/Script 05-00以降

11.2.3　EXECIDプロパティ （実行ファイルの識別子を返す）

機能

Execメソッド（終了待ちなし）から呼び出した実行ファイルの識別子を返します。

構文

Object . EXECID

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

説明

Execメソッドから呼び出すアプリケーションの終了待ちをしない場合，実行ファイルの識別子を文字列型で格納します。

対象バージョン

JP1/Script 05-00以降

11.2.4　EnableErrorMessageプロパティ （エラーの有無を返す）

機能

SPTOコントロール内にエラーがあるかどうかを返します。

構文

Object . EnableErrorMessage

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

説明

SPTOコントロール内にエラーがない場合はFalseを，エラーがある場合はTrueを返します。

対象バージョン

JP1/Script 05-00以降

11.2.5　SetGVメソッド （グローバル変数を設定する）

機能

グローバル変数を設定します。

構文

Object . SetGV ( GlobalName , Value )

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

GlobalName

設定するグローバル変数を文字列型で指定します。

Value

設定する値を文字列型で指定します。

説明

指定されたグローバル変数に指定された値を設定します。メソッドが正常に実行された場合はTrueを，エラーが発生した場合はFalseを，メソッドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，新規にグローバル変数を作成し値を設定します。グローバル変数が存在する場合は，指定された値で更新します。

補足

このメソッドは，インストール先フォルダの"DATA"フォルダ※下に，グローバル変数ファイル（SPTGV.SPG）を作成します。ただし，JP1/Script 06-51以降では，マネージャの［ツール］－［オプション（クラスタ環境）］ダイアログで管理ファイルの出力先が変更されている場合，指定されたフォルダ下にグローバル変数ファイルを作成します。このファイルはスクリプトの実行が終了しても残りますので，グローバル変数を初期化する場合は，ファイルを削除してください。

注※　Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

対象バージョン

JP1/Script 05-00以降

11.2.6　GetGVメソッド （グローバル変数を取得する）

機能

グローバル変数を取得します。

構文

Object . GetGV ( GlobalName )

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

GlobalName

取得するグローバル変数を文字列型で指定します。

説明

指定されたグローバル変数を取得し，値をメソッドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，長さ0の文字列（""）を返します。

対象バージョン

JP1/Script 05-00以降

11.2.7　DeleteGVメソッド （グローバル変数を削除する）

機能

グローバル変数を削除します。

構文

Object . DeleteGV ( GlobalName )

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

GlobalName

削除するグローバル変数を文字列型で指定します。

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

値 | 意味
AllGV | すべてのグローバル変数を削除します。ただし，グローバル変数ファイル（SPTGV.SPG）は残ります。

説明

指定されたグローバル変数を削除します。メソッドが正常に実行された場合はTrueを，エラーが発生した場合はFalseを，メソッドの実行結果として返します。

指定されたグローバル変数が存在しない場合は，何もしないで常にTrueを返します。

対象バージョン

JP1/Script 06-51以降

11.2.8　Execメソッド （実行ファイルを呼び出す）

機能

複数パラメタ指定で実行ファイル（EXEファイル，BATファイル，COMファイル，SPTファイル，CMDファイル，関連付けられたファイル）を呼び出します。終了待ちの有無を指定できます。

構文

Object . Exec ( FileName , Flag , Parameter )

指定項目

Object

SPTOコントロールへの参照を表すオブジェクト式を指定します。

FileName

呼び出す実行ファイル名を文字列型で指定します。

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

実行形式ファイル（.EXE）

MS-DOSバッチファイル（.BAT）

MS-DOS実行形式ファイル（.COM）

JP1/Scriptファイル（.SPT）

コマンドスクリプト（.CMD）

関連付けられたファイル

Flag

FileNameで指定された実行ファイルの終了待ちをするかどうかをブール型で指定します。終了待ちをするときはTrueを，終了待ちをしないときはFalseを指定します。

Parameter

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

複数のパラメタを指定する場合は，各パラメタを空白で区切って指定します。

なお，パラメタに次の文字列を指定した場合，特別な意味を持ちます。

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

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

説明

指定された実行ファイルを実行します。

FlagにTrueが指定された場合は，呼び出したアプリケーションが終了するまで待機し，Falseが指定された場合は，アプリケーションが終了するまで待機しないで次の処理に移ります。

アプリケーションが正常終了した場合はTrueを，それ以外の場合はFalseを，メソッドの実行結果として返します。

アプリケーションの終了待ちをし，メソッドの実行結果がTrueの場合は，実行ファイルの終了コードをEXECRTNプロパティに長整数型（long）で格納します。終了待ちをしない場合やメソッドの実行結果がFalseの場合は，EXECRTNプロパティには何も格納されません。

また，アプリケーションの終了待ちをしない場合，実行ファイルの識別子をEXECIDプロパティに文字列型で格納します。

対象バージョン

JP1/Script 05-00以降

付録

＜この付録の構成＞

付録A　Scriptトレースのファイル出力形式

付録B　サンプルファイル

付録C　エラー詳細コード

付録D　保守ログファイル

付録E　各バージョンの変更内容

付録F　このマニュアルの参考情報

付録G　用語解説

付録A　Scriptトレースのファイル出力形式

Scriptトレースで扱う次のファイルの出力形式について説明します。

解析トレースファイル

実行トレースファイル

ユーザトレースファイル（トレースファイル）

サーバトレースファイル

NetExecエラーログファイル

＜この節の構成＞

(1)　解析トレースファイルの出力形式

(2)　実行トレースファイルの出力形式

(3)　ユーザトレースファイルの出力形式

(4)　サーバトレースファイルの出力形式

(5)　NetExecエラーログファイルの出力形式

(1)　解析トレースファイルの出力形式

解析トレースファイルは，コマンドの解析結果を出力するファイルです。対象となるスクリプトが複数起動を許可されているかどうかによって，出力形式が異なります。

(a)　複数起動が許可されていないスクリプトの場合

ファイル名
ファイル名（拡張子.SPA）は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。

出力形式
解析トレースファイルの出力形式を図A-1に示します。

図A-1　解析トレースファイルの出力形式（複数起動が許可されていないスクリプトの場合）

a．トレース出力を開始した日時，実行したコンピュータ名，実行したユーザ名，およびスクリプトエンジンのバージョンを出力します。

b．解析時エラーとなった時間を出力します。

c．解析時エラーとなった行の位置，列の位置を出力します。

d．解析エラーとなったコマンドを出力します。

e．解析エラーの内容を出力します。

f．解析エラーの合計値を出力します。

g．トレース出力を終了した日時を出力します。

行数および列数の範囲
解析トレースファイルに出力するトレース情報は，行数100～9,999，列数128～1,024の範囲で出力できます。
行数，および列数の出力範囲は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

(b)　複数起動が許可されているスクリプトの場合

ファイル名
ファイル名（拡張子.SPA）は，マネージャの［ツール］－［オプション］の「複数起動」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。

出力形式
解析トレースファイルの出力形式を図A-2に示します。

図A-2　解析トレースファイルの出力形式（複数起動が許可されているスクリプトの場合）

a．実行したプロセスのトレース出力を開始した日時，プロセス識別子，開始を意味する「S」，スクリプトエンジンのバージョン，および実行したコンピュータ名と実行したユーザ名を出力します。

b．解析時エラーとなった時間を出力します。

c．解析時エラーとなったプロセスのプロセス識別子を出力します。

d．解析時エラーとなった行の位置，列の位置を出力します。

e．解析エラーとなったコマンドを出力します。

f．解析エラーの内容を出力します。

g．実行したプロセスのトレース出力を終了した日時，プロセス識別子，および終了を意味する「E」を出力します。

h．解析エラーの合計値を出力します。

行数および列数の範囲
解析トレースファイルに出力するトレース情報は，行数100～9,999，列数128～1,024の範囲で出力できます。
行数，および列数の出力範囲は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

(2)　実行トレースファイルの出力形式

実行トレースファイルは，スクリプト実行プログラムが，コマンドの実行結果を出力するファイルです。対象となるスクリプトが複数起動を許可されているかどうかによって，出力形式が異なります。

(a)　複数起動が許可されていないスクリプトの場合

ファイル名
ファイル名（拡張子.SPX）は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。

出力形式
実行トレースファイルの出力形式を図A-3に示します。

図A-3　実行トレースファイルの出力形式（複数起動が許可されていないスクリプトの場合）

a．トレースの出力を開始した日時，および実行したコンピュータ名，実行したユーザ名，およびスクリプトエンジンのバージョンを出力します。

b．実行時エラーとなった時間を出力します。

c．エラーとなったときに出力します。

d．実行時エラーとなったコマンドの行位置を出力します。

e．実行エラーのコマンド名を出力します。

f．エラーの内容を出力します。

g．実行エラーの合計値を出力します。

h．トレース出力を終了した日時を出力します。

行数および列数の範囲
実行トレースファイルに出力するトレース情報は，行数100～9,999，列数128～1,024の範囲で出力できます。
行数，および列数の出力範囲は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

(b)　複数起動が許可されているスクリプトの場合

ファイル名
ファイル名（拡張子.SPX）は，マネージャの［ツール］－［オプション］の「複数起動」ページで指定した，フォルダ名とスクリプトのファイル名を組み合わせた名称となります。

出力形式
実行トレースファイルの出力形式を図A-4に示します。

図A-4　実行トレースファイルの出力形式（複数起動が許可されているスクリプトの場合）

a．実行したプロセスのトレースの出力を開始した日時，プロセス識別子，開始を意味する「S」，およびスクリプトエンジンのバージョン，および実行したコンピュータ名と実行したユーザ名を出力します。

b．実行時エラーとなった時間を出力します。

c．実行時エラーとなったプロセスのプロセス識別子を出力します。

d．エラーとなったときに出力します。

e．実行時エラーとなったコマンドの行位置を出力します。

f．実行エラーのコマンド名を出力します。

g．エラーの内容を出力します。

h．実行したプロセスのトレース出力を終了した日時，プロセス識別子，および終了を意味する「E」を出力します。

i．実行エラーの合計値を出力します。

行数および列数の範囲
実行トレースファイルに出力するトレース情報は，行数100～9,999，列数128～1,024の範囲で出力できます。
行数，および列数の出力範囲は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。
なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

(3)　ユーザトレースファイルの出力形式

ユーザトレースファイルは，Messageコマンドの第一引数にTarget_Fileを指定して出力したファイルです。

(a)　ファイル名

ファイル名（.TXT）は，ユーザが任意で付けられます。

(b)　出力形式

ユーザトレースファイルの出力形式を図A-5に示します。

図A-5　ユーザトレースファイルの出力形式

a．トレース出力した日付と時間を出力します。

b．出力したメッセージです。

(c)　行数および列数の範囲

ユーザトレースファイルに出力するトレース情報は，行数100～9,999，列数128～1,024の範囲で出力できます。

行数，および列数の出力範囲は，マネージャの［ファイル］－［実行の環境設定］の「トレース情報」ページで，任意に値を変更できます。

なお，出力されるトレース情報が，行数の最大範囲を超えた場合は，先頭の行に戻って，先頭の行からトレース情報が出力されます（すでに出力されているトレース情報が上書きされます）。また，列数の最大範囲を超えた場合は，範囲を超えた部分が削除されます。

(4)　サーバトレースファイルの出力形式

サーバトレースファイルは，クライアントからSetGV，GetGV，DeleteGV，およびNetExecコマンドで呼び出されたサーバがコマンドを実行した結果を出力するファイルです。

(a)　ファイル名

ファイル名は，SPTSVTRC.SPYで固定です。インストール先フォルダの"DATA"フォルダ※下に作成されます。

注※

Windows Vista以降のOSではスクリプトの実行環境フォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Data）

(b)　出力形式

サーバトレースファイルの出力形式を図A-6に示します。

図A-6　サーバトレースファイルの出力形式

a．サーバでコマンドを実行した日付を出力します。

b．サーバでコマンドの実行を開始した時間を出力します。

c．サーバでコマンドの実行を終了した時間を出力します。

d．サーバで実行したコマンド名を出力します。

e．サーバで実行したコマンドがプロセスを呼び出す場合，2行のトレースを出力します。この1行目と2行目を識別する記号を出力します。

S：1行目のトレース

E：2行目のトレース

f．サーバで実行したコマンドがプロセスを呼び出す場合，プロセス識別子を出力します。

g．サーバで実行したコマンドの実行結果を出力します。

OK：正常

ER：実行エラー（括弧内の数値は，エラー詳細コード）

h．クライアントのコンピュータ名を出力します（""で囲まれます）。

i．クライアントのユーザ名を出力します（""で囲まれます）。

j．クライアントで実行したスクリプトファイル名をフルパスで出力します（""で囲まれます）。括弧内の数値は，サーバで実行したコマンドのスクリプトファイル中の行番号です。

k．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスを開始した時間を出力します。

l．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスを終了した時間を出力します。

m．サーバで実行したコマンドがプロセスを呼び出す場合，プロセスの終了コードを出力します（サーバで実行したコマンドの実行結果がOKのときだけ出力されます）。

(c)　行数および列数の範囲

サーバトレースファイルに出力する実行結果は，行数1～1,000，列数200で，行数，および列数の値は変更できません。なお，出力される実行結果が行数の最大値を超えた場合は，先頭の行に戻って，先頭の行から実行結果が出力されます（すでに出力されている実行結果が上書きされます）。また，列数の最大値を超えた場合は，改行されます。

(d)　出力指定

ユーザは，マネージャの［オプションダイアログ］の［サーバ情報］ページで，サーバトレースファイルの出力の有無を指定できます。

(5)　NetExecエラーログファイルの出力形式

NetExecエラーログファイルは，NetExecコマンド実行時に発生したエラー内容を出力します。障害が発生した際，トレースファイル，ログファイル，およびイベントログを参照しても障害の原因を特定できない場合は，NetExecエラーログファイルを採取してサポートセンターに問い合わせてください。

(a)　ファイル名

クライアント側
フォルダ名※1：インストール先の「LOG」フォルダ※2に「STXNetExec_Client」というフォルダを作成し，そのフォルダ下。
ファイル名：「STXNetExec_C_xx.LOG」
xxは01～30までの数値。NetExecコマンド実行制御を行うSPTXNetx.exeの1回のプロセス実行に対して，一つのトレースファイルを出力します。

サーバ側
フォルダ名※3：インストール先の「LOG」フォルダ※2に「STXNetExec_Server」というフォルダを作成し，そのフォルダ下。
ファイル名：「STXNetExec_S_xx.LOG」
xxは01～30までの数値。NetExecコマンド実行制御を行うSPTXNetx.exeの1回のプロセス実行に対して，一つのトレースファイルを出力します。
注※1　JP1/Script 07-00より前のバージョンではインストール先の"Data"フォルダ下に「LOG¥STXNetExec_Client」というフォルダを作成し，そのフォルダ下。
注※2　Windows Vista以降のOSではスクリプトのログファイルフォルダ（システムドライブ¥ProgramData¥Hitachi¥Script¥Log）。
注※3　JP1/Script 07-00より前のバージョンではインストール先の"Data"フォルダ下に「LOG¥STXNetExec_Server」というフォルダを作成し，そのフォルダ下。

(b)　出力形式

クライアント側エラーログの出力形式を図A-7に，サーバ側エラーログの出力形式を図A-8に示します。

図A-7　クライアント側エラーログの出力形式

図A-8　サーバ側エラーログの出力形式

(c)　ファイル容量

エラーログのファイル容量は，クライアント側，サーバ側のそれぞれで，次のとおりです。

1ファイルのファイル容量上限値：（100バイト／1行）＊100行=約10KB（キロバイト）

ファイル数の上限値： 30ファイル

合計の上限値：約10KB（キロバイト）＊30ファイル=約300KB（キロバイト）

(d)　出力指定

インストーラは次のレジストリを設定し，デフォルトでエラーログを出力します。

〔レジストリキー〕

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

〔値名1〕

Net_Trace

〔値のデータタイプ1〕

REG_DWORD

〔値1〕

トレースの出力の有無，および出力レベル

0：トレース出力しない

1：エラートレースだけ出力し，正常終了時はファイルを削除し残さない（初期値）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

〔値名2〕

Net_Trace_Directory

〔値のデータタイプ2〕

REG_SZ

〔値2〕

トレース出力先フォルダ名（初期値：スクリプトのログフォルダ）

〔設定が有効になるタイミング〕

スクリプトファイルの次回実行時

付録B　サンプルファイル

JP1/Scriptでは，次の2種類のサンプルファイルを提供しています。

メニュー画面を表示し，選択した番号に応じた処理をするサンプルファイル

プログラムを呼び出して，終了コードをチェックするサンプルファイル

ここでは，これらのサンプルファイルの機能概要，ファイル構成，および実行手順について説明します。なお，サンプルファイルの格納先については，「2.1.1 プログラムのインストール先のフォルダ」を参照してください。

＜この節の構成＞

(1)　メニュー画面を表示し，選択した番号に応じた処理をするサンプルファイル

(2)　実行ファイルを呼び出して，終了コードをチェックするサンプルファイル

(1)　メニュー画面を表示し，選択した番号に応じた処理をするサンプルファイル

(a)　機能概要

サンプルファイルを起動するとメニュー画面が表示されます。メニュー画面の番号を選択すると，次の操作ができます。

処理番号1

スクリプトファイルを作成します。

処理番号2

スクリプトファイルを複写します。

処理番号3

サンプルファイルのあるフォルダ下のファイル一覧をユーザトレースファイルへ出力します。

処理番号9

サンプルファイルを終了します。

(b)　ファイル構成

SmplMain.Spt：このサンプルファイルのメインスクリプトファイル

Smpl001.Spt：処理番号2に対応しているスクリプトファイル

Smpl002.Spt：処理番号3に対応しているスクリプトファイル

Sample.Spt：処理番号1の処理で作成するデフォルトスクリプトファイル

(c)　サンプルファイルの実行手順

サンプルファイル「SmplMain.Spt」を実行する。
メニュー画面が表示されます。

実行したい処理番号を入力して［実行］ボタンをクリックする。
（［キャンセル］ボタンをクリックするとサンプルプログラムが終了します）

処理番号「1」を選択すると，スクリプトファイル名を指定する画面が表示されます。ファイル名を入力後，［OK］ボタンをクリックしてください。
指定したスクリプトファイルを開きます。

処理番号「2」を選択すると，処理番号1で作成したスクリプトファイルを複写します。サンプルファイルが格納されているフォルダ下に「CopyFolder」フォルダを作成し，ファイル名「bkupSpt.spt」で複写します。

処理番号「3」を選択すると，サンプルファイルが格納されているフォルダ下のファイルの一覧がユーザトレースファイルに出力されます。ユーザトレースファイルのファイル名は「SmplOut.TXT」です。

処理が正常に終了すると，メニュー画面に戻ります。
エラーが発生した場合は，ビープ音が鳴り，メッセージボックスが表示されます。また，トレースビューアのステータスにユーザエラーの警告を出力します。

(2)　実行ファイルを呼び出して，終了コードをチェックするサンプルファイル

(a)　機能概要

サンプルファイルから実行ファイルを呼び出して，終了コードをチェックします。

(b)　ファイル構成

ExitCode.Spt：このサンプルファイルのメインスクリプトファイル

ExitCode.Exe：ExitCode.Sptから呼び出される実行ファイル

(c)　サンプルファイルの実行手順

サンプルファイル「ExitCode.SPT」を実行する
パラメタとして次のうちどちらかの値を指定します。
T：対話モードで実行する
B：バッチモードで実行する

対話モードで実行した場合，画面が表示されるので終了コードを入力する
終了コードに0以外の値を入力した場合は，ユーザトレースファイルが出力されます。出力されるファイル名は「EXITCODE.TXT」です。
バッチモードで実行した場合は，画面が表示されないで，終了コードが0で動作します。
エラーが発生した場合は，メッセージボックスを表示し，処理を終了します。

付録C　エラー詳細コード

＜この節の構成＞

(1)　JP1/Scriptが設定するエラーコード

(2)　OSのエラーコード

(1)　JP1/Scriptが設定するエラーコード

NetExecコマンド実行後，_RTN_に設定されるリターンコードの意味を次の表に示します。

エラーコード | エラーの内容
-1431698655​ | サーバからの応答待ちでタイムアウトエラー発生。
-1431698656​ | サーバが接続要求に対して応答しない。
-1431698579​ | サーバからデータ受信中にエラー発生。
-1431698578​ | サーバとの送受信中の無通信時間が許容時間を超えた。

(2)　OSのエラーコード

Windowsで設定されるエラーコードを，ご参考までに次の表に示します。ただし，OSの種類により異なる場合もありますので，この内容は必ず保証されるものではありません。

エラーコード | エラーの内容
-004 | 出力ファイル用のメモリ空間が足りません。
-006 | グローバルハンドルが不正です。
0001 | ファンクションが間違っています。
0002 | システムは指定されたファイルを見つけることができません。
0003 | システムは指定されたネットワーク名またはディレクトリパスを見つけることができません。
0004 | ファイルを開くことができません。
0005 | アクセスは拒否されました。ファイルの属性またはセキュリティを見直してください。
0006 | ハンドルが無効です。
0007 | 記憶域制御ブロックが壊れています。
0008 | このコマンドを実行するのに十分な記憶域がありません。
0009 | 記憶域制御ブロックのアドレスが無効です。
0010 | 環境が間違っています。
0011 | 間違ったフォーマットのプログラムを読み込もうとしました。
0012 | アクセスコードが無効です。
0013 | データが無効です。
0014 | この操作を完了するのに十分な記憶域がありません。
0015 | 指定されたドライブが見つかりません。
0016 | ディレクトリを削除できません。
0017 | ファイルを別のディスクドライブに移動できません。
0018 | これ以上ファイルがありません。
0019 | このメディアは書き込み禁止になっています。
0020 | 指定されたデバイスが見つかりません。
0021 | デバイスの準備ができていません。
0022 | デバイスがコマンドを認識できません。
0023 | データエラー（巡回冗長検査(CRC)エラー）です。
0024 | プログラムはコマンドを発行しましたが，コマンドの長さが間違っています。
0025 | 指定されたディスクの領域またはトラックが見つかりません。
0026 | 指定されたディスクまたはフロッピーディスクにアクセスできません。
0027 | 要求されたセクタが見つかりません。
0029 | 指定されたデバイスに書き込めません。
0030 | 指定されたデバイスから読み取れません。
0031 | システムに接続されたデバイスが機能していません。
0032 | プロセスはファイルにアクセスできません。別のプロセスが使用中です。
0033 | プロセスはファイルにアクセスできません。別のプロセスがファイルの一部をロックしています。
0036 | 開かれている共有ファイルが多過ぎます。
0038 | ファイルの終わりに達しました。
0039 | ディスクがいっぱいです。
0050 | ネットワーク要求はサポートされていません。
0051 | リモートコンピュータは利用できません。
0052 | ネットワーク上に同じ名前があります。
0053 | ネットワークパスが見つかりません。
0054 | ネットワークがビジーです。
0055 | 指定されたネットワークリソースまたはデバイスは利用できません。
0056 | ネットワーク BIOS コマンドが制限値に達しました。
0057 | ネットワークアダプタのハードウェアエラーが発生しました。
0058 | 指定されたサーバは，要求された操作を実行できません。
0059 | 予期しないネットワークエラーが発生しました。
0060 | リモートアダプタは互換性がありません。
0064 | 指定されたネットワーク名は利用できません。
0065 | ネットワークアクセスは拒否されました。
0066 | ネットワークリソースの種類が正しくありません。
0067 | ネットワーク名が見つかりません。
0068 | ローカルコンピュータのネットワークアダプタカードに対する名前の数が制限値を超えました。
0069 | ネットワークBIOSセッションの数が制限値を超えました。
0070 | リモートサーバは一時停止されているか，起動途中です。
0071 | コンピュータへの接続数が最大値に達しているため，これ以上このリモートコンピュータに接続できません。
0072 | 指定されたプリンタまたはディスクデバイスは一時停止されています。
0080 | ファイルがあります。
0082 | ディレクトリまたはファイルを作成できません。
0084 | この要求を処理するための記憶域がありません。
0085 | ローカル デバイス名は既に使用されています。
0086 | 指定されたネットワーク パスワードが間違っています。
0087 | パラメータが間違っています。
0088 | ネットワークで書き込みエラーが発生しました。
0089 | 現在，ほかのプロセスを起動できません。
0110 | 指定されたデバイスまたはファイルを開けません。
0111 | ファイル名が長過ぎます。
0112 | ディスクに十分な空き領域がありません。
0123 | ファイル名，ディレクトリ名，またはボリュームラベルの構文が間違っています。
0144 | このディレクトリはルートディレクトリのサブディレクトリではありません。
0145 | ディレクトリが空ではありません。
0148 | 指定されたパスは現在使用できません。
0161 | 指定されたパスは無効です。
0164 | このシステムでは，これ以上のスレッドを作成できません。
0167 | ファイルの領域をロックできません。
0170 | 要求されたリソースは使用中です。
0183 | すでに存在するファイルを作成することはできません。
0196 | このオペレーティングシステムではこのアプリケーションプログラムは実行されません。
0197 | オペレーティングシステムは現在このアプリケーションを実行するように構成されていません。
0199 | このオペレーティングシステムではこのアプリケーションプログラムは実行されません。
0206 | ファイル名または拡張子が長過ぎます。
0230 | パイプの状態が無効です。
0231 | すべてのパイプインスタンスがビジーです。
0232 | パイプを閉じています。
0240 | セッションは取り消されました。
0267 | ディレクトリ名が無効です。
1053 | そのサービスは指定時間内に開始要求または制御要求に応答しませんでした。
1054 | サービスに対してスレッドを作成できませんでした。
1056 | サービスインスタンスはすでに実行されています。
1057 | アカウント名が無効であるか，または存在しません。あるいは，指定したアカウント名のパスワードが無効です。
1058 | 指定されたサービスは無効であるか，または有効なデバイスが関連づけられていないため，開始できません。
1060 | 指定されたサービスはインストールされたサービスとして存在しません。
1062 | そのサービスを開始できませんでした。
1069 | ログオンに失敗したため，サービスを開始できませんでした。
1070 | サービスは開始後に開始待ち状態でハングしました。
1073 | 指定されたサービスはすでに開始されています。
1078 | その名前は，サービス名またはサービス表示名としてすでに使われています。
1114 | ダイナミックリンクライブラリ(DLL)初期化ルーチンの実行に失敗しました。
1115 | システムシャットダウンが実行中です。
1117 | I/Oデバイスエラーが発生したため，要求を実行できませんでした。
1123 | フロッピーディスクのセクタIDフィールドとフロッピーディスクコントローラトラックアドレスが一致しません。
1124 | フロッピーディスクドライバが認識しないエラーがフロッピーディスクコントローラから報告されました。
1125 | フロッピーディスクコントローラは矛盾する結果をレジスタに返しました。
1130 | このコマンドを処理するのに必要な記憶域をサーバで確保できません。
1131 | デッドロック発生の可能性が検出されました。
1176 | 置換するファイルを置換されるファイルに移動できません。置換されるファイルの名前は，元のままです。
1177 | 置換するファイルを置換されるファイルに移動できません。置換されるファイルの名前は，バックアップ名に変更されています。
1326 | ログオン失敗:ユーザー名を認識できないか，またはパスワードが間違っています。
1327 | ログオン失敗:ユーザー アカウントの制限。
1328 | ログオン失敗:アカウントのログオン時間の制約違反。
1329 | ログオン失敗:ユーザはこのコンピュータへのログオンを許可されていません。
1330 | ログオン失敗:指定されたアカウント，パスワードの有効期間が切れています。
1331 | ログオン失敗:アカウントは現在無効に設定されています。
1380 | ログオン失敗:要求された種類のログオンは，このコンピュータではユーザーに許可されていません。
1385 | ログオン失敗:要求された種類のログオンは，このコンピュータではユーザーに許可されていません。
1450 | システムリソースが不足しているため，要求されたサービスを完了できません。
1451 | システムリソースが不足しているため，要求されたサービスを完了できません。
1452 | システムリソースが不足しているため，要求されたサービスを完了できません。
7006 | 同じ名前のサービス名が，すでにシステムにあります。

コマンド実行後に設定されたリターンコードのエラー内容は，GetErrorMessageコマンドを使用して取得できます。次に例を示します。

（例）

Dim ErrMsg
Dim ErrCode
ErrCode=21
ErrMsg=GetErrorMessage(ErrCode)
Message( Target_File, _BIN_+"ErrMsg.txt", ErrMsg )

付録D　保守ログファイル

JP1/Scriptの各種プログラム内でWindowsが提供する機能を呼び出した際に障害が発生すると，保守ログファイルが出力されます。

障害が発生した際，トレースファイル，ログファイル，およびイベントログを参照しても障害の原因を特定できない場合は，保守ログファイルを採取してサポートセンターに問い合わせてください。

保守ログファイルを出力する機能，およびログファイル名を次の表に示します。

表D-1　保守ログファイルを出力する機能およびログファイル名

ログを出力する機能 | ログファイル名
Script実行制御 | SPTXE_プロセス識別子.log
NetExecコマンド実行制御 | SPTXNETX_プロセス識別子.log
Scriptサービス | SPTHSV_プロセス識別子.log
Scriptランチャ | SPTHLNCH_プロセス識別子.log
Scriptランチャサービス | SPTHLSV_プロセス識別子.log

一つのプロセスで繰り返し保守ログファイルが出力された場合，出力されたログファイルのサイズが最大値を超えることがあります。ログファイルのサイズが最大値を超えた場合，次に保守ログファイルを出力するタイミングで古いログファイルのファイル名がXXXX_プロセス識別子.n.log（nは通し番号）に変更され，XXXX_プロセス識別子.logファイルが新たに作成されます。

保守ログファイルの出力指定を次に示します。

〔レジストリキー〕

HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script¥Option¥Maintenance

表D-2　レジストリキーに設定する値

機能名
値名
データタイプ
値

Script実行制御
SptExec_Log_Dir
REG_SZ
出力先フォルダのパス※1

初期値：デフォルトの保守ログファイル出力フォルダ※2

SptExec_Log_Size
REG_DWORD
ファイルの最大サイズ（バイト）
1,024～2,147,483,647

初期値：32,768

SptExec_Log_Num
REG_DWORD
ファイルの最大面数
0～1,024

初期値：20

NetExecコマンド実行制御
SptNetExec_Log_Dir
REG_SZ
出力先フォルダのパス※1

初期値：デフォルトの保守ログファイル出力フォルダ※2

SptNetExec_Log_Size
REG_DWORD
ファイルの最大サイズ（バイト）
1,024～2,147,483,647

初期値：32,768

SptNetExec_Log_Num
REG_DWORD
ファイルの最大面数
0～1,024

初期値：10

Scriptサービス
Service_Log_Dir
REG_SZ
出力先フォルダのパス※3

初期値：デフォルトの保守ログファイル出力フォルダ※2

Service_Log_Size
REG_DWORD
ファイルの最大サイズ（バイト）
1,024～2,147,483,647

初期値：524,288

Service_Log_Num
REG_DWORD
ファイルの最大面数
0～1,024

初期値：2

Scriptランチャ
Launcher_Log_Dir
REG_SZ
出力先フォルダのパス※4

初期値：デフォルトの保守ログファイル出力フォルダ※2

Launcher_Log_Size
REG_DWORD
ファイルの最大サイズ（バイト）
1,024～2,147,483,647

初期値：524,288

Launcher_Log_Num
REG_DWORD
ファイルの最大面数
0～1,024

初期値：2

Scriptランチャサービス
LauncSv_Log_Dir
REG_SZ
出力先フォルダのパス※3

初期値：デフォルトの保守ログファイル出力フォルダ※2

LauncSv_Log_Size
REG_DWORD
ファイルの最大サイズ（バイト）
1,024～2,147,483,647

初期値：524,288

LauncSv_Log_Num
REG_DWORD
ファイルの最大面数
0～1,024

初期値：2

注※1　スクリプトを実行するアカウントが，ファイルの作成，削除，および更新ができるフォルダを選択してください。

注※2　保守ログファイルのデフォルトの出力フォルダは次のとおりです。

Windows Vista以降のOSの場合
システムドライブ¥ProgramData¥Hitachi¥Script¥Log¥Maintenance

Windows Vistaより前のOSの場合
JP1/Scriptインストールフォルダ¥Log¥Maintenance

注※3　ローカルシステムアカウントが，ファイルの作成，削除，および更新ができるフォルダを選択してください。

注※4　Scriptランチャを起動するアカウントが，ファイルの作成，削除，および更新できるフォルダを選択してください。

保守ログファイルの最大サイズおよび最大面数は，通常は初期値のまま運用してください。軽微なエラーの場合も保守ログファイルが出力されることがあるため，スクリプトの内容によってはシステムが正常に運用されていても保守ログファイルが生成・更新されるときがあります。このようなときは，Script実行制御の保守ログファイル面数やNetExecコマンドの保守ログファイル面数を変更してください。値を変更する際は，同時に実行されるスクリプト数相当の値を目安にして設定ください。

また，10-00より前のバージョンのJP1/Scriptを使用し，エラーが発生しても無視して次の処理を実行するようなスクリプトで運用していた場合，JP1/Scriptを10-00にバージョンアップすると，保守ログファイルの出力によって実行性能が低下することがあります。保守ログファイルの出力によって実行性能が低下した場合は，Script実行制御の保守ログファイルの最大面数を「0」に設定すると，保守ログファイルの出力を抑止できます。

付録E　各バージョンの変更内容

各バージョンでの変更内容を示します。

＜この節の構成＞

(1)　10-00の変更内容

(2)　09-00の変更内容

(1)　10-00の変更内容

CallDllコマンドで，「DLLファイルをアンロードしない」モードをサポートした。

NetExecコマンドをリモート実行できるユーザを限定する機能を追加した。

Scriptランチャサービスをサポートした。

Windows Server 2008ターミナルサービスのRemoteApp（TS RemoteApp）に対応した。

Windows Vista以降で出力されていたセキュリティの警告に対応し，JP1/Scriptが作成するファイルに対して，ユーザの運用に合わせたアクセス権を設定できるようにした。

試行オープン機能をサポートした。

排他エラーリトライ機能をサポートした。

保守ログファイルを出力するようにした。

次のOSをサポート対象外とした。

Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems

Microsoft(R) Windows Server(R) 2008 for Itanium-based Systems

Microsoft(R) Windows Server(R) 2008 R2 for Itanium-based Systems

(2)　09-00の変更内容

ジョブの自動運転・実行管理を行う場合のシステム構成について，JP1/AJS3との連携をサポートした。

ExitWindowsコマンドが有効にならない条件から，「Windows 2000 Server，Windows 2000 Advanced Server，およびWindows Server 2003でシステムアカウント以外を設定しているサービスからコマンドを実行し，かつログオンしていない状態の場合」を削除した。

Beepコマンド実行時の注意事項を追加した。

Windows Server 2008，Windows Server 2008（IPF）をサポート対象OSとした。

付録F　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録F.1　関連マニュアル

付録F.2　このマニュアルでの表記

付録F.3　オンラインヘルプについて

付録F.4　図中で使用する記号

付録F.5　このマニュアルで使用する記号

付録F.6　コマンドの文法で使用する記号

付録F.7　64ビット版のWindowsのレジストリキーの名称について

付録F.8　JIS 2004（JIS X 0213：2004）で追加された第3水準，第4水準漢字について

付録F.9　KB（キロバイト）などの単位表記について

付録F.1　関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

JP1/IM関連

JP1 Version 10 JP1/Integrated Management - Manager クイックリファレンス（3021-3-006）

JP1 Version 10 JP1/Integrated Management - Manager 導入・設計ガイド（3021-3-007）

JP1 Version 10 JP1/Integrated Management - Manager 構築ガイド（3021-3-008）

JP1 Version 10 JP1/Integrated Management - Manager 運用ガイド（3021-3-009）

JP1 Version 10 JP1/Integrated Management - Manager 画面リファレンス（3021-3-010）

JP1 Version 10 JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス（3021-3-011）

JP1 Version 10 JP1/Integrated Management - Manager メッセージ（3021-3-012）

JP1/AJS3関連

JP1 Version 10 JP1/Automatic Job Management System 3 入門（3021-3-101）

JP1 Version 10 JP1/Automatic Job Management System 3 導入ガイド（3021-3-102）

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3021-3-103）

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-104）

JP1 Version 10 JP1/Automatic Job Management System 3 構築ガイド1（3021-3-105）

JP1 Version 10 JP1/Automatic Job Management System 3 構築ガイド2（3021-3-106）

JP1 Version 10 JP1/Automatic Job Management System 3 運用ガイド（3021-3-107）

JP1 Version 10 JP1/Automatic Job Management System 3 トラブルシューティング（3021-3-108）

JP1 Version 10 JP1/Automatic Job Management System 3 操作ガイド（3021-3-109）

JP1 Version 10 JP1/Automatic Job Management System 3 コマンドリファレンス1（3021-3-110）

JP1 Version 10 JP1/Automatic Job Management System 3 コマンドリファレンス2（3021-3-111）

JP1 Version 10 JP1/Automatic Job Management System 3 連携ガイド（3021-3-112）

JP1 Version 10 JP1/Automatic Job Management System 3 メッセージ1（3021-3-113）

JP1 Version 10 JP1/Automatic Job Management System 3 メッセージ2（3021-3-114）

JP1/AJS2関連

JP1 Version 8 JP1/Automatic Job Management System 2 解説（3020-3-K21）

JP1 Version 8 JP1/Automatic Job Management System 2 設計・運用ガイド（3020-3-K22）

JP1 Version 8 JP1/Automatic Job Management System 2 セットアップガイド（3020-3-K23）

JP1 Version 8 JP1/Automatic Job Management System 2 操作ガイド（3020-3-K24）

JP1 Version 8 JP1/Automatic Job Management System 2 連携ガイド（3020-3-K27）

JP1関連

JP1 Version 10 JP1/Cm2/SNMP System Observer（3021-3-250）

JP1 Version 9 JP1/NETM/DM 運用ガイド1(Windows(R)用)（3020-3-S81）

JP1 Version 7i JP1/Performance Management/SNMP System Observer（3020-3-F69）

JP1 Version 6 統合ネットワーク管理システム　サーバシステム管理（3000-3-749）

付録F.2　このマニュアルでの表記

このマニュアルでは，製品名称または総称を次に示す略称で表記しています。

このマニュアルでの表記 | 製品名称または総称
IPF | Itanium(R) Processor Family
JP1/AJS2※ | JP1/AJS2 - Agent | JP1/Automatic Job Management System 2 - Agent
JP1/AJS2 - Client Toolkit | JP1/Automatic Job Management System 2 - Client Toolkit
JP1/AJS2 - Manager | JP1/Automatic Job Management System 2 - Manager
JP1/AJS2 - View | JP1/Automatic Job Management System 2 - View
JP1/AJS3※ | JP1/AJS3 - Agent | JP1/Automatic Job Management System 3 - Agent
JP1/AJS3 - Manager | JP1/Automatic Job Management System 3 - Manager
JP1/AJS3 - View | JP1/Automatic Job Management System 3 - View
JP1/Cm2/SSO | JP1/Cm2/SNMP System Observer
JP1/IM | JP1/Integrated Management - Manager
JP1/Integrated Management - View
JP1/NetBatch | JP1/Network Batch Queuing System
JP1/NETM/DM | JP1/NETM/DM Client | JP1/NETM/DM Client
JP1/NETM/DM Client - Base
JP1/NETM/DM Client - Delivery Feature
JP1/NETM/DM Client - Operation Log Feature
JP1/NETM/DM Client - Remote Control Feature
JP1/NETM/DM Manager

注※

JP1/AJS2，およびJP1/AJS3を合わせてJP1/AJSと表記することがあります。

付録F.3　オンラインヘルプについて

JP1/Scriptでは，オンラインヘルプを提供しています。

オンラインヘルプは，このマニュアルの内容のうち，JP1/Scriptの機能，操作手順，およびJP1/Scriptで使用できるコマンドを中心に説明しています。

付録F.4　図中で使用する記号

このマニュアルでは，図中で使用する記号を次のように定義しています。

付録F.5　このマニュアルで使用する記号

このマニュアルでは，次に示す記号を使用して，操作方法を説明しています。

記号 | 意味
［　　　］ | ウィンドウのボタン，またはメニューを示します。
［　A　］－［　B　］ | Aはメニューバーのメニューを示し，Bは，Aのメニューをクリックすると表示されるメニューを示します。

付録F.6　コマンドの文法で使用する記号

スクリプトに使用するステートメントまたはコマンド，およびコマンドライン形式の説明で使用する記号を次に示します。

記号
意味

〔　　　〕（きっ甲括弧）
この記号で囲まれている項目が省略できることを示します。
複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択します。
（例）
「〔A〕」は，「必要に応じてAを指定する」ことを示します（必要のない場合は，Aを省略できます）。
「〔B|C〕」は，「必要に応じてBまたはCを指定する」ことを示します（必要のない場合は，BおよびCを省略できます）。

…（点線）
この記号直前の項目を繰り返して指定できます。
（例）
「A B…」は，「AのあとにBを複数個指定できる」ことを示します。

｜（ストローク）
複数の項目に対し，項目間の区切りを示し，「または」の意味を示します。
（例）
「A｜B｜C」は，「A，BまたはC」を示します。

｛　　　｝（波括弧）
この記号で囲まれている複数の項目の中から，必ず一つを選択します。項目は|（ストローク）で区切ります。
（例）
「{A|B|C}」は，「A，B，またはCのどれか一つを指定する」ことを示します。

付録F.7　64ビット版のWindowsのレジストリキーの名称について

このマニュアルでは，レジストリキーの名称はすべて32ビット版のWindowsでの名称で表記しています。

64ビット版のWindowsの場合，「HKEY_LOCAL_MACHINE¥SOFTWARE¥Hitachi¥JP1/Script」は，「HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥Hitachi¥JP1/Script」に読み替えてください。

「HKEY_CURRENT_USER¥SOFTWARE¥HITACHI¥JP1/Script」は，読み替える必要はありません。

付録F.8　JIS 2004（JIS X 0213：2004）で追加された第3水準，第4水準漢字について

JP1/Scriptでは，JIS 2004で追加された第3水準漢字，第4水準漢字を使用できません。これらの文字を使用した場合，正常に動作しないおそれがあります。

付録F.9　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録G　用語解説

英字｜ア行｜カ行｜サ行｜タ行｜ハ行｜マ行｜ヤ行｜ラ行｜ワ行

英字

JP1/Automatic Job Management System 2（JP1/AJS2）

JP1関連製品の一つです。JP1/AJS2は，JP1 Version6での製品体系変更で，従来のJP1/AJSやJP1/NetBatchなどが統合されたプログラムです。JP1/Scriptは，JP1/AJS2と連携することで，複数のPC間での分散処理が実現できます。

JP1/Automatic Job Management System 3（JP1/AJS3）

JP1/AJS2の後継製品です。

JP1/Automatic Job Scheduler（JP1/AJS）

JP1関連製品の一つです。JP1/AJSは，PC上での複雑な業務運転の自動化・省力化を図るため，ジョブの自動運転を行うなどの機能を提供するプログラムです。JP1/Scriptは，JP1/AJSと連携することで，複数のPC間での分散処理が実現できます。

JP1/Base

JP1関連製品の一つです。JP1/Baseは，JP1 Version6での製品体系変更で，従来のJP1/IMのイベントサービスが移行されたプログラムです。JP1/Scriptは，コマンドの実行結果などをJP1/Baseにイベント発行することができます。製品中に「JP1/IM」と表記している場合，JP1/Baseのことも指しています。

JP1/Integrated Manager（JP1/IM）

JP1関連製品の一つです。JP1/IMは，分散システムの統合管理を行うためのプログラムです。JP1/Scriptは，コマンドの実行結果などをJP1/IMのイベントコンソールへ表示できます。

JP1/IMのイベントサービスは，JP1 Version6での製品体系変更で，JP1/Baseへ移行されました。製品中に「JP1/IM」と表記している場合，JP1/Baseのことも指しています。

JP1/Network Batch Queuing System（JP1/NetBatch）

JP1関連製品の一つです。JP1/NetBatchは，PC上でバッチジョブを効率良く運用するためのフログラムです。JP1/Scriptは，JP1/NetBatchと連携することで，複数のPC間での分散処理が実現できます。

JP1/Scriptサービス

JP1/Scriptを構成しているプログラムの一つです。自動起動情報に登録されたスクリプトファイルのサービス空間での起動および終了の制御や，NetExecコマンドのサービス空間での要求を制御します。

Scriptランチャ

JP1/Scriptを構成しているプログラムの一つです。あらかじめ設定されている自動起動の情報に従って，スクリプトファイルの起動および終了を制御します。

Scriptランチャサービス

JP1/Scriptを構成しているプログラムの一つです。NetExecコマンドのログオン空間での要求を制御します。

ア行

位置変数

コマンドラインからスクリプトを起動するときに指定するスクリプトファイル名，およびパラメタを格納する変数です。この位置変数は，「%0， %1， %2， %n， （nには数字が入る）…」のように"%"と正の整数で構成され，コマンドラインに指定したスクリプトファイル名，およびパラメタが，%0から順番に格納されます。

コマンドラインに「C:¥TEST.SPT　ABC　123」と指定した場合，位置変数%0，%1，%2には次の値が代入されます。

%0=C:¥TEST.SPT

%1=ABC

%2=123

このように位置変数を利用すると，スクリプトの起動時に変数の値を設定することができます。

インデックス番号

配列変数の要素（二次元配列の場合は，行要素および列要素）を表すための1から始まる数値のことです。

エディタ

JP1/Script付属のエディタです。簡易入力機能と連携できるので，効率良くスクリプトを作成できます。また，スクリプトの動作を見ながら実行できるモニタリング機能を使えば，デバッグ時の負荷も軽減できます。

カ行

解析トレースファイル

スクリプトの構文解析結果が保存されているファイルです。

簡易入力

JP1/Scriptを構成しているプログラムの一つです。コマンドを対話形式で入力でき，入力したコマンドはエディタ，またはクリップボードに出力できます。

キュー

実行するジョブを登録するところです。ジョブをキューに投入すると，一時的にキューに登録されます。キューに登録されたジョブは，キューから順次取り出されて実行されます。

組み込み定数

JP1/Scriptであらかじめ定義されている値です。コマンドの引数に指定できます。

グローバル変数ファイル

スクリプトの実行時に設定されたグローバル変数が保存されているファイルです。

コントロール

メニューフォーム上に配置するボタンやリストボックスなどの総称です。

サ行

サーバ環境ファイル

サーバ環境が設定されているファイルです。

サーバトレースファイル

クライアントにあるスクリプト文のコマンドから呼び出されたサーバのコマンド実行結果が保存されているファイルです。

サービス空間

JP1/Scriptサービスから起動するスクリプトプロセスのセッションです。JP1/Scriptサービスから起動することによって，ユーザのログオンやログオフに関係なく実行できます。ただし，GUIなどでの対話操作はできません。GUIなどでの対話操作が必要な場合は，ログオン空間で実行してください。また，JP1/AJSから起動する場合も，サービス空間での実行となります。

サービス情報

サービス操作に必要な情報を定義したオブジェクトのことです。

JP1/Scriptのサービス操作コマンドを利用する場合，あらかじめServiceSetValueコマンドを使って，必要な情報をサービス情報に設定しておきます。

サブルーチン

「プロシージャ」と同意語です。

実行環境ファイル

スクリプトファイルを実行するときの環境設定が保存されているファイルです。

実行環境ファイルコンバータ

Windows上のJP1/Scriptの実行環境ファイルをUNIX上のJP1/Scriptへ移行するためのツールです。

実行トレースファイル

スクリプトの実行結果が保存されているファイルです。

自動起動情報ファイル

Scriptランチャがスクリプトの実行を自動的に行えるようにするための，必要な情報が保存されているファイルです。

スクリプト（スクリプト文）

用意されたコマンドを使用して，命令文などを記述したものを指しています。

スクリプトエンジン

JP1/Scriptを構成しているプログラムの一つです。スクリプトエンジンによって，作成したスクリプトファイルのコマンドの文法チェック（字句解析および構文解析）が行われます。

スクリプト実行

JP1/Scriptを構成しているプログラムの一つです。スクリプトファイルの実行を行います。また，JP1/Scriptの各コマンドに対する処理も行います。

スクリプトファイル

作成したスクリプトを保存したファイルです。

スクリプトレベル

プロシージャ外に記述されているステートメントです。プロシージャレベルに対して，プロシージャの外に記述されているステートメントは，"スクリプトレベル"のステートメントとして参照されます。

タ行

トレース管理ファイル

トレースファイルを管理するファイルです。

トレースビューア

JP1/Scriptを構成しているプログラムの一つです。トレースビューアを起動すると，スクリプトファイルの実行時に出力されるトレース情報，スクリプトファイルの実行状態を見ることができます。

ハ行

バッチジョブ

バッチ処理で実現するジョブのことをいいます。

バッチ処理

ジョブを一括して実行する処理のことです。対話操作を必要としない業務や，多量のデータを処理する業務に適しています。

フィールド名

各コントロールに対して設定する名称です。作成されたメニューフォーム上には表示されず，メニュー情報ファイルに記述されます。

プライマリセッション

コンピュータに接続されている実際の物理的なコンソールから利用している場合のセッションのことです。

プログラムグループ

Windowsの［スタート］メニューに表示するプログラムのショートカットを登録するフォルダです。ユーザ個別と全ユーザ共通のフォルダがあります。

プロシージャ

実行時に一つの単位として処理されるコマンドの集まりのことをいいます。JP1/Scriptでは，FunctionステートメントとSubステートメントで定義された一連の処理がこれに当たります。

「サブルーチン」と同意語です。

プロシージャ レベル

FunctionプロシージャやSubプロシージャ内に記述されているステートメントです。

宣言を先に記述し，そのあとに代入ステートメントなど，実際の操作を行うコードを記述します。

プロセスビューア

JP1/Scriptを構成しているプログラムの一つです。現在実行されているスクリプトプロセスを一覧表示し，プロセスの監視や制御ができます。他のコンピュータで実行されているスクリプトプロセスも一覧表示できます。

編集モード

エディタの状態の一つで，スクリプトファイルを作成している状態のことを指します。

エディタ起動時には編集モードが設定されています。［モニタリング］－［モニタリングの実行］コマンドを選択するとモニタリングモードになり，［モニタリング］－［モニタリングの中止］コマンドを選択すると編集モードに戻ります。

マ行

マネージャ

JP1/Scriptを構成しているプログラムの一つです。スクリプトファイルの作成，編集，および動作環境の設定などの操作をします。

メニューエディタ

JP1/Scriptを使用して作成したスクリプトファイルのメニューフォームを作成したり編集したりする場合に，メニューエディタを利用します。また，メニューエディタには，コントロールのプロパティの設定，およびメニューフォームのテスト表示機能もあります。

メニュー情報ファイル

メニューフォームを構成するフォーム，および各コントロールのプロパティ定義が記述されたファイルです。メニューエディタでメニューフォームを編集すると，メニュー情報ファイルは自動的に作成され，テキスト形式で記述されます。

メニューフォーム

一般に「ウィンドウ」と呼ばれているGUIと同じ働きをします。メニューエディタを利用して，目的に応じた画面が作成できます。メニューフォームの上にはボタンやリストボックスなどを配置できます。

モニタリング情報ファイル

モニタリングで必要な情報を格納したファイルです。

モニタリングモード

エディタの状態の一つで，作成したスクリプトファイルをモニタリング実行している状態を指します。

エディタ起動時には編集モードが設定されています。［モニタリング］－［モニタリングの実行］コマンドを選択するとモニタリングモードになり，［モニタリング］－［モニタリングの中止］コマンドを選択すると編集モードに戻ります。

ヤ行

ユーザトレースファイル（トレースファイル）

スクリプトのコマンドによって出力されたトレースを保存するファイルです。

予約語ルールファイル

スクリプトファイルを解析・実行するために必要となる予約語に関する規則を格納したファイルです。

ラ行

ラージファイル

容量が2,147,483,648バイト以上のファイルです。

ログオン空間

ユーザがログオンしている時に，Script ランチャまたはScriptマネージャやエクスプローラなどのユーザ操作で起動するスクリプトプロセスのセッションです。GUIなどでの対話操作ができます。

スクリプト実行時にユーザがログオフすると実行が終了します。ユーザのログオンやログオフに関係なく実行したい場合は，サービス空間で実行してください。

ワ行

ワークファイル

JP1/Script内部で利用するワークファイルです。

ワイルドカード

ワイルドカードは* と ? で記述します。* は任意の文字列を，? は任意の1文字を表します。

（例）フォルダ"_TEMP_"の下のファイル"ABCDE.TXT"が該当する記述の例

_TEMP_+"*"

_TEMP_+"*.*"

_TEMP_+"ABC*"

_TEMP_+"*.TXT"

_TEMP_+"*E*"

索引

[記号]
[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ][Ｙ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行][ワ行]

(記号)

.LOG

.SPA

.SPB

.SPD

.SPG

.SPH

.SPN

.SPR

.SPS

.SPT

.SPU

.SPV

.SPX

.SPY

.TMP

.TXT

^=演算子（べき乗）

^演算子（べき乗）

_ALLRIGHT_

_ARGV_

_ARGV_CNT_

_BIN_

_COMP_

_COPY_CNT_

_COPY_RTN_

_COPY_SKIP_CNT_

_COPY_SKIP2_CNT_

_DLL_RTN_

_DOMAIN_

_ERR_ACCESS_

_ERR_EOF_

_ERR_EXCLUSIVE_

_ERR_FILE_

_ERR_FILE_POSITION_

_ERR_FILE_SIZE_

_ERR_NOT_LARGE_FILE_

_ERR_PATH_

_ERR_PROTECT_

_ERR_READY_

_ERR_SERVICE_NOT_BEGIN_〔意味〕

_ERR_SERVICE_NOT_BEGIN_〔設定契機〕

_ERR_SVR_CONNECT_

_ERR_SVR_NODATA_

_ERR_SVR_RECEIVEDATA_

_ERR_SVR_TIMEOUT_

_ERR_TIMEOUT_

_EXEC_ID_

_EXEC_RTN_

_FORM_FIELD_NAME_

_FORM_MODIFY_KEY_

_FORM_TERM_CMDNO_

_FORM_TERM_KEY_

_JOB_RTN_

_MSG_RTN_

_NL_

_NO_ERR_

_OS_

_OS_PLATFORM_

_OS_REVISION_

_OS_VERSION_

_PROC_ID_

_RTN_

_RTNxx_

_SCF_

_SCF_EXT_

_SCF_FIL_

_SDF_EXT_

_SNF_EXT_

_SVC_RTN_

_SVF_EXT_

_SYS_

_TAB_

_TEMP_

_USER_

_WIN_

_WINSYS_

/=演算子（除算）

/NOEVLOG（または/noevlog）

/SPALV（n）（または/spalv（n））

/SPXLV（n）（または/spxlv（n））

/演算子（除算）

' 〔コメントを記述する〕

+=演算子（加算）

+演算子（加算）

-=演算子（減算）

-演算子（減算・マイナス符号）

=

¥=演算子（整数除算）

¥演算子（整数除算）

*=演算子（乗算）

*演算子（乗算）

(数字)

1行の最大文字数やインデントの桁数を指定する

(英字)

(Ａ)

AddStr

Alert

AlreadyRun

And（論理積）

(Ｂ)

Beep

BitmapHide

BitmapShow

(Ｃ)

CalcDate

CalcTime

Call

CallDll

CallSpt

CancelStartUp

CatFiles

CheckDirName

CheckDriveType

CompDate

CompTime

Continue

Copy

(Ｄ)

Date

Day

DeleteDir

DeleteFile

DeleteGroup

DeleteGV

DeleteGVメソッド

DeleteShortcut

Dim

Dim（配列）

DLLファイルを呼び出す

Do...Loop

(Ｅ)

EnableErrorMessageプロパティ

EntryStartUp

Error

ExAbortError

Exec

Exec，NetExec，およびCallSptコマンドの違い

EXECIDプロパティ

EXECRTNプロパティ

ExecコマンドやNetExecコマンドからパラメタを指定してスクリプトファイルを呼び出す場合

Execメソッド

Exit

ExitWindows

Exit xx

(Ｆ)

For...End For

For...Next

Format

Function

(Ｇ)

GetArrayCount

GetDateCount

GetDiskFreeSpace

GetEnvironmentまたはGetEnv

GetErrorMessage

GetExecStatus

GetFileAttr

GetFileAttribute

GetFileSize

GetFileTime

GetGV

GetGVメソッド

GetPath

GetProcessCount

GetProcessInfo

GetServiceName

GetTextPosition

GetTimeCount

GetVerInfo

GetVersionInfo

GetVolLabel

GetVolumeLabel

GoTo

GrammarError

(Ｈ)

Hour

(Ｉ)

If...Then...Else

IMEventMessage

InArray

IniRead

IniWrite

InputBox

InStr

IPアドレス〔変更〕

IsDef

IsDefine

IsEmpty

IsEmptyDir

IsEmptyGroup

IsEmptyReg

IsExistDir

IsExistFile

IsExistRegKey

IsExistService

IsFileAttr

IsFileAttribute

IsLeapYear

IsLower

IsMultiChar

IsNew

IsNumeric

IsSingleChar

IsUpper

IsWriteableDir

(Ｊ)

JOBCancel

JOBHold

JOBSubmit

JOBWait

JP1/AJSからのJP1/Scriptの強制終了方法

JP1/AJSと連携したシステム構成

JP1/Baseと連携したシステム構成

JP1/IMと連携したシステム構成

JP1/IMまたはJP1/Baseにイベントを発行する

JP1/Scriptが設定するエラーコード

JP1/Scriptサービス

JP1/Scriptサービスの登録

JP1/Scriptで扱うファイル

JP1/Scriptで扱うファイルのバックアップとリカバリー

JP1/Scriptのアップグレードインストール

JP1/Scriptのアンインストール

JP1/Scriptのイベントログ

JP1/Scriptのインストール

JP1/Scriptのインストール／アンインストール

JP1/Scriptの概要

JP1/Scriptの規則

JP1/Scriptの起動と終了

JP1/Scriptの再インストール

JP1/Scriptのシステム構成

JP1/Scriptの終了コード

JP1/Scriptの全体構成

JP1/Scriptの操作

JP1/Scriptの操作の流れ

JP1/Scriptの対象バージョンを指定する

JP1/Scriptの特長

JP1/Scriptを起動する

JP1/Scriptを構成するプログラムの種類

JP1/Scriptを終了する

JP1/Scriptを利用するための準備

JP1呼び出しコマンド

(Ｌ)

LCase

Left

Len

LTrim

(Ｍ)

MakeDir

MakeGroup

MakePath

MakeShortcut

Menu

Message

MessageBox

MessageEventLog

Mid

Minute

Mod=演算子（剰余演算）

Mod演算子（剰余演算）

Month

(Ｎ)

NetExec

NetExecエラーログファイル

NetExecエラーログファイルの出力形式

NetExecコマンド実行制御

NetExecコマンド制限ポリシーファイル

Not（論理否定）

(Ｏ)

On Error

Or（論理和）

OSのエラーコード

(Ｒ)

RegDelete

RegDeleteKey

RegRead

RegWrite

Rem

Rename

ResetRetryMode

ResetStandardFile

ResetStdFile

ResetTrialOpenMode

Right

RTNプロパティ

RTrim

(Ｓ)

Scriptエディタウィンドウ

Scriptエディタウィンドウでのマウスとキーの操作

Scriptエディタウィンドウとメニュー

Scriptエディタウィンドウのダイアログ

Scriptエディタウィンドウのメニュー

Scriptトレースのファイル出力形式

Scriptトレースビューアウィンドウ

Scriptトレースビューアウィンドウでの操作

Scriptトレースビューアウィンドウでのマウスとキーの操作

Scriptトレースビューアウィンドウとメニュー

Scriptトレースビューアウィンドウのダイアログ

Scriptトレースビューアウィンドウのメニュー

Scriptトレース表示ウィンドウ

Scriptトレース表示ウィンドウでのマウスとキーの操作

Scriptトレース表示ウィンドウのメニュー

Scriptマネージャウィンドウ

Scriptマネージャウィンドウでのマウスとキーの操作

Scriptマネージャウィンドウとメニュー

Scriptマネージャウィンドウのダイアログ

Scriptマネージャウィンドウのメニュー

Scriptメニューエディタウィンドウ

Scriptメニューエディタウィンドウでのマウスとキーの操作

Scriptメニューエディタウィンドウとメニュー

Scriptメニューエディタウィンドウのダイアログ

Scriptメニューエディタウィンドウのメニュー

Scriptランチャ

Scriptランチャサービス

Second

Select Case

SeparateStr

SeparateStrCount

ServiceChange

ServiceContinue

ServiceControl

ServiceCreate

ServiceDelete

ServiceGetValue

ServicePause

ServiceQuery

ServiceRefer

ServiceSetValue

ServiceStart

ServiceStop

SetEnvironmentまたはSetEnv

SetFileAttr

SetFileAttribute

SetFileTime

SetGV

SetGVメソッド

SetPath

SetRetryMode

SetStandardFile

SetStdFile

SetTrialOpenMode

SetVolLabel

SetVolumeLabel

Sleep

Space

SplitFile

SplitPath

SPTHClose

SPTHGetErrorMessage

SPTHOpen

SPTHTerminate

SPTOコントロール

Str

Sub

(Ｔ)

TempDir

TempFile

Terminate

TerminateProcess

TextClose

TextFileReplace

TextOpen

TextRead

TextSeek

TextWrite

Time

TimeOut

Trim

(Ｕ)

UCase

(Ｗ)

WaitForExec

Weekday

While...End

(Ｙ)

Year

(ア行)

(あ)

値の更新ダイアログ

値を書式化した文字列を返す

値を文字列で返す

新しいメニューフォームを作成する

(い)

一時停止のサービスを再開する

一時ファイル名を作成する

一時フォルダを取得する

一括変更ダイアログ

イベントビューアにメッセージを出力する

イベントログ

(う)

ウォッチウィンドウ

ウォッチへ変数を追加する

うるう年かどうかを調べる

(え)

エディタ

エディタの関連付けダイアログ

エディタの起動と終了

エディタの起動方法

エディタの終了方法

エディタの操作

エディタの動作環境を設定する

エディットコントロールプロパティ（一般）ダイアログ

エディットコントロールプロパティ（キー）ダイアログ

エディットコントロールプロパティ（共通）ダイアログ

エディットコントロールプロパティ（スタイル）ダイアログ

エラーウィンドウ

エラーの有無を返す

エラーメッセージを取得する〔GetErrorMessage〕

エラーメッセージを取得する〔SPTHGetErrorMessage〕

演算規則

演算処理コマンド

演算の優先順位

(お)

オプション（JP1/IM）ダイアログ

オプション（色）ダイアログ

オプション（クラスタ環境）ダイアログ

オプション（互換性）ダイアログ〔Scriptエディタウィンドウ〕

オプション（互換性）ダイアログ〔Scriptマネージャウィンドウ〕

オプション（サーバ情報）ダイアログ

オプション（書式）ダイアログ

オプション（トレース）ダイアログ

オプション（複数起動）ダイアログ

(カ行)

(か)

解析トレースファイル〔ファイルの種類〕

解析トレースファイル〔ログ情報の種類〕

解析トレースファイルの出力形式

外部プログラム呼び出しコマンド〔基本コマンド〕

外部プログラム呼び出しコマンド〔特殊コマンド〕

稼働監視プログラムでのJP1/Scriptの監視

簡易入力

簡易入力機能を使う

簡易入力機能を使ってスクリプトを作成する

簡易入力の操作

簡易入力の操作項目

環境変数を取得する

環境変数を設定する

(き)

キー操作〔Scriptエディタウィンドウ〕

キー操作〔Scriptトレースビューアウィンドウ〕

キー操作〔Scriptトレース表示ウィンドウ〕

キー操作〔Scriptマネージャウィンドウ〕

キー操作〔Scriptメニューエディタウィンドウ〕

基本コマンド

基本コマンド一覧

キューサーバにスクリプトを登録する

(く)

クライアントからサーバ上のJP1/AJS2のキューへのジョブの登録

クラスタ環境でJP1/Scriptを使用する場合のシステム構成

クラスタシステム環境での環境設定

クリアの確認ダイアログ

グリッドの設定ダイアログ

グローバル変数ファイル

グローバル変数を削除する〔DeleteGV〕

グローバル変数を削除する〔DeleteGVメソッド〕

グローバル変数を取得する〔GetGV〕

グローバル変数を取得する〔GetGVメソッド〕

グローバル変数を設定する〔SetGV〕

グローバル変数を設定する〔SetGVメソッド〕

(け)

現在の時刻を返す

現在の日付を返す

検索ダイアログ〔Scriptエディタウィンドウ〕

検索ダイアログ〔Scriptトレースビューアウィンドウ〕

(こ)

更新情報ダイアログ

コーディング規則

コマンド実行時のトラブルと対処方法

コマンドのプロパティを設定する

コマンドプロパティダイアログ

コマンドプロパティの設定ダイアログ

コマンドやステートメントを入力する

コマンドラインに関する規則

コマンドラインの記述規則

コマンドラインの形式

コマンドラインの設定ダイアログ

コマンドラインのパラメタの説明

コマンドラインパラメタの設定ダイアログ

コメント行を設定・解除する

コントロールの大きさをそろえる

コントロールの属性を一括して変更する

コントロールを一列に並べる

コントロールを均等な間隔で並べる

コントロールをテキストの大きさに合わせる

コントロールをメニューフォームの中央に並べる

コンバータが扱うファイル

コンピュータの選択ダイアログ

コンボボックスプロパティ（一般）ダイアログ

コンボボックスプロパティ（キー）ダイアログ

コンボボックスプロパティ（共通）ダイアログ

コンボボックスプロパティ（スタイル）ダイアログ

(サ行)

(さ)

サーバ環境ファイル

サーバトレースファイル〔ファイルの種類〕

サーバトレースファイル〔ログ情報の種類〕

サーバトレースファイルの出力形式

サービスが存在するかどうかを調べる

サービス情報を設定する

サービス操作コマンド

サービスに制御コマンドを送る

サービスの現在の状態を取得する

サービスの情報を取得する

サービスの設定情報を取得する

サービスの設定情報を変更する

サービス表示名からサービス名を取得する

サービスを一時停止する

サービスを開始する

サービスを削除する

サービスを停止する

サービスを登録する

削除の確認ダイアログ

サンプルファイル

(し)

自PC／他PC上の実行ファイルを呼び出す

自PC上の実行ファイルを呼び出す

式の論理否定を求める

試行オープン機能

試行オープン機能を解除する

試行オープン機能を設定する

システムの日時変更手順

実行環境（打ち切り時間）の設定ダイアログ

実行環境（起動日時）の設定ダイアログ

実行環境（コマンドライン）の設定ダイアログ

実行環境（作業フォルダ）の設定ダイアログ

実行環境（トレース出力先フォルダ）の設定ダイアログ

実行環境（ユーザトレース情報）の設定ダイアログ

実行環境構文ファイル

実行環境構文ファイル（.SPU）の概要

実行環境構文ファイル（.SPU）の詳細

実行環境の設定（起動情報）ダイアログ

実行環境の設定（終了情報）ダイアログ

実行環境の設定（トレース情報）ダイアログ

実行環境ファイル

実行環境ファイルコンバータ

実行環境ファイルコンバータの概要

実行環境ファイルコンバータの実行方法

実行環境ファイルコンバータの操作

実行環境ファイルの変換手順

実行しているスクリプトファイルの強制終了方法

実行ダイアログ

実行中のスクリプトプロセスを一覧表示する

実行トレースファイル〔ファイルの種類〕

実行トレースファイル〔ログ情報の種類〕

実行トレースファイルの出力形式

実行ファイルの識別子を返す

実行ファイルの実行状態を取得する

実行ファイルの終了コードを返す

実行ファイルの終了待ち／強制終了を行う

実行ファイルを呼び出す

実行フォルダのパスを取得する

実行フォルダのパスを設定する

指定された時刻に加算減算を行う

指定された時刻の時を返す

指定された時刻の秒を返す

指定された時刻の分を返す

指定された日付に加算減算を行う

指定された日付の月を返す

指定された日付の年を返す

指定された日付の日を返す

指定された日付の曜日を返す

指定した文字数分の文字列を返す

指定した連結文字で文字列連結を行う

自動起動情報ファイル

自動起動処理コマンド

自動起動の設定ダイアログ

自動起動の方法

使用するエディタを決める

ショートカットが存在するかどうか調べる

ショートカット操作コマンド

ショートカットを削除する

ショートカットを作成する

初期化ファイルから値を読み込む

初期化ファイルに値を登録する

ジョブの自動運転・実行管理

ジョブの終了を待つ

ジョブをキャンセルする

ジョブを保留／解除する

新規作成ダイアログ

(す)

数字の記述規則

数値として評価できるかを調べる

スクリプトOLEコントロール

スクリプトOLEコントロールとは

スクリプト実行時のトラブルと対処方法

スクリプト実行制御

スクリプト実行を強制終了する

スクリプト制御インタフェース

スクリプト制御インタフェース一覧

スクリプト制御インタフェースとは

スクリプト制御インタフェースの記述例

スクリプト制御マネージャをオープンする

スクリプト制御マネージャをクローズする

スクリプトに関する規則

スクリプトの実行環境（各項目）を設定する

スクリプトの実行環境（すべての項目）を設定する

スクリプトの実行環境を設定する

スクリプトの実行を中断する

スクリプトの自動起動を設定する

スクリプトの名前を変更する

スクリプトの文法をチェックする

スクリプトファイル

スクリプトファイルの［実行環境の設定］ダイアログボックスでコマンドラインを指定する場合

スクリプトファイルの自動起動の登録を解除する

スクリプトファイルの文法をチェックする

スクリプトファイルを自動起動に登録する

スクリプトプロセスの表示更新間隔を指定する

スクリプトを削除する

スクリプトを作成・保存する

スクリプトを実行する〔エディタの操作〕

スクリプトを実行する〔マネージャの操作〕

スクリプトを終了しWindowsをログオフ／パワーオフ／リブートする

スクリプトを終了する

スクリプトを追加する

スクリプトを複写する

スクリプトを編集する

スタティックプロパティ（一般）ダイアログ

スタティックプロパティ（共通）ダイアログ

スタティックプロパティ（スタイル）ダイアログ

スタティックプロパティ（背景）ダイアログ

ステートメント

ステートメント一覧

スピーカからビープ音を鳴らす

(せ)

設定ダイアログ

全角文字かどうかを調べる

選択したコントロールを前面に移動する

選択したコントロールを背面に移動する

先頭および末尾のスペースを削除した文字列を返す

先頭のスペースを削除した文字列を返す

(そ)

その他のコマンド〔基本コマンド〕

その他のコマンド〔特殊コマンド〕

その他のファイル

(タ行)

(た)

ターミナルサービス環境でJP1/Scriptを使用する場合のシステム構成

ターミナルサービス環境での環境設定

ダイアログの説明

ダイアログボックスにメッセージを表示する

対処の手順

ダウングレード

他のコンピュータとの通信時のアカウント

タブオーダの設定ダイアログ

タブの移動順序を設定する

(ち)

チェック処理コマンド〔基本コマンド〕

チェック処理コマンド〔特殊コマンド〕

直線プロパティ（一般）ダイアログ

(て)

定数

ディスク空き容量を取得する

テキストファイルから1行分のデータを読み込む

テキストファイルにデータを書き込む

テキストファイルの文字列を置き換える

テキストファイルをオープンする

テキストファイルをクローズする

(と)

動作環境情報のバックアップとリカバリー

特殊コマンド

ドライブの種類を調べる

トラブルシューティング

トラブル発生時に採取が必要な資料

トラブルへの対処方法

トレース管理ファイル

トレースビューア

トレースビューア実行時のトラブルと対処方法

トレースビューアの起動と終了

トレースビューアの起動方法

トレースビューアの終了方法

トレースビューアの操作

トレースビューアを起動する

トレースビューアを終了する

トレースファイルの内容を検索する

トレースファイルの内容を表示する

トレースファイルの表示・非表示を切り替える

トレースファイルの表示ウィンドウとメニュー

トレースファイルの表示操作

トレースファイルを印刷する

トレースファイルをクリアする

トレースファイルを削除する

トレースファイルを別名で保存する

(ナ行)

(な)

名前の変更ダイアログ

(ハ行)

(は)

バージョン情報／ファイル日付の新旧を比較する

排他エラーリトライ機能

排他エラーリトライ機能を解除する

排他エラーリトライ機能を設定する

配列変数

配列変数の記述規則

配列変数のデータ構造例

配列変数の要素から文字列を検索し，インデックス番号を返す

配列変数の要素数を取得する

配列変数を宣言しメモリ領域を割り当てる

バックアップ対象ファイル

バックアップとリカバリー

パラメタ

半角アルファベットの大文字かどうかを調べる

半角アルファベットの大文字を小文字に変換する

半角アルファベットの小文字かどうかを調べる

半角アルファベットの小文字を大文字に変換する

半角スペースからなる文字列を返す

半角文字かどうかを調べる

(ひ)

比較演算子（=，<>，<，<=，>，>=）

左端から指定した文字数分の文字列を返す

日付操作コマンド

ビットマップを消去する

ビットマップを表示する

描画・表示処理コマンド

標準入力・出力・エラーファイルを解除する

標準入力・出力・エラーファイルを設定する

(ふ)

ファイル・フォルダ操作コマンド

ファイル／ウィンドウにテキストを出力する

ファイルが存在するかどうかを調べる

ファイル参照ボタンプロパティ（一般）ダイアログ

ファイル参照ボタンプロパティ（キー）ダイアログ

ファイル参照ボタンプロパティ（共通）ダイアログ

ファイル参照ボタンプロパティ（スタイル）ダイアログ

ファイル参照ボタンプロパティ（背景）ダイアログ

ファイルの上書き確認ダイアログ

ファイルの削除の確認ダイアログ

ファイルの種類

ファイルの追加ダイアログ

ファイルのバージョン情報を取得する

ファイルの日付と時刻を取得する

ファイルの日付と時刻を設定する

ファイルの複写ダイアログ

ファイルのプロパティダイアログ

ファイルの容量

ファイルの容量を取得する

ファイルバージョンの指定ダイアログ

ファイル名の指定ダイアログ

ファイル名を変更する

ファイルをコピーする

ファイルを削除する

ファイルを統合する

ファイルを分割する

ファンクションキープロパティ（一般）ダイアログ

ファンクションキープロパティ（共通）ダイアログ

ファンクションキープロパティ（スタイル）ダイアログ

フォルダ／ファイルの属性を取得する

フォルダ／ファイルの属性を調べる

フォルダ／ファイルの属性を設定する

フォルダが書き込み可能かどうかを調べる

フォルダが存在するかどうかを調べる

フォルダの選択ダイアログ

フォルダの中身が空かどうかを調べる

フォルダの変更ダイアログ

フォルダ名の末尾が（¥）かどうかを調べる

フォルダを削除する

フォルダを作成する

複数パラメタ指定でSPTファイルを呼び出す

二つの式の論理積を求める

二つの式の論理和を求める

二つの式の和を求める

二つの式を比較する

二つの時刻の経過時間を取得する

二つの時刻を比較する

二つの数値の差を求める

二つの数値の剰余を求める

二つの数値の商を求める ,[2]

二つの数値の積を求める

二つの数値のべき乗を求める

二つの日付の経過日数を取得する

二つの日付を比較する

フルパスを解析する

フルパスを作成する

プログラムグループを削除する

プログラムグループを作成する

プログラム内にコメントを記述する

プログラムのインストール先のフォルダ

プロセス監視コマンド

プロセスの起動数を取得する

プロセスの情報を取得する

プロセスビューア

プロセスビューア実行時のトラブルと対処方法

プロセスビューアの操作

プロセスビューアの操作項目

プロセスを強制終了する

(へ)

変数がEmpty値かどうかを調べる

変数が定義されているかどうかを調べる

変数操作コマンド

変数と式の差を変数に代入する

変数と式の剰余を変数に代入する

変数と式の商を変数に代入する ,[2]

変数と式の積を変数に代入する

変数と式のべき乗を変数に代入する

変数と式の文字列連結を行う

変数と式の和を変数に代入する

変数の追加ダイアログ

変数の名前付け規則

変数名として扱えないキーワード

変数を宣言しメモリ領域を割り当てる

(ほ)

保守ログファイル

ホスト名〔変更〕

ボタンプロパティ（一般）ダイアログ

ボタンプロパティ（キー）ダイアログ

ボタンプロパティ（共通）ダイアログ

ボタンプロパティ（スタイル）ダイアログ

ボタンプロパティ（背景）ダイアログ

ボリュームラベルを取得する

ボリュームラベルを設定する

(マ行)

(ま)

マウス操作〔Scriptエディタウィンドウ〕

マウス操作〔Scriptトレースビューアウィンドウ〕

マウス操作〔Scriptトレース表示ウィンドウ〕

マウス操作〔Scriptマネージャウィンドウ〕

マウス操作〔Scriptメニューエディタウィンドウ〕

末尾のスペースを削除した文字列を返す

マネージャ

マネージャの起動方法

マネージャの終了方法

マネージャの操作

(み)

右端から指定した文字数分の文字列を返す

(め)

メソッドのエラー詳細コードを返す

メッセージ出力コマンド

メッセージとテキストボックスを表示する

メニューエディタ

メニューエディタの起動方法

メニューエディタの終了方法

メニューエディタの操作

メニュー情報ファイル

メニューフォーム

メニューフォーム上にグリッドを表示する

メニューフォームの印刷情報ダイアログ

メニューフォームの内容を印刷する

メニューフォームプロパティ（一般）ダイアログ

メニューフォームプロパティ（キー）ダイアログ

メニューフォームプロパティ（スタイル）ダイアログ

メニューフォームプロパティ（背景）ダイアログ

メニューフォームプロパティ（壁紙）ダイアログ

メニューフォーム名の指定ダイアログ

メニューフォームをコピーする

メニューフォームを削除する

メニューフォームを作成する〔エディタの操作〕

メニューフォームを作成する〔マネージャの操作〕

メニューフォームをテスト表示する

メニューフォームを貼り付ける

メニュー呼び出しコマンド

(も)

文字列操作コマンド

文字列の記述規則

文字列の文字数を返す

文字列分割を行い，分割文字列の数を返す

文字列分割を行い，分割文字列を返す

文字列連結（+）

文字列連結（&）

文字列連結（&=）

文字列を検索し文字位置を返す

文字列を検索する

文字列を置換する

モニタリング実行時の動作環境を設定する

モニタリング実行時のブレークポイントを設定・解除する

モニタリング情報ファイル

モニタリングを実行・中止する

(ヤ行)

(ゆ)

ユーザエラーを警告／解除する

ユーザ定義のメニューを表示する

ユーザトレースファイル

ユーザトレースファイル（トレースファイル）

ユーザトレースファイルの出力形式

ユーザプログラムなどから実行形式（SPTXE.EXE）でコマンドラインを指定してスクリプトファイルを実行する場合

(よ)

読み書き開始位置を先頭または末尾に移動する

読み書きの開始位置を返す

予約語ルールファイル

予約変数

(ラ行)

(ら)

ラージファイル

(り)

リストコントロールプロパティ（一般）ダイアログ

リストコントロールプロパティ（キー）ダイアログ

リストコントロールプロパティ（共通）ダイアログ

リストコントロールプロパティ（スタイル）ダイアログ

利用できる変数の個数と容量

(れ)

レジストリから値を読み込む

レジストリサブキーが存在するかどうかを調べる

レジストリサブキーの中身が空かどうかを調べる

レジストリに値を登録する

レジストリのサブキーを削除する

レジストリの値を削除する

(ろ)

ログ情報

ログ情報の種類

ログファイルおよびディレクトリ一覧

(ワ行)

(わ)

ワークファイル

■ 商標類

Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
MS-DOSは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual Basicは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Win32は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。