...
The STC CP execution environment is the same as the USS command environment described in #zz/OS UNIX System Services Command.
Extended MCS Console
The started task is started with the START system command through an extended MCS console. Refer to the IBM MVS System Commands manual for a complete description of the START command.
...
The UCMD Manager provides the START command parameters. The STC CP adds parameter STDIN with a value of a cataloged dynamically allocated data set that contains the standard input from the Manager.
The syntax of the START command that is generated based on options passed to UCMD 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>
|
|