WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

RemoteBatchSubmit
✖
RemoteBatchSubmit

[Experimental]

✖
RemoteBatchSubmit[env,expr]

submits expr for evaluation using the remote batch submission environment env.

✖

submits expr for evaluation using $DefaultRemoteBatchSubmissionEnvironment.

Details and Options

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Submit a batch job to a batch computation provider:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-pd47rn
Out[1]=1

Retrieve the result of the job:

In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-dr01nn
Out[2]=2

Submit a batch job including a local input file, uploaded under the name "MyFile.jpg":

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-nn3gj4
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-flc9v1
Out[2]=2

Scope  (1)Survey of the scope of standard use cases

Submit a batch job using the default remote submission environment:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-r17eo
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-cls6te
Out[2]=2

Options  (6)Common values & functionality for each option

ForwardCloudCredentials  (1)

Submit a job using the "AWSBatch" provider, for which the default setting of the ForwardCloudCredentials option is True:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-jnou3f
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-dbk4he
Out[2]=2

Override the default and disable credential forwarding:

In[3]:=3
✖
https://wolfram.com/xid/0cf2zeyvogftzna-bqutt2
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0cf2zeyvogftzna-en4fz8
Out[4]=4

IncludeDefinitions  (1)

By default, definitions of symbols lexically relevant for the evaluation of the job expression are copied into the remote session:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-ratt
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-ddo1w3
Out[2]=2

Disable the automatic inclusion of definitions:

In[3]:=3
✖
https://wolfram.com/xid/0cf2zeyvogftzna-dbxfj5
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0cf2zeyvogftzna-bavbkf
Out[4]=4

LicensingSettings  (1)

Activate the kernel in a remote batch job using an automatically created on-demand license entitlement with custom settings:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-3t96o
Out[1]=1

RemoteInputFiles  (1)

Submit a batch job using a local file and a byte array as input files:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-e3izi1
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-fdeymb
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0cf2zeyvogftzna-duw2u9
Out[3]=3

The two input files were automatically downloaded into the remote session's working directory (along with the system-generated file containing the job code):

In[4]:=4
✖
https://wolfram.com/xid/0cf2zeyvogftzna-kawg82
Out[4]=4

RemoteProviderSettings  (1)

Submit a job with settings for the "AWSBatch" provider specifying how many vCPUs (processor cores) to allocate to the job container:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-n1omla
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-cyblsp
Out[2]=2

TimeConstraint  (1)

Submit a job with a timeout:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-b1jl20
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-fq9gzi
Out[2]=2

The "AWSBatch" provider supplies an additional "JobStatusReason" job property indicating the reason for the job's failure:

In[3]:=3
✖
https://wolfram.com/xid/0cf2zeyvogftzna-pjcqmg
Out[3]=3

Possible Issues  (1)Common pitfalls and unexpected behavior

Using the default on-demand licensing settings, RemoteBatchSubmit will refuse to submit a job if your Service Credits balance is insufficient to create a license entitlement based on the job processor count and TimeConstraint:

In[1]:=1
✖
https://wolfram.com/xid/0cf2zeyvogftzna-g4lqg0
Out[1]=1

Reduce the number of processor cores and/or the TimeConstraint:

In[2]:=2
✖
https://wolfram.com/xid/0cf2zeyvogftzna-4bgv4
Out[2]=2

Alternatively, you may override the balance check by supplying the "CheckCreditsBalance"False entitlement setting to the LicensingSettings option:

In[3]:=3
✖
https://wolfram.com/xid/0cf2zeyvogftzna-jyvi6w
Out[3]=3
Wolfram Research (2020), RemoteBatchSubmit, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.
✖
Wolfram Research (2020), RemoteBatchSubmit, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.

Text

Wolfram Research (2020), RemoteBatchSubmit, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.

✖
Wolfram Research (2020), RemoteBatchSubmit, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.

CMS

Wolfram Language. 2020. "RemoteBatchSubmit." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.

✖
Wolfram Language. 2020. "RemoteBatchSubmit." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html.

APA

Wolfram Language. (2020). RemoteBatchSubmit. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html

✖
Wolfram Language. (2020). RemoteBatchSubmit. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html

BibTeX

@misc{reference.wolfram_2025_remotebatchsubmit, author="Wolfram Research", title="{RemoteBatchSubmit}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html}", note=[Accessed: 29-March-2025 ]}

✖
@misc{reference.wolfram_2025_remotebatchsubmit, author="Wolfram Research", title="{RemoteBatchSubmit}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html}", note=[Accessed: 29-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_remotebatchsubmit, organization={Wolfram Research}, title={RemoteBatchSubmit}, year={2020}, url={https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html}, note=[Accessed: 29-March-2025 ]}

✖
@online{reference.wolfram_2025_remotebatchsubmit, organization={Wolfram Research}, title={RemoteBatchSubmit}, year={2020}, url={https://reference.wolfram.com/language/ref/RemoteBatchSubmit.html}, note=[Accessed: 29-March-2025 ]}