Command Line Commands

The syntax and description for each of the command line commands follows.

ARBCHAR

Read syntax diagramSkip visual syntax diagram>>-ARBCHAR--arbchar--------------------------------------------><
 

ARBCHAR sets the arbitrary characters.

Operands

arbchar
specifies a printable (typeable) character.

Return Codes

0
Normal return
202
Invalid operand

Example

'ARBCHAR .'

This example defines the character "." as being the arbitrary character.

Note

The arbitrary character takes the place of text in a string. The default value for the arbchar is a ".". For more information, on how you can do searches with the arbitrary character, see the FIND command, section FIND.

ARGS

Read syntax diagramSkip visual syntax diagram            (1)
         .-----------.
>>-ARGS--+-----------+-----------------------------------------><
         '-arguments-'
 
Notes:
  1. If arguments is not specified, any previously defined arguments are deleted.

ARGS stores the default parameters to be passed to the program being edited when invoked with the text editor EXEC command.

Operands

arguments
specifies the parameter string to be passed. If you do not specify arguments, any previously defined arguments are deleted.

Return Codes

0
Normal return

Example

'ARGS A B C'
'EXEC'
'ARGS'

The first line of this example defines the arguments to be passed as A, B, and C. The second line executes the last saved copy of the file that is currently being edited, passing it the arguments defined in line one. The last line deletes the arguments.

BACKWARD

Read syntax diagramSkip visual syntax diagram             .-1-----.
>>-BAckward--+-------+-----------------------------------------><
             +-+---+-+
             | '-n-' |
             '-*-----'
 

BACKWARD scrolls backward toward the beginning of a file for a specified number of screen displays.

Operands

n
specifies the number of screen displays you want to scroll backward. If you specify an asterisk (*), the screen scrolls to the top of the file and the current line is set to the top of the file. If n is not specified, the screen scrolls back one display.

Return Codes

0
Normal return
202
Invalid operand

Example

'BACKWARD'

This example scrolls one screen toward the top of the file.

Note

The editor, by default, sets PF7 to BACKWARD and PF8 to FORWARD.

BOTTOM

Read syntax diagramSkip visual syntax diagram>>-BOTTOM------------------------------------------------------><
 

BOTTOM scrolls to the bottom of the file.

Return Codes

0
Normal return

Example

'BOTTOM'

This example scrolls to the bottom of the file.

CANCEL

Read syntax diagramSkip visual syntax diagram>>-CANCEL------------------------------------------------------><
 

CANCEL ends the current edit session without saving the changes.

Return Codes

0
Normal return
210
Request failed

Example

'CANCEL'

This example quits the current editor session unconditionally, without saving any file changes.

Notes

  1. CANCEL lets you exit the editor without saving changes, and without any warning messages that changes have been made.
  2. CANCEL is a synonym for QQUIT.

CASE

Read syntax diagramSkip visual syntax diagram            (1)
         .-----------------------.
>>-CASE--+-----------------------+-----------------------------><
         +-MIXED--+-RESPECT----+-+
         |        '-+--------+-' |
         |          '-IGNORE-'   |
         '-UPPER--+-RESPECT----+-'
                  '-+--------+-'
                    '-IGNORE-'
 
Notes:
  1. The default is set in the user profile.

CASE sets the case translation and interpretation preferences.

Operands

UPPER
translates lowercase characters to uppercase when entered.
MIXED
works with each character in its original form.
RESPECT
respects the case of each character while doing a search.
IGNORE
ignores the case of each character while doing a search.

Return Codes

0
Normal request
202
Invalid operand

Example

'CASE MIXED RESPECT'

This example sets the case to MIXED and the sensitivity to RESPECT. For more information on sensitivity, see the FIND command, section FIND.

CHANGE

Read syntax diagramSkip visual syntax diagram>>-CHANGE--/string1/string2/--+-----+--------------------------><
                              '-ALL-'
 

CHANGE changes a string in the file.

Operands

