Introduction to the WYLBUR Text Editor.
Chapter 4: Command Summary.

Commands. Index. Glossary.

On this page:


line.


Editing Commands

Editing Commands List
Command Description
CHANGE changes one set of characters (perhaps a word or a number) in your active file to another character string. The character strings do not have to be the same length, and all occurrences of the first string will be changed within the given range. Use the form

CHANGE 'abcd' to 'efg' IN range

where abcd is the character string you want changed, efg is what you want it changed to, and range is the part of your file where it is to be changed.

Note: You may use upper-, lower-, or mixed-case letters, but your first character string must match the case of the string you want to change. Use single or double quotes to enclose the strings. If the first string is not in your file, you will receive the message

VOID RANGE
COLLECT creates a new active file or adds lines to your current active file. Use COLLECT to enter text or data into the computer. Use the form

COLLECT option

where option can be omitted or replaced by CLEAR, UNN, END, or n.

Note: The COLLECT options can be used together, such as: COLLECT 7.5 CLEAR, COLLECT 7.5 UNN, or COLLECT UNN CLEAR. If a range is given (such as COLLECT 7.5), that line number must not already be in your file.

CLEAR erases what was in your active file before you gave the command.
UNN collects a screen without the line numbers being displayed.
END collects lines at the end of your active file.
n the line number position where you want to enter new text.
COPY copies part or all of another file into your active file. Use the form

COPY range FROM dsname TO n

where range is the section of lines you want copied from the file, dsname is the filename, and n is the line you want the material copied to. If you do not give specific lines, the entire file will be copied.

Note: The destination line for COPY must not already be a line number. WYLBUR may renumber part of your file if you copy a large file to a line between existing lines. Text following the copied text is not affected or replaced.

MODIFY edits your text from a line-mode terminal or edits protected lines (lines that cannot be edited unless the UNPROTECT command is used). Use the form

MODIFY range

where range is the range or text you want to modify.

Editing with MODIFY

When displaying a line for you to modify, WYLBUR puts a line below it for you to type on. For example, while editing a file, if you were to enter MODIFY 5, line 5 would be displayed with a blank line like in the example below:

                    5. As, I was sayng aboute the dog dog FRED

               MODS ?

Use the following commands to modify text.

Commands to Modify Text
C to change character case
I to insert text
R to replace text
S to split text into two lines
X to delete text

To modify the example above, use MODIFY as follows. (Remember: You would use the space bar, not the arrow keys, to move the cursor.)

                    5. As, I was sayng aboute the dog dog FRED

               MODS ?    x                  x     xxxx    RFRED

After you press ENTER , WYLBUR displays another MODS? prompt line for you. If you were to press ENTER again without further corrections, line 5 would display the current status of the line:

                    5. As I was sayng about the dog FRED

Since the line is not correct, you would enter MODIFY 5 again and make the changes shown in the example below:

                    5. As I was sayng about the dog FRED

               MODS ?                                CCC

               MODS ?              Ii

After changing the case of the dog's name, you would press ENTER and insert the text needed. If you were to put "CCC" under "RED" on the same line you insert the "i" in "sayng," you would have seen the following as your correction:

                    5. As I was sayi        CCCng about the dog FRED

Whenever you insert something, anything you put after "I" will be added to the text at that point. After pressing ENTER again following the previous example, the line would display as

                    5. As I was saying about the dog Fred

Note: If you receive the message WINDOWED TEXT CONTAINS UNPRINTABLES - LINES PROTECTED, while in UPDATE, edit the highlighted lines with MODIFY. WYLBUR will not let you edit them from UPDATE. Use the SPACEBAR to move the cursor.

UPDATE Commands
Command Description
NUMBER renumbers your active file. If you do a lot of editing, your file has many lines numbered incrementally, such as 7.1, 7.2, 7.3, or 7.898, 7.899, etc. Renumber your file occasionally so that you can use whole numbers with UPDATE or REVIEW. The form is

NUMBER n/nn

where n is the first line number of the section to be renumbered, and nn is the last line number of the section. If you do not specify a section of lines, the entire file will be renumbered.

REVIEW looks at or reviews your active file. Use the form

REVIEW option

where you may specify options, such as the range or a character string. If you do not give an option, the entire file will be reviewed.

