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

Appendix E. BPXCOPY: Copying a sequential or partitioned
data set or PDSE member into an HFS file
BPXCOPY
Format
Description
This information describes the BPXCOPY program.
BPXCOPY allows you to copy an HFS file, a sequential data set, or a partitioned
data set or a PDSE member into a hierarchical file system (HFS) file.
JCL:
EXEC PGM=BPXCOPY,PARM='ELEMENT HEADID LINK TYPE PATHMODE SYMLINK
SYMPATH APF | NOAPF PROGCTL | NOPROGCTL SHAREAS | NOSHAREAS UID GID
SHARELIB | NOSHARELIB
BPXCOPY can copy an HFS file, a sequential data set, or partitioned data set or
PDSE member into an HFS file. You can invoke BPXCOPY in several ways:
v From JCL using EXEC PGM=BPXCOPY. BPXCOPY does not need the Terminal
Monitor Program (TMP) to be started when it is invoked from JCL.
v From LINK, XCTL, ATTACH, a TSO/E CALL command with the asis option, or by
a CALL after a LOAD.
BPXCOPY provides similar function to the OPUT command, but differs from OPUT
in these ways:
v There is no code page conversion available.
v The specified filename cannot be longer than 8 characters.
v The pathname of the directory specified cannot be longer than 255 characters.
v You can define hard links to the file.
v You can define symbolic links to the file.
v You can set the permission access bits of the file.
v You can set the extended attributes of the file.
v You can set the owning UID and GID of the file.
v Do not specify PATHOPTS when using the TSO/E ALLOCATE command or a
JCL DD statement. It will be ignored.
A DD statement allocates a data set or file and sets up a ddname. For BPXCOPY:
v The input ddname can specify a MVS data set (either a sequential data set or a
member of a partioned data set or PDSE) or the input ddname can be the full
pathname of the HFS file. When you invoke BPXCOPY from JCL, you must use
SYSUT1 as the input ddname. If BPXCOPY is invoked from LINK, XCTL, or
ATTACH, a TSO/E CALL command with the asis option, or by a call after a
LOAD, you can specify an alternative ddname.
v The output ddname is associated with the pathname of the directory in which the
HFS file resides. The absolute pathname for the HFS file is this pathname
combined with the name specified with the ELEMENT parameter. When you
invoke BPXCOPY from JCL, you must use SYSUT2 as the output ddname. If
BPXCOPY is invoked from LINK, XCTL, or ATTACH, a TSO/E CALL command
with the asis option, or by a CALL after a LOAD, you can specify an alternative
ddname.
© Copyright IBM Corp. 1996, 2007 901