Servers Web Service

Servers

Click here for a complete list of operations.

UpdateServer

Update server described identified by 'server_name' with information described in 'cjs' param.
Fields left null in the cjs object will also be updated as null in the db.
This method will fail if an attempt is made to set non-nullable fields to null
This method requires a user with the admin priv
This method can be used also to add or delete server entries
If in delete mode, only the 'name' in CJServer is functional; all others are ignored.

Parameters:
long admin_wsid : WebServicesID of admin account.
string admin_pw : Password of that account
string server_name : identifier of the server entry to update CJServer cjs: Object containing server parameters to update. See GetServers() for CJServer field documentation.
int mode : The type of operation. 0 will update, 1 will add, 2 will delete.
Output:
void if succesful, exceptions if not

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /casjobs/services/servers.asmx HTTP/1.1
Host: nadc.china-vo.org
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://Services.Cas.jhu.edu/UpdateServer"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateServer xmlns="http://Services.Cas.jhu.edu">
      <admin_wsid>long</admin_wsid>
      <admin_pw>string</admin_pw>
      <server_name>string</server_name>
      <cjs>
        <Name>string</Name>
        <Context>string</Context>
        <DBUser>string</DBUser>
        <DBMachine>string</DBMachine>
        <DBCatalog>string</DBCatalog>
        <DBPw>string</DBPw>
        <GPriv>string</GPriv>
        <ExecCap>int</ExecCap>
        <TimeOut>int</TimeOut>
      </cjs>
      <mode>int</mode>
    </UpdateServer>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateServerResponse xmlns="http://Services.Cas.jhu.edu" />
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /casjobs/services/servers.asmx HTTP/1.1
Host: nadc.china-vo.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <UpdateServer xmlns="http://Services.Cas.jhu.edu">
      <admin_wsid>long</admin_wsid>
      <admin_pw>string</admin_pw>
      <server_name>string</server_name>
      <cjs>
        <Name>string</Name>
        <Context>string</Context>
        <DBUser>string</DBUser>
        <DBMachine>string</DBMachine>
        <DBCatalog>string</DBCatalog>
        <DBPw>string</DBPw>
        <GPriv>string</GPriv>
        <ExecCap>int</ExecCap>
        <TimeOut>int</TimeOut>
      </cjs>
      <mode>int</mode>
    </UpdateServer>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <UpdateServerResponse xmlns="http://Services.Cas.jhu.edu" />
  </soap12:Body>
</soap12:Envelope>