z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

BPXBATCH
Format
Description
Any other usage of the BPXBATA8 and BPXBATA2 interfaces than what is
described is not supported and will cause the invoking job to fail.
JCL:
EXEC PGM=BPXBATCH,PARM=’SH|PGM program_name’
TSO/E:
BPXBATCH SH|PGM program_name
The BPXBATCH program allows you to submit MVS batch jobs that run shell
commands or scripts, or z/OS C executable files You can invoke BPXBATCH from a
JCL job or from TSO/E (as a command, through a CALL command, or from a
CLIST or REXX EXEC).
With BPXBATCH, you can allocate the MVS standard file stdin only as z/OS UNIX
files for passing input. You can allocate the MVS standard files stdout, stderr or
stdenv as MVS data sets or z/OS UNIX text files. The stdenv file for containing
environment variables or the stderr and stdout files for saving job output can be
allocated as SYSOUT, PDSE, PDS or sequential data sets. If you do not allocate
them, stdin, stdout, stderr, and stdenv default to /dev/null. Allocate the standard
files using the data definition PATH keyword options, or standard data definition
options for MVS data sets, for stdenv, stdout and stderr.
For MVS data sets use the standard data definition options for MVS data sets.
For JCL jobs, you specify PATH keyword options on DD statements:
//jobname JOB ...
//stepname EXEC PGM=BPXBATCH,PARM=’SH|PGM program_name’
//STDIN DD PATH=’/stdin-file-pathname’,PATHOPTS=(ORDONLY)
//STDOUT DD PATH=’/stdout-file-pathname’,PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
// PATHMODE=SIRWXU
//STDERR DD PATH=’/stderr-file-pathname’,PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//
.
PATHMODE=SIRWXU
Your application in the executable file can also allocate stdin, stdout, stderr, and
stdenv dynamically through the use of SVC 99.
For TSO/E, you specify PATH keyword options on the ALLOCATE command:
ALLOCATE FILE(STDIN) PATH(’/stdin-file-pathname’) PATHOPTS(ORDONLY)
ALLOCATE FILE(STDOUT) PATH(’/stdout-file-pathname’)
PATHOPTS(OWRONLY,OCREAT,OTRUNC) PATHMODE(SIRWXU)
ALLOCATE FILE(STDERR) PATH(’/stderr-file-pathname’)
PATHOPTS(OWRONLY,OCREAT,OTRUNC) PATHMODE(SIRWXU)
BPXBATCH SH|PGM program_name
stdin and stdenv must always be allocated as read. stdout and stderr must
always be allocated as write.
As previously stated, a user who wants to perform a local spawn without being
concerned about environment setup (that is, without having to set specific
environment variables which could be overwritten if they are also set in the user’s
892 z/OS V1R9.0 UNIX System Services Command Reference