High Level Assembler provides a summary of the options current
for the assembly, including:
A list of the overriding parameters specified in the external
file or library member (z/VSE® only)
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 that allows you to suppress the option summary or print it at the end of the listing.
See the description of the sample LISTING exit.
Figure 1 shows an example of
the High Level Assembler Option Summary. The example includes
assembler options that have been specified in the external file or
library member, the invocation parameters and in *PROCESS statements.
It also shows the *PROCESS statements in the Source and Object section
of the listing.
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 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 has been 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 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.
(For more information on *PROCESS statement, refer to *PROCESS statement options in the HLASM Programmer's Guide
information.)
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 may 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 VSE
command STDOPT.
5
The option came from a *PROCESS statement.
(blank)
The option came from the installation defaults.
5
On z/OS and CMS, if the
assembler has been called by a program and any standard (default)
DDnames have been 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.