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

Appendix K. Specifying MVS data set names in the shell
environment
Several utilities allow the user to specify an MVS data set name in place of an HFS
filename. See Utilities supporting MVS data set names for the current list. This topic
describes the syntax for specifying an MVS data set name. Because MVS data set
names generally contain single quotes and parenthesis which can be misinterpreted
by the shell, care needs to be taken to correctly escape these characters.
What follows are general rules for specifying MVS data set names. Consult the
description of each utility for more specific instructions or exceptions.
v MVS data sets are distinguished from HFS files by preceding them with two
slashes (//). For example, to specify the MVS data set name
PROGRAM.OUTPUT, enter:
//PROGRAM.OUTPUT
If the double slashes were not used, the name would be interpreted as the HFS
pathname PROGRAM.OUTPUT in the current working directory.
v Unless a utility specifically provides an option to disable uppercasing, the default
approach is to uppercase all MVS data set names before processing. For
example, the following are all equivalent methods for specifying the MVS data set
PROGRAM.OUTPUT:
//program.output
//ProGram.OutPut
//PROGRAM.OUTPUT
v The single quote (’) and parenthesis (()) metacharacters are typically used to
specify fully-qualified MVS names and PDS/PDSEs, respectively. These
characters, however, are metacharacters that will be incorrectly interpreted by the
shell. To prevent this, they must be escaped. The simplest approach is to place
the entire name within double-quotes (″). Alternatively, these characters can be
escaped by preceding each with a backslash (\). Some examples are:
To specify the fully qualified MVS data set ’SMITH.PROGRAM.OUTPUT’:
"//’smith.program.output’"
//\’smith.program.output\’
To specify the fully qualified partitioned data set
’SMITH.PROGRAM.SOURCE(FILE1)’:
"//’smith.program.source(file1)’"
//\’smith.program.source\(file1\)\’
To specify the non-qualified partitioned data set PROGRAM.SOURCE(FILE1):
"//program.source(file1)"
//smith.program.source\(file1\)
Utilities supporting MVS data set names
The following utilities currently support the use of MVS filenames. Consult the
description for each utility for limitations and exceptions:
v cp
v mv
v pax
v tar
v c89
© Copyright IBM Corp. 1996, 2007 935