Listing inclusion and exclusion directives

    Format

      .SHOW  [argument-list]

      .NOSHOW  [argument-list]

1  –  Parameter

 [argument-list]

    You can use either the long form or the short form of the
    arguments. If you specify multiple arguments, you must separate
    them by commas. If any argument is not specifically included in
    a listing control statement, the assembler assumes its default
    value (show or noshow) throughout the source program.

    Table 10 .SHOW and .NOSHOW Symbolic Arguments

                  Short
    Long Form     Form     Default  Function

    BINARY        MEB      Noshow   Lists macro and repeat block
                                    expansions that generate binary
                                    code. BINARY is a subset of
                                    EXPANSIONS.
    CONDITIONALS  CND      Noshow   Lists unsatisfied conditional
                                    code associated with the
                                    conditional assembly directives.
    EXPANSIONS    ME       Noshow   Lists macro and repeat range
                                    expansions.
    LIBRARY       None     Noshow   Includes the macro definitions in
                                    a library in the listing.
    INCLUDE       None     Noshow   Lists include file text in the
                                    listing file.

2  –  Description

    .SHOW and .NOSHOW specify listing control options in the source
    text of a program. You can use .SHOW and .NOSHOW with or without
    an argument list.

    .SHOW and .NOSHOW control the listing of the source lines that
    are in conditional assembly blocks (see the description of .IF),
    macros, and repeat blocks. When you use them without arguments,
    these directives alter the listing level count. The listing level
    count is initialized to 0. Each time .SHOW appears in a program,
    the listing level count is incremented; Each time .NOSHOW appears
    in a program, the listing level count is decremented.

    When the listing level count is negative, the listing is
    suppressed unless the line contains an error. Conversely, when
    the listing level count is positive, the listing is generated.
    When the count is 0, the line is either listed or suppressed,
    depending on the value of the listing control symbolic arguments.

3  –  Notes

    o  The listing level count allows macros to be listed
       selectively; a macro definition can specify .NOSHOW at the
       beginning to decrement the listing count and can specify .SHOW
       at the end to restore the listing count to its original value.

    o  The alternate forms of .SHOW and .NOSHOW are .LIST and .NLIST.

    o  The initial setting for each .LIST/.SHOW option (except
       BINARY) is obtained from the command-line setting using the
       /SHOW qualifier.

    o  The /[NO]SHOW=BINARY option overrides the .[NO]SHOW BINARY
       directive.

4  –  Example

        .NOSHOW   ; Turn off listing file display.  Counter < 0.
           .
           .
           .
        .SHOW     ; Turn on listing file display.  Counter = 0.
                  ; Value of .SHOW options are used.
           .
           .
           .
        .SHOW     ; Counter > 0.  Listing file display is
                  ; on for all options regardless of setting.
           .
           .
           .