Ubuntu Manpages

run-remote

(distributed-computing)

Call a remote service in a single statement.

run-remote <service> \
    ( local <app name> ) | ( location <location> ) \
    url-path <service URL> |
        ( \
        app-path <app path> \
        request-path <request path> \
        [ url-params <url params> ] \
        ) \
    [ request-body content <content> \
        [ content-length <content length> ] \
        [ content-type <content type> ] ] \
    [ method <request method> ] \
    [ environment <name>=<value> [ , ... ] ] \
    [ timeout <timeout> ]\
    [ status <status> ]  \
    [ started <started> ] \
    [ finished-okay <finished okay> ]\
    [ data <data> ] \
    [ error <error> ] \
    [ status <status> ] \
    [ status-text <status text> ] \
    [ exit-status <service status> ]

`

run-remote is a combination of new-remote, call-remote and read-remote in one. Clauses for each of those can be specified in any order. Only a single <service> can be used. If a call to <service> succeeds, its results are read. Use either:

• <status> (in "status" clause) to check if there are results to be read: if it is GG_OKAY, then you can use the results.

• <finished okay> (in "finished-okay" clause) to check if service call executed: if it's 1, then it has.

See details for each clause in new-remote (for "local" through "timeout" clauses), call-remote (for "status" through "finished-okay" clauses) and read-remote (for "data" through "exit-status" clauses).

begin-handler /serv public
    run-remote nf local "hash-server-yey" \
        url-path "/hash-server-yey/server/op=add/key=sb_XYZ/data=sdb_123" \
        finished-okay sfok \
        data rdata error edata  \
        status st exit-status rstatus
    if-true sfok  not-equal  1 or st  not-equal  GG_OKAY
        @Call did not succeed
    else-if
        @Result is <<print-out rdata> and (any) error is <<print-out edata>>
    end-if
end-handler


Distributed computing

call-remote new-remote read-remote run-remote See all documentation