PRINT instruction
The PRINT instruction controls the amount of detail
printed in the listing of programs.
 .-,-------.
V |
>>-+-----------------+--PRINT----operand-+---------------------><
'-sequence_symbol-'
|
- sequence_symbol
- is a sequence symbol.
- operand
- is an operand from one of the groups of
operands described below. If a null operand is supplied, it is accepted
by the assembler with no effect on the other operands specified.
The operands are listed in hierarchic order.
The effect, if any, of one operand on other operands is also described.
 .-ON--.
>>-+-----+-----------------------------------------------------><
'-OFF-'
|
- ON
- instructs the assembler to print, or resume printing, the
source and object section of the assembler listing.
- OFF
- instructs the assembler to stop printing the source and
object section of the assembler listing. A subsequent PRINT ON
instruction resumes printing.
When this operand is specified the
printing actions requested by the
GEN, DATA, MCALL, and MSOURCE
operands do not apply.
 .-GEN---.
>>-+-------+---------------------------------------------------><
'-NOGEN-'
|
- GEN
- instructs the assembler to print all statements generated by the
processing of a macro. This operand does not apply if PRINT OFF
has been specified.
- NOGEN
- instructs the assembler not to print
statements generated by
conditional assembly or
the processing of a macro.
This applies to all levels of macro nesting; no generated code
is displayed while PRINT NOGEN is in effect.
If this operand is specified, the DATA
operand does not apply to constants that are generated during macro
processing. Also, if this operand is specified, the MSOURCE operand
does not apply.
When the PRINT NOGEN instruction is in effect, the assembler prints one
of the following on the same line as the macro call or model
statement:
- The object code for the first instruction generated. The object
code includes the data that is shown under the ADDR1 and ADDR2
columns of the assembler listing.
- The first 8 bytes of generated data from a DC instruction
When the assembler forces alignment of an instruction or data
constant, it generates zeros in the object code and prints the generated
object code in the listing. When you use the PRINT NOGEN instruction the
generated zeros are not printed.
Note:
If the next line to print after macro call or model statement
is a diagnostic message, the object code or
generated data is not shown in the assembler listing.
The MNOTE instruction always causes a message to be printed.
 .-NODATA-.
>>-+--------+--------------------------------------------------><
'-DATA---'
|
- NODATA
- instructs the assembler to print only the first 8 bytes of the
object code of constants. This operand does not apply if PRINT OFF has
been specified. If PRINT NOGEN has been specified, this operand does
not apply to constants generated during macro processing.
- DATA
- instructs the assembler to print the object code of all constants in
full. This operand does not apply if PRINT OFF has been specified. If
PRINT NOGEN has been specified, this operand does not apply to constants
generated during macro processing.
 .-NOMCALL-.
>>-+---------+-------------------------------------------------><
'-MCALL---'
|
- NOMCALL
- instructs the assembler to suppress the printing of nested macro
call instructions.
- MCALL
- instructs the assembler to print nested macro call instructions,
including the name of the macro definition to be processed and the
operands and values passed to the macro definition.
The assembler only prints the operands and comments up to the
size of its internal processing buffer. If this size is exceeded
the macro call instruction is truncated, and the characters
... MORE are added to the end of the
printed macro call. This does not affect the processing of the
macro call.
This operand does not apply if either PRINT OFF or PRINT NOGEN
has been
specified.
 .-MSOURCE---.
>>-+-----------+-----------------------------------------------><
'-NOMSOURCE-'
|
- MSOURCE
- instructs the assembler to print the source
statements generated during
macro processing, as well as the assembled addresses
and generated object
code of the statements. This operand does not apply
if either PRINT OFF
or PRINT NOGEN has been specified.
- NOMSOURCE
- instructs the assembler to suppress the printing
of source statements generated
during macro processing, without suppressing the
printing of the assembled
addresses and generated object code of the statements. This operand
does not apply if either PRINT OFF or PRINT NOGEN has been specified.
 .-UHEAD---.
>>-+---------+-------------------------------------------------><
'-NOUHEAD-'
|
- UHEAD
- instructs the assembler to print a summary of active USINGs following
the TITLE line on each page of the source and object program section
of the assembler listing. This operand does not apply if PRINT OFF has
been specified.
- NOUHEAD
- instructs the assembler not to print a summary of active USINGs.
 >>-+---------+-------------------------------------------------><
'-NOPRINT-'
|
- NOPRINT
- instructs the assembler to suppress the printing of the PRINT
statement in which it is specified. The NOPRINT operand may only be
specified in conjunction with one or more other operands.
The PRINT instruction can be specified any number of times in a source
module, but only those operands actually specified in the
instruction change the current print status.
PRINT options can be generated by macro processing during conditional
assembly. However, at assembly time, all options are in force until the
assembler encounters a new and opposite option in a PRINT instruction.
The PUSH and POP instructions, described in PUSH instruction and
POP instruction,
also influence the PRINT options by saving and restoring the PRINT
status.
You can override the effect of the operands of the PRINT instruction
by using the PCONTROL assembler
option. For more information about this option, see the section
"PCONTROL" in the HLASM Programmer's Guide.
Unless the NOPRINT operand is specified, or the assembler listing
is suppressed by the NOLIST assembler option, the PRINT instruction
itself is printed.
[ Top of Page | Previous Page | Next Page | Contents | Index ]