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

Appendix D. Running shell scripts or executable files under
MVS environments
BPXBATCH
This information describes the IBM-supplied BPXBATCH program.
BPXBATCH makes it easy for you to run shell scripts and executable files that
reside in z/OS UNIX files through the MVS job control language (JCL). If you do
most of your work from TSO/E, using BPXBATCH saves you the trouble of going
into the shell to run your scripts and executable files. REXX execs can also use
BPXBATCH to run shell scripts and executable files.
In addition to using BPXBATCH, 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
profile) can use BPXBATSL. BPXBATSL provides users with an alternate entry point
into BPXBATCH, and forces a program to run using a local spawn instead of
fork/exec as BPXBATCH does. This ultimately allows a program to run faster.
BPXBATSL is also useful when the user wants to perform a local spawn of their
program but also needs subsequent child processes to be fork/exec’ed. Formerly,
this could not be done since BPXBATCH and the requested program shared the
environment variables. Failure to meet the following conditions will result in a failure
when BPXBATSL is invoked. For more details about these restrictions, see the
descriptions of the spawn() function and BPX1SPN callable service in z/OS UNIX
System Services Programming: Assembler Callable Services Reference:
v The invoker must have an UID of 0 to issue a SH request
v The child process is not setuid or setgid to a value different from the parent
v The spawned file name is not an external link or a sticky bit file
v The parent has enough resources to allow the child process to reside in the
same address space
BPXBATSL is an alias of BPXBATCH.
BPXBATA2 and BPXBATA8 are provided as APF authorized alternatives to
BPXBATSL. BPXBATA2 and BPXBATA8 provide the capability for a target APF
authorized z/OS UNIX program to run in the same address space as the originating
job, allowing it to share the same allocations, joblog, and so on. BPXBATA2 is
specifically intended to provide the capability for APF Authorized z/OS UNIX
program to be started in a PSW Key 2 . To insure the target program receives
control PSW Key 2, a PPT entry for BPXBATA2 must be set up that specifies that
BPXBATA2 starts up PSW Key 2.
The same restrictions that apply to BPXBATSL apply to BPXBATA2 and
BPXBATA8, in addition to, the following:
v The PGM keyword is the only invocation type that is supported. The SH keyword
is not supported.
v The interfaces can only be used from Started Task address spaces.
v The z/OS UNIX program that is the target of the BPXBATA2 and BPXBATA8 job
must be marked as an APF Authorized executable file.
© Copyright IBM Corp. 1996, 2007 891