Note: Use upper-, lower-, or mixed-case character strings, but you must match the case of the string you are searching for. Use single or double quotes to enclose the strings. If the message MORE... is displayed in the corner of your screen, press ENTER to move to the next screen. If the first string is not in your file, you will receive the message VOID RANGE. You may not edit on the screen while you are using REVIEW. Press PA1 or BREAK to leave REVIEW before the final screen.

UPDATE edits your file. UPDATE allows you to change existing text on the screen or to use line number commands. To use UPDATE, use the form

UPDATE option

where you may specify options, such as the range or character string. If you do not designate an option, the entire file will be scrolled through for updating.

Note: Use upper-, lower-, or mixed-case character strings, but you must match the case of the string you are searching for. Use single or double quotes to enclose the strings. If the message MORE... is displayed in the corner of your screen, press ENTER to move to the next screen. If the first string is not in your file, you will receive the message VOID RANGE. Press PA1 or BREAK to leave UPDATE before the final screen. If you are using BREAK to leave UPDATE, make sure you press ENTER before pressing BREAK; otherwise, all the changes you made since you last pressed ENTER will be undone.

If you receive the message WINDOWED TEXT CONTAINS UNPRINTABLES - LINES PROTECTED while in UPDATE, edit the highlighted lines with MODIFY. WYLBUR will not let you edit them from UPDATE.

WINDOW When you use REVIEW or UPDATE, your screen is a "window" that lets you see your text. The window is always representative of what is in your active file. Sometimes lines are longer than your screen is able to display. In order to move your window to see the unseen parts of the text, use the form

WINDOW direction spaces

where direction is the direction to move the screen, such as LEFT or RIGHT, and spaces is the number of spaces, or "columns," to move the window. If the number of spaces is not given, the window will move--right or left--40 spaces (columns), unless you try to move left when the window is already in its left-most position.

Line number commands (LNC) allow you to insert, move, copy, delete, duplicate, and split lines without leaving UPDATE. LNCs are explained in the next table.

Note: WINDOW commands may be abbreviated WR for WINDOW RIGHT and WL for WINDOW LEFT. Use the arrow keys to move the cursor to the command prompt, type the WINDOW command over your existing command, and erase whatever is left showing of the current command; after the window has moved, your former command will be displayed again. The WINDOW RIGHT and LEFT commands do not affect the range of lines showing on the screen. You will see the same text; however, it will be shifted in one direction or the other.

Also, WINDOW commands do not abort the current command (i.e., UPDATE, REVIEW, etc.), but merely move the active file window so that the unseen columns of the current lines will be displayed and can be modified without affecting the completion of the current command range.

Pressing PA1 will break the range of a command and cause any screen modifications to be ignored. Current lines are redisplayed to ensure that the current window is the active file.

Line Number Commands

To use line number commands, type the command into the line number fields to the left of your text. You can set your screen so that you can use line number commands, or you can set it so that you do not have to TAB over line number fields when inserting text. Use the command

SET WINDOW LNC

to use line number commands and

SET WINDOW NOLNC

to protect the line number command fields.

In the following explanations, n is an optional one- to eight-digit number. If no number is given, n equals 1.

Line Number Commands
LNC Description
Insertion
In n indicates the number of lines to insert immediately following this line.
Replication
Rn n indicates the number of times to duplicate the line. The duplicated lines will be placed immediately following the original.
RRn indicates the first or last line of a block of lines to be repeated immediately following the block. n indicates the number of times to duplicate the block. When both ends of a block have been identified, the operation will be performed.
Deletion
Dn n indicates the number of lines to delete, starting with this line.
DD indicates the first or last line of a block of lines to be deleted. When both ends of a block are marked, it will be deleted.
Copying
Cn n indicates the number of lines to copy to a new location. See "Destinations" below.
CC indicates the first or last line of a block of lines to be copied. When both ends of a block and the destination have been identified, the operation will be performed.
Moving
Mn n indicates the number of lines to move to a new location. See "Destinations" below.
MM indicates the first or last line of a block of lines to be moved. When both ends of a block and the destination have been identified, the operation will be performed.
Destinations
An indicates that the destination of a move or copy command is after this line. n indicates the number of times to repeat the group of lines being moved or copied.
Bn indicates that the destination of a move or copy command is before this line. n indicates the number of times to repeat the group of lines being moved or copied.
Text Split
TSn splits a line at the character after the cursor. Text after the cursor moves to a new line. A blank line to hold new text is inserted between the two lines. n indicates the number of blank lines to be inserted.

