Use PutHeading to copy a specified group of lines from the current session to the session heading and to optionally delete the lines.
PutHeading may also be entered as PutHead[ing].
The group of lines can be specified by pre-selecting the lines (see Selection) or by using the FCT operand. If neither a pre-selection or FCT operand is provided, the group of lines consists solely of the current line.
Optional Operands
FCT specifies the number of lines to copy. If FCT is specified as asterisk (*), the lines through the end of the session are copied.
Default: 1.
OPT If OPT is specified as CLEAR or CL, the session heading is first cleared. If APPEND or AP is specified, the session heading is not cleared.
Default: CLEAR.
DEL If DEL is specified as YES, after the lines are copied to the session heading, they will be deleted from the session. If DEL is specified as NO, lines will not be deleted.
Default: NO.
Return Codes
OK Successful.
Examples
After clearing the session heading, copy 3 lines to it:
=> puthead 3