Hca.geocities.com/JLABELLE@rogers.com/nsasm/docs/c85.htmlca.geocities.com/JLABELLE_rogers.com/nsasm/docs/c85.htmldelayedxmJOKtext/htmlPS'b.HTue, 07 Dec 2004 00:53:01 GMT3Mozilla/4.5 (compatible; HTTrack 3.0x; Windows 98)en, *mJInvocation and Operation

Chapter 2. Invocation and Operation

Table of Contents
invoking asmcop
default file name and extensions
include file search order
help file search order
temporary file directory
error level return

This section discusses the invocation of asmcop, assembler options, search order for include and help files, and the default file names and extensions. See the release letter for installation instructions.

invoking asmcop

The assembler command line syntax is as follows:

asmcop.exe asmfile [,asmfile...]
[/chip=chip] [/model= {small | medium | larg}] [/pass=number]
[/define=symbol [=value]...] [/undefine=symbol...]
[/sym_debug]
[/localsymbols] [/constants] [/mlocal]
[/listfile [=filename]]
[/cnddirectives] [/cndlines] [/nocommentlines] [/crossref] [/nodatadirectives] [/noformfeed] [/noheadings] [/ilines] [/nomasterlist] [/nomcalls] [/nomcomments] [/nomdefinitions] [/mexpansions] [/mobject] [/nonumberlines] [/plength=number] [/pwidth=number] [/tablesymbols] [/tabs] [/verify]
[/errorfile [=file]] [/noerrorfile] [/objectfile [=filename]] [/noobjectfile]
[/include [=directory]...] [/xdirectory]
[/aserrorfile [=file]] [/remove]
[/complexrel] [/signedcompare]
[/nowarnings] [/quick] [/echo] [/nomemory]
[/save] [/restore]
[/sizesymbol=number(6..64)] [/uppercase]

The options can be placed in any order, before and/or after the asmfile[s]. The assembler options are not case sensitive and may be abbreviated to the minimum number of characters as specified by the documentation for each option.

asmcop.exe asmfile [,asmfile...]
[/ch=chip] [/mod= {s | m | l}] [/pa=number]
[/define=symbol [=value]...] [/undefine=symbol...]
[/sy]
[/lo] [/con] [/ml]
[/l [=filename]]
[/cndd] [/cndl] [/nocomm] [/c] [/noda] [/nof] [/noh] [/il] [/nom] [/nomca] [/nomco] [/nomd] [/mex] [/mo] [/non] [/pl=number] [/pw=number] [/t] [/tabs] [/v]
[/e [=file]] [/noe] [/o [=filename]] [/noo]
[/i [=directory]...] [/x]
[/a [=file]] [/r]
[/comp] [/sig]
[/now] [/q] [/ec] [/nomem]
[/sa] [/res]
[/siz=number(6..64)] [/up]

asmfile is the name of the source program. Multiple files may be assembled by joining them with a ,. This syntax was designed to allow the user to include standard definition files without having to specify them in each program. The default extension is .asm.

We use the phrase source program to describe the program input to one run of the assembler. The program may be in one or more files; how the source is partitioned into files doesn't change the meaning of the source.

The source program is a concatenation of the text in all the files, in the order specified. Each time you run asmcop it assembles exactly one source program. The source program is made up of one or more files.

asmcop without any parameters gives command line help information. If no options are specified the assembler defaults are used. Reference II, Assembler Options and Controls describes each option.

Any error detected on the invocation line causes the assembler to stop execution and display the part in error with an appropriate message.