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

|
|
|
BPXCOPY
Parameters
v The message output ddname is associated with an MVS data set. The default
ddname is SYSTSPRT, which typically directs messages to SYSOUT. When you
invoke BPXCOPY from JCL, you must use SYSTSPRT as the message output
ddname. SYSTSPRT’s default LRECL is 137, with a BLKSIZE of 3155. 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 BPXCOPY invokes IKJTSOEV, and will always have an allocation for ddname
SYSTSIN. Please see z/OS TSO/E Programming Services for more information
about the IKJTSOEV service.
You can specify the following keyword parameters with BPXCOPY. The parameters
can be separated by any delimiter (space, comma, tab, or comment (/*)).
ELEMENT(element_name)
element_name is a simple 1-to-8-character filename of the output file. The
element_name specified is converted to uppercase characters.
The directory pathname for the output file is specified with the PATH keyword
on a JCL DD statement.
The pathname of the output file consists the directory pathname appended with
the element_name.
This parameter is required.
HEADID('character_string')
An 8-byte character string, enclosed in single quotes, that will appear on the
header of each page of output created.
This optional parameter is provided for SMP/E usage, not for a typical user.
LINK('linkname','linkname',...)
The names of hard links to the file. Each linkname is concatenated with the
output directory pathname. On the JCL DD statement for the directory, the
maximum length for a pathname (before concatenation) is 255 characters.
Pathnames with a length of up to 1023 characters can be specified only if
BPXCOPY is invoked from LINK, XCTL, or ATTACH, a TSO/E CALL command,
or by a CALL after a LOAD.
If you specify this parameter, you create one or more hard links to the file when
the data is copied into a file. The linkname must be enclosed in single quotes.
You can specify up to 64 linknames, and each must be enclosed in single
quotes. Specifying LINK is optional.
SYMLINK('linkname','linkname',...)
The names of symbolic links to the file. Each linkname is concatenated with the
output directory pathname. On the JCL DD statement for the directory, the
maximum length for a pathname (before concatenation) is 255 characters.
Pathnames with a length of up to 1023 characters (after concatenation) can be
specified if BPXCOPY is involved from LINK, XCTL, or ATTACH, a TSO/E CALL
command, or by a CALL after a LOAD.
If you specify this parameter, you create one or more symbolic links to the file.
The linkname must be enclosed in single quotes. You can specify up to 64
linknames, and each must be enclosed in single quotes. Specifying SYMLINK is
optional. If you specify SYMLINK, you must also specify SYMPATH.
SYMPATH('pathname','pathname',...)
The pathnames of the file for which the symbolic link is created. Each
902 z/OS V1R9.0 UNIX System Services Command Reference