|
All masks produced by CFS can be captured to a file. CFS will capture the screens with correct line and column justification. In addition to screens, the executed Actions can also be captured.
Hardcopy mode is set with the HC command. From this point on, all masks and Actions in the main CFS task will be captured. Hardcopy mode can be reset with the NHC command (No HardCopy).
Without explicitly switching on the hardcopy mode, individual screens from the main CFS task (e.g. a section of the current Display file) can be captured by pressing F3 . It should be noted that each screen captured with F3 will appear in the listing on a new page. This is in contrast to the normal hardcopy mode (HC command), where multiple screens can appear on a single page. Transmitting a mask with the F3 key will cause CFS to behave as though DUE1 had been pressed, irrespective of the hardcopy function.
Input/output can also be captured to a hardcopy file for all Connections opened with OC. The hardcopy mode can be activated in two different ways for Connections. An HC [file] [,params] command can be issued in the Connection itself, or an HCn command can be issued from the main task of CFS. The hardcopy mode is reset by issuing an NHC command from within the Connection, or NHCn from the COMMAND field in the main mask.
The hardcopy command and its parameters are described below.
HC [n] [file] [, L] [, B] [, T] [, E|O] [, A|F] [, G|I] [, S] [, R] [, RS]
All of the HC command switches are optional. If any option is not specified, the default value will apply.
n If the hardcopy mode is to be activated from the CFS main task for a particular Connection n, then n must be specified in the HC command.
If n is not specified, the hardcopy mode will be set for the main task of CFS.
If the user is already in a Connection, n does not have to be specified in the HC command in order to activate the hardcopy mode for that Connection.
file Name of the file in which the hardcopy should be saved. The hardcopy file will always be created in the userid under which the main CFS task is running. Separate hardcopy files for each Connection can be created.
If the specified hardcopy file exists, and neither the O nor the E options have been specified (see below), then the user will be asked whether the existing file should be overwritten or not.
If the hardcopy process is temporarily switched off (NHC) in a Connection, and then activated again at a later stage (HC), then the last file to have been opened will be extended.
If no file name is specified in a Connection for the first HC command, then a file with the default name of CFS.HARDCOPY.yymmdd.hhmm.tsn will be created.
The hardcopy file will be created in a laser printable format (ND-/HPFILE). Bright/half-bright, and protected/unprotected fields can be printed as displayed by using the laser option.
Hardcopy files created with the L option can be printed out using the /DO CFS.DO.PRINT,file procedure.
This DO procedure, together with the associated CFS.ND-/HPFILE must exist under TSOS, and be cataloged as shareable. The system administrator must match the PROC parameters to the HP-/NDFILE, as well as to the character set. Information on how to do this is contained in the procedure file.
Standard: L option is not set, i.e. the hardcopy file will be created in normal print format.
B Before Images (only in Connections):
Both the contents of the mask before the user effects any input, and the usual contents after any input, are saved.
Standard: B option is not set, i.e. no Before images.
The captured input/output is saved to the hardcopy file, together with the date and time.
Standard: T option is not set, i.e no time stamping.
E If the specified hardcopy file already exists, it will be opened in Extend mode.
O The specified hardcopy file will be opened in Output mode, i.e. the previous contents will be overwritten. Instead of 'O', 'N' (New file) can be given.
Standard: If a file with the specified name already exists, the user will be asked whether the existing file should be overwritten or extended.
A | F 1) With laser preparation (L option set):
A The screen display control codes will be checked for bright/half-bright fields. Half-bright fields will be printed in a grey shaded font.
F The field control codes will be checked for protected/unprotected fields. Protected fields will be printed in a grey shaded font.
The A and F options may not be specified together.
Standard: A option is set (display control codes will be evaluated).
2) Without laser preparation (L option not set):
F The IS2 sequences will also be saved to the hardcopy file. This provides the user with the opportunity of converting these IS2 sequences into any user-specific control sequence.
A The IS3 sequences will also be saved to the hardcopy file. This provides the user with the opportunity of converting these IS3 sequences into any user-specific control sequence.
The F and A options can be specified together, so that IS2 and IS3 sequences will appear in the hardcopy file.
Standard: A/F option is not set, i.e. IS2/IS3 sequences will not appear in the hardcopy file.
G | I Only valid when L option is set: German/International
G German umlauts will appear in the printed output. This is irrespective of how they are displayed on the screen.
I German umlauts will appear as square/curly brackets, following the international character set.
Standard: G option (Umlauts will be printed correctly).
S Screen. After entering the HC command in line mode, all input and output appearing thereafter is saved to the hardcopy file. The contents of the screen at the time the command is entered will therefore not be captured. The S option will cause the entire visible screen contents to be saved to the hardcopy file.
The S option is only relevant when entering the HC command in line mode in a Connection.
Standard: S option is not set.
R Reduced. Reduced output to the hardcopy file. With reduced output, only the screen contents within the frame are captured. Only lines 5 to 23, or 6 to 23 in the case of the Help system, are captured. For example, when displaying a file, only the file contents will be captured to the hardcopy file.
R mode is not relevant in laser-ready hardcopy files (see the L parameter), nor in hardcopy in Connections.
Standard: R option is not set.
RS Reduced Size: This Hardcopy mode will cause the borders of the list to be suppressed. In addition, all padding blanks to the right of the end of the records will be suppressed, resulting in a significant reduction of the file size, particularly for large numbers of hardcopy printouts.
NHC Command
NHC | NHCn Reset hardcopy mode for the main CFS task/for Connection n.
The hardcopy file will be automatically closed under a subtask in the event of a LOGOFF/KDCOFF, Disconnect/Connection Lost condition occurring.
Notes:
HC Command in Connections.
In a Connection, the HC command can be entered in both Line mode, and in Format mode. The HC command should be entred in the first overwritable field of a screen mask. EDT is an exception, where the HC command should be entered in the 24th line (command line). No other fields may be modified in this same mask. The same is true for the NHC command.
LSP-key In cases where the first overwriteable field is too short to hold the HC command, the screen can be cleared with the LSP key, or by pressing Shift + Reset. The HC command can then be entered at line 1, column 1. The LSP key can be used at any time within a Connection, even when formats are displayed.