High Level Assembler provides a summary of the options current
for the assembly, including:
A list of the overriding parameters specified in the ASMAOPT file
A list of the overriding parameters specified when the assembler
was called
The options specified on *PROCESS statements
In-line error diagnostic messages for any overriding parameters
and *PROCESS statements in error
You cannot suppress the option summary
unless you suppress the entire listing, or you supply a user exit
to control which lines are printed.
On z/OS® and CMS, High Level Assembler provides a sample
LISTING exit to suppress the option summary or print it at the end of the listing. See Sample LISTING user exit (z/OS and CMS).
Figure 1 shows an example of the High Level Assembler Option Summary. The
example includes assembler options that are specified in the following option sources:
ASMAOPT file
Invocation parameters
PROCESS statements that includes an example specifying the OVERRIDE keyword.
The example shows a number of error diagnostic messages that relates to the conflicts and errors
in the options specified.
High Level Assembler Option Summary (PTF R160 ) Page 1
1 2
HLASM R6.0 2015/02/20 18.42
Overriding ASMAOPT Parameters -
>* Input ASMAOPT Statement
>sysparm(thisisatestsysparm),rxref
>LIST(MAX)
Overriding Parameters- NOOBJECT,LANGUAGE(EN),SIZE(4MEG),XREF(SHORT,UNREFS),NOMXREF,NORXREF,ADATA,NOADATA,GOFF
Process Statements- OVERRIDE(ADATA,MXREF(full))
ALIGN
noDBCS
MXREF(FULL),nolibmac
FLAG(0)
noFOLD,LANGUAGE(ue)
NORA2
NODBCS
XREF(FULL)
3
** ASMA400W Error in invocation parameter - SIZE(4MEG)
** ASMA438N Attempt to override ASMAOPT parameter. Option NORXREF ignored.
** ASMA425N Option conflict in invocation parameters. NOADATA overrides an earlier setting.
** ASMA423N Option ADATA, in a *PROCESS OVERRIDE statement conflicts with invocation or default option. Option is not permitted in a *PROCESS statement and has been ignored.
** ASMA422N Option LANGUAGE(ue) is not valid in a *PROCESS statement.
** ASMA437N Attempt to override invocation parameter in a *PROCESS statement. Suboption FULL of XREF option ignored.
Options for this Assembly
4
3 Invocation Parms NOADATA
5 *PROCESS ALIGN
NOASA
BATCH
CODEPAGE(047C)
NOCOMPAT
5 *PROCESS NODBCS
NODECK
DXREF
ESD
NOEXIT
FAIL(NOMSG,NOMNOTE,MAXERRS(500))
5 *PROCESS FLAG(0,ALIGN,CONT,EXLITW,NOIMPLEN,NOPAGE0,PUSH,RECORD,NOSUBSTR,USING0)
5 *PROCESS NOFOLD
3 Invocation Parms GOFF(NOADATA)
NOINFO
3 Invocation Parms LANGUAGE(EN)
5 *PROCESS NOLIBMAC
LINECOUNT(60)
2 ASMAOPT LIST(MAX)
MACHINE(,NOLIST)
1 *PROCESS OVERRIDE MXREF(FULL)
3 Invocation Parms NOOBJECT
OPTABLE(UNI,NOLIST)
NOPCONTROL
NOPESTOP
NOPROFILE
5 *PROCESS NORA2
NORENT
RLD
2 ASMAOPT RXREF
SECTALGN(8)
Figure 1. Option
summary including options specified on *PROCESS statements
High Level Assembler Option Summary (PTF R160 ) Page 2
HLASM R6.0 2015/02/20 18.42
SIZE(MAX)
NOSUPRWARN
2 ASMAOPT SYSPARM(thisisatestsysparm)
NOTERM
NOTEST
THREAD
NOTRANSLATE
TYPECHECK(MAGNITUDE,REGISTER)
USING(NOLIMIT,MAP,WARN(15))
NOWORKFILE
3 Invocation Parms XREF(SHORT,UNREFS)
5
No Overriding DD Names
External Symbol Dictionary Page 3
Symbol Type Id Address Length Owner Id Flags Alias-of HLASM R6.0 2015/02/20 18.42
SAMP01 SD 00000001
B_IDRL ED 00000002 00000001
B_PRV ED 00000003 00000001
B_TEXT ED 00000004 00000000 0000006C 00000001 00
SAMP01 LD 00000005 00000000 00000004 00
ENTRY1 LD 00000006 00000000 00000004 00
DateRcvd ER 00000007 00000001 RCNVDATE
RCNVTIME ER 00000008 00000001
Page 4
Active Usings: None
Loc Object Code Addr1 Addr2 Stmt Source Statement HLASM R6.0 2015/02/20 18.42
6
1 *PROCESS OVERRIDE(ADATA,MXREF(full))
2 *PROCESS ALIGN
3 *PROCESS noDBCS
4 *PROCESS MXREF(FULL),nolibmac
5 *PROCESS FLAG(0)
6 *PROCESS noFOLD,LANGUAGE(ue)
7 *PROCESS NORA2
8 *PROCESS NODBCS
9 *PROCESS XREF(FULL)
Sample Program - HLASM Page 5
Active Usings: None
Loc Object Code Addr1 Addr2 Stmt Source Statement HLASM R6.0 2015/02/20 18.42
11 ***********************************************************************
12 * *
13 * Licensed Materials - Property of IBM *
14 * *
15 * 5696-234 *
16 * *
17 * Copyright IBM Corporation 2008, 2015 All Rights Reserved. *
18 * *
19 * US Government Users Restricted Rights - Use, duplication *
20 * or disclosure restricted by GSA ADP Schedule Contract *
21 * with IBM Corp. *
22 * *
23 ***********************************************************************
00000000 00000000 0000006C 24 Samp01 Csect
25 ASMDREG include standard registers
26+ PUSH PRINT 01-ASMDREG
126+ POP PRINT 01-ASMDREG
127 Entry1 MACSAMP Parm1=YES
00000000 18CF 128+Entry1 LR 12,15 01-MACSAMP
129+ ENTRY Entry1 01-MACSAMP
R:C 00000000 130+ USING Entry1,12 Ordinary Using 01-MACSAMP
The highlighted numbers in the example are:
1
The product description. Shown on each page of the assembler
listing. (You can use the TITLE instruction to generate individual
headings for each page of the source and object program listing.)
2
The date and the time of the assembly.
3
Error diagnostic messages for overriding parameters and *PROCESS
statements. These messages immediately follow the list of *PROCESS
statement options. The error diagnostic messages are:
ASMA400W -
The value specified as the size option is not valid. The valid
option is SIZE(4M).
ASMA438N -
The option RXREF is specified in the ASMAOPT file and the conflicting
option NORXREF is specified as an invocation parameter. The ASMAOPT
options have precedence over the invocation parameters and the NORXREF
option is ignored.
ASMA425N -
The ADATA option specified as an invocation parameter overrides the option NOADATA, which was
also specified as an invocation parameter. When conflicting options are received from the same
source, the last occurrence takes precedence.
ASMA423N -
The option ADATA is specified in a *PROCESS statement with the OVERRIDE option. The option
cannot be set by a *PROCESS statement, and the option conflicts with an invocation or default
option. This message is printed when an option that cannot be set by a *PROCESS statement (See *PROCESS statement options) is included in a *PROCESS OVERRIDE statement and the option conflicts
with an invocation or default option. If the option does not conflict with the invocation or default
option no message is printed.
ASMA422N -
The option LANGUAGE is not permitted in a *PROCESS statement.
ASMA437N -
The option XREF(FULL), which is specified in the last *PROCESS statement conflicts with the
option NORXREF, which is specified as an invocation parameter. The option XREF(FULL) is
ignored.
4
Each option can be preceded by a flag that indicates the option’s source.
If the flag is omitted, the option came from the installation defaults.
Table 1. Flags used in the option summary
Flag
Meaning
1
The option came from a *PROCESS OVERRIDE statement.
2
The option came from the ASMAOPT options file (z/OS and CMS) or ASMAOPT.USEROPT library member (z/VSE®).
3
The option came from the invocation parameters.
4
The permanent job control options set by the z/VSE command STDOPT.
5
The option came from a *PROCESS statement.
(space)
The option came from the installation defaults.
5
On z/OS and CMS, if the assembler is called by a program
and any standard (default) ddnames is overridden, both the default ddnames and the overriding
ddnames are listed. Otherwise, this statement appears:
No Overriding DD Names
6
The *PROCESS statements are written as comment statements in the
Source and Object section of the listing.