Using SQR Print Command-Line Flags

The following table describes the SQR Print command-line flags:

Command-line Flag

Description

-A

Appends the output to an existing output file of the same name. If the file does not exist, it creates a new one. This flag is useful when you want to run the same report more than once, but you want to create only one output file.

-BURST:{xx}

Specifies the type of bursting to be performed.

-BURST:T generates the table of contents file only.

-BURST:S generates the report output according to the symbolic table of contents entries that are set in the program with the LEVEL argument of the TOC-ENTRY command. In -BURST:S[ {l} ], l is the level at which to burst. The -BURST:S setting is equivalent to -BURST:S1.

-BURST:P generates the report output by report page numbers. In -BURST:P[ {l}, {s} [, {s}] …] ], l is the number of logical report pages that each .htm file contains and s is the page selection: {n}, {n}-{m}, -{m}, or n-. The -BURST:P setting is equivalent to -BURST:P0,1- when using -PRINTER:HT or -BURST:P1 when using -PRINTER:EH.

Note: -BURST:P and -BURST:S require -PRINTER:EH or -PRINTER:HT. The page range selection feature of -BURST:P requires -PRINTER:HT.

BURST:T requires -PRINTER:HT.

-Dnn

(Non-Microsoft Windows) Displays the report output on the terminal at the same time that it is being written to the output file. The variable nn is the maximum number of lines that appear before pausing. If you do not enter a number after -D, the displayed output scrolls continuously. The printer type must be LP or no output appears. If the program is producing more than one report, then only the first report appears.

-E[file]

Directs error messages to the named file or to the default file, program.err. If no errors occur, no file is created.

Note: The following -EH flags are applicable only when either the −PRINTER:EH or −PRINTER:EP flag is specified.

-EH_APPLETS:dir

Specifies the directory location of the enhanced HTML applets. The default directory for theses applets is IMAGES.

-EH_BQD

Generates a {report}.bqd file from the report data. Also associates a BQD icon with {report}.bqd in the navigation bar.

-EH_BQD:file

Associates the BQD icon with the specified file.

-EH_BROWSER:xx

Specifies the target browser. When set to ALL, SQR automatically determines which browser is being used, invokes a browser-specific file, and generates HTML that is designed for that browser.

When set to BASIC, SQR generates HTML that is suitable for all browsers.

When set to IE, SQR generates HTML that is designed for Microsoft Internet Explorer.

-EH_CSV

Generates a {report}.csv file from the report data.

-EH_CSV:file

Associates the CSV icon with the specified file.

-EH_CSVONLY

Creates a CSV file, but does not create an HTML file.

-EH_FULLHTM L:xx

Switches between HTML 3.0 and HTML 3.2.

When set to TRUE, SQR generates HTML 3.2.

When set to FALSE, SQR generates HTML 3.0

-EH_Icons:dir

Specifies the directory in which the HTML should find the referenced icons.

-EH_LANGUAGE:xx

Sets the language that is used for the HTML navigation bar. You can specify English, French, German, Portuguese, Spanish, Japanese, Simplified Chinese, or Korean.

-EH_PDF

Associates a PDF icon with {report}.pdf in the navigation bar.

-EH_Scale:{nn}

Sets the scaling factor from 50 to 200.

-F[file | directory]

Overrides the default output file name, program.lis. The default action places program.lis in the same directory as the program.sqr file.

To use the current directory, specify -F without an argument.

To change the name of the output file, specify -F with the new name. If the new name does not specify a directory, the file is created in the current directory. The output file is not created until data is actually printed on the page. If no data is printed, no output file is created.

Specify these file names and directories for different operating systems:

  • UNIX\Linux

  • MVS

-ID

Displays the copyright banner on the console.

-O[file]

Directs log messages to the specified file or to programt.log if no file is specified. By default, the sqr.log file is used in the current working directory.

-P

(IBM MVS) Suppresses printer control characters from column 1.

-PRINTER:xx

Causes SQR to use printer type xx when creating output files:

  • EH

  • EP

  • HP

  • HT

  • LP

  • PD

Types LP, HP, and PS produce files with the .lis extension.

Types EH and HT produce .htm file output.

In Microsoft Windows systems, the WP extension sends output to the default Microsoft Windows printer. To specify a nondefault Microsoft Windows printer, enter -PRINTER:WP:{printer name}. The {printer name} is the name that is assigned to the printer. For example, to send output to a Microsoft Windows printer named NewPrinter, use -PRINTER:WP:NewPrinter. If your printer name has spaces, enclose the entire argument in quotes. If you also want to create an .spf file, use -KEEP.

-XB

(Non-Microsoft Windows) Suppresses the SQR banner and the SQR.... End of Run message.

-XNAV

Prevents SQR from creating the navigation bar in .htm files that are generated with -PRINTER:HT. This occurs when only a single .htm file is produced. Multiple .htm files that are generated from a single report always contain the navigation bar.

-XTB

Preserves the trailing blanks in a .lis file at the end of a line.

-XTOC

Prevents SQR from generating the table of contents for the report. This flag is ignored when -PRINTER:EH or -PRINTER:HT is also specified.

-ZIF{file}

Sets the full path and name of the SQR initialization file, pssqr.ini.

-ZMF{file}

Specifies the full path and name of the SQR error message file, sqr­err.dat.