16.12.2012 Views

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

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

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

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

|<br />

|<br />

-ax Instructs the assembler to produce the DSECT Cross Reference<br />

topic of the assembler listing. This is equivalent to specifying:<br />

--DXREF.<br />

=file Specifies the file name of the listing output. If you do not specify a<br />

file name, the output goes to stdout.<br />

You may combine these options; for example, use -ams for an assembly<br />

listing with expanded macro and symbol output. The =file option, if used,<br />

must be specified last.<br />

-g Instructs the assembler to collect debug information. By default, the debug<br />

information is produced in DWARF Version 3 format (or --gdwarf3).<br />

--[no]gadata[=file]<br />

Instructs the assembler to collect associated data and write it to the<br />

associated data file. You can optionally specify the name of the output<br />

debug file. The specified name cannot be a PDS or z/<strong>OS</strong> <strong>UNIX</strong> file system<br />

directory name. If you do not specify a file name, the default name is<br />

created as follows:<br />

v If you are compiling a data set, the as command uses the source file<br />

name to form the name of the output data set. The high-level qualifier is<br />

replaced with the user ID under which the as command is running, and<br />

.ADATA is appended as the low-level qualifier. For example, if TS12345 is<br />

compiling TSMYID.MYSOURCE(src) with this option, the produced debug file<br />

name will be TS12345.MYSOURCE.ADATA(src).<br />

v If you are compiling a z/<strong>OS</strong> <strong>UNIX</strong> file, the as command stores the debug<br />

information in a file that has the name of the source file with an .ad<br />

extension. For example, if you are compiling src.a with this option, the<br />

compiler will create a debug file named src.ad.<br />

-moption<br />

HLASM keyword options are specified using the following syntax:<br />

-m[=[=][:[=]]...]<br />

where is an option name, is a suboption name, and<br />

is the suboption value.<br />

Keyword options with no parameters represent switches that may be either<br />

on or off. The keyword by itself turns the switch on, and the keyword<br />

preceded by the letters NO turns the switch off. For example, -mLIST tells<br />

the HLASM assembler to produce a listing and -mNOLIST tells the HLASM<br />

assembler not to produce a listing. If an option that represents a switch is<br />

set more than once, the HLASM assembler uses the last setting.<br />

Keyword option and parameter names may appear in mixed case letters in<br />

the invocation command.<br />

-I PDS Instructs HLASM to look for assembler macro invocation in the specified<br />

location. The PDS data set specified must be fully qualified. The specified<br />

locations are then prepended to a default set of macro libraries. The as<br />

command assumes a default set of macro libraries that is compatible with<br />

the defaults for the C/C++ compilers. The default data sets used are: -I<br />

CEE.SCEEMAC, -I SYS1.MACLIB, and -I SYS1.MODGEN. The default<br />

data sets can be changed via the environment variable _AS_MACLIB, for<br />

example:<br />

export _AS_MACLIB="FIRST.PDS:SECOND.PDS"<br />

as<br />

Chapter 2. Shell command descriptions 19

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!