High Level Assembler option summary

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 (z/OS and CMS) or library member ASMAOPT.USER (z/VSE).
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 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 have been specified in the following option sources:

ASMAOPT file
Invocation parameters
PROCESS statements including an example specifying the OVERRIDE keyword.

The example shows a number of error diagnostic messages relating to the conflicts and errors in the options specified.

                                        High Level Assembler Option Summary                                   Page    1
                                                                                               1          2 
                                                                                           HLASM R6.0  2008/07/11 17.48
 0  Overriding ASMAOPT Parameters - sysparm(thisisatestsysparm),rxref
    Overriding Parameters-  NOOBJECT,language(en),size(4meg),xref(short,unrefs),nomxref,norxref,adata,noadata
    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 NOADATA
 5   ALIGN
   NOASA
     BATCH
     CODEPAGE(047C)
   NOCOMPAT
 5 NODBCS
   NODECK
     DXREF
     ESD
   NOEXIT
 5   FLAG(0,ALIGN,CONT,EXLITW,NOIMPLEN,NOPAGE0,PUSH,RECORD,NOSUBSTR,USING0)
 5 NOFOLD
   NOGOFF
   NOINFO
 3   LANGUAGE(EN)
 5 NOLIBMAC
     LINECOUNT(60)
     LIST(121)
     MACHINE(,NOLIST)
 1   MXREF(FULL)
 3 NOOBJECT
     OPTABLE(UNI,NOLIST)
   NOPCONTROL
   NOPESTOP
   NOPROFILE
 5 NORA2
   NORENT
     RLD
 2   RXREF
     SECTALGN(8)
     SIZE(MAX)
   NOSUPRWARN
 2   SYSPARM(thisisatestsysparm)
   NOTERM

Figure 1. Option summary including options specified on *PROCESS statements

1                                         High Level Assembler Option Summary                                   Page    2
-                                                                                            HLASM R6.0  2008/07/11 17.48
0  NOTEST
     THREAD
   NOTRANSLATE
     TYPECHECK(MAGNITUDE,REGISTER)
     USING(NOLIMIT,MAP,WARN(15))
 3   XREF(SHORT,UNREFS)
   NOWORKFILE

   5 
   No Overriding DD Names
1                                              External Symbol Dictionary                                       Page    3
-Symbol   Type   Id     Address  Length   Owner Id Flags Alias-of                            HLASM R6.0  2008/07/11 17.48
0A         SD 00000001 00000000 00000000             00
1                                                                                                               Page    4
   Active Usings: None
0  Loc  Object Code    Addr1 Addr2  Stmt   Source Statement                                  HLASM R6.0  2008/07/11 17.48
                                          6 
0                                      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)
 000000                00000 00000    10 A        CSECT
                  R:F  00000          11          USING *,15

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 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 (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

A flag beside each option indicates the source of the option. This table shows the sources:

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

See Precedence of assembler options.