string1
specifies the string being replaced.
string2
specifies the string that replaces string1.
ALL
is a keyword indicating that all occurrences on all lines, from the current line, to the end of the file, are changing.
/
is the delimiting character.

Return Codes

0
Normal return
202
Invalid operand
210
Request failed
223
Search argument not found

Example

'CHANGE /noeditor/editor/'

This example replaces the first occurrence of noeditor with editor.

Note

The CHANGE command respects the sensitivity settings of the editor when locating string1 and when changing string2 as defined by the CASE command or the system default.

CMDLINE

Read syntax diagramSkip visual syntax diagram>>-CMDLINE--+-TOP----+-----------------------------------------><
            '-BOTTOM-'
 

CMDLINE sets the command line display preferences.

Operands

TOP
displays the command line on the second line of the screen.
BOTTOM
displays the command line on the bottom line of the screen.

Return Codes

0
Normal return
202
Invalid operand

Example

'CMDLINE TOP'

This example places the command line on the second line of the screen.

CTLCHAR

Read syntax diagramSkip visual syntax diagram>>-CTLCHAR--+-character-+--+-ESCAPE----+-----------------------><
            '-OFF-------'  +-PROTECT---+
                           +-NOPROTECT-+
                           '-OFF-------'
 

CTLCHAR sets a control character's function.

Operands

character
specifies a control character to use.
OFF
drops all definitions of control characters if OFF is used without specifying a character or drops the specific character if one is specified.
ESCAPE
specifies that the following character in the string, passed to the RESERVED command, is a control character.
PROTECT
specifies that the string passed to the RESERVED command is protected from user input.
NOPROTECT
specifies that user input, passed to the RESERVED command, is allowed on this string.

Return Codes

0
Normal return
202
Invalid operand

Example

'CTLCHAR ! ESCAPE'
'CTLCHAR % PROTECT'
'RESERVED 20 HIGH !% Important Info'

This example defines ! as the escape character and % as the field protection character. After you enter these commands, the screen line 20 will be protected and contain the text that follows the control characters, !%.

CURLINE

Read syntax diagramSkip visual syntax diagram>>-CURLINE--number---------------------------------------------><
 

CURLINE sets the current line display preferences.

Operands

number
specifies the screen line number.

Return Codes

0
Normal return
202
Invalid operand

Example

'CURLINE 3'

This example sets the current display line to screen line 3.

Note

The current line is displayed at the screen line number specified in this command. However, the current line cannot be displayed on line 1 because line 1 is reserved for the title line.

DISPLAY

Read syntax diagramSkip visual syntax diagram>>-DISPLAY-----------------------------------------------------><
 

DISPLAY shows the current edit screen.

Return Codes

0
Normal return
210
Request failed

Example

'DISPLAY'

This example displays the current edit screen.

Note

The DISPLAY command is only useful when it runs from a macro. It displays the current edit session's screen. When it runs from a normal terminal edit session there is no noticeable effect.

DOWN

Read syntax diagramSkip visual syntax diagram         .-1------.
>>-DOWN--+--------+--------------------------------------------><
         '-number-'
 

DOWN scrolls forward in the file.

Operands

number
specifies the number of lines to scroll. If you do not specify number, the screen moves down only one line.

Return Codes

0
Normal return
202
Invalid operand

Example

'DOWN 5'

This example scrolls forward through the file five lines.

EDIT

Read syntax diagramSkip visual syntax diagram         .-NONAME--------------------.
>>-EDIT--+---------------------------+-------------------------->
         +-fileid--------------------+
         '-lib.sublib(mem.type)--LIB-'
 
>--+---------------------+-------------------------------------><
   '-(--MACRO--macroname-'
 

EDIT opens a new edit session.

Operands

fileid
specifies the file ID of the file to be created or edited.
lib.sublib(mem.type)
specifies a VSE Librarian sublibrary and member to be edited.
LIB
is a keyword that follows a VSE Librarian sublibrary member name when a sublibrary member is being edited.
MACRO
is a keyword specifying a group of instructions applied to the file being edited.
macroname
specifies the file name portion of the profile macro file ID (REXX exec name).

