hubcli job submitpgm¶

Submits a job that runs a SAS language program using Altair SLC. The program is copied to the Hub cluster from the local machine.

The command has the following format:

hubcli job submitpgm [flags] filename

flags: One or more optional flags that provide additional control over execution of the command.

filename The filename of the package to submit.

The following flags are available:

--allowExitCodes string: Treats jobs that return non-zero exit codes as successful. A non-zero code can be specified to string. You can specify more than one exit code, separated by commas.
For example, you could specify --allowExitCodes 1,2,3,5-10.
--allowWarnings: Treats SLC jobs that return warnings as successful.
--appendOption name=value: Appends the specified value to the end of the current value of the system option specified by name. This is only valid for Altair SLC program types. The default is [].
-c string or --connection string: Specifies the name of the connection to use. If you do not specify this option, then the default connection is used. If there is no default connection, then you must specify a connection. The first connection created for the Altair SLC Hub instance is set by default as the default Hub instance, but a different default connection can be set using the hubcli connection use command.
-d or --download: Downloads job results when the job has finished to either the default directory, or the directory specified by the -o option. The default directory is ./connection_name_jobid, where connection_name is the name of the connection used for the job and job_id is the job identifier for the job.
--debug: Enables debug logging.
-e name=value or --env name=value: Sets the environment variable name to the specified value to the job. The default is [].
-p string or --execution-profile string: The name of the execution profile to use for the job. If an execution profile is not specified, the default profile is used. A default profile can be specified using the hubcli exprof use command.
-h or --help: Returns help information for this command.
--insertOption name=value: Prepends the specified value at the beginning of the current value of the system option specified by name. This is only valid for Altair SLC program types. The default is []).
--jobNamejobname: Specifies the name to assign to the job.
-n string or --namespace string: Specifies the name of the namespace to use. If you do not specify this option, then the default namespace is used, if a default is available. A default namespace for the current connection is created using the hubcli namespace use command.
-O name=value or --option name=value: Sets the SLC system option name to value for the job. This is only valid for Altair SLC program types. The default is [].
-o dir or --outputDir dir: Specifies the directory into which the results of the job are downloaded. By default the directory is ./connectionname_jobid. for download, ./ for downloadZip.
-r list or --result list: Specifies a comma-separated list of result artifacts to download. Each artifact has the format 'result-name=worker-path', where result-name is the name of a result, and worker-path is the worker path used to run the job.
--rm: Removes the job after it has completed.
-T string or --type string: Specifies that the specified file extension defines a file that contains an executable job (that is, an Altair SLC program, shell script or operating system batch job).
-w or --wait: Waits until the job has completed before returning.
-t duration or --waitTimeout duration: Specifies the amount of time to wait for the job to finish. duration can be specified in common units such as s (seconds), m (minutes), and h (hours); for example, 30s, 5m, 2h. The default is to wait forever.
-z or --downloadZip: Downloads job results in a zip file when the job has finished. The zip file is downloaded to either the default directory, or to the directory specified by the -o option. The default directory is ./ (the current working directory).

Note: submit is an alias of submitpgm.