Rules for Entering Line Number Commands

Since line number commands are typed over numbers, there are rules for defining n.

  1. If the cursor was in the line number field when you pressed ENTER, it shows the end of n.
  2. A blank shows the end of n.
  3. Otherwise, the last number different from the original line number is the last digit in n. If the line number field has not been changed (with the exception of the line number command), n=1.

Incorrect commands are highlighted, and you will see the message UNRECOGNIZED LINE NUMBER CMD at the top of your screen. WYLBUR will remember parts of your file if it needs room to obey the commands you have given it.

Pending Operations

Incomplete (pending) line number commands are displayed until they are completed. When a move, copy, or delete is incomplete (i.e., no destination is given), a pending message will be displayed. During an incomplete operation, only certain commands can be given, such as REVIEW or UPDATE. Abort a pending operation with PA1 (BREAK).

Working with Files

Commands for Working with Files
Command Description
SAVE places a copy of your active file as an "external" file on a magnetic disk pack. The command form is

SAVE dsname option ON pack

where dsname is the name you want to give the file, and option can be omitted or replaced with REPLACE or CLEAR. REPLACE writes over an existing file of the same name; use it to save a correct copy of a file in place of the old one. CLEAR saves the file and erases your active file. ON is used when you want to save the file on a disk pack other than the default pack for your account, and pack is the disk pack you want to save it on instead.

Note: Make sure you save files on packs you are authorized to use; otherwise, they will be erased. Store files on TPPAK1 only in your library called LIB.

SCRATCH erases files you no longer want to keep. Use the form

SCRATCH dsname ON pack

where dsname is the name of the file you want to erase, ON tells WYLBUR the file is on a specific disk pack, and pack is the name of the disk pack. If "ON pack" is omitted, WYLBUR will look on your default pack. See SET VOLUME below.

SHOW CATALOG lists the files and libraries you have saved on the various magnetic disk packs. This command will not show the files in your libraries (see SHOW DIRECTORY). Because the system catalog keeps track of where your files are, use the command

SHOW CATALOG
to show you all the files you have on the system catalog.

Note: If you do not access a file or library for 30 days, it is archived. This means that it will be listed when you give the SHOW CATALOG command, but when you give a SHOW DIRECTORY or SHOW DSNAMES command, you will get the message

dsn NOT ON pack

where dsn is the name of the file, and pack is the name of the disk pack it was on. To get your file back from archive, enter the command

TECH RESTORE

TECH RESTORE runs about every four hours, and your file will be restored from the archive during the next run.

SHOW DIRECTORY lists the files in your libraries. The command form is

SHOW DIRECTORY IN lib

where lib can be replaced by the name of the library you want to see or can be omitted to default to the library named LIB. By typing only

SHOW DIRECTORY

you will receive the names of all files in your library called LIB, but if you type

SHOW DIRECTORY IN MYLIB

you will be shown the names of all files in your library called MYLIB.

See note under SHOW CATALOG.

SHOW DSNAMES checks the size of files and checks to see if they have been archived. Use the command form

SHOW DSNAMES LIKE dsname size ON pack

where dsname is the name of a specific file you are looking for or can be omitted to show all datasets (files), size is an optional command telling WYLBUR you want to see how much space each of your files occupy, ON tells WYLBUR you want to see all the files specified by "dsname" on a certain pack, and pack is the name of the disk pack. If you leave size off, WYLBUR will respond with a list of your files and what packs they are on. If you specify size, WYLBUR will tell you how big your files are and, if they are libraries, how much space is being used inside them.

See note under SHOW CATALOG.

USE brings a copy of a file you have saved on a disk pack into your active file so that you can work with it. Anything you do to a file you have used does not affect the original file unless you use the SAVE command and replace it with a new copy. The command form is

USE dsname ON pack CLEAR

where dsname is the name of the file you want to use, ON tells WYLBUR you want it from a specific disk pack, pack is the name on that magnetic disk pack, and CLEAR erases whatever was in your active file before you gave this command. If you do not specify CLEAR and you have something in your active file, WYLBUR will prompt

OKAY TO CLEAR?

Any response other than YES, Y, or OK will stop the USE command, and you will be where you were right before you gave this command. If you do not specify a pack, WYLBUR will look on your default pack. See SET VOLUME below.