Return Codes

0
Normal return
203
File not found
204
Not authorized
211
Invalid file ID
226
File is currently being edited
299
Internal error

Example

'EDIT TEST.EXEC'

This example opens an edit session for the file TEST.EXEC.

Notes

  1. The directory used when editing a file, is determined as follows:
  2. A VSE Librarian sublibrary member is distinguished by using the keyword LIB after the member name. Members must be enclosed in parentheses, quotes are not allowed.
  3. The default user profile macro that the editor tries to call is CICEPROF. The CICEPROF macro creates an ISPF/PDF like environment. A second profile macro, named CICXPROF, is provided. CICXPROF creates a VM/CMS XEDIT like environment.
  4. If a file ID or VSE Librarian sublibrary member name is not specified, an RFS file with the special name, NONAME, is created.

EXEC

Read syntax diagramSkip visual syntax diagram            (1)
         .-----------------------------.
>>-EXEC--+-----------------------------+-----------------------><
         '-REXX_program--+-----------+-'
                         '-arguments-'
 
Notes:
  1. If REXX_program is not specified, the last saved copy of the file that is currently being edited is executed.

EXEC executes a REXX program within an editor session.

Operands

REXX_program
specifies the REXX program name to execute. If you do not specify a name, the last saved copy of the file that is currently being edited will be executed. If any arguments have been defined using the ARGS command, these will be passed.
arguments
specifies the arguments to be passed to the program specified in the REXX_program operand.

Return Codes

n
specifies the return code set by the exit of the called exec
0
Normal return
-3
Exec not found
-10
Exec name not specified
-11
Invalid exec name
-12
GETMAIN error
-99
Internal error

Example

'EXEC TEST1.EXEC X Y Z'

This example executes program TEST1.EXEC and passes X, Y, and Z as arguments.

FILE

Read syntax diagramSkip visual syntax diagram            (1)
         .------------.
>>-FILe--+------------+----------------------------------------><
         '-+--------+-'
           '-fileid-'
 
Notes:
  1. If fileid is not specified, the file is saved as the default file ID.

FILE saves the current file being edited.

Operands

fileid
specifies the file ID of the file. If you do not specify fileid, the file is saved as the default file ID.

Return Codes

0
Normal return
202
Invalid operand
204
Not authorized
207
Insufficient space in file pool
210
Request failed

Example

'FILE'

This example saves the current file being edited, using the current file ID specification for the edit session. The current file ID is initially taken from the file ID specified on the edit command, when an edit session is created.

FIND

Read syntax diagramSkip visual syntax diagram         .-previous_searcharg-.
>>-Find--+--------------------+--------------------------------><
         '-searcharg----------'
 

FIND locates a string of text in the file.

Operands

searcharg
specifies the text string to be searched on. If you do not specify searcharg, a search is performed on the previous search string (previous_searcharg).

Return Codes

0
Normal return
202
Invalid operand
223
Search argument not found

Examples

'FIND REDT'

This example finds the first occurrence of REDT.

'FIND Redt'

If CASE is set to RESPECT then this example will not find the first occurrence of REDT. It will find the first occurrence of Redt. For more information, see the CASE command, section CASE.

The searcharg can contain the arbitrary character, in which case the arbitrary character represents any text string which might be imbedded at the arbitrary character's location.

'FIND ONE.THREE'

This example finds the first occurrence of any string with ONE and THREE joined by another string.

Notes

  1. When the RESPECT flag is set with the CASE command, the case of the searcharg is respected.
  2. The search begins at the current line and continues downward until BOTTOM OF DATA is reached, or a match is made. If BOTTOM OF DATA is reached without a match, then the current line remains where it was before the FIND was processed, rather than making BOTTOM OF DATA the current line.

FORWARD

