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

pathname may be an absolute pathname (beginning with a slash) or a relative
pathname (not beginning with a slash). When an absolute pathname is used,
the symbolic link will be resolved starting at the root directory. When a relative
pathname is used, the symbolic link will be resolved starting at the parent
directory of the symbolic link.
For JCL, the maximum length for a pathname is limited by the 100 character
limit on the entire PARM string (including other parameters) on the EXEC
statement. Pathnames with a length of up to 1023 characters can be specified if
BPXCOPY is invoked from LINK, XCTL, or ATTACH, a TSO/E CALL command,
or by a CALL after a LOAD.
Specifying SYMPATH is optional, but if you specify SYMPATH, you must also
specify SYMLINK. Each SYMLINK linkname must be matched with a
corresponding SYMPATH pathname. The first linkname will define a symbolic
link to the first pathname, the second linkname will define a symbolic link to the
second pathname, etc. If there are fewer pathnames than linknames, the last
pathname will be used for the remaining linknames.
PATHMODE (mode_bits)
Changes the access permissions, or modes, of the specified file or directory.
Modes determine who can read, write, or search a directory. The bits are used
to set execution and permission access of the output file. On BPXCOPY, you
can specify PATHMODE as an absolute mode; it must consist of four octal
numbers separated by commas or blanks.
Absolute modes are four octal numbers specifying the complete list of attributes
for the files; you specify attributes by ORing together the bits for each octal
number.
4,0,0,0 Set-user-ID bit
2,0,0,0 Set-group-ID bit
1,0,0,0 Sticky bit
0,4,0,0 Individual read
0,2,0,0 Individual write
0,1,0,0 Individual execute (or list directory)
0,0,4,0 Group read
0,0,2,0 Group write
0,0,1,0 Group execute
0,0,0,4 Other read
0,0,0,2 Other write
0,0,0,1 Other execute
Specifying PATHMODE is optional.
For more information on permission bits, see the chmod command.
BPXCOPY
TYPE (TEXT|BINARY)
The format for the HFS file. The default is BINARY for U-format data sets and
TEXT for all others. (U-format means undefined-length records.) Specifying
TYPE is optional.
APF|NOAPF
Specifies whether the APF extended attribute is set or unset. When this
attribute is set (APF) on an executable program file (load module), it behaves
as if loaded from an APF-authorized library. For example, if this program is
exec()ed at the job step level and the program is linked with the AC = 1
attribute, the program will be executed as APF-authorized.
To be able to set APF, you must have at least READ access to the
BPX.FILEATTR.APF resource in the FACILITY class. For more information, see
z/OS UNIX System Services Planning.
Appendix E. BPXCOPY: Copying a sequential or partitioned data set or PDSE member into an HFS file 903