EDIT Subcommands-GETFILE GETFILE Use the GETFILE subcommand to insert all or part of a specific CKS file
into a file that you are editing. The format of the GETFILE subcommand
is:
r '-----, I , Get file I r r r r "" l{fn}lft Ifm Ifirstrec Inumreclill I I I I I I * I! I! I 1 ! * I I I I I , L L L L J.!I.JJ L
fn is the filename of the file that contains the data to be
inserted into the file you are editing. When an asterisk (*)
is specified, the filename of the file you are'editing is
assumed.
ft
fm
is the filetype
inserted. If ft
specified, the
assumed.
of the file that contains the data to
is not specified or when an asterisk
filetype of the file you are editing
be
is
is
is the filemode of the file that contains the data to be
inserted. If fm is not specified or when an asterisk is
specified, all of your accessed disks are searched for the
file. firstrec indicates the record number of the first record you want to
copy. numrec indicates the number of lines to be inserted, starting with
the line specified by firstrec. If numrec is not specified, or specified as *, then the remainder of the file between
firstrec and the end of the file is inserted.
1 • The GETFILE operand list is positional; if you omit YOl cannot specify any operands that follow. Thus, if
specify firstrec and lastrec, yoa must specify the
filemode of the file.
2. The last line inserted becomes the new current line.
one operand,
you want to
filetype and
3. If the record length of the records in the file containing the data
to be inserted exceeds that of the file being edited, an error
messaqe is displayed, and the GETFILE is not executed; if shorter, the records are padded to the record length of thafile being
edited and inserted in the file.
4. If you use the GETFILE subcommand to insert lines into a VSBASIC file, you must also use the RENUK subcommand to the
file.
5. If the editor fills up available storage while executing a GETFILE
request, it may not be able to copy all of the file. You should determine how many records were actually copied, and then write the current file on disk.
232 CMS Command and Macro Reference

EDIT Subcommands-GETFILE, IMAGE When verification is on, the last line inserted into the file is
displayed. If the end of the file has been reached, the message: EOF REACHED is displayed, followed by the display of the last line inserted. IMAGE Use the IMAGE subcommand to control how the editor should handle
backspaces and tab characters or to display the current image setting. The format of the IMAGE subcommand is:
r I , IMAGE I I , L- I r , I ,ON I , IOFF , , ,CANON, ,L J
1 , , , , I ____________________________ , ______________________________ -J ON specifies that any text entered while in input mode or as a line
of data following a FIND, INPUT, OVERLAY, or REPLACE subcommand, is expanded into a line image; backspaces are removed and tabs
are replaced by blanks. OFF CANON Text entered in the form of delimited strinas. as in LOCATE, and ALTER, is not expanded; tabs and backspaces are
treated in the same way as other characters. IMAGE ON is the default for all filetypes except SCRIPT. specifies that tabs and backspaces are treated
characters in the same way as other charaGters. They
deleted, translated, expanded, or reordered.
as data
are not
specifies that backspaces may be used to produce compound
characters such as underscored words, headings, or phrases.
Before they are inserted in the file, compound characters are
ordered, with backspaces arranged singly between the characters
that overlay each other; the overlaying characters are arranged
according to their EBCDIC values. Tab characters are handled as
for IMAGE OFF. CANON is the default for SCRIPT files.
1. When the image setting is ON, tab characters are expanded to an
appropriate number of blanks, according to the current settings of
the TAB SET subcommand. The TABSET command has no effect if the
image setting is either OFF or CANON. Section 3. EDIT Subcommands and Macros 233