Read syntax diagramSkip visual syntax diagram            .-1-.
>>-FORward--+---+----------------------------------------------><
            +-n-+
            '-*-'
 

FORWARD scrolls forward toward the end of the file for a specified number of screen displays.

Operands

n
specifies the number of screen displays you want to scroll forward. If you specify an asterisk (*), the screen scrolls to the bottom of the file and the current line is set to the last line of data. If n is not specified, the screen scrolls forward one display.

Return Codes

0
Normal return
202
Invalid operand

Example

'FORWARD'

This example scrolls one screen toward the end of the file.

Note

The editor, by default, sets PF7 to BACKWARD and PF8 to FORWARD.

GET

Read syntax diagramSkip visual syntax diagram>>-GET--+--------+---------------------------------------------><
        '-fileid-'
 

GET imports an RFS file into the current edit session.

Operands

fileid
specifies the file ID of the file.

Return Codes

0
Normal return
203
File not found
204
Not authorized
210
Request failed

Example

'GET POOL1:\USERS\USER1\TEST.EXEC'

This example pulls the REXX File System file TEST.EXEC in after the current line.

GETLIB

Read syntax diagramSkip visual syntax diagram>>-GETLIB--lib.sublib(mem.type)--------------------------------><
 

GETLIB imports a member from a VSE Librarian sublibrary into the current edit session. The file is inserted after the current line.

Operands

lib.sublib(mem.type)
specifies a VSE Librarian sublibrary and member name.

Return Codes

0
Normal return
203
File not found
204
Not authorized
210
Request failed
237
CICSEXC1 Link error
238
CICSEXC1 return code was invalid

Example

'GETLIB MYSLIB.PROJ1(MEM1.PROC)'

This example gets member MEM1.PROC from sublibrary MYSLIB.PROJ1 and puts it after the current line in an edit session.

Note:
GETLIB is the VSE equivalent of the GETPDS function available with CICS/ESA.

INPUT

Read syntax diagramSkip visual syntax diagram             (1)
          .-------.
>>-Input--+-------+--------------------------------------------><
          '-text--'
 
Notes:
  1. If text is not specified, the new line is blank.

INPUT inserts a new line after the current line.

Operands

text
specifies the text being inserted on the new line. If you do not specify text, the new line is blank.

Return Codes

0
Normal return

Example

'INPUT Test Input Data'

This example places the text Test Input Data on a newly inserted line after the current line.

JOIN

Read syntax diagramSkip visual syntax diagram>>-JOIN--------------------------------------------------------><
 

JOIN joins two lines into one.

Return Codes

0
Normal return
210
Request failed

Example

'JOIN'

This example joins the line that the cursor is on with the line immediately following it.

LEFT

Read syntax diagramSkip visual syntax diagram         .-1------.
>>-LEFT--+--------+--------------------------------------------><
         '-number-'
 

LEFT scrolls left in the file.

Operands

number
specifies the number of characters to scroll. If you do not specify number, the screen scrolls left one character in the file. If you specify 0 for number, the file scrolls to the far left side.

Return Codes

0
Normal return
202
Invalid operand
210
Request failed

Example

'LEFT 20'

This example scrolls 20 characters to the left.

LINEADD

Read syntax diagramSkip visual syntax diagram>>-LINEADD-----------------------------------------------------><
 

LINEADD adds a blank line after the cursor line.

Return Codes

0
Normal return
230
Cursor is not in file area

Example

'PFKEY 2 LINEADD'

This example causes the addition of a blank line after the line where the cursor resides (if it is a file line) whenever PF2 is pressed.

Note

LINEADD is mainly useful when assigned to a program function (PF) key. It is by default assigned to PF2.

LPREFIX

Read syntax diagramSkip visual syntax diagram>>-LPREFIX--prefix---------------------------------------------><
 

LPREFIX enters a prefix command into the current line prefix area.

Operands

prefix
specifies any standard prefix (such a C, CC, M, MM, B, A) that is entered during an edit session.

Return Codes

0
Normal return
202
Invalid operand