Note: Remember to save your work before giving the USE command to bring another file into active status.

Running a Job

Commands for Running a Job
Command Description
FETCH retrieves a copy of your job from the system so that you can see it on the screen. The form to use is

FETCH jobid MC CLEAR

where jobid is the number the system has assigned to the job you want to FETCH, MC means you want the job FETCHed with machine carriage-control characters in the first column (may be omitted), and CLEAR means you want your active files erased and replaced with the job you are FETCHing.

Note: The jobid may be replaced with an asterisk (*) if you want to FETCH the last job run. Make sure you have saved your work before you FETCH your job "CLEAR."

LIST OFFLINE sends a copy of your active file to the printer. Use the form

LIST OFFLINE UNN

to print your file without line numbers. If you omit UNN, your file will print with the line numbers you see on the screen.

LOCATE shows what jobs you have in the system and what they are doing. The command form is

LOCATE jobid

where jobid can be omitted or replaced with the jobid of the job to be located. If you omit a jobid, LOCATE will give a listing of every job you have running or waiting to print. The list will be in the form

JOB jobid UUUGG017 message

where UUUGG will be your userid (group ID at the end), 017 is an example of what you would see as the number of jobs you have run that day, and message stands for the various messages you can receive. The most common of these messages are listed below.

ON READER Your job has not yet run; the JCL is being checked.
AW EXEC C=C POS=7
PRI=09
Your job has not run; it is waiting in line to execute, Position 7.
AW FET Your job is finished, and you can FETCH it now.
AW OUT Your job has run; it is waiting to print.
ON OUT Your job is printing.
JOB NOT FOUND You have no jobs on the system.
PRINT releases a job you have RUN with the FETCH option. Use the command form

PRINT jobid

where jobid can be replaced with the jobid of the job you want to print, or it can be replaced with an asterisk (*) if the job is the last job you ran.

PURGE removes jobs from the system you do not want to run or print. Use the form

PURGE jobid

where jobid can be replaced with the jobid of the job you want to print or replaced with an asterisk (*) if the job is the last job you ran.

RUN submits a job to the computer for processing. Use the command form

RUN FETCH

where FETCH means that you do not want the job to print until you release it. If you omit FETCH, the job will print when it has finished running and a printer is free. In the example,

RUN

your active file will be submitted to the computer for processing. In the example:

RUN FETCH

your active file will also be submitted to the computer for processing, but it will not print until you release it with the PRINT command. It will remain in the system for 24 hours or until you PURGE it, whichever comes first.

Using QWIK Files

Commands for Using QWIK Files
Command Description
COPY copies part of a QWIK file into your active file. Use the form

COPY range1 REF qname TO range2

where range1 is the section of the file you want copied, qname is the name of the QWIK file you want to copy from, and range2 is where you want it copied to.

ERASE deletes a QWIK file you do not want. Use the form

ERASE qname

where qname is the name of the QWIK file to be deleted.

IDENTIFY designates your active file as a QWIK file. Use the command form

IDENTIFY qname

where qname is the name you are giving to the QWIK file.

Note: The QWIK filename will appear on your screen as

ID=qname

where qname is the name of the QWIK file you have in your active file.

REFERENCE sets up additional QWIK files once you have identified your active file as a QWIK file. This command can also be used to move between existing QWIK files. The command form is

REFERENCE qname new

where qname is the name of the QWIK file, and new is used if you are creating a new QWIK file called qname.

Note: You may have up to five QWIK files. QWIK files are saved automatically when the system goes down as

QWIK.qname

where qname is the name of the QWIK file. If you are not sure what your QWIK files names were, enter

SHOW DSNAMES LIKE QWIK

to see a list of all the QWIK files that were saved. USE these QWIK files and SCRATCH them. If you do not scratch them, but identify QWIK files with the same name, and the system goes down again, your new QWIK files will be lost.

SHOW FILES shows all the QWIK files you currently have. An asterisk (*) will show beside the QWIK file you have in your active file. The form to use to display all your QWIK files is

SHOW FILES

Customizing Your WYLBUR Session

Commands for Customizing WYLBUR
Command Description
SET BIN tells WYLBUR in which bin you want your printouts. This way, WYLBUR will not prompt

BIN?

every time you run a job. The form is

SET BIN nnnn

where nnnn is the four-digit bin number you want (use the last four digits of your Social Security number).

