<doc>
  <legacy_id>1744</legacy_id>
  <name>revXMLRPC_SetHost</name>
  <type>command</type>
  <syntax>
    <example>revXMLRPC_SetHost <i>XML-RPC document</i>,<i>host</i>[,<i>port</i>]</example>
  </syntax>
  <library>XML-RPC library</library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Text and Data Processing</category>
    <category>Networks &amp; Communication</category>
  </classification>
  <references>
    <command tag="revXMLRPC_SetPort">revXMLRPC_SetPort Command</command>
    <function tag="revXMLRPC_GetHost">revXMLRPC_GetHost Function</function>
  </references>
  <history>
    <introduced version="2.5">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
    <process/>
  </security>
  <summary>Sets the host and optionally the port of an XML-RPC document structure.</summary>
  <examples>
    <example>revXMLRPC_SetHost theRequest,"www.runrev.com"</example>
    <example>revXMLRPC_SetHost myRequest,"example.com",10000</example>
  </examples>
  <description>
    <p>Use the <b>revXMLRPC_SetHost</b> <glossary tag="command">command</glossary> to set the host and optionally the port that is the target of the execution of an <glossary tag="XML-RPC document">XML-RPC request</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>documentID</i> is the number <glossary tag="return">returned</glossary> by the <function tag="revXMLRPC_CreateRequest">revXMLRPC_CreateRequest</function> when you created the <glossary tag="XML-RPC document">XML-RPC request</glossary>.</p><p/><p>The <i>host</i> is the <glossary tag="IP address">IP address</glossary> or <glossary tag="domain name">domain name</glossary> of the <glossary tag="host">host</glossary> you want to connect to.</p><p/><p>The <i>port</i> is the <glossary tag="port">port</glossary> number you want to connect to. If you don't specify a port, port 80 is used. (On most systems, port 80 is used for <keyword tag="http">HTTP</keyword> connections.)</p><p/><p><b>Comments:</b></p><p>If the <b>revXMLRPC_SetHost</b> <glossary tag="command">command</glossary> encounters an error, the <function tag="result">result</function> is set to an error message beginning with "xmlrpcerr"..</p><p/><p><img src="202653"/> <b>Important!</b> The <b>revXMLRPC_SetHost</b> <glossary tag="command">command</glossary> is part of the <glossary tag="XML-RPC library">XML-RPC library</glossary>. To ensure that the <glossary tag="command">command</glossary> works in a <glossary tag="standalone application">standalone application</glossary>, you must include this <glossary tag="LiveCode custom library">custom library</glossary> when you create your <glossary tag="standalone application">standalone</glossary>. In the Inclusions section on the General screen of the <glossary tag="Standalone Application Settings">Standalone Application Settings</glossary> window, make sure "XML-RPC Library" is selected in the list of script libraries.</p>
  </description>
</doc>