Example

'LPREFIX D'

This example causes the deletion of the current file line.

Note

LPREFIX is provided to let you use the prefix commands from within edit macros.

MACRO

Read syntax diagramSkip visual syntax diagram>>-MACRO--fileid-----------------------------------------------><
 

MACRO calls a macro.

Operands

fileid
specifies the file ID of the macro you want to run. If this file ID includes a file type suffix, then an attempt is made to call an exec with that suffix. Otherwise, an attempt is made to call an exec whose suffix is EXEC.

Return Codes

n
specifies the return code set by the exit of the called exec
0
Normal return
-3
Exec not found
-10
Exec name not specified
-11
Invalid exec name
-12
GETMAIN error
-99
Internal error

Example

'MACRO POOL1:\USERS\USER1\TEST'

This example calls the macro, POOL1:\USERS\USER1\TEST.EXEC.

Note

Macros have the ability to make calls to the REXX/CICS editor server. Any command that you can enter from the command line of the editor can be run from a macro.

MSGLINE

Read syntax diagramSkip visual syntax diagram>>-MSGLINE--+-+--------+-+-------------------------------------><
            | '-number-' |
            +-OFF--------+
            '-INFO-------'
 

MSGLINE sets the message line display preferences.

Operands

number
displays the message line on the corresponding screen line.
OFF
does not display the message line.
INFO
displays messages in the header line.

Return Codes

0
Normal return
202
Invalid operand

Example

'MSGLINE 2'

This example places the message line on screen line 2.

NULLS

Read syntax diagramSkip visual syntax diagram>>-NULLS--+-ON--+----------------------------------------------><
          '-OFF-'
 

NULLS controls whether the fields on the screen will be written with trailing blanks or trailing nulls.

Operands

ON
specifies that fields on the screen are written with trailing nulls.
OFF
specifies that fields on the screen are written with trailing blanks.

Return Codes

0
Normal return
202
Invalid operand

Example

'NULLS ON'

This example causes trailing nulls on the fields of the screen.

NUMBERS

Read syntax diagramSkip visual syntax diagram>>-NUMbers--+-ON--+--------------------------------------------><
            '-OFF-'
 

NUMBERS sets the prefix area display preferences.

Operands

ON
displays sequential numbers in the prefix area.
OFF
displays equal signs in the prefix area.

Return Codes

0
Normal return
202
Invalid operand

Example

'NUMBERS ON'

This example displays sequential numbers in the prefix area.

Note

Line number sequencing is not done on the data within the edit session, but are pseudo line numbers associated with the file lines during the edit session only.

PFKEY

Read syntax diagramSkip visual syntax diagram                     (1)
                  .-------.
>>-PFkey--number--+-------+------------------------------------><
                  '-text--'
 
Notes:
  1. If text is not specified, the PF key is processed.

PFKEY sets or processes a program function (PF) key.

Operands

number
specifies the PF key that is set or processed.
text
specifies the text that the PF key is set to. If you do not specify text, the PF key is processed.

Return Codes

0
Normal return
202
Invalid Operand
229
Number out of range

Example

'PFKEY 3 quit'
'PFKEY 3'

This example first sets PFKEY 3 to quit and then processes the PF key.

PFKLINE

Read syntax diagramSkip visual syntax diagram>>-PFKLINE--+-TOP----+-----------------------------------------><
            +-BOTTOM-+
            +-number-+
            '-OFF----'
 

PFKLINE sets the program function (PF) key line display preferences.

Operands

TOP
displays the PF key line on the second line of the screen.
BOTTOM
displays the PF key line on the bottom line of the screen.
number
specifies the screen line number.
OFF
removes the PF key from the display screen.

Return Codes

0
Normal return
202
Invalid operand

Example

'PFKLINE BOTTOM'

This example places the PF key line on the bottom line of the screen.

QQUIT

Read syntax diagramSkip visual syntax diagram>>-QQuit-------------------------------------------------------><
 

