#### SHOW

#### Synopsis

    HELP:   Specifies which information should be shown and if processing [ALL]
    TYPE:   NUMBER
    SYNTAX: SHOW/SH=ALL/DIR/ATTRIBUTE/ERROR/NONE

#### Description

This parameter specifies which information should be shown in the FLAM control protocol.

This parameter corresponds to parameter INFO.

This parameter controls the information output by FLAM. You can choose between detailed information (all), error messages and warnings either with or without statistics (error or statistics) and no information (none).

During the decompression procedure, you can decide just to show the information about the original file, without creating a decompressed file. Use `show=attributes` to do so.

If the FLAMFILE contains compressed versions of several files, the information about each of the original files is shown one file at a time. However, this information is only shown, if this was specified when the files were compressed into the FLAMFILE (see parameter ATTRIBUTES).

If `-show=attributes` is specified, parameter FLAMOUT is ignored.

Syntax restrictions for FLAMv4 or older:

- z/OS
  - `SHOW=ALL/NONE/ATTRIBUT/ERROR/DIR`
  - `SH=ALL/NONE/ATTRIBUT/ERROR/DIR`
- UNIX
  - `-show=none/all/attributes/error/statistics`
- WINDOWS
  - `show=none/all/attributes/error/statistics`
  - `sh=none/all/attributes/error/statistics`

Values

- z/OS
  - `ALL` - All messages and statistics - generate and display.
  - `NONE` - Don't display messages.
  - `ATTRIBUT` - Display the parameters for compression or decompression but do not execute processing.
  - `ERROR` - Display error messages and end-of-program message only.
  - `DIR` - The names of all files (and their attributes) that are to be processed are listed.
- UNIX
  - `none` - No information is shown.
  - `all` - All the available information is shown. This depends on the invoked operation (compress or decompress), but not on whether FLAM was invoked directly or using the parameter file.
    - The following information is shown during the compression procedure:
      - FLAM version
      - FLAM settings
        - Operation (compress)
        - Code table
        - Compression mode
        - Matrix buffer size
        - Maximum number of records/matrix buffer
        - Character set (ASCII or EBCDIC)
        - attributes setting
      - Name of the original file
      - Formatting information for the original file
      - Name of the compressed file (FLAMFILE)
      - Formatting information for the compressed file
      - Statistical information (see show=statistics)
      - Error messages and warnings
    - The following information is shown during the decompression procedure:
      - FLAM version
      - FLAM settings:
        - Operation (decompress)
        - Code table (only if the FLAM call includes the necessary specifications)
      - Name of the compressed file (FLAMFILE)
      - Name of the decompressed file
      - Formatting information for the decompressed file
      - Saved compression information (see `show=attributes`)
      - Statistical information (see `show=statistics`)
      - Error messages and warnings
  - `attributes` - (Decompression only)
    This suppresses creation of the decompressed file.
    Only the saved compression information is shown:
    - Name of the original file (only if `-attributes=all` was specified when it was compressed).
    - Formatting information for the original file.
    - Compression mode.
    - Character set (ASCII or EBCDIC).
    - System which created the FLAMFILE.
  - `error` - Only error messages and warnings are shown.
  - `statistics` - Error messages, warnings and the following statistics are shown:
    - Number of compressed records
    - Number of compressed bytes
    - Number of non-compressed records
    - Number of non-compressed bytes
    - Compression efficiency as compared with the original file (compression only)
      This efficiency is the ratio of the number of bytes actually read to the number of bytes output and is specified as a percentage. Record size fields, record delimiters and characters for padding compressed records are not taken into account
  - Note: Message outputs can be redirected to a file by specifying `2>>filename`. If `-msgfile=filename` is specified, on the other hand, the FLAM messages are written into a file, but system messages continue to be displayed on the screen.
- WINDOWS
  - `none` - no display.
  - `all` - Shows all of the information available. The information depends on the invoked operation, compression or decompression, but not on the circumstance if FLAM was called directly or with a parameter file.
  - `attributes` - decompression only
    suppresses the creation of the decompressed file.
    only shows the saved compression information:
    - name of the original file (only if compressed with `attributes=all`)
    - format specifications of the original file
    - compression mode
    - character set ASCII or EBCDIC
      - system which generated the FLAMFILE
  - `error` - only shows error and warning messages.
  - `statistics` - shows error and warning messages plus the number of compressed records.

Default

- z/OS
  - ALL
- UNIX
  - none (No information is shown/no display)
- WINDOWS
  - none (No information is shown/no display)

Valid for

- compression
- decompression

#### Selections

- `ALL - Print messages and statistics (default)`
- `DIR - Printouts of file names but no processing`
- `ATTRIBUTE - Printouts but no processing`
- `ERROR - Only errors and error trace are logged`
- `NONE - No logging`