Contents - Index


 

Use GetFile to insert a copy of the text of a specified file immediately following the current line of the session.

 

GetFile may also be entered as Get.

 

Optional Operands

 

FILE FILE may be any file. FILE can also be specified as either $LOG for the log, $Mail for the mail log, or $Stack for the clipboard.

 

 Default: last referenced file.

 

BASE specifies the starting line number for retrieval.

 

 Default: 1.

 

DEPTH specifies the number of lines to retrieve.

 

 Default: number of lines between BASE and end of file.

 

If the file is currently being edited, GetFile will retrieve the text of the file exclusive of any changes made in the edit session.

 

GetFile sets the last referenced file.

 

When Valid

 

The user must have LIST access level to the FILE directory.

 

Return Codes

 

OK Successful.

NF File not found.

SC Inadequate access level.

 

Procedure Notes

 

GetFile sets the TXM variables to the attributes of FILE.

 

Examples

 

Get the entire text of file OMRSYBT:

 

   => get omrsybt

 

Get the first 200 lines of file OMREXOP:

 

   => get omrexop,1,200