Contents - Index


 

Use PutClipboard to copy a specified group of lines from the current session to the current Clipboard and to optionally delete the lines from the session.

 

PutClipboard may also be entered as PutClip[board], PutSt[ack], or St[ack].

 

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 not specified, or if OPT is specified as CLEAR or CL, the clipboard is first cleared.  If APPEND or AP is specified, the clipboard is not cleared.

 

DEL If DEL is specified as YES, after the lines are copied to the clipboard they will be deleted from the session.  If DEL is specified as NO, or not specified, lines will not be deleted.

 

Pressing Shift-Ctrl, Ctrl-Insert, Ctrl-C, or Alt-C invokes the following command:

 

   => PutClip

 

Pressing Alt-K invokes the following command:

 

   => PutClip ,Append

 

Pressing Shift-Delete, Alt-M, Ctrl-X, or Alt-X invokes the following command:

 

   => PutClip ,Del=Yes

 

Pressing Alt-N invokes the following command:

 

   => PutClip ,Append,Del=Yes

 

PutClipboard, in combination with the GetClipboard command, is generally used for moving or copying lines. Further, the Clipboard contents created from the PutClipboard command can be the object of one of the following commands:

 

ClipMail

ClipSubmit

 

Return Codes

 

OK Successful.

 

Examples

 

After clearing the clipboard, copy 20 lines to it:

 

   => putclip 20

 

Append 740 lines from the current session to the clipboard:

 

   => putclip 740,ap

 

Clear the clipboard:

 

   => putclip ,cl