...
The syntax of the START command is as follows:
| Panel |
|---|
| Html bobswift |
|---|
<pre>
S manager-cmd,STDIN=stdin-dataset
</pre>
|
|
The manager-cmd value is the command value provided by the UCMD Manager. The stdin-dataset value is the dynamically allocated data set that contains the Manager's standard input data.
As an example, the following Manager command, executed from a Windows system:
| Panel |
|---|
| Html bobswift |
|---|
<pre>
ucmd -c "prdtask,opt=abc" -cmd_type stc -u ts0023 ...
</pre>
|
|
results in a START command as follows:
| Panel |
|---|
| Html bobswift |
|---|
<pre>
S PRDTASK,OPT=ABC,STDIN=TS0023.UCM.C08AD835.STDIN
</pre>
|
|
Access to UCMD Manager started task requests and the associated command value can be protected with Universal Access Control Lists. See
Universal Command Server for zOS - UACL for complete details on protecting request types.
...
The following figure illustrates a started task procedure JCL.
| Panel |
|---|
| Html bobswift |
|---|
<pre>
//UCMREQ PROC
//*
//UCMSS000 EXEC PGM=UCMSS000
//STEPLIB DD DISP=SHR,DSN=UNV.SUNVLOAD
//STDIN DD DISP=SHR,DSN=&STDIN
//SYSUDUMP DD SYSOUT=H
//*
//S1 EXEC PGM=ABC123
//SYSOUT DD SYSOUT=A,HOLD=YES
//SYSPRINT DD SYSOUT=A,HOLD=YES
//SYSIN DD DISP=SHR,DSN=&STDIN
</pre>
|
|
The JCL executes two steps:
...
For example, the following UCMD Manager command can be used from Windows or UNIX to request execution of the command reference
cref100 and pass it options
opt1 and
opt2:
| Panel |
|---|
| Html bobswift |
|---|
<pre>
ucmd -c "cref100 opt1,opt2" -cmd_type cmdref ...
</pre>
|
|
z/OS command references can define any valid command type, such as USS shell commands and scripts and started task commands.
...
The following command reference executes a
ucopy command to read a file.
| Panel |
|---|
| Html bobswift |
|---|
<pre>
# Command reference to read a file.
#
-format cmd
-type shell
</pre>
|
<eof>
| Html bobswift |
|---|
<pre>
ucopy /opt/application/file.txt
</pre>
|
|
STC Command Reference Example
The following command reference starts started task SCHEDINT.
| Panel |
|---|
| Html bobswift |
|---|
<pre>
# Command reference to scheduler interface.
#
-format cmd
-type stc
</pre>
|
<eof>
| Html bobswift |
|---|
<pre>
SCHEDINT,OPT=ABC
</pre>
|
|