Assembler options

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:
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.