HISTORICAL MANUALS

 
 
 
                                           UNIVERSITY OF KENTUCKY
                                           COMPUTING CENTER
 
                                           XEDIT Reference
 
                                           VM/SP Release 3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
                                           UU  U KK  K   CCCC  CCCC
                                           UU  U KK K   CC    CC
                                           UU  U KKK    CC    CC
                                           UU  U KK  K  CC    CC
                                            UUU  KK   K  CCCC  CCCC
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
         Fifth Edition, Revision 0 (March 1984)
 
         Users of this manual are encouraged to report
         any errors or ambiguities, and to make
         suggestions for improvements.  The author can
         be contacted at the address below.
 
         Technical changes made to the contents of this
         manual are indicated by a vertical bar to the
         left of the change.
 
         University of Kentucky
         Computing Center
         72 McVey Hall
         Lexington, KY  40506-0045
         Phone: 606/257-2900
 
         Processed March 7, 1984-Waterloo SCRIPT - Version 82.2 (09/26/83)
 
         Prepared by Dave Elbon
 
 
 
 
 
         XEDIT Reference
 
 
 
 
                                                                       CONTENTS
 
 
 
 
         Section 1.  Introduction  . . . . . . . . . . . . . . . . . . . . .  1
 
         Section 2.  Reference . . . . . . . . . . . . . . . . . . . . . . .  2
 
         Section 3.  XEDIT Default Filetype Attributes . . . . . . . . . . . 37
 
         Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
                                                                Contents     ii
 
 
         XEDIT Reference
 
 
 
 
         Section 1:  Introduction
 
 
 
         The information in this publication is taken from the UKCC CMS
         Reference, and is intended to provide a convenient reference for XEDIT
         users.  A reference card for XEDIT, VM/SP System Product Editor
         Command Language Summary (SX24-5122), is available also.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
                                                 Section 1:  Introduction     1
 
 
         XEDIT Reference
 
 
 
 
         Section 2:  Reference
 
 
 
         Use the XEDIT command to invoke the System Product Editor to create,
         examine, and modify CMS disk files.  XEDIT can also be used to examine
         OS disk data sets and can be used to copy them to CMS disk files.
         Once XEDIT has been invoked, the XEDIT environment is entered and
         XEDIT subcommands and macros, CP commands, and CMS commands and EXEC's
         can be entered.  XEDIT is the editor used by the PEEK, NOTE, OSXEDIT,
         and RXEDIT commands.
 
       | Return control to the CMS environment with the CANCEL, QUIT, QQUIT,
       | FILE, or FFILE subcommands.
 
         This is not a complete description of the facilities available from
         XEDIT.  Consult the VM/SP System Product Editor Command and Macro
         Reference, the VM/SP System Product Editor User's Guide, and the
         online HELP command for more information.
 
         +--------------------------------------------------------------------+
         |           |                                                        |
         | Xedit     | [fn  [ft  [fm]]]  [(options... [)]]                    |
         |           |                                                        |
         |           | Options:                                               |
         |           |                                                        |
         |           | [Width n]   [NOSCreen]   +                 +           |
         |           |                          |PROFile macroname|           |
         |           | [NOCLear]                |NOPROFile        |           |
         |           |                          +                 +           |
       | |           | [NOMsg]                                                |
         |           |                                                        |
         |           | UPDATE Mode Options:                                   |
         |           |                                                        |
         |           | +        +  +      +  +             +                  |
         |           | |Update  |  |Seq8  |  |Ctl cntrlname|                  |
         |           | |NOUpdate|  |NOSeq8|  |NOCtl        |                  |
         |           | +        +  +      +  +             +                  |
         |           |                                                        |
       | |           | [Merge]  [Incr n]  [SIDcode string]   [UNtil filetype] |
         |           |                                                        |
         +--------------------------------------------------------------------+
 
         where
 
         fn        is the filename of the file to be edited or created.  If not
                   specified, it must be provided by the LOAD subcommand in the
                   XEDIT PROFILE.
 
 
 
 
                                                    Section 2:  Reference     2
 
 
         XEDIT Reference
 
 
 
 
         ft        is the filetype of the file.  If not specified, it must be
                   provided by the LOAD subcommand in the XEDIT profile.
 
         fm        is the filemode of the file.  If no filemode is specified,
                   all accessed disks are searched for an existing file with a
                   matching name and type.  If none is found, a new file is
                   created using filemode "A1."
 
         Options
 
         Ctl cntrlname
                   controls the XEDIT multi-level update facility.  Use of the
                   CTL option implies the UPDATE and SEQ8 options.  Consult the
                   description of the CMS UPDATE command in the VM/SP CMS
                   Command and Macro Reference for details.
 
         Incr n    specifies the minimum serial number increment between two
                   adjacent lines used by XEDIT when assigning numbers to new
                   lines.  The default is one.  This option implies the UPDATE
                   option.
 
         Merge     specifies that all the updates made using the control file
                   and all the changes made while editing will be merged and
                   written into the most recent update file.  This option
                   implies the UPDATE option.
 
         NOCLear   specifies that the screen is not to be cleared by XEDIT.
                   The screen will be placed in "MORE..." status and any
                   messages on the screen will still be visible.  Either press
                   CLEAR or wait one minute to clear the screen and begin
                   normal XEDIT processing.  This option is useful only on
                   3270-type display terminals.
 
       | NOMsg     causes XEDIT to start with MSGMODE OFF.
 
         NOPROFil  suppresses execution of the profile macro.
 
         NOSCreen  forces XEDIT to operate in line (typewriter) mode when used
                   on a 3270-type terminal.
 
         NOSeq8    If NOSEQ8 is specified, columns 73 through 75 are assumed to
                   contain a label field, and columns 76 through 80 are assumed
                   to contain sequence numbers.  Specifying NOSEQ8 will force
                   the UPDATE option and cause XEDIT to operate in update mode.
 
       | NOUpdate  disables the XEDIT update facility.  This is the default
       |           unless CTL, NOSEQ8, SIDCODE, SEQ8, or UNTIL are specified.
 
         PROFile macroname
                   specifies the name of the XEDIT profile.  The profile is an
                   XEDIT macro (filetype must be XEDIT) executed each time the
                   XEDIT command or subcommand is issued.  It can be used to
 
 
 
                                                    Section 2:  Reference     3
 
 
         XEDIT Reference
 
 
 
 
                   tailor the XEDIT environment to your own needs and
                   preferences.  The Usage Notes contain more information about
                   writing a profile macro.  If this option is not specified
                   the macro name "PROFILE" will be used.
 
         Seq8      if SEQ8 is specified, columns 73 through 80 are assumed to
                   contain sequence numbers.  SEQ8 is the default in update
                   mode.  Specifying SEQ8 also implies the UPDATE option and
                   will cause XEDIT to operate in update mode.
 
         SIDcode string
                   specifies an identifier used to mark all new or changed
                   lines in an update file.  The string is placed in columns 64
                   through 71 (padded on the right with blanks to a length of
                   eight), overlaying any other data in these columns, unless
                   column 72 contains a non-blank character.  This option
                   implies the UPDATE option.
 
       | UNtil filetype
       |           specifies the filetype of the last update to be applied.
       |           The filetype cannot be that of an UPDATE AUX file.  This
       |           option implies the UPDATE option.
 
         Update    enables the XEDIT update facility.  XEDIT supports an update
                   mode which is compatible with all of the features of the CMS
                   UPDATE command, including multi-level updating.  Consult the
                   VM/SP CMS Command and Macro Reference and the VM/SP System
                   Product Editor Command and Macro Reference for details.
 
         Width n   sets the maximum length used to store one record from the
                   file.  The WIDTH may also be specified with the LOAD
                   subcommand in an XEDIT profile.  If no value is specified,
                   the default is either the actual record length of the file,
                   or the default record length for the filetype, whichever is
                   larger.  The WIDTH is used to set the default values for
                   LRECL and TRUNC.  Specifying a width less than the actual
                   record length of an existing file can cause records to be
                   truncated.
 
         Display and Typewriter Modes
 
         XEDIT supports all terminal types supported by CMS.  When used from a
         3270-type display terminal it will operate in DISPLAY mode.  On other
         types of terminals it will operate in TYPEWRITER (line) mode.
         Typewriter mode can be forced on a 3270-type terminal with the
         NOSCREEN option or the SET TERMINAL subcommand.  This may be desirable
         on a remote 3270-type terminal when the line transmission rate is low.
         Some XEDIT subcommands will function only in display mode.
 
 
 
 
 
                                                    Section 2:  Reference     4
 
 
         XEDIT Reference
 
 
 
 
         The XEDIT Display Screen Format
 
         When operating in display mode, XEDIT will control the format of the
         screen.  The display screen will appear as follows:
 
         +-----------------------------------------------------+
         | fn ft fm  V 80 TRUNC=n SIZE=n LINE=n COLUMN=n ALT=n |<--File Id Line
         |                                                     |<--Message Line
         |===== * * * TOP OF FILE * * *                        |
         |=====                                                |
         |=====                                                |
         |=====                                                |<--Current Line
         |      |...+....1....+....2... ... ...6....+....7..>  |<--Scale
         |=====                                                |
         |=====                                                |
         |===== * * * END OF FILE * * *                        |
         |                                                     |
         |===>                                                 |<--Command Line
         |                                  X E D I T  1 FILE  |<--Status Area
         +-----------------------------------------------------+
          |   | |                                             |
          +---+ +---------------------------------------------+
            |                         |
         Prefix Area              File Area
 
         The first line of the display is the File Identification Line.  It
         contains the filename, filetype, and filemode of the file being
         edited.  The next two items are the record format (V for variable-
         length, F for fixed-length, VP for packed variable-length, or FP for
         packed fixed-length)  and the maximum record length.  Following these
         are the truncation column (TRUNC), the number of lines in the file
         (SIZE), the current line number (LINE), and the column pointer
       | (COLUMN).  The last item on this line is the alteration count (ALT).
       | The count is incremented for each subcommand that causes a change in
         the file and for every line that is directly modified.  When the
         alteration count reaches the SET AUTOSAVE value (if you have set one),
         the file is automatically saved.  The alteration count is reset to
       | zero after an automatic save and by the SAVE subcommand.  You may use
       | the QUERY ALT subcommand to determine the alteration count at any
         time.  You cannot type on the File Id Line.
 
         Following the File Id Line is the Message Line.  This line is used to
         display XEDIT error and informational messages.  You can't type on
         this line either.
 
         Following the Message Line is the File Area.  The lines in this area
         are used to display and enter data.  You may type directly in this
         area to enter new lines or modify existing lines.  One line in the
         File Area is designated the Current Line.  This line appears in the
         middle of the screen and will be highlighted to make it easy to find.
         Many XEDIT subcommands perform their functions on the current line or
         on a group of lines beginning with the current line.
 
 
 
                                                    Section 2:  Reference     5
 
 
         XEDIT Reference
 
 
 
 
         Each line in the File Area is preceded by a special command area
         called the Prefix Area (marked with "=====").  The commands entered in
         the Prefix Areas are called prefix subcommands and generally operate
         on or following the line on which they are entered.  Prefix
         subcommands can be used to add, delete, duplicate, move, and copy
         lines in the file.  The SET PREFIX subcommand can be used to move the
         Prefix Areas to the right of the screen, or remove them entirely.  The
         SET NUMBER subcommand can be used to cause line numbers to be
         displayed in the Prefix Areas.
 
         The Command Line is actually about one and three-quarters of a line at
         the bottom of the screen.  XEDIT subcommands and macros, CP commands,
         and CMS commands and EXECs can be entered on the Command Line.  The
         SET CMDLINE subcommand can be used to move the Command Line to the top
         of the screen, where it will share the space occupied by the Message
         Line.
 
         The Status Area is on the right at the bottom of the screen, following
         the Command Line.  The Status Area indicates the current operating
         mode (XEDIT, COPY/MOVE PENDING, BLOCK INCOMPLETE, INPUT-MODE, UPDATE-
         MODE, or MACRO-READ) and the number of files currently being edited.
         The SET CMDLINE subcommand can be used to remove the Status Area from
         the display.
 
         The Scale Line appears under the current line and indicates the column
         numbers, the position of the column pointer (marked "|"), the left and
         right zone columns (marked "<" and ">"), and the truncation column
         (marked "T").  The Scale Line can be repositioned on the screen (or
         removed entirely) with the SET SCALE subcommand.
 
         Keyboard Functions (for 3270 Displays)
 
         CLEAR     will clear the screen and cause the display to be rebuilt as
                   it was after the last time ENTER or a PF key was pressed.
                   CLEAR also clears the CMS stack.
 
         ERASE INPUT
                   will erase everything in the input and command areas.
 
         ERASE EOF will erase everything from the cursor to the end of the
                   line.  In power or long input mode ERASE EOF will erase
                   everything from the cursor to the end of the screen.
 
         ENTER     causes XEDIT to read the screen and analyze its contents.
 
         PA1       will transfer control to CP and clear the screen.  A CP READ
                   status will be displayed.  Enter BEGIN to return to XEDIT.
 
         PA2       will have the effect of setting nulls on for the line that
                   contains the cursor.  This allows insert mode (see INS MODE
                   below) to be used on the line.
 
         Cursor Movement
 
 
                                                    Section 2:  Reference     6
 
 
         XEDIT Reference
 
 
 
 
                   keys are available to move the cursor forward, backward, up,
                   and down on the screen.  A cluster of four keys marked with
                   arrows are used to move the cursor one space at a time.  The
                   New Line key (marked <- is used to move the cursor to the
                   beginning of the next line.  Tabbing between input and
                   command areas can be done with the forward and backward tab
                   keys (marked ->| and |<-).
 
         PFnn      will cause the information associated with the Program
                   Function key pressed to be processed.  This data is stacked
                   and may contain commands or data or some combination.  The
                   data associated with each PF key may be set with the SET PFn
                   subcommand.  The current settings may be displayed with the
                   QUERY PF subcommand.  Initially, the PF keys have the
                   following assignments:
 
       |                PF1  BEFORE HELP MENU        PF7  BEFORE BACKWARD
       |                PF2  BEFORE SOS LINEADD      PF8  BEFORE FORWARD
       |                PF3  BEFORE QUIT             PF9  ONLY =
       |                PF4  BEFORE TABKEY           PF10 BEFORE RGTLEFT
       |                PF5  BEFORE SCHANGE 6        PF11 BEFORE SPLTJOIN
       |                PF6  ONLY ?                  PF12 BEFORE CURSOR HOME
 
         INS MODE  places the terminal in insert mode.  This causes typed
                   characters to be inserted at the cursor position and shifts
                   other characters on the line to the right.  To use insert
                   mode on a data line requires that SET NULLS ON be in effect,
                   or that PA2 be pressed while the cursor is on the line.  To
                   leave insert mode, press RESET.  You should not use INS MODE
                   while in long input mode.
 
         DEL       will delete the character at the cursor position and shift
                   any following characters to the left.  You should not use
                   DEL while in long input mode.
 
         RESET     will reset insert mode and error conditions.  You should not
                   use this key to reset an "INPUT INHIBITED" condition caused
                   by slow system response time.  This can confuse XEDIT and
                   may cause loss of data.
 
         FIELD MARK
                   will enter a unique character (hexadecimal 1E, an EBCDIC
                   Record Separator).  A FIELD MARK will appear on most screens
                   as either ";" or a right-arrow.  FIELD MARK is entered as a
                   shifted PA2.
 
         DUP       will enter a unique character (hexadecimal 1C, an EBCDIC
                   Field Separator) and physically move the cursor to the start
                   of the next field (usually the start of the next line or
                   Prefix Area).  On most terminals the DUP character will be
                   displayed as either "*" or "/" until the field is rewritten.
                   DUP is entered as a shifted PA1.
 
 
 
                                                    Section 2:  Reference     7
 
 
         XEDIT Reference
 
 
 
 
         XEDIT Subcommands
 
         XEDIT has two types of subcommands: subcommands entered on the Command
         Line and those entered in Prefix Areas.  Those entered on the command
         line are generally called subcommands, while those entered in Prefix
         Areas are known as prefix subcommands.  The Command Line may also be
       | used to enter XEDIT macros, CP commands, and CMS commands and EXEC's.
       | XEDIT macros are REXX or EXEC 2 files with a filetype of "XEDIT."
       | These can be used to combine XEDIT subcommands and macros, CP
         commands, CMS commands and EXEC's, and EXEC functions to create new
         functions.  Macros are executed by entering their name on the Command
         Line just like a subcommand.
 
         Commands on the Command Line may be preceded by the character "&" in
         column one; this will cause XEDIT to leave the string on the screen.
         The command, or commands, may then be repeated by simply pressing the
         ENTER key.  Multiple subcommands may be entered on the Command Line by
         separating them with a line end character.  The default line end
         character is a pound sign (#).  If any error occurs when processing a
         command, the command will be left on the Command Line for correction.
 
         Prefix subcommands generally correspond to similar subcommands that
         would be entered on the Command Line.  While subcommands generally
         operate on or following the current line, prefix subcommands usually
         operate on or following the line on which they are entered.  Prefix
         subcommand arguments may either precede or follow the subcommand in
       | the Prefix Area.  Prefix subcommands also can be executed with the
       | LPREFIX subcommand.
 
         When the ENTER key or a PF key is pressed, XEDIT will read and process
         the screen.  Processing proceeds in the following order:
 
             1.  Record any changes made in the data display area.
             2.  Process any prefix commands.
             3.  Process any commands from a Program Function key.
             4.  Process any commands found on the command line.
 
         If a PF key is set to a special PF key function (like TABKEY),
         pressing the PF key will not cause commands on the screen to be
         processed.  When all processing is complete, the file will be written
         to disk if the number of lines altered, added, or deleted since the
         last SAVE has reached or exceeded the SET AUTOSAVE threshold (see
         Usage Note 2).  The new screen is then displayed.
 
         XEDIT commands make use of several important concepts.  Most important
         is the concept of the current line.  Many subcommands operate either
         on or beginning on the current line, and several subcommands exist to
         make some specified line the current line.  In display mode the
         current line is highlighted and appears in the center of the display;
         on other kinds of terminals the current line is generally the line
         most recently typed.
 
 
 
 
                                                    Section 2:  Reference     8
 
 
         XEDIT Reference
 
 
 
 
         Another important concept is that of targets.  A target is used to
         identify a particular line to XEDIT.  Targets may be absolute line
         numbers (in the form ":n"), relative line numbers (either "n", "+n",
         or "-n"), names (".name" assigned with the SET POINT subcommand or the
         "." prefix subcommand), or string expressions.  A string expression is
         from one to four character strings delimited by any non-blank
         character that does not appear in the string.  The string expression
         may be preceded with a "+" or "-" to indicate the search direction (a
         "+" is assumed).  As many as four separate delimited strings
         (separated with vertical bars) may be included in the expression.
         This will match a line containing any one of the strings.  Each string
         may also be preceded with a "¬" to locate a line that does not contain
         the string.  String expressions may also make use of several SET
         subcommand options.  SET ARBCHAR allows a string of unknown characters
         to be specified.  SET CASE specifies whether or not the difference
         between upper and lowercase is significant.  SET HEX ON allows the
         characters to be specified as hexadecimal values.  SET SPAN can be
         used to allow targets to span multiple lines in the file.  SET
         VARBLANK specifies whether or not the number of blanks between words
         is significant.  Targets are used as arguments by some subcommands
         (particularly LOCATE), as subcommand prefixes, or may be entered alone
         to make the line specified by the target the current line.
 
         XEDIT also makes use of a column pointer and column targets, which are
         similar in some respects to the current line and targets.  Column
         pointer movement is controlled and used by a set of special column-
         oriented subcommands (CLOCATE, CINSERT, CDELETE, etc.).  In display
         mode the current line and column pointer is indicated in the header
         line and the scale line.  On other types of terminals the column
         pointer position is marked by underscoring.  Column-targets may be
         absolute or relative column numbers, or string expressions.  Use -* to
         refer to the left zone column and * or +* to refer to the right zone
         column.
 
         The following describes the XEDIT subcommands and supplied macros.
         Default parameter values are listed immediately following the general
         form.
 
         &[command]
                   causes the specified command to be retained in the input
                   area on a 3270-type terminal.  The command may be repeated
                   by pressing ENTER.
 
         = [command]
                   repeats the execution of the last command entered for this
                   file, or executes a specified command and then repeats the
                   last command.  The = buffer may be changed with the SET =
                   subcommand.
 
         ?         displays the last command entered for this file.  Repeated
                   execution of the ? subcommand displays previous commands.  ?
                   cannot be used from a macro, and cannot have a synonym.
 
 
 
                                                    Section 2:  Reference     9
 
 
         XEDIT Reference
 
 
 
 
         Add [n]   adds lines after the current line.  The number of lines
                   added is specified by "n."  The default is one line.  ADD is
                   allowed only in display mode.
 
         ALL target
                   displays the target lines and excludes all others.  ALL is a
                   macro.
 
         ALter char1 char2 [target|1 [n|1|* [p|1]]]
                   changes a single character to another character.  The
                   characters can be specified as two hexadecimal digits.  The
                   remaining arguments correspond to those of the CHANGE
                   subcommand.  ALTER is a macro.
 
         BAckward [n]
                   scrolls backward (toward the top of the file) the indicated
                   number of screens.  The default is one screen.
 
         Bottom    makes the last data line of the file or range the new
                   current line.
 
         BURN      erases the current file from disk and issues a QUIT
                   subcommand.  If you are using RXEDIT to edit a reader spool
                   file the spool file is purged.  This will completely destroy
                   the file you are editing.  BURN is a macro.
 
         CANCEL    immediately terminates XEDIT.  It is equivalent to entering
                   QUIT for each file being edited.  CANCEL is a macro.
 
         CAPPEND [text]
                   appends the specified text to the end of the current line.
                   The column pointer is moved to the first appended character,
                   or the first trailing blank if no text is given.  CAPPEND is
                   a macro.
 
         CDELETE [column target|1]
                   deletes characters from the current line, beginning at the
                   column pointer and deleting up to the column target.  SET
                   STREAM ON (the initial setting) allows text on multiple
                   lines to be deleted.
 
         CFIRST    moves the column pointer to the beginning of the ZONE.
 
         Change /string1 [/string2/  [target|1 [n|1|* [f|1]]]]
                   replaces occurrences of "string1" with "string2."  The
                   delimiter (/) may be any non-blank character that does not
                   appear in the strings.  If "string2" is omitted, a null
                   string is used.  The target specifies the number of lines to
                   be searched.  Lines are searched beginning with the current
                   line and ending before the target line.  The value "n" is
                   the number of occurrences of "string1" that may be changed
                   on each line, and "f" is the relative number of the first
                   occurrence on each line to be changed.  The search for
 
 
 
                                                   Section 2:  Reference     10
 
 
         XEDIT Reference
 
 
 
 
                   string1 is limited by the current ZONE columns, but the
       |           change may affect data from the left ZONE column to the
       |           TRUNC column.  SET SPILL controls what happens to characters
       |           pushed past the TRUNC column.  SET STAY controls current
                   line positioning after multiple line changes.  SET VERIFY ON
                   causes all changed lines to be displayed.  The strings may
                   make use of the ARBCHAR.  SPAN and VARBLANK settings are
                   ignored.
 
         CINSERT text
                   inserts text immediately before the column pointer in the
                   current line.
 
         CLAST     moves the column pointer to the end of the ZONE.
 
         CLocate column-target
                   makes the column specified by the column target the column
                   pointer value.  Searching begins at the column pointer
                   position in the current line.  If SET STREAM ON (the initial
                   setting) is in effect searching continues beyond the current
                   line.
 
         CMS [text]
                   will pass "text" to CMS as a command.  If "text" is not
                   specified CMS subset mode is entered.  Use the RETURN
                   command to return to XEDIT.
 
         CMSG [text]
                   puts a message on the command line of a 3270-type terminal.
                   CMSG is intended for use in macros.
 
         COMMAND [text]
                   executes "text" as an XEDIT subcommand, without checking for
                   synonyms or macros.  If "text" is not an XEDIT subcommand,
                   and SET IMPCMSCP is ON, it is passed to CMS or CP as a
                   command.  The & and ?  subcommands cannot be used.
 
         COMPRESS [target|1]
                   replaces blank (or FILLER) characters immediately preceding
                   the current tab columns with a single tab character.  The
                   SET TABS and EXPAND subcommands are used to align the
                   compressed text to new columns.
 
         COpy target1 target2
                   copies one or more lines, beginning with the current line
                   and ending before the "target1" line, to the "target2" line.
                   The last line copied becomes the current line.
 
         COUnt /string[/target|1]
                   counts the occurrences of "string," beginning with the
                   current line and ending before the target.  The count is the
                   number of strings that would be affected by a CHANGE
                   subcommand specifying the same string.
 
 
 
                                                   Section 2:  Reference     11
 
 
         XEDIT Reference
 
 
 
 
         COVerlay text
                   overlays the current line (starting at the column pointer)
                   with the non-blank characters in "text."  Use underscores in
                   "text" to force blanks on the current line.
 
         CP [text] passes "text" to the Control Program (CP) as a command.  If
                   "text" is not specified, control transfers to CP mode; use
                   the BEGIN command to return to XEDIT.
 
         CReplace text
                   replaces the characters in the current line (starting at the
                   column pointer) with the "text."  This is similar to
                   COVERLAY, except blanks and underscores have no special
                   significance.
 
       | CURsor CMdline [column|1] [Priority n]
       |        Column [Priority n]
       |        File line [column] [Priority n]
       |        Home [Priority n]
       |        Screen line [column] [Priority n]
       |           moves the cursor to the specified column on the command
       |           line, the current line and column pointer position, a file
       |           line, switches between a screen line and the command line,
       |           or moves to a screen line.  It also assigns a priority to
       |           the new position.  This subcommand is allowed only in
                   display mode.
 
         DBLANK    removes all of the blank lines from a file.  DBLANK is a
                   macro.
 
         DELete [target|1]
                   deletes one or more lines, beginning with the current line
                   and ending before the target.
 
         Down [n|1|*]
                   advances the current line "n" lines toward the end of the
                   file.
 
         DUPlicat [n|1 [target|1]]
                   duplicates one or more lines, beginning with the current
                   line and ending before the target, "n" times.
 
         EMSG [code] [text]
                   displays an error message.  Refer to the description of the
                   CMSEMSG command elsewhere in this manual for a description
                   of the optional message identifier code.  If the code is not
                   supplied, or if the severity is E, S, or T, the alarm will
                   be sounded.  EMSG is intended for use in macros.
 
         EXPAND [target|1]
                   replaces tab characters in the specified lines with blanks
                   (or the SET FILLER character) to align to the current tab
                   columns.  EXPAND can be used in conjunction with COMPRESS
                   and SET TABS to realign tables and other text.
 
 
                                                   Section 2:  Reference     12
 
 
         XEDIT Reference
 
 
 
 
         EXPLAIN   displays the HELP information for the most recently issued
                   XEDIT error message.  For EXPLAIN to work properly, CP SET
                   EMSG must be ON before the error occurs.  This can be done
                   automatically with a CP SET EMSG ON command in your PROFILE
                   EXEC or XEDIT PROFILE.  EXPLAIN is a macro.
 
       | EXTract /operand[/operands...
       |           returns information to an EXEC or XEDIT macro by setting
       |           variables in the EXEC or macro.  EXTRACT can obtain
       |           information not obtainable with TRANSFER.  Refer to the
       |           XEDIT Reference or online HELP for more information.
 
       | FFile     is a synonym for COMMAND FILE.  See FILE and PFILE for more
       |           information.
 
         FILE [fn [ft [fm]]]
               =   =   =
                   puts the current file into a CMS disk file and removes it
                   from the set of files being edited.  If only one file was
                   being edited XEDIT terminates.  Optionally, a fileid may be
                   specified to override the current fileid.  An "=" may be
                   used in place of "fn", "ft", or "fm" to specify that the
       |           current setting for this identifier is to be used.  A FILE
       |           issued from a macro when only one file is being edited is
       |           not executed until the macro ends.  FILE cannot be used from
       |           a prefix macro.  By default, FILE is a synonym of PFILE.
 
         Find text searches forward from the line following the current line
                   for a line beginning with "text."  Columns containing blanks
                   in "text" are not checked; columns containing underscores
                   are matched for blanks.  The search starts at the first tab
                   position in each line.  The first line containing "text"
                   becomes the current line.  SET WRAP controls wraparound from
                   the bottom of the file.
 
         FINDUp text
         FUp       is similar to FIND, but searches up (toward the top of the
                   file), rather than down.
 
         FLOW [target|2 [l|1 [r|70]]]
                   reformats lines beginning with the current line and ending
                   before the target.  The lines are concatenated and then
                   broken at word boundaries to fit within the specified left
                   and right column margins.  FLOW is a macro that uses SCRIPT
                   to format the text, and SCRIPT control words in the text are
                   processed (.AD, .CO, .FO, .JU, .LL, and .NF should not be
                   used).
 
         FOrward [n|1|*]
                   scrolls toward the end of the file the specified number of
                   screens.  FORWARD is allowed only in display mode.
 
         GET [fn|= [ft|= [fm|*|=] [f|1 [n|*]]]]
 
 
 
                                                   Section 2:  Reference     13
 
 
         XEDIT Reference
 
 
 
 
                   inserts lines after the current line.  The lines come from
                   the PUT/PUTD buffer, or a specified CMS file.  When a CMS
                   fileid is specified, "f" (the first record to be read) and
                   "n" (the number of records to be read) may also be
                   specified.  The new records are truncated or filled to the
                   required record length.  Packed files are not unpacked.
 
         HELP [MENU|topic]
                   displays information about XEDIT subcommands and macros.
                   The "topic" may not use abbreviations.  MENU displays a list
                   of all XEDIT subcommands and macros.  The "topic" can also
                   be anything accepted by the CMS HELP command.
 
         HEXTYPE [target|1]
                   displays lines beginning with the current line and ending
                   before the target in both hexadecimal and character form.
                   HEXTYPE is a macro.
 
         INLong    enters long input mode.  In this mode you can enter data
                   lines as wide as the display screen (or to the current
                   truncation column, whichever is shorter).  Each line on the
                   screen is entered into the file as a data line.  Pressing
                   the ENTER key causes the lines to be entered and a new input
                   screen to be displayed.  Pressing the ENTER key with no new
                   data on the screen terminates input mode.  The last line
                   entered becomes the current line.  The current line and the
                   SCALE and TABLINE indicators are displayed at the top of the
                   screen in protected form.  The remaining lines on the screen
                   can be used for input.  Each input line contains the current
                   SET MASK data (initially all blank).  VERIFY is forced to
                   begin with column one and end at the truncation column or
                   the end of the screen line.  The normal operation of the
                   Program Function (PF) keys and PA2 key are suspended; these
                   keys are ignored with the exception of PF keys set to
                   TABKEY, SOS TABF, or SOS TABB.  The multiple tab features of
                   SOS TABF and TABB are not supported.  Tabbing beyond the
                   last tab column moves the cursor to the first tab column of
                   the next line.  Backward tabbing will not move to the left
                   of the first tab column.  The LINEND character is treated as
                   a normal data character.  XEDIT SET CASE and CMS SET INPUT
                   translations are made.  Use the insert (INS MODE) and delete
                   (DEL) keys with care; the entire screen is one long field
                   and inserting or deleting characters causes the input data
                   to become aligned to other than the normal line boundaries.
                   INLONG is allowed only in display mode.
 
         Input [text]
                   enters new lines into a file after the current line.  If
                   "text" is specified, one line containing "text" is inserted;
                   otherwise, XEDIT enters input mode and new lines may be
       |           entered.  Only data typed within the VERIFY columns is
       |           accepted.  In display mode, press ENTER once for a new input
                   screen, twice to return to edit mode.  In typewriter mode,
 
 
 
                                                   Section 2:  Reference     14
 
 
         XEDIT Reference
 
 
 
 
                   enter an empty line to return to edit mode.  The last line
                   entered becomes the current line.
 
       | Join [ALigned] [Column|CURSOR]
       |      [ALigned] [column|/string/]...
                   joins two or more lines, beginning with the current line,
                   into one new line, and deletes the original lines from the
       |           file.  ALIGNED attempts to correct for leading blanks on the
       |           lines being joined.  If no operand is specified the current
       |           line and the following line are joined following the last
                   non-blank on the current line.  COLUMN can be specified to
                   join two lines at the column pointer position.  Column
                   numbers will append additional lines at the specified
                   columns.  "String" will append the specified string to the
                   current line and then append a line.  CURSOR is used to join
                   the line containing the cursor and the following line (for
                   display mode only).  The new line will be truncated to fit
       |           within the current record length.  JOIN is a macro.  See
       |           also SPLTJOIN.
 
         JUSTIFY [target|* [l|1 [r|70]]]
                   reformats lines beginning with the current line and ending
                   before the target.  The lines are concatenated, broken at
                   word boundaries, and aligned to the left and right column
                   margins.  JUSTIFY is a macro that uses SCRIPT to format the
                   text, and SCRIPT control words in the text are be processed
                   (although .AD and .LL should not be used).
 
         LEft [n|1]
                   changes the columns displayed so that data to the left of
                   the first column on the screen is visible.  The data appears
       |           to move to the right.  See also RGTLEFT.
 
         LOAD [fn [ft [fm]]] [(options... [)]]
                   is used from a profile macro to load the file into storage
                   for editing.  The format of the LOAD subcommand is the same
                   as that of the XEDIT command.  All XEDIT parameters and
                   options may be specified, although options specified on the
                   XEDIT command will override those specified on the LOAD
                   subcommand.  If used, LOAD must be the first XEDIT
                   subcommand in the XEDIT profile.  The WIDTH option of the
                   LOAD subcommand is overridden if it would cause truncation
                   of existing file lines.  The default SET LRECL, SET TRUNC,
                   and SET ZONE values are assigned when LOAD is executed.
 
         [Locate] target [subcommand]
                   searches the file, starting after the current line, for the
                   specified target.  The first line containing the target
                   becomes the new current line.  A subcommand may be specified
                   to be executed after positioning at the new current line.
                   SET STAY and SET WRAP control the operation of LOCATE.
 
         LOWercas [target|1]
 
 
 
                                                   Section 2:  Reference     15
 
 
         XEDIT Reference
 
 
 
 
                   converts uppercase letters to lowercase, beginning with the
                   current line and ending before the target line.
 
       | LPrefix text
       |           executes "text" as a prefix subcommand on the current line.
       |           This can be used in display or typewriter mode.
 
         MACRO [text]
                   executes "text" as an XEDIT macro, without checking for
                   synonyms or subcommands.
 
       | MErge target1 target2 [column|1]
       |           overlays the second group of lines with data from the first
       |           group and then deletes the first group.  The first group of
       |           lines contains the lines from the current line and ending
       |           before "target1."  The second group begins with "target2."
       |           The data from the first group can be shifted with the
       |           "column" parameter.  MERGE treats underscores as ordinary
       |           data characters.
 
         MODify keyword
                   displays a subcommand and its current setting on the command
                   line where it can be modified (if desired) and entered.
                   MODIFY is allowed only in display mode.  Refer to the XEDIT
                   Reference or online HELP for a list of valid keywords.
 
         MOVE target1 target2
                   moves one or more lines, beginning with the current line and
                   ending before the "target1" line, to the "target2" line.
                   The original lines are deleted.  The last line moved becomes
                   the current line.
 
         MSG [text]
                   displays a message.  MSG is intended for use in macros.
 
         Next [n]  is the same as the DOWN subcommand.
 
         NFind text
                   searches forward from the line following the current line
                   for a line not beginning with "text".  Columns containing
                   blanks in "text" are not checked; columns containing
                   underscores are matched for blanks.  Searching begins at the
                   first tab position in each line.  The first line not
                   containing "text" becomes the current line.  SET WRAP
                   controls wraparound from the bottom of the file.
 
         NFINDUp text
         NFUp      is similar to NFIND, but searching is up (toward the top of
                   the file), rather than down.
 
         Overlay text
                   overlays the current line with "text."  Blanks in the text
                   do not change existing characters, and underscores in the
                   text cause blanks to be placed in the current line.
 
 
                                                   Section 2:  Reference     16
 
 
         XEDIT Reference
 
 
 
 
         PARSE column keyword ...
                   is a macro used for parameter processing in macros.  Refer
                   to the XEDIT Reference or online HELP for details.
 
       | PFILE [fn [ft [fm]]]
       |        =   =   =
       |           saves the current file in a CMS disk file and removes it
       |           from the ring of files being edited.  XEDIT ends if this was
       |           the last file in the ring.  If you changed the identifier of
       |           the file, and a with the new name already exists, you will
       |           be prompted to enter FFILE to overwrite the file on disk.
       |           By default, FILE is a synonym of PFILE.
 
         POWerinp  enters "power input" mode.  The entire display screen is
                   treated as one line, and text may be entered without regard
                   to physical line boundaries on the screen.  Pressing ENTER
                   once causes a new input screen to be displayed, twice
                   returns to edit mode.  When input mode ends lines entered
                   are broken to fit within the current truncation setting, and
                   words broken over line boundaries are reassembled.  Use the
                   LINEND character to force data to the beginning of a line.
                   The last line entered becomes the current line.  POWERINP is
                   allowed only in display mode.
 
         PQUIT [n] terminates editing of the current file and returns control
                   to CMS if there is only one file being edited.  If the file
                   has been altered you will be prompted to enter QQUIT.  The
                   optional argument is a return code for use with macros.  By
                   default, QUIT is a synonym of PQUIT.
 
       | PSAVE [fn [ft [fm]]]
       |        =   =   =
       |           saves the current file in a CMS disk file.  If you changed
       |           the identifier of the file, and a with the new name already
       |           exists, you will be prompted to enter SSAVE to overwrite the
       |           file on disk.  By default, SAVE is a synonym of PSAVE.
 
       | PREServe  saves the current settings of several XEDIT SET subcommand
       |           variables for later restoration with the RESTORE command.
       |           The current line pointer, column pointer, and some SET
       |           values are not saved.  Refer to the XEDIT Reference or
       |           online HELP for more information.
 
       | PURge macroname
                   purges the current copy of the named macro from storage.
 
         PUT [target|1 [fn|= [ft|= [fm|=]]]]
                   saves records beginning with the current line and ending
                   before the target line.  If no fileid is specified the lines
                   are placed in a special buffer for later use by the GET
       |           subcommand.  (The buffer is cleared by each PUT and PUTD).
       |           If a CMS fileid is specified, a CMS disk file will be
                   created.  If the file already exists, the lines will be
                   added to the end.  The target line becomes the current line.
 
 
                                                   Section 2:  Reference     17
 
 
         XEDIT Reference
 
 
 
 
         PUTD [target|1 [fn|= [ft|= [fm|=]]]]
                   is similar to PUT, except the specified lines are deleted
                   from the current file.
 
         QQUIT [n] terminates editing of the current file and ends XEDIT if
                   only one file is being edited.  The optional argument is a
       |           return code for use with macros.  By default, QQUIT is a
       |           synonym for COMMAND QUIT, and QUIT is a synonym for PQUIT.
 
         Query keyword
       |           displays the current value of the specified XEDIT setting.
       |           Use EXTRACT (or TRANSFER) to obtain these values in an EXEC
       |           or macro.  Refer to the XEDIT Reference or online HELP for a
       |           list of keywords.
 
         QUIT [n]  terminates editing of the current file and ends XEDIT if
                   there is only one file being edited.  The optional argument
       |           is a return code for use with macros.  By default, QUIT is a
       |           synonym for COMMAND PQUIT, and QQUIT is a synonym for
                   COMMAND QUIT.  PQUIT also clears the stack.
 
         RBLANK target
                   changes all multiple blanks to single blanks, beginning with
                   the current line and ending before the target.
 
       |      Cmdline
       | READ All [Number]      [Tag|Notag]
       |      Nochange [Number]
                   stacks the specified information.  CMDLINE (the default)
                   stacks the command input area.  ALL stacks all changed lines
                   on the screen, followed by the CMDLINE.  NOCHANGE is similar
                   to ALL, but the changes on the screen are not made to the
                   file.  The NUMBER operand causes stacked lines to be
                   prefixed with their file line number.  Specifying TAG causes
       |           each line to include additional information.  READ is
       |           intended for use in macros.  Refer to the XEDIT Reference or
       |           online HELP for more information.
 
       | RECover [n|1|*]
                   recovers lines deleted by DELETE, MERGE, or PUTD.  The
                   recovered lines are inserted before the current line.  All
                   deleted lines (within the limits of available storage) are
                   saved in one buffer and are moved from this buffer by the
       |           RECOVER subcommand.  RECOVER usually can't be used in UPDATE
       |           mode.
 
       | REFRESH   updates the display.  It can be used from a macro to update
       |           the display without ending the macro or waiting for input.
       |           REFRESH is allowed only in display mode.
 
         RENum [start|10 [incr]]
                   renumbers the lines in files with a filetype of BASIC,
                   COBOL, FREEFORT, VSBASIC, or WBASIC.  The default increment
                   is the value of the starting number.
 
 
                                                   Section 2:  Reference     18
 
 
         XEDIT Reference
 
 
 
 
         REPEat [target|1]
                   will advance the current line and repeat the last command.
                   REPEAT is equivalent to entering =UP or =DOWN until the
       |           target is reached, or a non-zero return code occurs.
 
         Replace [text]
                   replaces the current line with "text," or deletes the
                   current line and enters input mode.
 
         RESet     removes all pending prefix subcommands.
 
         RESTore   restores the settings saved by the PRESERVE subcommand.
 
       | RGTLEFT [n]
       |           changes the view columns to display data currently not
       |           visible on the screen.  You can specify the number of
       |           columns to move.  SET VERSHIFT controls the direction of the
       |           shift.  RGTLEFT is a macro and is allowed only in display
       |           mode.
 
         RIght [n] changes the columns displayed so that data to the right of
                   the last column on the screen is visible.  The data will
       |           appear to move to the left.  See also RGTLEFT.
 
         RINPUT id1 id2 [(options...]
                   uses the CMS command INPUT to read a reader spool file into
                   the file being edited.  The parameters and options are the
                   same as those of the CMS command INPUT.  Except for the file
                   destination options (APPEND, DISK, DSTACK, REPLACE, SELECT,
                   and XEDIT), any INPUT option may be specified.  The NOHOLD
                   option is ignored and the spool file is be retained in your
                   reader.  RINPUT inserts the file after the current line (or
                   at the end of the file if the current line is the EOF
       |           indicator).  The current line does not change and the
       |           alteration count is incremented by one.  RINPUT is a macro.
 
         SAVE [fn [ft [fm]]]
               =   =   =
       |           saves the current file in a CMS disk file.  By default, SAVE
       |           is a synonym of PSAVE.
 
         SCHANGE [pfkey]
                   locates and selectively changes occurrences of a specified
                   string.  SCHANGE can only be used in display mode and only
                   from a Program Function key.  To use SCHANGE, place a CHANGE
                   or CLOCATE subcommand in the command area and press the
                   SCHANGE PF key instead of ENTER.  The cursor is placed under
                   the specified string (if found).  Pressing the PF key again
                   will move the cursor to the next occurrence of the string.
                   Pressing the key indicated by "pfkey" on the SCHANGE command
                   will execute the CHANGE subcommand.  Searching begins with
       |           the current line and column pointer.  If you press the
       |           SCHANGE PF key without a CHANGE subcommand on the command
 
 
 
                                                   Section 2:  Reference     19
 
 
         XEDIT Reference
 
 
 
 
       |           line the subcommand in the LASTLORC buffer is used.  SCHANGE
       |           is a macro.
 
         SET keyword [operands...]
       |           is used to control an assortment of XEDIT options.  The
       |           various settings can be examined with the QUERY, EXTRACT,
       |           and TRANSFER subcommands.  The SET subcommand name is only
                   required with the SET =, SET ALT, SET MACRO, and SET MSGLINE
                   subcommands.
 
         SET = text
                   sets the command reuse (=) buffer.  This is intended for use
                   in macros.
 
       | SET ALT n [m]
       |           sets the alteration count to the specified value.  The first
       |           value is the number of alterations since the last autosave,
       |           the second value is the number since the last SAVE.
 
         [SET] APL ON|OFF
                   controls support for the 3270 APL character set.  The
                   initial setting is determined by the CP TERMINAL APL
                   command.
 
         [SET] ARBchar ON [char]
                       OFF
                   defines a character to represent an arbitrary character in a
                   target.  The initial setting is ARBCHAR OFF $.
 
         [SET] AUtosave n [fm|A]
                        OFF
                   causes a SAVE subcommand to be issued automatically when "n"
                   lines have been added, changed, or deleted.  A filemode may
                   be specified.  The file is written to a special CMS disk
       |           file named "rrrnnnnn AUTOSAVE fm."  The SAVE and FILE
       |           subcommands erase the autosave file; QUIT does not.  See the
                   Usage Notes for more information on AUTOSAVE.  The initial
                   setting is AUTOSAVE OFF.
 
         [SET] CASE Uppercase [Respect|Ignore]
                    Mixed [Respect|Ignore]
                   determines how alphabetic characters are treated when
                   entered as data and when used in targets.  UPPERCASE causes
                   all data to be translated to uppercase when entered;  MIXED
                   bypasses this translation.  Data is always displayed with
                   mixed case.  RESPECT causes the case of alphabetic
                   characters to be significant during target searches; IGNORE
                   causes the difference to be ignored ("a" matches both "a"
                   and "A").  The default is CASE MIXED RESPECT for LISTING,
                   MEMO, and SCRIPT files; CASE UPPER RESPECT for all other
                   filetypes.
 
       | [SET] CMDline On|OFf|Top|Bottom
 
 
 
                                                   Section 2:  Reference     20
 
 
         XEDIT Reference
 
 
 
 
                   sets the location of the command line in display mode.
                   CMDLINE TOP causes the command line and default message line
                   to share the same space, and messages must be cleared before
       |           you can enter commands.  CMDLINE OFF removes the command
       |           line.  The status are is not displayed with CMDLINE OFF,
       |           BOTTOM, or TOP.  The initial setting is CMDLINE ON.
 
       | [SET] COLOR field [color] [exthi] [High|Nohigh]
       |           controls color and highlighting used for some areas of the
       |           screen.  Refer to the XEDIT Reference or online HELP for
       |           details.
 
         [SET] COLPtr ON|OFF
                   controls marking the column pointer position in typewriter
                   mode.  The column pointer position is marked with an
                   underscore, and requires that the terminal have a backspace-
                   and-overstrike capability.  The initial setting is COLPTR
                   ON.
 
         [SET] CTLCHAR OFF
                       char Escape
       |               char OFF
       |               char [Protect] [color] [exthi] [High|Nohigh|Invisible]
       |               char [Noprotect] [color] [exthi] [High|Nohigh|Invisible]
                   defines screen formatting control characters for display
                   mode.  The SET RESERVE subcommand can be used to display
                   data on the screen using these characters.  CTLCHAR is
                   intended to be used in macros.  Refer to the XEDIT Reference
                   or online HELP for details.
 
       | [SET] CURLine ON [M] [n|+n|-n|]
       |           specifies the line on a display screen where the current
       |           line will appear.  The current line is highlighted.  M
       |           refers to the middle of the screen; CURLINE ON M is the
       |           initial setting.  CURLINE is allowed only in display mode.
 
       | [SET] DISPlay n [m|*]
       |           specifies the selection levels of lines to be displayed.
       |           SET DISPLAY is used in conjunction with SET SELECT, SCOPE,
       |           and SHADOW.  DISPLAY 0 0 is the initial setting.  Refer to
       |           the XEDIT Reference or online HELP for details.
 
       | [SET] ENTer [BEFORE|AFTER|ONLY|IGNORE]|[string|NULLKEY|COPYKEY|TABKEY]
       |           defines the function of the ENTER key.  ENTER IGNORE COMMAND
       |           CURSOR CMDLINE 1 PRIORITY 30 is the initial setting.  Refer
       |           to the XEDIT Reference or online HELP for details.
 
         [SET] ESCape ON [char]
                      OFF
                   defines the input-mode subcommand escape character.
                   Preceding a line with the escape character in column one
                   while in input mode will cause the line to be treated as a
                   command rather than data.  This function is not provided in
 
 
 
                                                   Section 2:  Reference     21
 
 
         XEDIT Reference
 
 
 
 
       |           display mode.  The initial setting is ESCAPE ON + for BATCH,
       |           JCL, and JOB files, and ESCAPE ON / for other filetypes.
 
         [SET] FILler [char]
                   defines the character used to expand tab characters.  The
                   initial value is a blank.
 
         [SET] FMode fm
               FName fn
               FType ft
                   changes the current fileid.  The new fileid is used by the
                   SAVE and FILE subcommands.  A copy of the file already on
                   disk with the old name is not affected.  No warning is given
                   if a file with the new fileid already exists on disk.
 
       | [SET] FULLread [ON|OFF]
       |           controls the way nulls are treated on a 3270-type display
       |           screen.  Do not use FULLREAD ON when using the 3270
       |           Simulator (S3270).  FULLREAD OFF is the initial setting.
       |           Refer to the XEDIT Reference or online HELP for details.
 
         [SET] HEX ON|OFF
                   specifies whether subcommand string operands and targets can
                   be specified in hexadecimal notation.  XEDIT will convert
                   the hexadecimal notation to the equivalent EBCDIC
                   characters.  The initial setting is HEX OFF.
 
         [SET] IMage ON|OFF|Canon
                   specifies how backspace and tab characters are handled when
                   entered.  IMAGE ON causes backspaces to be interpreted as
                   corrections (deleting the preceding character from the line)
                   and tabs to be expanded with the FILLER character.  IMAGE
                   OFF causes both characters to be treated as normal data
                   characters.  IMAGE CANON causes tabs to be unchanged, but
                   sequences using backspaces will be sorted into canonical
                   order (the characters in collating sequence separated by
                   single backspaces).  The IMAGE setting affects the operation
                   of FIND (and FINDUP, NFIND, and NFINDUP), input mode,
                   OVERLAY, and targets.  Use the SET TABS subcommand when
                   IMAGE ON is in effect to set the columns used for tab
       |           expansion.  The initial setting is IMAGE CANON for SCRIPT
       |           files, and IMAGE ON for most other filetypes.
 
         [SET] IMPcmscp ON|OFF
                   controls how entries not recognized as XEDIT subcommands are
                   handled.  IMPCMSCP ON causes unrecognized entries to be
                   passed to CMS and CP as commands.  IMPCMSCP OFF inhibits
                   this action.  The initial setting is IMPCMSCP ON.
 
       | [SET] LASTLorc text
       |           sets the LASTLORC (Last Locate or Change) buffer.  The
       |           buffer is set by each CHANGE, LOCATE, CLOCATE, and FIND-type
       |           command.  The initial setting is a null string.  LASTLORC is
       |           intended to be used in macros.
 
 
                                                   Section 2:  Reference     22
 
 
         XEDIT Reference
 
 
 
 
         [SET] LINENd ON [char]
                      OFF
                   defines a logical line end character.  The line end
                   character can be used to separate multiple subcommands
                   entered on one line, and to mark new lines when entering
                   data.  The initial setting is LINEND ON #.
 
         [SET] LRecl n
                   changes the current logical record (line) length.  The value
                   cannot exceed the WIDTH option value.  For files with
                   variable-length records, the LRECL is the maximum line
                   length.  For files with fixed-length records, the LRECL is
                   the length of all lines.  Setting an LRECL value less than
                   the current value may cause the settings of TRUNC and ZONE
                   to be reduced and can cause truncation of existing data.
                   The initial setting depends on the filetype.
 
         SET MACRO ON|OFF
                   controls the search order for macros and subcommands.  MACRO
                   ON causes macros to be searched for first.  MACRO OFF causes
                   subcommands to be searched for first.  The initial setting
                   is SET MACRO OFF.
 
         [SET] MASK Immed [text]
                    Define
                    Modify
                   sets the initial contents of new lines added to the file.
                   MASK IMMED sets the mask to the specified text.  MASK DEFINE
                   displays a scale in the command line on which the mask is
                   entered.  MASK MODIFY writes the current mask into the
                   command line to be modified.  The initial setting is a blank
                   line.  DEFINE and MODIFY can be used only in display mode.
 
       | SET MSGLine ON [M[+n|-n]|[+n|-n] [m|1] [Overlay]
       |             OFF
       |           defines the location of the message line.  The second value
       |           (m) defines the number of lines used for messages.  If
       |           OVERLAY is specified the message lines are used for data
       |           until needed for a message.  SET MSGLINE ON 2 2 is the
       |           initial setting.
 
         [SET] MSGMode ON [Short|Long]
                       OFF
                   controls the display of XEDIT messages.  MSGMODE ON SHORT
                   suppresses informational (I) and warning (W) messages, and
                   shortens error (E) messages to the not-sign (¬).  MSGMODE ON
                   LONG displays all of every message.  MSGMODE OFF suppresses
                   the display of all messages.  The initial setting is MSGMODE
                   ON LONG.  The CP command SET EMSG controls the format of the
                   message when MSGMODE ON LONG is in effect.
 
         [SET] NONDisp [char]
 
 
 
                                                   Section 2:  Reference     23
 
 
         XEDIT Reference
 
 
 
 
                   specifies the character to be used to represent characters
                   that cannot be displayed in display mode.  Avoid using the
                   character insert (INS MODE) and delete (DEL) functions of a
                   3270-type terminal on lines containing non-displayable
                   characters, since XEDIT will not always be able to determine
       |           the correct positions of the characters.  NONDISP " is the
       |           initial setting.
 
         [SET] NULls ON|OFF
                   controls how trailing blanks are represented on a 3270-type
                   screen.  NULLS ON causes the blanks at the end of lines to
                   be represented as nulls, thus allowing the use of the
                   character insert function (INS MODE) of the terminal.  NULLS
                   OFF fills lines with blanks, which disables the insert
       |           function.  The PA2 key (or any key set to NULLKEY) sets
                   NULLS ON for the line containing the cursor.  The initial
                   setting is NULLS OFF.
 
         [SET] NUMber ON|OFF
                   controls the display of file line numbers in the prefix
                   area.  NUMBER ON causes the prefix area to contain a five-
                   digit file line number.  NUMBER OFF causes five equal signs
       |           to be displayed (unless the prefix area has been set to
       |           NULLS).  The initial setting is NUMBER OFF.
 
       | [SET] PAn [BEFORE|AFTER|ONLY|IGNORE]|[string|NULLKEY|COPYKEY|TABKEY]
       |           defines the function of a PA (Program Attention) key.  PA1
       |           BEFORE COMMAND CP,  PA2 BEFORE NULLKEY, and PA3 ONLY ?  are
       |           the initial settings.  The setting of the CP break key
       |           overrides the XEDIT PA settings.  Refer to the TERMINAL
       |           command for details about the break key.  Refer to the XEDIT
       |           Reference or online HELP for more about SET PAn.
 
         [SET] PACK ON|OFF
                   specifies how the file is written to disk.  PACK ON causes
                   the file to be written in packed format.  Packed format is
                   also used by the CMS commands PACK and UNPACK.  PACK OFF
                   causes the file to be written in normal format.  PACK OFF is
                   the initial setting.  Refer to the Usage Notes for more
                   information.
 
       | [SET] PENDing [ON|BLOCK|ERROR] string
       |               OFF
       |           controls the execution of prefix macros and the status
       |           display.  PENDING is intended to be used from macros.  Refer
       |           to the XEDIT Reference or online HELP for details.
 
       | [SET] PFn [BEFORE|AFTER|ONLY|IGNORE]|[string|NULLKEY|COPYKEY|TABKEY]
       |           defines the function of a PF (Program Function) key.  The
       |           initial settings are listed under Keyboard Functions.  Refer
       |           to the XEDIT Reference or online HELP for details.
 
         [SET] Point .name [OFF]
 
 
 
                                                   Section 2:  Reference     24
 
 
         XEDIT Reference
 
 
 
 
                   assigns a name to the current line.  This name can then be
                   used as a target to refer to this line, even if its position
                   in the file changes.  The name must be in the form of a
                   period followed by from one to eight characters.  The OFF
                   operand removes the name.  You must remove a name before it
                   can be assigned to a new line.
 
       | [SET] PREfix ON [Left|Right]
                      Nulls [Left|Right]
                      OFF
                      Synonym new old
                   controls the position of the prefix areas, and defines
                   synonyms for prefix subcommands.  PREFIX ON LEFT displays
                   the prefix areas on the left side of the screen, PREFIX ON
       |           RIGHT on the right side.  PREFIX NULLS fills the prefix
       |           areas with nulls.  PREFIX OFF removes the prefix areas.
                   PREFIX SYNONYM is used to define synonyms for existing
                   prefix subcommands.  Prefix subcommand names can be up to
                   five characters (numbers cannot be used).  The initial
       |           setting is PREFIX ON LEFT.
 
         [SET] RANge target1 target2
                   defines limits for movement within the file.  The top range
                   (target1) acts as the new top-of-file, the bottom range
                   (target2) as the end-of-file.  Only the SAVE and FILE
                   subcommands can act outside of the defined range.  The
                   initial range is the entire file, which is equivalent to
                   RANGE :1 *.
 
         [SET] RECFm V|VP|F|FP
                   changes the record format of the file.  "V" indicates
                   variable-length records, "VP" indicates packed variable-
                   length records, "F" indicates fixed-length records, and "FP"
                   indicates packed fixed-length records.  Trailing blanks are
                   discarded when variable-length records are written to disk,
                   which saves a great deal of disk space for most files.
                   Setting RECFM VP or FP will also set PACK ON.  The initial
                   value of RECFM depends on the filetype.  Refer to the Usage
                   Notes for more information about packed files.
 
       | [SET] REMote [ON|OFF]
       |          controls data transmission to a terminal in display mode.
       |           REMOTE ON reduces the amount of data transmitted, but
       |           increases the overhead.  Initially, REMOTE ON is set for
       |           remote terminals, REMOTE OFF for locally attached terminals.
 
         [SET] RESERved [M][+|-]n [color] [exthi] [High|Nohigh] [text]
                                  Off
                   reserves the specified line on the screen in display mode.
                   XEDIT will not use reserved lines.  The OFF operand returns
                   the line to XEDIT for its use.  Use SET CTLCHAR to define
                   attribute characters for use on reserved lines.  RESERVE is
                   intended for use in macros, and is allowed only in display
 
 
 
                                                   Section 2:  Reference     25
 
 
         XEDIT Reference
 
 
 
 
                   mode.  Refer to the XEDIT Reference or online HELP for
                   details.
 
       | [SET] SCALe ON [n]|[M][+n|-n]
                     OFF
                   controls the display of a scale line in display mode.  SCALE
                   ON places the scale under a specified line or the current
       |           line.  SCALE OFF suppresses the scale display.  SCALE ON M+1
       |           is the initial setting.  SCALE is allowed only in display
                   mode
 
       | [SET] SCReen n [Horizontal|Vertical]
       |              Size s [s...]
       |              Width w [w...]
       |              Define ...
                   defines the logical screens displayed on the physical
                   screen.  The first form divides the physical screen into "n"
       |           logical screens of equal size.  The screen can be divided
       |           horizontally or vertically.  The screen can be divided into
       |           unequal parts, and with both horizontal and vertical
       |           divisions.  Refer to the XEDIT Reference or online HELP for
                   details.  The initial setting is one logical screen using
                   the entire physical screen.  SCREEN is allowed only in
                   display mode.
 
       | [SET] SELect [+|-] [target]
       |           sets the selection level for the specified lines.  SET
       |           SELECT is used in conjunction with SET DISPLAY, SCOPE, and
       |           SHADOW.  SELECT 0 is the initial setting.  Refer to the
       |           XEDIT Reference or online HELP for details.
 
         [SET] SERial ON [incr|10 [start|10]]
                      ALL [incr|1000 [start|1000]]
                      string [incr|10 [start|10]]
                      OFF
                   puts sequence numbers in the last columns of each line in
                   the current file when the file is written to disk with SAVE
                   or FILE.  Only files with fixed-length records can be
                   serialized.  SERIAL ON uses the first three characters of
                   the filename and five digits to create the serial numbers,
                   SERIAL ALL uses eight digits, and SERIAL string uses the
                   string as a prefix and as many digits as will fit in an
                   eight-character field.  The initial setting depends on the
                   filetype.
 
       | [SET] SHADow [ON|OFF]
       |           controls the display of shadow lines to indicate lines
       |           excluded from display.  SHADOW ON is the initial setting.
 
       | [SET] SIDcode [string]
       |           sets the string placed in columns 64 through 71 of update
       |           lines.  The initial setting is blanks unless overridden by
       |           the SIDCODE option of the XEDIT command.
 
 
 
                                                   Section 2:  Reference     26
 
 
         XEDIT Reference
 
 
 
 
         [SET] SPAN ON [Blank|Noblank [n|*]]
                    OFF
                   specifies the number of lines which a string may span and
                   still match a string target.  SPAN OFF requires that a
                   string be contained within one line.  SPAN ON defines the
                   number of lines that may be concatenated for searching
                   purposes.  The BLANK operand will cause a blank to be
                   inserted between lines for search purposes.  NOBLANK will
                   concatenate lines with no intervening blank.  The initial
                   setting is SPAN OFF BLANK 2.
 
       | [SET] SPILL [ON|OFF|WORD]
       |           controls what happens to characters that would be truncated
       |           as the result of a CHANGE, CINSERT, SHIFT, and other
       |           subcommands.  ON creates a new line containing spilled
       |           characters, OFF discards spilled characters, and WORD breaks
       |           spilled characters at a word boundary (blank).  The initial
       |           setting depends on the filetype.
 
         [SET] STAY ON|OFF
                   specifies how the current line will be set after a failed
                   target search or FIND-type subcommand.  ON leaves the
                   current line position unaffected, and OFF causes the top or
                   end of the file or range to become the current line.  The
                   initial setting is STAY OFF.
 
         [SET] STReam ON|OFF
                   controls string column target searching.  STREAM ON allows
                   multiple lines to be searched, beginning with the current
                   line and column pointer.  OFF restricts the search to the
                   current line.  The initial setting is STREAM ON.
 
         [SET] SYNonym ON
       |               OFF
       |               [LINEND char] syn [n] cmd
       |               [LINEND char] syn [n [form...] cmd [parms...]]
                   both controls searching for subcommand synonyms and defines
                   synonyms.  SYNONYM OFF disables synonyms.  Refer to the
                   XEDIT Reference or online HELP for details.  The initial
                   setting is SYNONYM ON.
 
       | [SET] TABLine ON [n]|[M][+n|-n]
                       OFF
                   controls the display of a tab ruler in display mode.  ON
       |           places the ruler under a specified line or the current line.
       |           OFF suppresses the line.  TABLINE OFF -3 is the initial
                   setting.  TABLINE is allowed only in display mode
 
         [SET] TABS n [n...]
                   defines logical tab columns.  IMAGE ON must be set for tabs
                   in the input data to be expanded in the file.  The TABKEY PF
                   key function is also controlled by the tab settings.  As
                   many as 28 tab stops may be specified.  The FIND subcommands
 
 
 
                                                   Section 2:  Reference     27
 
 
         XEDIT Reference
 
 
 
 
                   are affected by the first tab column.  The initial setting
                   depends on the filetype.
 
         [SET] TERMinal Typewriter
                        Display
                   controls the mode in which XEDIT will operate.  DISPLAY is
                   the full-screen mode used by default with 3270-type
                   terminals.  TYPEWRITER is the line mode used on other types
       |           of terminals.  DISPLAY is allowed only on 3270-type
       |           terminals.
 
         [SET] TEXT ON|OFF
                   controls support for the 3270 TEXT character set.  The
                   initial setting is determined by the CP TERMINAL TEXT
                   command.
 
         [SET] TOFEOF ON|OFF
                   controls the display of the top and end of file and range
                   indicators.  ON displays the indicators, OFF suppresses the
                   display.  The initial setting is TOFEOF ON.
 
       | [SET] TRANSLat char1 char2 [char1 char2...]
       |                OFF
       |           defines an uppercase/lowercase pair of characters.  This
       |           subcommand is provided to support non-English language
       |           keyboards.  The initial setting defines uppercase/lowercase
       |           pairs of English letters.
 
         [SET] TRUNC n|*
       |           sets the truncation column.  Data entered (or already
       |           existing) beyond the truncation column will be spilled (see
       |           SET SPILL).  The setting may not exceed the record length
                   (LRECL). The initial setting is based on the filetype.
 
         [SET] VARblank ON|OFF
                   specifies whether or not the number of blanks between words
                   is significant in string target searches.  ON ignores the
                   number of blanks between words, OFF requires that the number
                   of blanks between words match.  The initial setting depends
                   on the filetype.
 
         [SET] Verify [ON|OFF] [[Hex] start end] ...
                   controls the display of lines changed by subcommands, and
                   the manner in which data is displayed in display mode.  The
                   ON and OFF operands control the display of changed lines.
                   ON displays them, OFF does not.  HEX causes all data to be
                   displayed in hexadecimal rather than the normal graphic
                   character form.  "Start" and "end" are starting and ending
                   columns that define an area to be displayed.  Multiple pairs
                   of column numbers, optionally preceded by HEX, may be
                   specified.  The same area may be displayed more than once,
                   and in both graphic and hexadecimal form.  The initial
                   VERIFY settings depend on the terminal type and the
                   filetype.
 
 
                                                   Section 2:  Reference     28
 
 
         XEDIT Reference
 
 
 
 
         [SET] WRap ON|OFF
                   controls wraparound during target searches.  ON causes
                   searching to wrap around when the top or end of the file or
                   range is encountered, and stop at the line preceding the
                   current line (and in some cases the column pointer).  OFF
                   suppresses wraparound.  The initial setting is WRAP OFF.
 
         [SET] Zone start end|*
                   specifies the starting and ending zone columns.  Target
                   searching and column pointer movement is confined to within
                   the zone.  The end column may not exceed the truncation
       |           column.  The initial setting is from the first tab to the
       |           truncation column.
 
         SHift Left|Right [cols [target]]
                   shifts data in the current zone either left or right the
                   number of columns specified by "cols."  Lines are shifted
                   beginning with the current line and ending before the
       |           target.  Data shifted past the left zone is lost.  Data
       |           shifted past the right zone is spilled (see SET SPILL).
 
         SORT target [A|D] start end ...
                   sorts lines beginning with the current line and ending
                   before the target in either ascending (A) or descending (D)
                   order, based on the contents of the fields described by the
                   starting and ending column pairs.  The total length of the
                   sort fields cannot exceed 255 characters.  If CASE is set to
                   IGNORE, sorting is alphabetic, with the difference between
                   uppercase and lowercase letters ignored.  Changes made with
       |           the SORT subcommand are not retained in update mode.  SORT
       |           operates outside of the current SCOPE.  SORT is a macro.
 
         SOS operands
                   provides screen operation simulation that can be used from a
                   macro or PF key.  Refer to the XEDIT Reference or online
                   HELP for details.
 
         SPELL [word]
                   checks the spelling of a word.  If no word is specified on
                   the command line, the word beginning at the cursor position
       |           is used (in display mode).  SPELL displays a list of
       |           alternative spellings.  SPELL is a macro and uses the
                   SPELLCHK command.
 
         SPELLFIX  checks the spelling in the current file.  The file is first
                   saved on disk (using SAVE) and then each error detected is
                   indicated for correction.  The SPELLFIX subcommand operates
                   in the same manner as the CMS command SPELLFIX.  SPELLFIX is
                   a macro, and is allowed only in display mode
 
         SPlit [ALigned] Column
                         CURSOR
                         col
                         [Before|After] /string/
 
 
                                                   Section 2:  Reference     29
 
 
         XEDIT Reference
 
 
 
 
                   splits a line into two or more lines.  COLUMN splits the
                   current line at the column pointer position.  CURSOR splits
                   the line containing the cursor at the cursor position (only
                   valid in display mode).  The "col" form specifies a column
                   number at which to split the current line.  The /string/
       |           form splits the current line either BEFORE or AFTER the
       |           string.  ALIGNED causes created lines to have the same
       |           number of leading blanks as the original line.  See also
       |           SPLTJOIN.  SPLIT is a macro.
 
       | SPLTJOIN  splits a line or joins two lines, based on the cursor
       |           position.  SPLTJOIN is a macro
 
       | SSave     is a synonym for COMMAND SAVE.  See SAVE and PSAVE for more
       |           information.
 
         STack target [start [length]]
                   stacks lines beginning with the current line and ending
                   before the target in first in, first out (FIFO) order.  The
                   starting column and length of the data from each line to be
                   stacked may be specified.  The maximum length is 256
                   characters.  STACK is intended for use in macros.
 
         STATus [filename]
                   displays some SET subcommand settings, or creates a macro
                   named "filename" that will contain the SET subcommands and
       |           their values.  Not all settings are included.
 
         TOP       makes a null line preceding the first data line in the file
                   (or range) the current line.  TOP does not alter the column
                   pointer position.
 
         TRAnsfer keyword...
       |           is used within a macro to stack the values of specified
       |           XEDIT variables.  EXTRACT should be used instead of TRANSFER
       |           for new applications.  Refer to the XEDIT Reference or
       |           online HELP for details.
 
         Type [target|1]
                   displays data lines beginning with the current line and
                   ending before the target line.  The format of the data is
                   determined by the SET VERIFY subcommand.  The last line
       |           displayed becomes the current line.  Typed output is limited
       |           to 160 columns.
 
         Up [n|*|1]
                   advances the current line "n" lines toward the top of the
                   file.
 
         UPPercas [target|1]
                   converts lowercase to uppercase beginning with the current
                   line and ending before the target line.  The last line
                   converted becomes the current line.
 
 
 
                                                   Section 2:  Reference     30
 
 
         XEDIT Reference
 
 
 
 
         Xedit [fn|= [ft|= [fm|=]]] [(options...[)]]
                   begins editing for another file, or resumes editing a file
                   already in storage.  If a fileid is specified, a file not
                   being edited is added to a ring of files in storage.  In any
                   case, editing switches to the new file.  If no fileid is
                   specified on the XEDIT subcommand, the next file in the ring
                   is edited.  The FILE and QUIT subcommands remove the current
                   file from the ring and editing resumes with the preceding
                   file (if any).  The SET SCREEN subcommand can be used on a
                   3270-type terminal to allow several files to be viewed
                   simultaneously on the screen, or to view several parts of a
                   single file.  The options are the same as those of the XEDIT
                   CMS command.  Care must be taken when using this subcommand,
                   because issuing the CMS XEDIT command causes XEDIT to be
                   entered recursively and create a new file ring.  The number
                   of files currently being edited is displayed in the status
                   area in display mode, or may be obtained with the QUERY
                   NBFILE subcommand.
 
       | Prefix Subcommands and Macros (For Display Mode Only)
 
       | [n]<  or  <[n]  or  [n]<<  or  <<[n]
       |           shifts the data on the indicated lines left one or more
       |           columns.
 
       | [n]>  or  >[n]  or  [n]>>  or  >>[n]
       |           shifts the data on the indicated lines right one or more
       |           columns.
 
         [n]/  or  /[n]
                   marks the line to become the next current line.  The column
                   pointer may be set by specifying "n".
 
         [n]"  or  "[n]  or  [n]""  or  ""[n]
                   marks a line or block of lines to be duplicated.  Specifying
                   "n" will cause the lines to be duplicated "n" times.  "" is
                   used to mark the first and last lines of a block of lines to
                   be duplicated.
 
         .name     assigns a name to a line.  The name can later be used as a
                   target.  This function is identical to the SET POINT
                   subcommand, except that the name is limited to four
                   characters and replaces an existing name.
 
         [n]A  or  A[n]
                   marks the line after which one or more new lines are to be
                   added.
 
         [n]C  or  C[n]  or  CC
                   marks one or more lines to be copied.  Specifying "n" will
                   cause "n" lines to be copied.  CC is used to mark the first
                   and last lines of a block of lines to be copied.  The
 
 
 
                                                   Section 2:  Reference     31
 
 
         XEDIT Reference
 
 
 
 
                   destination line is marked with the F (following) or P
                   (preceding) prefix subcommand.
 
         [n]D  or  D[n]  or  DD
                   marks one or more lines to be deleted.  Specifying "n" will
                   cause "n" lines to be deleted.  DD is used to mark the first
                   and last lines of a block of lines to be deleted.
 
       | E         extends a logical line by one additional screen line.  You
       |           cannot extend a line on a vertically-split screen.
                   Extension is limited by the SET VERIFY subcommand.
 
         F         marks the destination for a copy or move prefix subcommand.
                   The new lines follow the line marked.
 
         [n]I  or  I[n]
                   inserts new lines into the file.  The I prefix subcommand
                   has the same function as the A prefix subcommand.
 
         [n]M  or  M[n]  or  MM
                   marks one or more lines to be moved.  Specifying "n" will
                   cause "n" lines to be moved.  MM is used to mark the first
                   and last lines of a block of lines to be moved.  The
                   destination line is marked with the F (following) or P
                   (preceding) prefix subcommand.  The original lines are
                   deleted.
 
         P         marks the destination for a copy or move prefix subcommand.
                   The new lines precede the line marked.
 
       | [n]S  or  S[n]
       |           (show) causes the specified lines to be displayed after
       |           having been excluded by the X prefix macro, ALL macro, SET
       |           DISPLAY subcommand, or SET SELECT subcommand.  The S prefix
       |           macro can only be used in the prefix area of a shadow line.
 
         SCALE     causes the scale line to be displayed on the marked line.
 
         TABL      causes the tab line to be displayed on the marked line.
 
       | [n]X  or  X[n] or XX
       |           excludes the indicated lines from the display and the scope
       |           of editing subcommands.
 
         The XEDIT Profile
 
         When the XEDIT command (or subcommand) is executed, it will cause an
         XEDIT macro named "PROFILE" to be executed (if one exists).  You may
         supply an alternate name for the profile with the XEDIT option
       | PROFILE.  The filetype must always be "XEDIT" (this is true of all
       | XEDIT macros).  The profile macro may contain REXX or EXEC 2
         statements, CP commands, CMS commands and EXECs, and XEDIT subcommands
 
 
 
                                                   Section 2:  Reference     32
 
 
         XEDIT Reference
 
 
 
 
         and macros.  These statements and commands can be used to tailor the
         XEDIT environment to your requirements.  For example, Program Function
         keys can be defined, the screen layout altered, the file format set,
         and so on.
 
         The arguments passed to the profile macro are the arguments that were
         specified on the XEDIT command or subcommand.  Additional operands
         (including the fileid) and options may be specified by the profile
         with the LOAD subcommand.  The LOAD subcommand must be the first XEDIT
         subcommand issued by the profile.
 
         The following example demonstrates what sort of things might be placed
         in a "PROFILE XEDIT:"
 
       |      /* Sample XEDIT Profile */
 
       |      address command "MAKEBUF"
 
       |      /* Default filetype will be SCRIPT */
 
       |      arg fn ft fm . "(" options
       |      if ft="" then ft = "SCRIPT"
 
       |      /* Load the file (and exit in case of error) */
 
       |      address xedit
       |      "COMMAND LOAD" fn ft fm
       |      if rc¬=0 then exit rc
 
       |      /* Common Setup */
 
       |      "COMMAND SET AUTOSAVE 25"
       |      "COMMAND SET CASE MIXED IGNORE"
       |      "COMMAND SET ESCAPE OFF"
       |      "COMMAND SET IMAGE ON"
       |      "COMMAND SET RECFM V"
       |      "COMMAND SET SPAN ON BLANK 2"
       |      "COMMAND SET STAY ON"
       |      "COMMAND SET VARBLANK ON"
       |      "COMMAND SET VERIFY OFF 1 *"
       |      "COMMAND SET WRAP ON"
 
       |      /* Determine what sort of terminal we are using.
       |         If it's not a 3270, exit now. */
 
       |      "COMMAND EXTRACT/TERMINAL/"
       |      if terminal.1¬="DISPLAY" then exit
 
       |      /* Additional setup for 3270-type terminals. */
 
       |      "COMMAND SET CURLINE ON 2"
       |      "COMMAND SET MSGLINE ON 2 15 OVERLAY"
       |      "COMMAND SET PF1 SPELL"
       |      "COMMAND SET PF4 SPLTJOIN"
 
 
                                                   Section 2:  Reference     33
 
 
         XEDIT Reference
 
 
 
 
       |      "COMMAND SET PF10 ?"
       |      "COMMAND SET PF11 SOS TABB"
       |      "COMMAND SET PF12 TABKEY"
       |      "COMMAND SET NULLS ON"
       |      "COMMAND SET NUMBER ON"
       |      "COMMAND SET PREFIX ON RIGHT"
       |      "COMMAND SET SCALE OFF"
 
         This file is available as "SAMPLE XEDIT Y2" for use as a base for your
         own profile.
 
         Usage Notes
 
          1.  The XEDIT SET AUTOSAVE subcommand provides an automatic
              checkpoint to ease recovery in case of system failure during an
              edit session.  The facility is enabled with the XEDIT "SET
              AUTOSAVE n" command.  The value "n" specifies how often a
              checkpoint should be taken.  When the specified number of lines
              have been added, changed, or deleted, a SAVE subcommand will be
       |      issued to write the AUTOSAVE file.  AUTOSAVE files are named
       |      "rrrnnnnn AUTOSAVE," where "rrr" is the number of times XEDIT was
       |      called recursively and "nnnnn" is the current AUTOSAVE number.
       |      These numbers begin with 100001 and are incremented when multiple
              files are edited, or if an AUTOSAVE file already exists on your
              disk.  The AUTOSAVE files are automatically erased when you issue
              a FILE or SAVE subcommand, but not if you QUIT, so you may want
              to eliminate these files with the CMS command ERASE.
 
              If the system should fail during a session, the most recent copy
       |      of the file being edited will be the file named "rrrnnnnn
       |      AUTOSAVE".  You may edit this file to determine if it contains
              information that you want; if it does, you can replace the older
              version of the file with the AUTOSAVE file by erasing the
              original file and renaming the AUTOSAVE file.  This can also be
              used to recover from erroneous global changes made to a file.
              Immediately QUIT, erase the original file, and rename the
              AUTOSAVE file.
 
              Most users will find that setting AUTOSAVE to 20 or 30 will
              provide sufficient protection against loss of data.  This can be
              done automatically at the beginning of each session in an XEDIT
              profile.
 
          2.  XEDIT can directly manipulate files that are in packed format.
              Packed files are kept on disk in a special compressed format that
              generally requires much less disk space than files in normal
              format.  Files may be converted to this format with the CMS PACK
              command, or with XEDIT by specifying SET PACK ON or SET RECFM VP
              or FP.  Files can be restored to normal format with the CMS
              UNPACK command, or with XEDIT by specifying SET PACK OFF or SET
              RECFM V or F.  Packed files cannot be processed by most CMS
              commands (like SCRIPT, PRINT, SUBMIT, etc.).  Only XEDIT should
 
 
 
                                                   Section 2:  Reference     34
 
 
         XEDIT Reference
 
 
 
 
              be used to modify a packed file.  Modifying a packed file
              improperly will make it impossible to unpack the file or recover
              the data.  Refer to the description of the CMS PACK command for
              more information.
 
          3.  Remember that a 3270-type terminal is a buffered device; data is
              only read after ENTER or a PF key is pressed.  This allows a
              great deal of data to be entered or changed on a screen without
              any interaction with the computing system, which is especially
              desirable during periods of heavy system load.  However, since
              data is not read until one of these keys is pressed, pressing the
              CLEAR or ERASE INPUT keys will destroy any new data on the
              screen.
 
          4.  Since XEDIT controls a 3270-type terminal's screen and PF keys
              while it is operating, normal system messages cannot be
              displayed.  When the system has a message waiting to display on
              your terminal, it will wait until an interrupt-producing key
              (such as ENTER) is pressed to display the message.  After you
              have read the message, press the CLEAR key once to return to
              XEDIT.  Pressing any other key or pressing CLEAR more than once
              may cause data on the screen to be lost.  Warning messages from
              the system operator will cause the screen to be cleared
              immediately.
 
       |  5.  Refer to the Appendix "XEDIT Default Filetype Attributes" for the
       |      default values of RECFM, WIDTH, LRECL, TRUNC, SPILL, CASE,
       |      SERIAL, and TABS.
 
          6.  XEDIT may be used to examine an OS disk data set.  The data set
              cannot be modified, but it can be saved as a CMS disk file, with
              or without modifications.  To edit an OS data set you must first
              access the OS disk volumes and then define a name to be used by
              XEDIT to refer to the file.  The following commands could be
              used:
 
              OSDISKS
              FILEDEF SYSIN DISK filename filetype H DSN data set name (options
              XEDIT filename filetype H
 
              The OSXEDIT command simplifies this process.
 
          7.  XEDIT has a feature that allows you to create your own XEDIT
              subcommands by combining existing commands and subcommands into
              XEDIT macros.  A macro is a file with a filetype of "XEDIT" and
       |      is very similar to an EXEC (REXX and EXEC 2 are used by XEDIT to
       |      process macros).  Refer to the VM/SP System Product Editor User's
              Guide, the VM/SP System Product Editor Command and Macro
       |      Reference, the VM/SP System Product Interpreter Reference, and
       |      the VM/SP EXEC 2 Reference for more information.
 
 
 
 
 
                                                   Section 2:  Reference     35
 
 
         XEDIT Reference
 
 
 
 
         Messages and Return Codes
 
         XEDIT subcommands use the following return codes (to be checked in
         XEDIT macros):
 
           0  Normal.
           1  Error.  Meaning depends on subcommand.
           2  Target not found.
           3  Operand is valid only in display mode, or other error.
           4  Error.  Meaning depends on subcommand.
           5  Missing or invalid operand.
       |   6  Rejected in profile due to LOAD error, or QUIT subcommand
       |      issued in macro called from last file being edited.
           7  Error building update file.
           8  Pending or incomplete prefix subcommand.
          12  Disk is read-only.
          13  Disk is full.
          20  Invalid character in fileid.
          24  Invalid filemode, or invalid parameter.
          28  File not found.
          32  Error during update.
          36  Disk not accessed.
          88  File too large to fit in storage.
         100  Error writing file to disk.
         104  No storage available.
 
         Details on return codes and messages may be found in the VM/SP System
         Product Editor Command and Macro Reference and VM/SP System Messages
         and Codes.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
                                                   Section 2:  Reference     36
 
 
         XEDIT Reference
 
 
 
 
         Section 3:  XEDIT Default Filetype Attributes
 
 
 
         Use the XEDIT profile to alter these settings.  Note: The "Format"
         column lists the RECFM and WIDTH; the LRECL defaults to the WIDTH.
 
         +--------------------------------------------------------------------+
         |Filetype|Format|TRUNC|SPILL|CASE|SERIAL|SET TABS Columns            |
         |--------|------|-----|-----|----|------|----------------------------|
       | |$EXEC   | F 80 |  72 | OFF | U R|  ON  |2 5 10 15 20 25 30 35       |
       | |$XEDIT  | F 80 |  72 | OFF | U R|  ON  |2 5 10 15 20 25 30 35       |
         |AMSERV  | F 80 |  72 | OFF | U R|  ON  |2 5 10 15 20 25 30 35       |
         |        |      |     |     |    |      |40 45 50 55 60              |
         |ASM3705 | F 80 |  72 | OFF | U R|  ON  |1 10 16 30 35 40 45 50      |
         |        |      |     |     |    |      |55 60 65 70                 |
         |ASSEMBLE| F 80 |  72 | OFF | U R|  ON  |1 10 16 30 35 40 45 50      |
         |        |      |     |     |    |      |55 60 64 72                 |
         |BASDATA | F 80 |  80 | OFF | U R|  OFF |see BASIC                   |
         |BASIC   | F 80 |  80 | OFF | U R|  OFF |7 10 15 20 25 30 80         |
       | |BATCH   | V 80 |  72 | OFF | U R|  OFF |see DIRECT                  |
         |CNTRL   | F 80 |  80 | OFF | U R|  OFF |1 5 8 17 27 31              |
         |COBOL   | F 80 |  72 | OFF | U R|  ON  |1 8 12 20 28 36 44 68       |
         |        |      |     |     |    |      |72 80                       |
         |COPY    | F 80 |  72 | OFF | U R|  ON  |see ASSEMBLE                |
         |DIRECT  | F 80 |  72 | OFF | U R|  ON  |1 5 10 15 20 25 30 35       |
         |        |      |     |     |    |      |40 45 50 55 60 65 70        |
         |ESERV   | F 80 |  71 | OFF | U R|  ON  |see AMSERV                  |
         |EXEC    | V 80 |  80 | OFF | U R|  OFF |1 5 10 15 20 25 30 35       |
         |        |      |     |     |    |      |40 45 50 55 60 65 70        |
         |FORTRAN | F 80 |  72 | OFF | U R|  ON  |1 7 10 15 20 25 30 80       |
         |FREEFORT| V 81 |  81 | OFF | U R|  OFF |9 15 18 23 28 33 38 81      |
         |JCL     | V 80 |  80 | OFF | U R|  OFF |1 3 12 16 18 72 80          |
         |JOB     | V 80 |  80 | OFF | U R|  OFF |see JCL                     |
         |LISTING | V 121| 121 | OFF | M R|  OFF |1 5 10 15 20 25 30 35       |
         |        |      |     |     |    |      |40 45 50 55 60 65 70        |
         |        |      |     |     |    |      |75 80 85 90 95 100 105      |
         |        |      |     |     |    |      |110 115 120                 |
         |MACLIB  | F 80 |  72 | OFF | U R|  ON  |see ASSEMBLE                |
         |MACRO   | F 80 |  72 | OFF | U R|  ON  |see ASSEMBLE                |
       | |MEMO    | V 80 |  80 | WORD| M R|  OFF |see LISTING                 |
       | |MODULE  | V 80 |  80 | WORD| M R|  OFF |see LISTING                 |
       | |NAMES   | V 255| 255 | OFF | M R|  OFF |see LISTING                 |
       | |NETLOG  | V 255| 255 | OFF | M R|  OFF |see LISTING                 |
       | |NOTE    | V 132| 132 | WORD| M R|  OFF |see LISTING                 |
       | |NOTEBOOK| V 132| 132 | WORD| M R|  OFF |see LISTING                 |
       | |PASCAL  | V 72 |  72 | OFF | U R|  OFF |see DIRECT                  |
         |PLI     | F 80 |  72 | OFF | U R|  ON  |2 4 7 10 13 16 19 22 25     |
         |        |      |     |     |    |      |31 37 43 49 55 79 80        |
         |PLIOPT  | F 80 |  72 | OFF | U R|  ON  |see PLI                     |
         +--------------------------------------------------------------------+
 
 
 
                           Section 3:  XEDIT Default Filetype Attributes     37
 
 
         XEDIT Reference
 
 
 
 
         +--------------------------------------------------------------------+
         |Filetype|Format|TRUNC|SPILL|CASE|SERIAL|SET TABS Columns            |
         |--------|------|-----|-----|----|------|----------------------------|
       | |SAS     | F 80 |  80 | OFF | M R|  OFF |see DIRECT                  |
         |SCRIPT  | V 80 |  80 | WORD| M R|  OFF |see LISTING                 |
         |SYNONYM | F 80 |  80 | OFF | U R|  OFF |see CNTRL                   |
       | |TEXT    | F 80 |  80 | OFF | U R|  OFF |see CNTRL                   |
         |UPDATE  | F 80 |  72 | OFF | U R|  ON  |see ASSEMBLE                |
         |UPDT    | F 80 |  72 | OFF | U R|  ON  |see ASSEMBLE                |
         |VSBASIC | F 80 |  80 | OFF | U R|  OFF |see BASIC                   |
         |VSBDATA | V 132| 132 | OFF | U R|  OFF |see LISTING                 |
       | |WATFIV  | F 80 |  80 | OFF | U R|  OFF |see FORTRAN                 |
         |WBASIC  | V 80 |  80 | OFF | U R|  OFF |see BASIC                   |
         |XEDIT   | V 80 |  80 | OFF | U R|  OFF |see EXEC                    |
         |other   | V 80 |  80 | OFF | U R|  OFF |see LISTING                 |
         +--------------------------------------------------------------------+
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
                           Section 3:  XEDIT Default Filetype Attributes     38
 
 
         XEDIT Reference
 
 
 
 
                                                                          INDEX
 
 
 
         -&-                                  CMSG, 11
         &, 9                                 COLOR, 21
                                              COLPTR, 21
         -/-                                  column pointer, 9
         /, 31                                column targets, 9
                                              COMMAND, 11
         -?-                                  COMPRESS, 11
         ?, 9, 31                             COPY, 11
                                              COUNT, 11
         -=-                                  COVERLAY, 12
         =, 9, 20                             CP, 12
                                              CREPLACE, 12
         -"-                                  CTL, 3
         ", 31                                CTLCHAR, 21
         "", 31                               CURLINE, 21
                                              current line, 8
         -A-                                  cursor, 6, 12
         A, 31
         ADD, 10                              -D-
         ALL, 10                              D, 32
         ALT, 20                              DBLANK, 12
         ALTER, 10                            DD, 32
         alteration count, 5                  DEL, 7
         APL, 20                              delete, 7, 12
         ARBCHAR, 20                          DISPLAY, 21
         AUTOSAVE, 20                         display mode, 4
                                              DOWN, 12
         -B-                                  DUP key, 7
         BACKWARD, 10                         DUPLICATE, 12
         BOTTOM, 10
         break key, 24                        -E-
         BURN, 10                             E, 32
                                              editor, 2
         -C-                                  EMSG, 12
         C, 32                                ENTER, 21
         CANCEL, 10                           ENTER key, 6
         CAPPEND, 10                          ERASE EOF key, 6
         CASE, 20                             ERASE INPUT key, 6
         CC, 32                               ESCAPE, 22
         CDELETE, 10                          EXPAND, 12
         CFIRST, 10                           EXPLAIN, 13
         CHANGE, 11                           EXTRACT, 13
         CINSERT, 11
         CLAST, 11                            -F-
         CLEAR key, 6                         F, 32
         CLOCATE, 11                          FFILE, 13
         CMDLINE, 21                          FIELD MARK key, 7
         CMS, 11                              field separator, 7
 
 
                                                                   Index     39
 
 
         XEDIT Reference
 
 
 
 
         FILE, 13                             MERGE, 16
         FILLER, 22                           MM, 32
         FIND, 13                             MODIFY, 16
         FINDUP, 13                           MOVE, 16
         FLOW, 13                             MSG, 16
         FMODE, 22                            MSGLINE, 23
         FNAME, 22                            MSGMODE, 23
         FORWARD, 13
         FTYPE, 22                            -N-
         FULLREAD, 22                         new line, 7
         FUP, 13                              NEXT, 16
                                              NFIND, 16
         -G-                                  NFINDUP, 16
         GET, 14                              NFUP, 16
                                              NONDISP, 24
         -H-                                  NOSEQ8, 3
         HELP, 14                             NOUPDATE, 3
         HEX, 22                              NULLS, 24
         HEXTYPE, 14                          NUMBER, 24
         highlighting, 21
                                              -O-
         -I-                                  OS data sets, 2, 35
         I, 32                                OSXEDIT, 2
         IMAGE, 22                            OVERLAY, 16
         IMPCMSCP, 22
         INLONG, 14                           -P-
         INPUT, 15                            P, 32
         INS MODE, 7                          PA keys, 24
         insert mode, 7                       PACK, 24
                                              packed files, 24, 35
         -J-                                  PAn, 24
         JOIN, 15                             PARSE, 17
         JUSTIFY, 15                          PA1 key, 6
                                              PA2 key, 6
         -K-                                  PEEK, 2
         keyboard, 6                          PENDING, 24
                                              PF, 24
         -L-                                  PF keys, 7, 24
         LASTLORC, 22                         PFILE, 17
         LEFT, 15                             POINT, 25
         line mode, 4                         POWERINP, 17
         LINEND, 23                           PQUIT, 17
         LOAD, 15                             PREFIX, 25, 31
         LOCATE, 15                           prefix subcommands, 8, 16
         long input, 14                       PRESERVE, 17
         LOWERCASE, 16                        PROFILE, 4
         LPREFIX, 16                          PROFILE EXEC, 13
         LRECL, 23                            PROFILE XEDIT, 32
                                              program attention keys, 24
         -M-                                  program function keys, 7, 24
         M, 32                                PSAVE, 17
         MACRO, 16, 23, 32                    PURGE, 17
         macros, 35                           PUT, 17
         MASK, 23                             PUTD, 18
 
 
                                                                   Index     40
 
 
         XEDIT Reference
 
 
 
 
         -Q-                                  STAY, 27
         QQUIT, 18                            STREAM, 27
         QUERY, 18                            SYNONYM, 27
         QUIT, 18                             System Product Editor, 2
                                              S3270, 22
         -R-
         RANGE, 25                            -T-
         RBLANK, 18                           TABL, 32
         READ, 18                             TABLINE, 27
         recall, 9                            TABS, 28
         RECFM, 25                            targets, 9
         record separator, 7                  TERMINAL, 28
         RECOVER, 18                          TEXT, 28
         REMOTE, 25                           TOFEOF, 28
         RENUM, 18                            TOP, 30
         REPEAT, 19                           TRANSFER, 30
         REPLACE, 19                          TRANSLAT, 28
         RESERVED, 26                         TRUNC, 28
         RESET, 7, 19                         TYPE, 30
         RESTORE, 19                          typewriter mode, 4
         retain, 9
         reuse, 9                             -U-
         RGTLEFT, 19                          UP, 30
         RIGHT, 19                            UPDATE, 4
         RINPUT, 19                           UPPERCASE, 30
         RXEDIT, 2
                                              -V-
         -S-                                  VARBLANK, 28
         S, 32                                VERIFY, 28
         SAVE, 19
         SCALE, 26, 32                        -W-
         SCHANGE, 20                          WIDTH, 4
         SCREEN, 26                           WRAP, 29
         SCRIPT, 13
         SELECT, 26                           -X-
         SEQ8, 4                              X, 32
         SERIAL, 26                           XEDIT, 31
         SET, 20                              XEDIT macros, 35
         SET =, 20
         SET EMSG, 23                         -Z-
         SHADOW, 26                           ZONE, 29
         SHIFT, 29
         SIDCODE, 4, 26                       -3-
         SORT, 29                             3270 simulator, 22
         SOS, 29
         SPAN, 27
         SPELL, 29
         SPELLFIX, 29
         SPILL, 27
         SPLIT, 30
         SPLTJOIN, 30
         SSAVE, 30
         STACK, 30
         STATUS, 30
 
 
                                                                   Index     41