8. コマンドライン引数とオプション

8.1 クライアントソフトArcsCmd

グローバルオプションは、ArcsCmd直後から、アプリケーションのコマンド（application_command）の前に指定するオプションです。

ArcsCmd [options...] application_command application_command_args

-?, -h, -v, -arcs-data, -arcs-mkdirは、アプリケーションのコマンドの前に指定するグローバルオプションです。

オプションや引数	説明
-?や-h	ヘルプを表示します。
-v	バージョン情報とライセンスファイルの情報を表示します。
-arcs-data	変換に必要なデータをサーバーにインポートします。
-arcs-mkdir	変換に必要なディレクトリをサーバー上に作成します。
アプリケーションのコマンド	アプリケーションを実行するコマンド。AHFCmd, SBCCmd, DHCCmdなど。
アプリケーションの引数	アプリケーションに渡す引数。

-arcs-dataは、変換に必要なデータをサーバーにインポートするときに使います。何回でも指定できます。

次の例は、AHFCmdの変換元my.foの中に、image.pngを参照する指定があるという想定です。

クライアントマシンにあるファイルC:\my-images\image.pngをサーバー上の変換元ファイルと同じディレクトリにインポートするために使っています。

制限事項の「変換元ファイル内のディレクトリやファイルの指定」で述べたように、XSL-FOの修正が必要になる場合もあります。

ArcsCmd -arcs-data C:\my-images\image.png AHFCmd -d my.fo -o my.pdf

変換に必要なデータが多数あるときは、クライアントマシンの特定ディレクトリにそれらを集めて、１つの-arcs-dataオプションで、そのディレクトリを丸ごとインポートする方法もあります。

次の例は、AHFCmdの変換元my.foの中に、多数の画像を参照する指定があるという想定です。

画像をクライアントマシンのC:\my-images\many-imagesディレクトリに集めて、サーバにインポートするために使っています。

インポートすると、ARCSサーバーが管理しているディレクトリの下に、many-imagesディレクトリが作られ、その下に多数の画像ファイルが作られます。

XSL-FOでは、many-images\image1.png, many-images\image2.pngのように、many-imagesディレクトリを付けた相対パスで、画像ファイルにアクセスする必要があります。したがって、XSL-FOの修正が必要になる場合もあります。

ArcsCmd -arcs-data C:\my-images\many-images AHFCmd -d my.fo -o my.pdf

毎回、多数の画像ファイルなど、変換に必要なものをサーバーにインポートするのを省略したい場合、-arcs-dataを使わない方法もあります。

あらかじめ、ARCSとは関係なく、サーバー上に必要なものを配置しておきます。

XSL-FOでは、サーバー上の絶対パスを指定して、必要なものにアクセスします。

Formatter V7.5から、

<fo:external-graphic src="file:///C:/my-images/image.png"/>

のように、絶対パスを指定できるようになりました。

詳しくは、Formatter技術的資料のURI

を参照してください。

ただし、これは、セキュリティ上は好ましくないので、推奨はしません。組織（企業や団体）のセキュリティポリシーが、サーバー上のいろいろな場所にあるファイルにアクセスするのを許している場合にのみ、使える方法です。

-arcs-mkdirは、変換に必要なディレクトリをサーバー上に作ります。何回でも指定できます。

次の例は、OSDCの変換で、SVGの出力先ディレクトリが必要なので、使っています。

ArcsCmd -arcs-mkdir svg-image SBCCmd -d my.pdf -o my.svg -p @SVG -svgip 1

OSDC V10からは、OSDC自身にSVGのディレクトリを作る、-svgcicpオプションが追加されたので、-arcs-mkdirを使う必要はなくなりました。

ArcsCmd SBCCmd -d my.pdf -o my.svg -p @SVG -svgip 1 -svgicp svg-image

グローバルオプションは、ArcsDirMonitorCmdの直後から、startやstopの前に指定するオプションです。

ArcsDirMonitorCmd [global options...] start [options...] or stop [options...]

-?, -h, -vは、startやstopの前に指定するグローバルオプションです。

オプションや引数	説明
-?や-h	ヘルプを表示します。
-v	バージョン情報とライセンスファイルの情報を表示します。
start	ARCSディレクトリ監視ソフトを起動します。
stop	ARCSディレクトリ監視ソフトを終了します。

startとstopには、さらにオプションがあります。