High Level Assembler provides you with many assembler options for
controlling the operation and output of the assembler. You can set
default values at assembler installation time for most of these assembler
options. You can also fix a default option so the option cannot be
overridden at assembly time. See IBM-supplied default assembler options for
a list of the changes to the IBM-supplied default assembler options
from High Level Assembler Release 4.
You specify the options at assembly time on:
- An external file (z/OS and CMS) or library member (z/VSE)
- The JCL PARM parameter of the EXEC statement on z/OS and z/VSE,
or the ASMAHL command
on CMS.
- The JCL OPTION statement On z/VSE.
- The *PROCESS assembler statement.
The assembler options are:
- ADATA | NOADATA
- Produce
the associated data file.
- ALIGN | NOALIGN
- Check alignment of
addresses in machine instructions and whether DC, DS, DXD, and CXD
are aligned on correct boundaries.
- ASA | NOASA
- (z/OS and CMS) Produce the assembly listing
using American National Standard printer-control characters. If NOASA
is specified the assembler uses machine printer-control characters.
- BATCH | NOBATCH
- Specify multiple assembler
source programs are in the input data set.
- CODEPAGE(X'047C')
- Specify
the code page module to be used to convert Unicode character constants
- COMPAT(suboption) | NOCOMPAT
- Direct the assembler
to remain compatible with earlier assemblers in its handling of lowercase
characters in the source program, and its handling of sublists in
SETC symbols, and its handling of unquoted macro operands. The LITTYPE
suboption instructs the assembler to return 'U' as the type attribute
for all literals.
- DBCS | NODBCS
- Specify that the source
program contains double-byte characters.
- DECK | NODECK
- Produce an object module.
- DXREF | NODXREF
- Produce the DSECT
Cross Reference section of the assembler listing.
- ERASE | NOERASE
- (CMS) Delete specified
files before running the assembly.
- ESD | NOESD
- Produce the External
Symbol Dictionary section of the assembler listing.
- EXIT(suboption1,suboption2,…) |
NOEXIT
- Provide user exits to
the assembler for input/output processing.
- ADEXIT(name(string)) | NOADEXIT
- Identify the name of a user-supplied
ADATA exit module.
- INEXIT(name(string)) | NOINEXIT
- Identify the name
of a user-supplied SOURCE exit module.
- LIBEXIT(name(string)) | NOLIBEXIT
- Identify the name
of a user-supplied LIBRARY exit module.
- OBJEXIT(name(string)) | NOOBJEXIT
- Identify the name of a user-supplied OBJECT
exit module.
- PRTEXIT(name(string)) | NOPRTEXIT
- Identify the name
of a user-supplied LISTING exit module.
- TRMEXIT(name(string)) | NOTRMEXIT
- Identify
the name of a user-supplied TERM exit module.
- FAIL(suboption1,suboption2,…) |
NOFAIL
- MSG(msgval) | NOMSG
- Specify the minimum severity
messages which should have their severity raised.
- MNOTE(mnoteval) | NOMNOTE
- Specify the minimum
severity MNOTEs which should have their severity raised.
- MAXERRS(maxerrs) | NOMAXERRS
- Specify the number of error message to be issued before assembly
terminates.
- FLAG(suboption1,suboption2,…)
- Specify the level and
type of error diagnostic messages to be written.
- FOLD | NOFOLD
- Convert lowercase characters
to uppercase characters in the assembly listing.
- GOFF | NOGOFF
- (z/OS
and CMS) Set generalized object format.
- INFO | NOINFO
- Display service information
selected by date.
- LANGUAGE(EN | ES | DE | JP | UE)
- Specify the language
in which assembler diagnostic messages are presented. High Level Assembler
lets you select any of the following:
- English mixed case (EN)
- English uppercase (UE)
- German (DE)
- Japanese (JP)
- Spanish (ES)
When you select either of the English
languages, the assembler listing headings are produced in the same
case as the diagnostic messages.
When you select either the
German language or the Spanish language, the assembler listing headings
are produced in mixed case English.
When you select the Japanese
language, the assembler listing headings are produced in uppercase
English.
The assembler uses the default language for messages
produced on CMS by the High Level Assembler command.
- LIBMAC | NOLIBMAC
- Instruct the assembler
to imbed library macro definitions in the input source program.
- LINECOUNT(integer)
- Specify the number
of lines to print in each page of the assembly listing.
- LIST | LIST(121 | 133 | MAX) | NOLIST
- (z/OS and CMS) Specify whether
the assembler produces an assembly listing. The listing may be produced
in 121-character format or 133-character format.
- LIST | NOLIST
- (VSE only) Specify whether
the assembler produces an assembly listing.
- MACHINE([370 | S370XA | S370ESA | S390 | S390E |
ZSERIES | ZS | ZSERIES-2 | ZS-2 | ZSERIES-3 | ZS-3 | ZSERIES-4 | ZS-4
| ZSERIES-5 | ZS-5 | ZSERIES-6 | ZS-6 | ZSERIES-7 | ZS-7][,LIST |
NOLIST])
- Specify the operation
code table to use to process machine instructions in the source program.
A alternative to the OPTABLE option, the operands are also synonyms
of, but are not identical to, those of the OPTABLE option.
- MXREF | MXREF(FULL | SOURCE | XREF) | NOMXREF
- Produce the Macro
and Copy Code Source Summary, or the Macro and Copy Code Cross
Reference, or both, in the assembly listing.
- OBJECT | NOOBJECT
- Produce an object
module.
- OPTABLE([DOS | ESA | UNI | XA | 370 | YOP | ZOP |
ZS3 | ZS4 | ZS5 | ZS6 | ZS7 ][,LIST | NOLIST])
- Specify the operation
code table to use to process machine instructions in the source program.
- PCONTROL(suboption1,suboption2,…)
| NOPCONTROL
- Specify whether
the assembler should override certain PRINT statements in the source
program.
- PESTOP
- Specify that the
assembler should stop immediately if errors are detected in the invocation
parameters.
- PRINT | DISK | NOPRINT
- (CMS) Specify that
the assembler should write the LISTING file on the virtual printer.
- PROFILE | PROFILE(name) | NOPROFILE
- Specify the name
of a library member, containing assembler source statements, that
is copied immediately following an ICTL statement or *PROCESS statements,
or both. The library member can be specified as a default in the installation
options macro ASMAOPT.
- RA2 | NORA2
- Specify whether the assembler
is to suppress error diagnostic message ASMA066 when 2-byte relocatable
address constants are defined in the source program.
- RENT | NORENT
- Check for possible coding
violations of program reenterability.
- RLD | NORLD
- Produce the Relocation
Dictionary section of the assembler listing.
- RXREF
- Produce the Register
Cross Reference section of the assembler listing.
- SECTALGN(alignment)
- Specify the desired
alignment for all sections, expressed as a power of 2 with a range
from 8 (doubleword) to 4096 (page).
- SEG | NOSEG
- (CMS) Specify that assembler
modules are loaded from the Logical Saved Segment (LSEG).
- SIZE(value)
- Specify the amount of
virtual storage that the assembler can use for working storage.
- SUPRWARN(msgnum1,msgnum2,…) | NOSUPRWARN
- Specify one or more
message numbers, of warning (4) or less severity, to be suppressed.
- SYSPARM(value)
- Specify the character
string that is to be used as the value of the &SYSPARM system
variable.
- TERM(WIDE | NARROW) | NOTERM
- Specify whether error
diagnostic messages are to be written to the terminal data set On
z/OS and CMS, or SYSLOG On z/VSE.
- TEST | NOTEST
- Specify whether special
symbol table data is to be generated as part of the object module.
- THREAD | NOTHREAD
- Specify
whether or not the location counter is to be reset at the beginning
of each CSECT.
- TRANSLATE(AS | suffix) | NOTRANSLATE
- Specify whether
characters contained in character (C-type) data constants (DCs) and
literals should be translated using a user-supplied translation table.
The suboption AS directs the assembler to use the ASCII translation
table provided with High Level Assembler.
- TYPECHECK(suboption1,suboption2) | NOTYPECHECK
- Control whether
or not HLASM performs type checking of machine instruction operands.
- USING(suboption1,suboption2,…)
| NOUSING
- Specify the level of
monitoring of USING statements required, and whether the assembler
is to generate a USING map as part of the assembly listing.
- WORKFILE | NOWORKFILE
- If storage apart
from central storage is required during assembly, use the utility
file for temporary storage.
- XREF(SHORT | UNREFS | FULL) | NOXREF
- Produce the Ordinary
Symbol and Literal Cross Reference, or the Unreferenced Symbols
Defined in CSECTs, or both, in the assembly listing.