SET DESTINATION tells WYLBUR where you want your jobs printed and dispatched. Use the form

SET DESTINATION dest

where dest can be replaced by ACS, BA, or LOCAL. Technology Support will print your jobs at the ATLC in the west basement of the Library. BA will print your jobs at Business Administration, and LOCAL will print your jobs to be dispatched in the Computer Center.

Note: Put SET DESTINATION in your log-on file so that you do not have to use it every session.

SET KEYWORD changes your password (keyword). The command form is

SET KEYWORD newkey

where newkey can be omitted or replaced by a new password. This option allows you to see what you are typing if you think you might type your password wrong. You will be prompted for your old keyword (password). If you do not use the newkey option, you will be prompted for both your new and old passwords.

SET KEYWORD

will begin the change prompts:

OLD KEYWORD:
NEW KEYWORD:
NEW KEYWORD:

where the second NEW KEYWORD is for verification of your typing.

SET TABS sets up to 12 tabs. CLEAR TABS erases the current logical tab settings. To clear the physical tabs, space to the end of the line, and press CLEAR-ATTN or CLEAR-RETURN. Then type the command

SET TABS

See the screen example below for the response.

After you type the command SET TABS, you will see:

TYPE A "T" BENEATH EACH POSITION AT WHICH YOU SET A TAB.
        1234567891123456789212345678931234567894123456789...
START?

Start at the left and space to each column where you want to set a tab. Press the TAB key on the keyboard and then the letter "T." The maximum number you can set is 12 tabs. WYLBUR will verify the tab positions by displaying a "V" in each position you set a tab. In the example below, the tabs are set at 8, 28, and 37:

TYPE A "T" BENEATH EACH POSITION AT WHICH YOU SET A TAB.
        1234567891123456789212345678931234567894123456789...
START?         T                   T        T
               V                   V        V

More Commands to Customize WYLBUR
Command Description
SET TERSE/VERBOSE controls what appears on your screen for a command prompt. The form is

SET option

where option can be replaced by TERSE or VERBOSE. TERSE will set the command prompt to "?" (in uppercase text entry) or ">" (in mixed-case text entry). VERBOSE will set the command prompt to "COMMAND?" (in uppercase text entry) or "COMMAND>" (in mixed-case text entry).

SET UPLOW/UPPER sets the case of the text you are entering. The command form is

SET option

where option can be replaced by UPLOW or UPPER. UPLOW will set the case of the text you are entering as uppercase and lowercase (mixed-case). UPPER will set the case of the text you are entering to uppercase only.

Note: Set the toggles on your terminal to agree with the type of text entry you are doing. If you are entering uppercase only, use SET UPPER, but also make sure the toggle on your terminal is set to the "A," and not the "A,a." If you are entering uppercase and lowercase text, use SET UPLOW and press the toggle on your terminal toward "A,a" and not "A." SHOW CASE will ask WYLBUR to tell you which option you are using.

SET VOLUME changes the volume you want WYLBUR to use for storing your files. Use the form

SET VOLUME pack

where pack is the name of the disk pack you want WYLBUR to use.

Note: Set your volume to the disk pack you use the most. Put this command in your log-on file so you will not have to type it in every session.

Logging Off

Commands for Logging Off
Command Description
LOGOFF ends your WYLBUR session. The command form is

LOGOFF option

where option can be omitted or replaced by CLEAR, ERASE, or SAVE.

Note: Any response, other than YES, Y, or NO to a prompt during log-off will abort the log-off, and you will still be in your WYLBUR session. Make sure you have saved all your work before you LOGOFF ERASE.

CLEAR erases your active file. If you do not specify CLEAR and you have an active file, WYLBUR will prompt "OK TO CLEAR?".
ERASE deletes any QWIK files you have and clears the active file. If you do not specify ERASE and you have QWIK files, WYLBUR will prompt "OK TO ERASE?" for each QWIK file.
SAVE saves your active and QWIK files to disk as you log-off. QWIK files will be cataloged under QWIK.name (where name is the name you gave the QWIK file), and your active file (if it is not a QWIK file) will be saved as ACTIVE. The command LOGON is the same as LOGOFF SAVE.
LOGON Use LOGON as you do LOGOFF SAVE. See above for more information.

line.

Site Search Options

[© 2/2001 Documentation Home] [Laws and Policies] [TTU Home Page]
Updated July 29, 2003