<runtime> Element (Windows Script Host)

 

Groups together the set of run-time arguments for a script.

Syntax

<runtime> 
    <named attributes etc. />
    <unnamed attributes etc. />
    <example>Example Text</example>
    </runtime>

Remarks

The ShowUsage method uses the information enclosed by the <runtime> element to display the runtime parameters for a script.

Since the <runtime> element is enclosed within a set of job tags, the defined run-time arguments apply to that job only.

Note

With version 5.6, the data enclosed by the <runtime> element is used only for self-documentation and to format the data displayed by ShowUsage. The <runtime> element does not enforce the values set for the arguments it contains (i.e. a "required" argument that is missing from the command line does not cause an error). If the <runtime> element is included in a .wsf file, then running the script with the "/?" argument will show the usage and quit.

The following script demonstrates the use of the <runtime> Element:

<job>
    <runtime>
        <named
            name="server"
            helpstring="The server to run the script on"
            type="string"
            required="true"
        />
    </runtime>
<script language="JScript">
  if (!WScript.Arguments.Named.Exists("server"))
  {
    WScript.Arguments.ShowUsage();
  }
// ... some script here
</script>
</job>

See Also

ShowUsage Method
<named> Element
<unnamed> Element
<description> Element (Windows Script Host)
<example> Element