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

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
as
-o objectfile
Specifies the name of the object file. If the name specified is a PDS or
z/OS UNIX System Services directory name, a default file name is created
in the PDS or z/OS UNIX directory specified as follows:
v If the source file is a sequential data set, the second last part of the data
set name will be used. If the data set name only contains one part after
the high-level qualifier, then the last part will be used.
v If the source file is a PDS member, the member name will be used.
v If the source file is a z/OS UNIX file, the suffix will be removed if
applicable.
v If the object file is going into a PDS, the first eight characters of the
name will be used. If there is a dot, anything after the first dot will be
removed.
v If the object file is going into a z/OS UNIX directory, .o will be appended
to the name.
For example:
Source file: //’abc.hello.source’
Ouput file in PDS: HELLO
Output file in UNIX directory: hello.o
Source file: //’ABC.HELLO’
Ouput file in PDS: HELLO
Output file in UNIX directory: HELLO.o
Source file: //SOURCE(hello)
Ouput file in PDS: HELLO
Output file in UNIX directory: hello.o
Source file: /abc/hello.s
Ouput file in PDS: HELLO
Output file in UNIX directory: hello.o
Source file: /abc/hellothere.s
Ouput file in PDS: HELLOTHE
Output file in UNIX directory: hellothere.o
-v Writes the version of the as command to stderr.
--[no]gdwarf3[=file]
Instructs the assembler to generate debug information conforming to the
DWARF Version 3 format. Debugging tools (for example, dbx) can take
advantage of this debug information. You can optionally specify the name of
the output debug file. The file name of the output debug file must be a PDS
member, a sequential data set or z/OS UNIX System Services file; it cannot
be a PDS directory or z/OS UNIX System Services file system directory
name. If you do not specify a file name, the default name is created as
follows:
20 z/OS V1R9.0 UNIX System Services Command Reference
v If you are compiling a data set, the as command uses the source file
name to form the name of the output data set. The high-level qualifier is
replaced with the userid under which the as command is running, and
.DBG is appended as the low-level qualifier. For example, if TS12345 is
compiling TSMYID.MYSOURCE(src) with the -g option, the produced
debug file name will be TS12345.MYSOURCE.DBG(src).
v If you are compiling a z/OS UNIX System Services file, the as command
stores the debug information in a file that has the name of the source file
with a .dbg extension. For example, if you are compiling src.a with the
-g option, the produced debug file name will be src.dbg.