submit file
To run this command, in the security file you must have submit access for the job with the name specified in its database definition and, if you use the alias keyword, also with the name specified with this keyword. In addition, if you use the recoveryjob keyword, you must have submit access for the job specified with that keyword.
To include
needs
and prompt
dependencies, you must have use
access to the resources and global prompts.
- Has proper credentials defined in the useropts file to connect to the master domain manager through WebSphere Application Server Liberty
- Is authorized to perform submit commands in the security file stored on the master domain manager
Syntax
{submit file = | sbf} "filename"
[;alias[=name]]
[;into=[[folder/]workstation#]{jobstream_id
;schedid |[folder/]jobstreamname([hhmm[ date]])}]
[;joboption[;...]]
[;noask]
Arguments
- filename
- Specifies the name of the file, up to 255 characters. Wildcard characters are permitted. The name must be enclosed in quotes (") if it contains characters other than alphanumeric characters, dashes (-), slashes (/), and underscores (_). See the examples.
- alias=name
- Specifies a unique name to be assigned to the job. If you enter
the alias keyword without specifying a name, a name is constructed
using up to the first six alphanumeric characters (in upper case)
of the file name, depending on the number of characters in the file
name, followed by a ten digit random number. For example, if the file
name is
jclttx5
, the generated name will be similar toJCLTTX0123456789
.If you do not include alias, a filename is constructed using up to 255 alphanumeric characters of the file's base name, in upper case.
In either of the above cases, if the file name does not start with a letter, you are prompted to use alias= name.
If you submit a file a second time from the same workstation, the alias keyword is mandatory and must be unique for each file submission.
- into=[folder/]jobstream_instance
- Identifies the job stream instance, and optionally the folder in which it is defined, into which
the job will be placed for launching. If [folder/] is omitted, then the
root folder is assumed. Select the job stream instance as follows:
[[folder/]workstation#][folder/]jobstreamname([hhmm[date]])
or[[folder/]workstation#]jobstream_id ;schedid
If into is not used, the job is added to a job stream named JOBS.
- joboption
- Specify one of the following:
at=hhmm [timezone|tz tzname] [+n days | mm/dd[/yy]] | [absolute | abs]
confirmed
critical
deadline=time[timezone | tz tzname][+n days | mm/dd[/yy]]
every=rate
follows=[netagent::][workstation#]{jobstreamname[hhmm [mm/dd[/yy]]][.job | @] | jobstream_id.job;schedid}| job[,...] [if 'condition_name[| condition_name][| ...]']Note: Internetwork dependencies do not support folders, therefore, the network agent workstation, and the jobs and job streams running on them, cannot be defined in a folder different from the root (/). Folders are supported on all other workstation types as follows:[follows {[[folder/]workstation#][folder/]jobstreamname[.jobname]
follows=[[folder/]workstation#][folder/]{jobstreamname[hhmm [mm/dd[/yy]]][.job | @] | jobstream_id.job;schedid}| job[,...] [if 'condition_name[| condition_name][| ...]']
The condition_name variable indicates the name of the condition defined in the job definition. Conditions can be status conditions, based on job status, or other output conditions, based on a mapping expression such as a return code, output variables, or output found in a job log. In each follows statement, you can specify only one dependency type: either status or output conditions. At submission time, you can add status or output conditions, but no joined dependencies.
- wait
- The time in seconds HCL Workload Automation waits before performing a second check on the dependency if the object specified in the dependency does not exist. If the object specified in the dependency was created during the wait interval, the submission is performed, otherwise the job is not submitted.
- nocheck
- Ignores the dependency. If the object specified in the dependency does not exist, the submission is performed anyway.
Note: The ;nocheck argument is not supported in internetwork dependencies.interactiveNote: This keyword can be used in Windows® environments only.logon=user
maxdur=time[onmaxdur action]
mindur=time[onmindur action]
needs=[num] [[folder/]workstation#][folder/]resource[,...]
opens=[[folder/]workstation#]"filename"[(qualifier)][,...]
priority=[pri | hi | go]
prompt="[: | !]text" | [folder/]promptname[,...]
recovery=stop | continue | rerun
recoveryjob=[[folder/]workstation#][folder/]jobname
The name of a recovery job, and optionally the folder containing the recovery job, different from the job (if present) specified in the job definition in the database.
after [[folder/]workstation#][folder/]jobname
abendprompt “text”
until time [timezone|tz tzname][+n day[s] | [absolute | abs]] [;onuntil action]
- noask
- Specifies not to prompt for confirmation before taking action against each qualifying file.
Using local parameters
opens
logon
prompt
abendprompt
Local parameters are defined and managed with the parms utility command in a local database on the workstation where the job is run. The parameters are resolved on the workstation while the submit command is running.
Comments
Jobs submitted in production from the conman command line are not included in the preproduction plan and so they cannot be taken into account when identifying external follows dependencies predecessors.
If
you do not specify a workstation with follows
, needs
, opens
,
or into
, the default is the workstation on which conman is
running.
The scheduler classifies follows dependencies as internal when they are specified only by their job name within the job stream. It classifies them as external when they are specified in the workstationName#[folder/]jobStreamName.jobName format.
When
you submit the object into a job stream and add a follows dependency
that shares the same job stream name (for example, you submit the
object into job stream schedA
and define a follows
dependency on schedA.job2
), the dependency is treated
as an external follows dependency. Since Version 8.3, unlike
in previous versions, because the scheduler uses the sameday
matching
criteria to resolve external dependencies, dependencies originated
in this way are never added the first time the object is submitted.
Examples
jobs
(the job name is
myjcl
), run the following command:
submit file = d:\jobs\lib\daily\myjcl
where the ;into
sequence was omitted.misjob4
, into the job stream
missked
located in the root folder, run the following command:
sbf /usr/lib/mis/jcl4;alias=misjob4;into=missked ;needs=2 slots
The job needs
two units of the slots
resource. misjob4
, into
the job stream missked
that is located in the europe
folder, run
the following command:
sbf /usr/lib/mis/jcl4;alias=misjob4;into=/europe/missked
back
into
the job stream bkup
, run the following command: sbf "/usr/lib/backup/back@";into=bkup
tws_env.cmd
, whose path
contains a blank, on a Windows workstation run: - In interactive mode:
Being in Windows, the double quotation marks (") must be escaped by thesbf "\"C:\Program Files\HCL\TWS\lucaMDM\tws_env.cmd\"";alias=MYJOB
"\
character sequence. - In command line mode:
Being in Windows, and running the command externally from the conman environment, the escape sequence becomes longer.conman sbf "\"\\\"C:\Program Files\HCL\TWS\lucaMDM\tws_env.cmd\\\"\"";alias=MYJOB
"\"
is the escape character for the blank
in the file path.