PRINT

Purpose

The PRINT subcommand controls the writing of performance monitoring output to a virtual printer or to disk.

Format

Options

Notes:

¹ Not valid if ALL is specified.

Parameters

: The PRINT subcommand without any arguments causes all data to be printed which are available for the current display. In the case of the REDISPLAY screen, each display line may extend over up to three print lines (print width limited to 130 characters, regardless of actual output device).
This mode of operation was chosen to allow printing multiple reports in a single print file.
display: Can be any display that is to be printed.
ALL: Causes a collection of different performance reports to be printed. The reports to be printed must previously be defined in file FCONX REPORTS (see "FCONX REPORTS File" in the z/VM: Performance Toolkit Guide for a detailed description).
ON: Causes all performance data displayed on the screen to be also written to a virtual printer for later reference. Data extending beyond the screen will not be included.
This type of printing remains active until a 'PRINT OFF' subcommand is entered, i.e. you will get a complete log of all the data which you looked at on the screen.
OFF: Causes continuous printing of monitor output to be stopped, and the virtual printer to be closed. Make sure of the printer output routing before issuing the 'PRINT OFF' subcommand!
DISK: Causes the performance output data to be written to disk file 'FCONMON LISTING' instead of virtual printer. A carriage control character is included in the first column of each record, so that the file may still be printed using the 'CC'-option of the CMS 'PRINT' subcommand.
Once a 'PRINT ON DISK' subcommand has been entered, all monitor print output will be written to disk until a 'PRINT OFF' subcommand is received.

Options:

nnn

Can be used to define the maximum number of print lines nnn to be created. It is valid only for limiting the number of output lines of actual performance data displays. This option is useful especially to reduce the output size of the USER or DEVICE displays on large systems. (Make sure the lines are SORTed so that the meaningful information is contained in the first part of the display.)

Note: This option is supported for single displays only, i.e. it cannot be used if ALL is specified.

SORT sortarg

Indicates that the report is to be sorted as defined by the sort argument sortarg. The SORT option is valid only for reports that also support sorting in monitor mode, i.e. which are supported by the SORT subcommand. The same sort arguments can be used as with the SORT subcommand (see SORT for a detailed description).

Note: This option is supported for single displays only, i.e. it cannot be used if ALL is specified.

PAGEsize

Defines the number of lines to be printed consecutively before a skip to a new page is forced, and the header lines printed again at the top of the page.

mm: The maximum number of lines to printed.
OFF: Forces continuous printing, without insertion of intermediate header lines even if the print output extends over several pages.

Note: This option is supported for single displays only, i.e. it cannot be used if ALL is specified.

TO userid {AT nodeid}

Sets the destination address for the print output, where

userid

Is the user identification of the target virtual machine where the output is to be sent

AT nodeid

Specifies the node identification nodeid of the system where the destination user userid is located.

The destination ID is assumed to be defined on the same VM system if the 'AT nodeid' specification is omitted.

The print file will be closed automatically when a specific destination ID has been entered with the 'TO' option, i.e. the CLOSE option is implied and needs not be entered separately.

CLOSE

Lets the print file be closed when complete.

TOFILE fn {ft {fm}}

Indicates that the 'print' file is to be written to disk, where

fn: Is the file name of the disk file
ft: Is the file type of the disk file. A file type of LISTING will be used when no explicit file type is entered.
fm: Is the file mode of the disk file. A file mode of A1 will be used when no explicit file mode is entered.

Usage

The data printed will always be the same as what you see on your screen. Usually you will see data from the last interval unless an 'AVERAGE' subcommand has previously been entered to force calculation of average load figures.
The print file will not be closed automatically when the output is directed to the virtual printer. Use any one of the following methods to close the printer when you are done:
- 'CLOSE' option of the PRINT subcommand
- 'TO userid' option of the PRINT subcommand
- 'PRINT OFF' subcommand
- 'CP CLOSE PRT' subcommand
REDHist prints one screen's worth of the selected extended history file's data, or the full benchmark log on disk if an object's benchmark log has been selected. The file name, file type and file mode of a history file on disk can be specified with additional arguments fn ft fm; the current day's HISTLOG file is used as input if no further arguments are entered. Since these HISTLOG files can be very large, only a small subset - enough to fill a screen - will be printed.
REDisp causes all CPU redisplay data in storage to be printed. The file name, file type and file mode of a history file on disk can be specified with additional arguments fn ft fm; the performance redisplay data in storage are displayed if no further arguments are entered.