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

Return codes
Examples
0 Processing successful
12 Processing unsuccessful. An error message has been issued.
1. JCL and BPXCOPY are used to copy a PDSE member into a directory.
Known:
v The name of the PDSE member is REGEREX.
v The directory name is /u/turbo/llib.
v Output messages are to be directed to SYSOUT.
v Type of data: binary.
//TEST JOB MSGLEVEL=(1,1)
//STEP EXEC PGM=BPXCOPY,
// PARM=’ELEMENT(REGEREX) LINK("../erex") TYPE(BINARY)’
//SYSUT1 DD DSN=TURBO.LOADLIB(REGEREX),DISP=SHR
//SYSUT2 DD PATH=’/u/turbo/llib’
//SYSTSPRT DD SYSOUT=*
The LINK name is concatenated with the directory name from SYSUT2, yielding
/u/turbo/llib/../erex. The file system treats this as /u/turbo/erex, making this an
alias for /u/turbo/llib/REGEREX.
2. JCL and BPXCOPY are used to copy a PDS member into a directory.
Known:
v The name of the PDS member is TABLE1.
v The directory name is /u/carbon/data.
v Output messages are to be directed to SYSOUT.
v Type of data: text.
//TEST JOB MSGLEVEL=(1,1)
//STEP EXEC PGM=BPXCOPY,
// PARM=’ELEMENT(TABLE1) TYPE(TEXT) PATHMODE(0,7,6,4)’
//SYSUT1 DD DSN=CARBON.DATA(TABLE1),DISP=SHR
//SYSUT2 DD PATH=’/u/carbon/data’
//SYSTSPRT DD SYSOUT=*
This results in a file /u/carbon/data/TABLE1 with read, write, and execute
authority for the user; read and write authority for the group; and read authority
for other users.
3. A member of an MVS partitioned data set is copied to an HFS file from a
program using the LINK macro.
Known:
v The ddname of the source: INDD. INDD can be any sequential data set and
is defined by an ALLOCATE command issued outside the program.
v The ddname of the directory to copy into: OUTDD. OUTDD can be any
directory name and is defined by an ALLOCATE command issued outside the
program.
v Three link names—DATA, link1, and link2—for the target file.
v Output messages are directed to SYSOUT.
v Type of data: text.
*
COPYEX CSECT
STM 14,12,12(13) Entry linkage
LR 12,15
USING COPYEX,12
LA 10,SAVEAREA
BPXCOPY
Appendix E. BPXCOPY: Copying a sequential or partitioned data set or PDSE member into an HFS file 905