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

--[no]help
Help menu. Displays the syntax of the as command.
--[no]verbose
Specifies verbose mode, which writes additional information messages to
stdout.
file may be:
v An MVS data set (for example, //somename)
v An absolute z/OS UNIX file (for example, /somename)
v A relative z/OS UNIX file (for example, ./somename or somename)
The output of the as command is an object file. If you do not specify a file name via
the -o option, the default name is created as follows:
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
user ID under which the as command is running, and .OBJ is appended as the
low-level qualifier. For example, if TS12345 is compiling TSMYID.MYSOURCE(src),
the compiler will create an object file named TS12345.MYSOURCE.OBJ(src).
v If you are compiling a z/OS UNIX file, the as command names the object file with
the name of the source file with an .o extension. For example, if you are
compiling src.a, the object file name will be src.o.
Notes:
1. The as command does not accept standard input as a file.
2. The as command invokes the HLASM assembler to produce the object file. The
HLASM assembler is invoked with the default options ASA and TERM. The ASA
option instructs HLASM to use American National Standard printer control
characters in records written to the listing file, thus making the listing file more
readable in the UNIX System Services environment. The TERM option instructs
HLASM to write error messages to stderr. These defaults can be changed by
using the -m option or -- option.
3. HLASM messages and as error messages are directed to stderr. Verbose
option output is directed to stdout.
4. When invoking as from the shell, any option arguments or operands specified
that contain characters with special meaning to the shell must be escaped. For
example, source files specified as PDS member names contain parentheses; if
they are specified as fully qualified names, they contain single quotes. To
escape these special characters, either enclose the option argument or operand
in double quotes, or precede each character with a backslash.
asa — Interpret ASA/FORTRAN carriage control
Format
Description
asa [file ...]
Historically, printouts created by programs use the first character of each line to
control the spacing between that line and the previous one. For example, if the first
character is a space, the rest of that line immediately follows the previous line; if it
is a 1, that line should begin on a new page, and so on.
as
Chapter 2. Shell command descriptions 21