QQUIT ends the current edit session without saving changes.

Return Codes

0
Normal return

Example

'QQUIT'

This example quits the current editor session unconditionally, without saving any file changes.

Notes

  1. QQUIT lets you exit the editor without saving changes, and without any warning messages that changes have been made.
  2. A synonym for QQUIT is CANCEL.

QUERY

Read syntax diagramSkip visual syntax diagram>>-QUERY--+-CHANGES-+------------------------------------------><
          +-CMDLINE-+
          +-COLUMN--+
          +-DIR-----+
          +-FILEID--+
          +-MSGLINE-+
          +-NULLS---+
          +-NUMBERS-+
          +-PFKLINE-+
          +-PFKEY.n-+
          '-RECORDS-'
 

QUERY displays the current settings of the editor.

Operands

CHANGES
displays the number of modifications to the file since it was last saved.
CMDLINE
displays the current setting of the command line. For more information see the Text Editor command, section CMDLINE.
COLUMN
displays the starting column in the file that is displayed on the screen.
DIR
displays the directory that is associated with the file.
FILEID
displays the name of the file being edited.
MSGLINE
displays the current setting of the message line. For more information see the Text Editor command, section MSGLINE.
NULLS
displays the current setting of NULLS. For more information see the Text Editor command, section NULLS.
NUMBERS
displays the current setting of NUMBERS. For more information see the Text Editor command, section NUMBERS.
PFKLINE
displays the current setting of the PFKLINE. For more information see the Text Editor command, section PFKLINE.
PFKEY.n
displays the command that is processed if PFKEY n is pressed. The n is any number from 1 to 24.
RECORDS
displays the number of lines in the file.

Return Codes

0
Normal return
202
Invalid operand
236
Not defined

Example

'QUERY PFKEY.1'

This example displays the command that is processed when PFKEY 1 is pressed.

QUIT

Read syntax diagramSkip visual syntax diagram>>-QUIT--------------------------------------------------------><
 

QUIT ends the current edit session.

Return Codes

0
Normal return
210
Request failed

Example

'QUIT'

This example exits the editor.

Note

When the current file has been changed, the editor does not let you exit until either a save is done or you enter the QQUIT command.

RESERVED

Read syntax diagramSkip visual syntax diagram>>-REServed--line--+-HIGH---+--+------+------------------------><
                   +-NOHIGH-+  '-text-'
                   '-OFF----'
 

RESERVED reserves a line on the screen for your output.

Operands

line
specifies the line that is reserved and the text is displayed.
HIGH
is a keyword specifying that the text is highlighted.
NOHIGH
is a keyword specifying that the text is the usual intensity.
OFF
is a keyword specifying that the line is freed from its reserved state.
text
specifies a string of text, with optional control characters, that is displayed on the reserved line.

Return Codes

0
Normal return
202
Invalid operand
210
Request failed
229
Number out of range

Example

'CTLCHAR ! ESCAPE'
'CTLCHAR % PROTECT'
'RESERVED 20 HIGH !% Important Info'

This example displays Important Info in a high intensity, protected field on screen line 20.

RESET

Read syntax diagramSkip visual syntax diagram>>-RESET-------------------------------------------------------><
 

RESET terminates any pending prefix commands.

Return Codes

0
Normal return

Example

'RESET'

This example cancels all pending prefix commands.

RIGHT

Read syntax diagramSkip visual syntax diagram          .-1------.
>>-RIght--+--------+-------------------------------------------><
          '-number-'
 

RIGHT scrolls right in the file.

Operands

number
specifies the number of characters to scroll. If you do not specify number, the screen scrolls to the right one character in the file. If you specify 0 for number, the file scrolls to the far right.

Return Codes

0
Normal return
202
Invalid operand

Example

'RIGHT 20'

This example scrolls 20 characters to the right in the file.

Note

If the value you specified causes a target outside of the record, scrolling stops at the right side of the record.

SAVE

Read syntax diagramSkip visual syntax diagram            (1)
         .--------.
