Subversion Repositories XServices

Rev

Rev 59 | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 59 Rev 163
1
<?xml version='1.0' encoding='utf-8'?>
1
<?xml version='1.0' encoding='utf-8'?>
2
<!DOCTYPE section [
2
<!DOCTYPE section [
3
<!ENTITY % myent SYSTEM "../entities.ent">
3
<!ENTITY % myent SYSTEM "../entities.ent">
4
%myent;
4
%myent;
5
]>
5
]>
6
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
6
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
7
	xmlns:xi="http://www.w3.org/2001/XInclude">
7
	xmlns:xi="http://www.w3.org/2001/XInclude">
8
	<title>runCommand</title>
8
	<title>runCommand</title>
9
	<para>Run an executable with arguments on the server providing the web
9
	<para>Run an executable with arguments on the server providing the web
10
		service. The command is run within the environment and under the user
10
		service. The command is run within the environment and under the user
11
		privileges of the user who is running the Tomcat Server.</para>
11
		privileges of the user who is running the Tomcat Server.</para>
12
	<section>
12
	<section>
13
		<title>&inp;
13
		<title>&inp;
14
		</title>
14
		</title>
15
		<para />
15
		<para />
16
		<table frame="all">
16
		<table frame="all">
17
			<title>runCommand input parameters</title>
17
			<title>runCommand input parameters</title>
18
			<tgroup cols="4">
18
			<tgroup cols="4">
19
				<colspec colnum="1" colname="parameter" />
19
				<colspec colnum="1" colname="parameter" />
20
				<colspec colnum="2" colname="type" />
20
				<colspec colnum="2" colname="type" />
21
				<colspec colnum="3" colname="required" />
21
				<colspec colnum="3" colname="required" />
22
				<colspec colnum="4" colname="description" />
22
				<colspec colnum="4" colname="description" />
23
				<thead>
23
				<thead>
24
					<row>
24
					<row>
25
						<entry>parameter</entry>
25
						<entry>parameter</entry>
26
						<entry>type</entry>
26
						<entry>type</entry>
27
						<entry>required</entry>
27
						<entry>required</entry>
28
						<entry>description</entry>
28
						<entry>description</entry>
29
					</row>
29
					</row>
30
				</thead>
30
				</thead>
31
				<tbody>
31
				<tbody>
32
					<row>
32
					<row>
33
						<entry>executable</entry>
33
						<entry>executable</entry>
34
						<entry>String</entry>
34
						<entry>String</entry>
35
						<entry>Yes</entry>
35
						<entry>Yes</entry>
36
						<entry>Command to be run. The command may be specified with full
36
						<entry>Command to be run. The command may be specified with full
37
							path using forward slash &quot;/&quot; as path separator.</entry>
37
							path using forward slash &quot;/&quot; as path separator.</entry>
38
					</row>
38
					</row>
39
					<row>
39
					<row>
40
						<entry>argline</entry>
40
						<entry>argline</entry>
41
						<entry>String</entry>
41
						<entry>String</entry>
42
						<entry>No</entry>
42
						<entry>No</entry>
43
						<entry>Any command line arguments</entry>
43
						<entry>Any command line arguments</entry>
44
					</row>
44
					</row>
45
          &param-timeout;
45
          &param-timeout;
46
				</tbody>
46
				</tbody>
47
			</tgroup>
47
			</tgroup>
48
		</table>
48
		</table>
49
		<para />
49
		<para />
50
	</section>
50
	</section>
51
	<section>
51
	<section>
52
		<title>&outp;
52
		<title>&outp;
53
		</title>
53
		</title>
54
		<xi:include href="../types/ReturnCode.xml" />
54
		<xi:include href="../types/ReturnCode.xml" />
55
	</section>
55
	</section>
-
 
56
	<section>
-
 
57
	<para>
-
 
58
	Sample request: Start Windows Command Interpreter and print "Hello World" to STDOUT.
-
 
59
	<programlisting language="xml">
-
 
60
	<![CDATA[<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
-
 
61
   <soapenv:Header/>
-
 
62
   <soapenv:Body>
-
 
63
      <ws:runCommand>
-
 
64
         <executable>c:/windows/system32/cmd.exe</executable>
-
 
65
         <argline>/C "echo Hallo Welt!"</argline>
-
 
66
         <timeout>3000</timeout>
-
 
67
      </ws:runCommand>
-
 
68
   </soapenv:Body>
-
 
69
</soapenv:Envelope>]]>
-
 
70
	</programlisting>
-
 
71
	
-
 
72
	Sample response:
-
 
73
	<programlisting language="xml">
-
 
74
	<![CDATA[<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
-
 
75
   <soap:Body>
-
 
76
      <ns2:runCommandResponse xmlns:ns2="http://ws.xservices.brutex.net">
-
 
77
         <return>
-
 
78
            <returnCode>0</returnCode>
-
 
79
            <stdOut/>
-
 
80
            <stdErr/>
-
 
81
            <propertyList>
-
 
82
               <name>ExecuteService.result</name>
-
 
83
               <value>0</value>
-
 
84
            </propertyList>
-
 
85
            <propertyList>
-
 
86
               <name>ExecuteService.stdout</name>
-
 
87
               <value>Hallo Welt!</value>
-
 
88
            </propertyList>
-
 
89
            <propertyList>
-
 
90
               <name>ExecuteService.stderr</name>
-
 
91
               <value/>
-
 
92
            </propertyList>
-
 
93
         </return>
-
 
94
      </ns2:runCommandResponse>
-
 
95
   </soap:Body>
-
 
96
</soap:Envelope>]]></programlisting></para></section>
-
 
97
<section>
-
 
98
<para>
-
 
99
Sample request: Start notepad.exe and close it after 15 seconds.
-
 
100
<programlisting language="xml">
-
 
101
<![CDATA[<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.xservices.brutex.net">
-
 
102
   <soapenv:Header/>
-
 
103
   <soapenv:Body>
-
 
104
      <ws:runCommand>
-
 
105
         <executable>c:/windows/system32/notepad.exe</executable>
-
 
106
         <argline></argline>
-
 
107
         <timeout>15000</timeout>
-
 
108
      </ws:runCommand>
-
 
109
   </soapenv:Body>
-
 
110
</soapenv:Envelope>]]></programlisting></para></section>
56
</section>
111
</section>
57
 
112
 
58
Generated by GNU Enscript 1.6.5.90.
113
Generated by GNU Enscript 1.6.5.90.
59
 
114
 
60
 
115