flam4_manual-flam4_commands-flam-show

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