>>-Save--+--------+--------------------------------------------><
         '-fileid-'
 
Notes:
  1. If fileid is not specified, the file is saved as the default file ID.

SAVE saves a file to an RFS file or VSE Librarian sublibrary member.

Operands

fileid
specifies the file ID of the file. If you do not specify fileid, the file is saved as the default file ID.

Return Codes

0
Normal return
202
Invalid operand
207
Insufficient space in file pool
210
Request failed

Example

'SAVE SYSTEM:\USERS\USER1\TEST.EXEC'

This example saves the current file to the RFS and names it, SYSTEM:\USERS\USER1\TEST.EXEC.

SORT

Read syntax diagramSkip visual syntax diagram                      .-A-----.  .-1-------.
>>-SORT--+-*-------+--+-------+--+---------+-------------------><
         '-+-----+-'  '-+---+-'  +-fromcol-+
           '-num-'      '-D-'    '-tocol---'
 

SORT sorts the lines from the current line on down.

Operands

*
specifies that all the lines from the current line to the end of the file are sorted.
num
specifies that the lines from the current line for the value of num are sorted.
A
specifies that the lines are sorted in ascending order. (This is the default.)
D
specifies that the lines are sorted in descending order.
fromcol
specifies that the lines are sorted on data beginning in this column. If you do not specify fromcol tocol, sorting begins at the first column.
tocol
specifies that the lines are sorted on data ending in this column.

Return Codes

0
Normal return
202
Invalid operand
229
Number out of range

Example

'SORT * A 5 10'

This example sorts all lines in the file from the current line down and is sorted on columns 5 to 10.

Note

If you sort a large number of lines, the sort will work very slowly.

SPLIT

Read syntax diagramSkip visual syntax diagram>>-SPLIT-------------------------------------------------------><
 

SPLIT splits a line into two lines.

Return Codes

0
Normal return
210
Request failed

Example

'SPLIT'

This example splits the line, that the cursor is on, into two lines. One line contains all the text on that line to the left of the cursor and the line following contains the remaining text (under and to the right of the cursor).

STRIP

Read syntax diagramSkip visual syntax diagram>>-STRIP-------------------------------------------------------><
 

STRIP strips the trailing blanks off all file lines.

Return Codes

0
Normal return

Example

'STRIP'

This example strips all trailing blanks of each file line.

SYNONYM

Read syntax diagramSkip visual syntax diagram>>-SYNONYM--syn--+---------+-----------------------------------><
                 '-command-'
 

SYNONYM assigns a command action to any other valid command.

Operands

syn
specifies any valid command that executes the command action for which it is a synonym.
command
specifies any valid command.

Return Codes

0
Normal return

Example

'SYNONYM GL GETLIB'

This example makes GL equivalent to the command GETLIB.

TOP

Read syntax diagramSkip visual syntax diagram>>-TOP---------------------------------------------------------><
 

TOP scrolls to the top of the file.

Return Codes

0
Normal return

Example

'TOP'

This example scrolls to the top of the file.

TRUNC

Read syntax diagramSkip visual syntax diagram>>-TRUNC--column-----------------------------------------------><
 

TRUNC truncates each line in the file to the given length.

Operands

column
specifies the last column you want to keep.

Return Codes

0
Normal return
202
Invalid operand

Example

'TRUNC 72'

This example truncates all lines in the file to a length of 72 characters.

Note

This command is useful when you are working with data sets that have sequence numbers that require removing. The editor does not currently have support for placing or maintaining sequence numbers in a file.

UP

Read syntax diagramSkip visual syntax diagram       .-1------.
>>-UP--+--------+----------------------------------------------><
       '-number-'
 

UP scrolls backward in the file (towards the top of the file).

Operands

number
specifies the number of lines to scroll. If you do not specify number, the default scroll amount is set to 1.

Return Codes

0
Normal return
202
Invalid operand

Example

'UP 20'

This example scrolls 20 lines backward in the file.