1 • EDIT Subcommands-FORMAT, FORiARD
Line mode is the default for remote 3270s. If you are using a
remote 3270 in display mode, and you enter the INPUT subcommand, you are placed in line mode while you enter input. When you return
to edit mode, the full screen display is restored.
2. The FORMAT subcommand is treated as invalid under any of the
following conditions:
a. The NODISP option of the EDIT command was used to invoke the
editor.
b. The edit session wa s ini tia ted on a typewriter terminal. (The
session may optionally be continued on a 3270 after a
reconnection. ) obtain a full screen display, 70U must save your file and
restart your edit session.
3. The column settings for the VERIFY, TRUNC, and Z3NE subcommands
remain unchanged when you issue the FORMAT subcommande None.
FORWARD (Primarily 3270) Use the FORWARD subcommand to move
end of the file you are editing.
is: r I I FOrward I I r , I n I III L .J the current line pointer towards the
The format of the FORWARD subcommand L- n is the number of records you wish to move forward in the file being
edited. If n is not specified, 1 is assumed.
The FORWARD subcommand is equivalent to the DOWN and NEXT subcommands;
it is provided for the convenience of 3270 users.
When verification is on, the new current line is displayed. If the
number specified exceeds the number of lines remaining in the file, the
current line pointer is positioned at EOF:.
Section 3. EDIT Subcommands and Macros 231

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