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

file.p Specifies the name of a prelinker composite object file produced during the
c89/cc/c++ link-editing phase. By default, the composite object file is written
to a temporary file. To have the composite object file written to a permanent
file, see the environment variable prefix_TMPS under Environment
variables.
When a composite object file is produced by c89/cc/c++, the default name
is based upon the output file name. See the -o option under Options on
page 75, for information on the name of the output file.
If the output file is named a.out, then the composite object file is named
a.p, and is always in the working directory. If the output file is named
//a.load, then the composite object file is named //a.CPOBJ. If the output file
specified already has a suffix, that suffix is replaced. Otherwise the suffix is
appended. This file may also be specified on the command line, in which
case it is used as a file to be link-edited.
file.s Specifies the name of an assembler source file to be assembled. You can
specify an MVS data set name, by preceding the file name with double
slash (//), in which case the last qualifier of the data set name must be
ASM.
file.x Specifies the name of a definition side-deck produced during the
c89/cc/c++ link-editing phase when creating a DLL (Dynamic Link Library),
and used during the link-editing phase of an application using the DLL.
DLLs are further described under the -W option.
When a definition side-deck is produced by c89/cc/c++, the default name is
based upon the output file name. See the -o option under Options on page
75, for information on the name of the output file.
If the output file is named a.dll, then the definition side-deck is named a.x,
and is always in the working directory. If the output file is named //a.DLL,
then the definition side-deck is named //a.EXP. If the output file specified
already has a suffix, that suffix is replaced. Otherwise the suffix is
appended.
You can specify an MVS data set name to be link-edited, by preceding the
file name with double slash (//), in which case the last qualifier of the data
set name must be EXP.
Example: If a partitioned data set is specified, more than one member
name may be specified by separating each with a comma (,):
c89 //file.EXP(mem1,mem2,mem3)
c89, cc, and c++
–l libname
Specifies the name of an archive library. c89/cc/c++ searches for the file
liblibname.a in the directories specified on the -L option and then in the
usual places. The first occurrence of the archive library is used. For a
description of the usual places, see Usage Note 7 on page 99.
You can also specify an MVS data set; you must specify the full data set
name, because there are no rules for searching library directories.
The data set specified must be a C370LIB object library or a load library. If
a data set specified as a library has undefined (U) record format, then it is
assumed to be a load library. For more information about how load libraries
are searched, see Usage Note 7 on page 99.
Chapter 2. Shell command descriptions 83