<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFEXECUTE</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="説明">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFEXECUTE</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">説明</span>
<p>
サーバーコンピュータ上で ColdFusion 開発者が指定したすべての処理を実行します。 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">カテゴリ</span>
<p>
拡張タグ、フロー制御タグ 
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">シンタックス</span><pre>&lt;cfexecute
   name = &quot;application name&quot;
   arguments = &quot;command line arguments&quot;
   outputFile = &quot;output filename&quot;
   variable = &quot;variable name&quot;
   timeout = &quot;timeout interval&quot;&gt;
   ...
&lt;/cfexecute&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">関連項目</span>
<p>
cfcollection、cfindex、cfobject、cfreport、cfsearch、cfwddx
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">ヒストリ</span>
<p>
ColdFusion MX&#160;6.1: 
</p>
<ul>

<li>variable 属性が追加されました。</li>

<li>outputFile 属性のファイルパスの動作が変更されました。outputFile 属性に絶対ファイルパスを指定しなかった場合は、ColdFusion のテンポラリディレクトリを基準とした相対パスになります。</li>
</ul>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">使用方法</span>
<p>
cfexecute の開始タグと終了タグの間には、他の ColdFusion のタグや関数を指定しないでください。cfexecute タグはネストできません。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例外</span>
<p>
次の例外が発生します。
</p>
<ul>

<li>アプリケーション名が見つからない場合 : java.io.IOException </li>

<li>ColdFusion の実行スレッドを認可されたユーザーが、プロセスの実行権限を持っていない場合 : セキュリティ例外</li>
</ul>

<p>
タイムアウト値は、0 から、オペレーティングシステムでサポートされる最大タイムアウト値までの値でなければなりません。
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">例</span><pre>&lt;h3&gt;cfexecute&lt;/h3&gt;
&lt;p&gt;この例では、Windows NT バージョンの netstat ネットワーク監視プログラムを実行し、その出力をファイル
に格納します。

&lt;cfexecute name = &quot;C:WinNTSystem32netstat.exe&quot;
   arguments = &quot;-e&quot; 
   outputFile = &quot;C:Tempoutput.txt&quot;
   timeout = &quot;1&quot;&gt;
&lt;/cfexecute&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">必須</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>実行するアプリケーションの絶対パスです。</p>
<p>Windows では、C:myapp.exe のように拡張子を指定する必要があります。</p>

  </td>
  </tr>
  </table>
</div>
<div id="ARGUMENTS">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">ARGUMENTS</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>アプリケーションに渡されるコマンドライン変数です。文字列として指定された場合は、次のように処理されます。 </p><ul>

<li>Windows の場合 : プロセスコントロールサブシステムに渡されて、解析されます。</li>

<li>UNIX の場合 : 引数の配列に置き換えられます。デフォルトのトークンセパレータはスペースです。スペースが埋め込まれた引数を二重引用符 (&quot;) で区切ることもできます。</li>
</ul>

<p>配列として渡された場合は、次のように処理されます。</p><ul>

<li>Windows の場合 : 要素はトークンの文字列に連結され、スペースで区切られます。プロセスコントロールサブシステムに渡されて、解析されます。</li>

<li>UNIX の場合 : 要素は exec() 引数の配列にコピーされます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>
<div id="OUTPUTFILE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">OUTPUTFILE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>プログラム出力の送信先となるファイルです。outputFile 属性または variable 属性を指定しなかった場合は、出力は呼び出し元のページに表示されます。 </p>
<p>絶対パス (ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス) を指定しなかった場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスになります。</p>

  </td>
  </tr>
  </table>
</div>
<div id="VARIABLE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">VARIABLE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>プログラム出力を保管するための変数です。outputFile 属性または variable 属性を指定しなかった場合、出力は呼び出し元のページに表示されます。</p>

  </td>
  </tr>
  </table>
</div>
<div id="TIMEOUT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">TIMEOUT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">オプション</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "0"


<p>生成されたプログラムからの出力を ColdFusion が待機する時間を秒単位で指定します。</p><ul>

<li>0: 非ブロックモードに相当します。</li>

<li>非常に大きい値: ブロックモードに相当します。 </li>
</ul>

<p>値が 0 の場合、次の処理が行われます。</p><ul>

<li>処理が開始され、すぐに返されます。プログラムの出力が表示される前に、呼び出しページに制御権が返される場合があります。プログラムの出力を確実に表示するには、値を 2 以上に設定してください。</li>

<li>outputFile 属性を指定しない場合、プログラムの出力は破棄されます。</li>
</ul>


  </td>
  </tr>
  </table>
</div>

  </body>
</html>
