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 fileyou 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 aresearched 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 andinserted in the file.
4. If you use the GETFILE subcommand to insert lines into aVSBASIC file, you must also use the RENUK subcommand to the
file.
5. If the editor fills up available storage while executing a GETFILE
request, itmay 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
into a file that you are editing. The format of the GETFILE subcommand
is:
r
fn is the filename of the file that contains the data to be
inserted into the file
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
file.
copy.
the line specified by firstrec. If numrec is not specified,
firstrec and the end of the file is inserted.
1
specify firstrec and lastrec,
filemode of the file.
2.
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,
edited and
4. If you use the GETFILE subcommand to insert lines into a
file.
5. If the editor fills up available storage while executing a GETFILE
request, it
232