Running the tas Program

The tas command line interface program for the Tachyon z/Assembler accepts command line parameters that are similar to those accepted by the GNU assembler in the binutils package of Linux for S/390 and zSeries.

The command line syntax for the tas program is:

tas [{-m31|-m64|-goff}] [{-mesa|-mzarch}]
    [{-march=g5|-march=g6|-march=z900|-march=z990|-march=z9-109|-march=z9-ec|-march=z10|-Aesa|-Aesame}]
    [-f] [-v] [-W] [-a[{dlhns}][=listing-file-name]]
    [-o object-file-name] [source-file-name]
Where:
tas
The command line interface program is tas. If the directory containing the tas program is not in the PATH, then the path name must be specified. e.g. C:\Tachyon\tas
-m31
The -m31 parameter specifies that the GNU assembler source input file was generated by GCC using the -m31 parameter and thus contains 31-bit code for Linux for S/390. The object file will be generated for Linux for S/390 in 31-bit ELF format. The -m31 parameter may not be specified with -mzarch, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10 or -Aesame or any of the other object format parameters (-m64 or -goff).
-m64
The -m64 parameter specifies that the GNU assembler source input file was generated by GCC using the -m64 parameter and thus contains 64-bit code for Linux for zSeries. The object file will be generated for Linux for zSeries in 64-bit ELF format. The -m64 parameter may not be specified with -mesa, -march=g5, -march=g6 or -Aesa or any of the other object format parameters (-m31 or -goff).
-goff
The -goff parameter specifies that the input source file contains 31-bit GNU assembler source code and that the object file is to be generated for OS/390 or z/OS in GOFF format. The -goff parameter may not be specified with -mzarch, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10 or -Aesame or any of the other object format parameters (-m31 or -m64).

If none of the object format parameters (-m31, -m64 or -goff) are set, then the default depends on other parameter values as follows:

-mzarch, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10 or -Aesame:
-m64
-mesa, -march=g5, -march=g6, -Aesa or -o parameter not set:
-m31
-mesa
The -mesa parameter specifies that target CPU mode is ESA/390 and sets defaults for other parameters to -march=g6 and -m31. The -mesa parameter may not be specified with -m64, -mzarch, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10 or -Aesame.
-mzarch
The -mzarch parameter specifies that target CPU mode is z/Architecture and set defaults for other parameters to -march=z900 and -m64. The -mzarch parameter may not be specified with -goff, -m31, -mesa, -march=g5, -march=g6 or -Aesa.
-march=g5 | -march=g6 | -Aesa
These parameters specify that target architecture is ESA/390 on a G5 or G6 processor. For this assembler, there is no difference between -march=g5 and -march=g6. These parameters may not be specified with -m64 or -mzarch and only one of the architecture parameters (-march=g5, -march=g6, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10, -Aesa or -Aesame) may be specified.
-march=z900 | -Aesame
These parameters specify that target architecture is z/Architecture on a z900 or z800 processor. These parameters may not be specified with -goff, -m31 or -mesa and only one of the architecture parameters (-march=g5, -march=g6, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10, -Aesa or -Aesame) may be specified.
-march=z990
The -march=z990 parameter specifies that target architecture is z/Architecture on a z990 or z890 processor. The -march=z990 parameter may not be specified with -goff, -m31 or -mesa or any of the other architecture parameters (-march=g5, -march=g6, -march=z900, -march=z9-109, -march=z9-ec, -march=z10, -Aesa or -Aesame).
-march=z9-109 | -march=z9-ec
These parameters specify that target architecture is z/Architecture on a System z9 processor. These parameters may not be specified with -goff, -m31 or -mesa or any of the other architecture parameters (-march=g5, -march=g6, -march=z900, -march=z990, -march=z10, -Aesa or -Aesame).
-march=z10
The -march=z10 parameter specifies that target architecture is z/Architecture on a System z10 processor. The -march=z10 parameter may not be specified with -goff, -m31 or -mesa or any of the other architecture parameters (-march=g5, -march=g6, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -Aesa or -Aesame).

If none of the architecture parameters (-march=g5, -march=g6, -march=z900, -march=z990, -march=z9-109, -march=z9-ec, -march=z10, -Aesa or -Aesame) are set, then the default depends on other parameter values as follows:

-m64 or -mzarch:
-march=z900
-m31, -mesa, -goff or object file and format not set:
-Aesa
-f
The -f (fast) parameter tells the GNU assembler that the source file was created by a compiler and thus does not need to be preprocessed. Since the Tachyon z/Assembler does not ever preprocess GNU assembler code, it always runs as if the -f parameter is specified.
-v
The -v (verbose) parameter instructs Tachyon z/Assembler to run with the MSGLEVEL(2,1) option. If the -v parameter is not specified, the assembler is run with the MSGLEVEL(1,0) option.
-W
The -W parameter tells the GNU assembler to supress warning messages. For the Tachyon z/Assembler, the -W parameter causes the assembler to run with the FLAG(4) option. If the -W parameter is not set, the assembler is run with the FLAG(0) option.
-a[{dlhns}][=listing-file-name]
The -a parameter tells the GNU assembler to produce a listing file, the d, l, h, n and s options tell the GNU assembler which reports to produce, and the listing-file-name sets the file name of the listing. Likewise, the -a option instructs the Tachyon z/Assembler to produce a listing, which reports to produce and optionally overrides the default listing file name. If the -a parameter is not set, the Tachyon z/Assembler does not generate a listing file. If none of the report options are specified, the default is hls. The l option is for the assembly listing and the s is for the symbol cross reference. The Tachyon z/Assembler ignores the other report options. If the -a parameter is specified without the listing-file-name, then the file name from the default SYSPRINT option is used.
-o object-file-name
The -o parameter tells the GNU assembler and the Tachyon z/Assembler to produce an object file and specifies the name of the object file. The blank character between the -o parameter and the file name can be omitted. The object file will be produced in GOFF format if the -goff option is set, in 64-bit ELF format if the -m64 option is set or in 31-bit ELF format if none of these options are set.
source-file-name
The name of the input source file is required unless the input is piped or redirected to stdin.

Tachyon z/Assembler Options

The tas programs always disables macro processing by the Tachyon z/Assembler. When macro processing is disabled, the following options are also disabled and not printed in the option listing: If the tas program is run without a Tachyon z/Assembler license, the following options are also disabled:


Frames No Frames Previous Next Contents
Introduction Setup Running Options Macros Translation Compatibility Messages
© Copyright 2002-2008, Tachyon Software® LLC.
Last modified on March 19, 2008