Notice

IBM Decision Optimization on Cloud or DOcloud for short is a service that lets you solve CPLEX and OPL problems on the Cloud. You can access the interactive service called DropSolve or you can use use the API to integrate the service into your application. Here is a quick introduction with useful links. This module provides a simple command line client to submit and monitor your jobs. It is also good example of what you can do with the Node.js DOcloud client.

Installation
------------
After installing npm, you can install the command line client as a global module. During installation, npm will make sure that the command line tool 'docloud' is accessible as an executable.

``
npm install docloud-cli -g
`

Example
-------
First create a configuration named 'beta' using the DOcloud URL and your API key that you can get from your account.

`
> docloud config beta -u docloud_url -c api_key
`

Then create a directory 'warehouse' and unpack the sample files. You can submit a job by using the following simple command.

`
> docloud -g beta execute warehouse -v
Using config beta with DOcloud URL https://...
18 May 21:34:44 - Job job.500394427.1432010087482.38 created
18 May 21:34:44 - Starting upload of '.oplproject' of job job.500394427.1432010087482.38
18 May 21:34:45 - Attachment '.oplproject' of job job.500394427.1432010087482.38 uploaded in 793 ms
18 May 21:34:45 - Starting upload of 'warehouse_cloud.dat' of job job.500394427.1432010087482.38
18 May 21:34:45 - Attachment 'warehouse_cloud.dat' of job job.500394427.1432010087482.38 uploaded in 563 ms
18 May 21:34:45 - Starting upload of 'warehouse_cloud.mod' of job job.500394427.1432010087482.38
18 May 21:34:46 - Attachment 'warehouse_cloud.mod' of job job.500394427.1432010087482.38 uploaded in 560 ms
18 May 21:34:46 - Starting upload of 'warehouse_data.mod' of job job.500394427.1432010087482.38
18 May 21:34:47 - Attachment 'warehouse_data.mod' of job job.500394427.1432010087482.38 uploaded in 656 ms
18 May 21:34:47 - Job job.500394427.1432010087482.38 submitted
18 May 21:34:47 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:48 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:48 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:48 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:48 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:49 - Job job.500394427.1432010087482.38 is RUNNING
18 May 21:34:49 - Job job.500394427.1432010087482.38 is PROCESSED
18 May 21:34:50 - Attachment 'solution.json' of job job.500394427.1432010087482.38 downloaded in 390 ms
18 May 21:34:50 - Log of job job.500394427.1432010087482.38 downloaded in 313 ms
`

If you want to see the live log being streamed while the job is running, you can use the -l option:
`
> docloud -g beta execute warehouse -v -l
`

You can get the list of jobs using the command:
`
> docloud -g beta jobs
job.500394427.1432049497173.34 5/19/2015 8:31:37 AM PROCESSED OPTIMAL_SOLUTION
job.500394427.1432049446147.8 5/19/2015 8:30:46 AM PROCESSED OPTIMAL_SOLUTION
job.500394427.1432010087482.38 5/18/2015 9:34:47 PM PROCESSED OPTIMAL_SOLUTION
`

Note that the trial subscription has a limit of 3 jobs and you will quickly get this error.
`
Unexpected response code 403 on POST /jobs, reason : Subscription [...] of user api_... has a limit of 3 jobs total
`

You just need to remember to delete your jobs when done either one by one or all at once:
`
> docloud -g beta delete job.500394427.1432010087482.38
> docloud -g beta delete-all
`

Usage
-------

You will get the latest help with these commands:
`
> docloud --help
> docloud command --help
`

Here are the current global commands and options:
`
Usage: docloud [options] [command]

Commands:

config [name] save configuration defaults in ~/.docloud
execute|exec [options]