HP 3000 Manuals HP 3000 Manuals
Chapter 3 SUMMARY OF COMMANDS
Summary of TOOLSET/XL Commands
ADD Enables you to add text to the file you are currently
editing.
A[DD] [line number] [BY increment]
AT Sets a breakpoint in a user program.
AT {location} [ |EVERY| n |TIMES| ] [FOR {n } |TIMES|]
{ NEXT } {ALL}
[DO [command-list ] ]
[(BREAK) ]
BREAK Is used in the command list operand of the AT or DATATRACE
command. Returns control to the command interpreter.
B[REAK]
CALLS Displays the names of the main program and currently called
subprograms.
CA[LLS]
CHANGE Allows you to change specific strings or column ranges in the
edit file.
CH[ANGE] [ [ALL] find string] [TO] change string [ [IN] line range] ]
[ [ ,] [ ,] ]
[ [col pos[:col pos]] ]
[Q[UIET]]
CLEAR Removes a breakpoint in the user program.
{location}
CL[EAR] { NEXT }
{ ALL }
COMPILE Causes TOOLSET/XL to call the appropriate compiler for your
COBOL
Pascal source file.
COM[PILE] [sourcefile[version designator] [objfile]
[,sourcefile[version designator] [objfile]]...]
CONVERT Converts files from USASCII or KSAM to TSAM format or from
TSAM to
USASCII format.
CON[VERT] filename1[version designator] [|TO| filename2][UN[NUMBERED]]
COPY Copies text to a file, from a file, or from one location to
another within the edit file.
COP[Y] {char range [TO filename ] [BY increment]}
{ [TO char position] }
{ }
{filename[vers des][char range][TO char position] [BY increment]}
[Q[UIET]]
COPYFILE Copies a named TSAM file to a new file in the current
Workspace.
COPYF[ILE] [filename1[version range][|TO| filename2 [N[EWVERSION]]]]
DATATRACE Monitors the value of a data item in a user program.
DA[TATRACE] data-item[DO command-list[NOMESSAGE] ]
[OFF ]
DELETE Deletes text from an edit file.
D[ELETE][character rangelist][Q[UIET]]
DISCARD Cancels a USE command.
DISC[ARD] filename1[version designator] [,filename2[version
designator]]...
DISPLAY Causes the contents of a specified data item in a user
program to be displayed on the terminal screen.
[ O[CTAL] ]
{rec-item [USING t1[,t2.. ]]}[ I[NTEGER] ] [|FOR| n |ITEMS|]
DI[SPLAY] { data-item }[ C[HARACTER] ]
{"literal" }[ H[EXADECIMAL]]
EDIT Opens a file for editing.
ED[IT] [filename] [line position]
END Terminates a TOOLSET/XL function or activity.
[ A[LL] ]
[ E[DIT] ]
[ L[ISTING] ]
EN[D] [ RE[AD] ]
[ RU[N] ]
[ C[OMPILE] ]
EXIT Exits TOOLSET/XL and returns you to MPE XL.
EX[IT]
FIND Locates a line of text or string in the file you are
editing or reading.
F[IND] [ [ALL] find-string [ |IN| character rangelist] ]
[ line position ]
[level1[#line position] ]
GENERATE Generates COBOL and Pascal data declarations from information
in the data dictionary.
[F[ILE] [NAMELIST]] [V[AR] [line #] ]
GENERATE [E[LEMENT] [NAMELIST]] [T[YPE] [line #] ]
[I[MAGE] ] [ [ENV[line #]][DATA [line #]]]
[C[OMAREA] ] [line # ]
[BY Increment][Q[UIET]]
HELP Accesses the TOOLSET/XL Help facility.
[ OVERVIEW ]
[ function name ]
[ ]
H[ELP] [ [SYNTAX ] ]
[ [PARAMETERS ] ]
[command name [OPERATION ] ]
[ [EXAMPLE ] ]
[ ]
LABEL Allows you to enter a comment for a file version.
LA[BEL] filename[version range] "comment string"
LIBCOPY Is used to add new modules to a copylib from an existing
file.
LIBC[OPY] [filename] [line range] [TO modname[OF libname]]
LIBEDIT Allows you to edit a module in an existing copylib.
LIBE[DIT] [modname [OF libname] [line#]]
LIBLIST Allows you to display the contents of a copylib without
having to convert it from KSAM to TSAM format.
LIBL[IST] [{modname}[OF libname] [|TO| LP] [UN[NUMBERED]]]
[{ALL } ]
LIBPURGE Is used to delete one or more modules from a copylib.
LIBP[URGE] [modname[,modname2...] [OF libname]]
LINK Prepares an object file and creates a program file.
LINK [objfile, progfile]
[;RL=filename[,filename],...]
[;XL=filename[,filename],...]
[;CAP=caplist]
[;NMSTACK=stacksize]
[;NMHEAP=max_heap_size]
[;UNSAT=unsat_name]
[;PARMCHECK=integer]
[;PRIVLEV=integer]
[;ENTRY=entry_name]
[;NODEBUG]
[;MAP]
[;SHOW]
LIST Allows you to list a specific portion of your edit or
read file while in command mode.
L[IST][line rangelist][|TO| LP] [UN[NUMBERED]]
LIST CHANGE Provides a list of the changes between an active version of
a source file and the next version of the same source file.
L[IST] C[HANGE] filename[version range] [|TO| LP]
LISTING Displays a compile listing.
LISTI[NG] [Program-ID] [Stmt#]
[Procedure ]
MODIFY Allows you to change records in your edit file while
you are in command mode.
M[ODIFY][line rangelist]
MOVE (Edit) Moves text from one location to another.
MOV[E] character range |TO| character position [BY increment][Q[UIET]]
MOVE (Debug) Transfers the value of a literal, figurative constant, or
data item to another data item.
{literal }
MOV[E] {data-item-1 } TO data-item-2 [|FOR| n |ITEMS| ]
{fig-constant}
PRINT Sets the flag to determine whether or not hard copy
listing are created during a compile.
PRI[NT] {ON }
{OFF}
PURGE Purges files that are owned by the current workspace.
{filename1[version range] }
PU[RGE] {@ [,filename2[version range]]... }
{WORKSPACE[workspacename] }
READ Allows a TOOLSET/XL formatted file to be read
without being open for editing.
REA[D] [filename[version designator]] [line position]
RECOVER Recovers all versions of a file.
REC[OVER] [filename [U[NLOCK]]]
REDO Allows you to correct and re-execute the last command or
command list.
RED[O]
REFRESH Redisplays the screen if it was accidentally destroyed.
REF[RESH]
RENAME Changes a file's identification within the system.
RENA[ME] filename1|,|filename2
RENUMBER Renumbers all the lines of text in your current edit file.
RENU[MBER] [|by| increment][N[EWVERSION]]
RESTORE Restores a workspace and all files owned by it from tape.
REST[ORE] workspacename [KEEP]
RESUME Restarts the user program execution.
RES[UME] [para-name ]
[section-name ]
RETRACE Lists the most recently executed paragraph(s),
procedures, subroutines, or functions.
RET[RACE] [n |PARAGRAPHS| ]
[ |PROCEDURES| ]
RUN Executes a program file.
RUN [progfile][,[ "]entrypoint[ "]]
[;NOPRIV]
[;LMAP]
[;DEBUG]
[;MAXDATA=maxstack]
[;PARM=parameternum]
[;STACK=stacksize]
[;DL=dlsize]
[;NMSTACK=nmstacksize]
[;NMHEAP=nmheapsize]
G
[;LIB={P}]
S
[;XL="[library [,...]"]
[;NOCB]
[;INFO=quotedstring]
[;UNSAT=[ "]unsatproc[ "]]
[ = [{*formaldesignator}] ]
[;STDIN = [{fileref }] ]
[ [{$NULL }] ]
[ [{*formaldesignator}] ]
[;STDLIST = [{fileref [,NEW] }] ]
[ [{$NULL }] ]
[ {BS}{BM} ]
[;PRI={CS}{CM}{#}]
[ {DS}{DM} ]
[ {ES}{EM} ]
SET EDIT Allows you to view and change edit options that you defined
when you created your edit file.
SET ED[IT]
SET Allows you to change the design features such as page
ENVIRONMENT size.
SET EN[VIRONMENT]
SET Changes the workspace default language.
LANGUAGE
[ C[OBOL] ]
[ P[ASCAL] ]
SET LAN[GUAGE] [|=| O[THER] ]
[ F[ORTRAN] ]
SET LIBRARY Is used to create a copylib and set the default library name
for copylib editing commands.
SET LIB[RARY] [|=| libname]
SET LOG Logs all terminal output to a file.
SET LO[G] = [ ON]
[OFF]
SETREF Designates the Reference version of a source file.
SETR[EF]filename1[version designator1][,filename2[version
designator2]]...
SETVERSION Freezes changes to a file and increments the latest version
number.
SETV[ERSION] [filename]
SET Presents the Set Workspace menu of options.
WORKSPACE
SET W[ORKSPACE]
SHIFT Allows you to shift a block of text to a particular
column and shift text right or left a specified
number of characters.
SHI[FT] line rangelist [|FROM| column number] {|TO| column
number}[Q[UIET]]
{ L number }
{ R number }
SHOW Lists all active functions in your TOOLSET/XL sessions.
ACTIVITIES
SHO[W] A[CTIVITIES]
SHOW DEBUG Displays all active breakpoints and datatrace variables.
SHO[W] D[EBUG]
SHOW EQUATES Displays the file equations that have been set up by the
USE command.
SHO[W] E[QUATES]
SHOW FILES Displays a list of all owned and used files for a particular
Workspace.
SHO[W] F[ILES] [workspacename]
SHOW LABELS Displays any comments associated with a version of a TSAM
file.
SHO[W] LA[BEL] filename[version range]
SHOW LIBRARY Displays the file information about a copylib and the names
of the modules within it.
SHOW LI[BRARY] [libname]
SHOW SOURCE Displays Workspace source files.
SHO[W] S[OURCE]
STORE Stores the entire Workspace onto tape.
ST[ORE] [workspacename]
SYSDEBUG Enters MPE XL Debug when executing a user program.
SYS[DEBUG]
TRACE Identifies each subprogram, section, paragraph, or procedure
just before it executes.
T[RACE] [OFF]
[ON]
UNDO Allows you to cancel the last CHANGE, DELETE, MOVE,
SHIFT, or MODIFY command just entered.
UN[DO]
USE Allows two Workspaces to share ownership of a file
and specifies which version of the file will be shared.
USE filename1[version designator] [,filename2[version designator]] ...
USE [formal1 |FOR|] filename1[version designator]
[,[formal2 |FOR|] filename2[version designator]] ...
WORKSPACE Allows you to create and change Workspaces.
[P[ASCAL]]
W[ORKSPACE] [workspacename][C[OBOL]]
[O[THER]]
[F[ORTRAN]]
XEQ Allows input from a specified file.
X[EQ] filename[version designator]