TCL Commands

TCL Commands, which operate exclusively on files and items, use a consistent form to specify the file and items:

tcl.Commands file.reference {item.list} {(options)}

The following TCL Commands are presented (use the alphabetic table below to quickly jump to TCL commands that begin with a specific letter):

NOTE	See the TCL Command Categories section for categorized listings of many TCL commands.

A
! Command	Creates a UNIX shell and executes any UNIX command.
abs-dump Command	Dumps the abs file to magnetic media, creating a bootable tape.
abs.fid Command	Displays the ABS information.
account-coldstart Macro	Performs any account specific coldstart processes and allows users to define their own custom sequence of activities to perform each time the system is powered on or rebooted.
account-maint Command	Invokes a menu to create, modify, or delete user accounts.
account-restore Command	Restores an account from an account-save, file-save, or md-save magnetic media or pseudo tape.
account-save Command	Saves individual accounts to the currently attached peripheral storage device.
add Command	Adds two integer numbers together and displays the result as an integer number.
addbi Command	Extends the functionality of the D3 monitor by making new C functions available to FlashBASIC.
addx Command	Adds two hexadecimal numbers and displays the result as a hexadecimal number.
admin Utility	Contains systems administration functions and must be invoked from the dm account.
admin.files Utility	Used for data backup and restore.
admin.maint Utility	Used for creating and maintaining users and accounts.
admin.status Utility	Provides information on the users that are logged on to the system as well as reporting the status of the system lock table.
admin.tape Utility	Contains options to list the devices as well as commands to set up tape devices for usage.
admin.tape.setup Utility	Assigns the various tape devices for use.
alarm Command	Schedules a task at a given time, or after a given delay in seconds, at a given date.
assignfq (UNIX) Command	Assigns a printer device driver to a spooler form queue.
assignfq (Windows) Command	Assigns a printer device driver to a spooler form queue.

B
b/list Command	Formats and outputs BASIC source code listings.
basic Command	Invokes the BASIC and/or FlashBASIC compiler, which translates the specified source code into executable object code with case-sensitivity in effect.
basic-prot Command	Toggles or displays the status of the FlashBASIC object protection scheme.
bformat Command	Formats a BASIC source program and updates the source file with the formatted item.
blist Command	Formats and outputs BASIC source code listings, according to the options chosen.
blkio Command	Displays or sets the I/O blocking factor, or number of frames read in one disk access during sequential file accesses.
block-print Command	Produces a banner by converting characters to a large block format, made up of rows and columns of the character itself.
bootstrap Command	Reloads the D3 operating system software from a currently executing system and then invokes the coldstart procedure.
break-key-Command	Toggles the availability of the BREAK key, or displays its present status when issued without options.
break-key-off Macro	Disables the BREAK key on the current port.
break-key-on Macro	Enables the BREAK key on the current port.
brk-debug Command	Indicates that the BREAK key invokes the debugger on subsequent uses.
brk-level Command	Causes the BREAK key to push a level on subsequent uses.
buf-map Command	Displays a visual map of the file system, indicating which frames are currently being held in the RAM buffer area, and updates the display every few seconds.
buffers Command	Displays a single snapshot of the status of memory-resident buffers.
buffers.g Command	Produces a graphic histogram of buffer usage for a range of dates and times.
bulletin.board Command	Prints bulletins from the bulletin file located in the dm account.

C
cal Macro	Executes the UNIX cal command.
callx-off Command	Disables callx triggers. This command is only available from the DM account.
callx-on Command	Enables callx triggers. This command is only available from the DM account.
capt Command	Enables or disables the capturing of every TCL command issued.
capture-off Command	Disables the automatic capturing of TCL commands previously invoked with the capture-on command.
capture-on Command	Enables the capturing of every TCL command issued.
case Command	Toggles case-sensitivity on the current port, or displays its present condition when used without options.
case-file Command	Converts the case of items to either uppercase or lowercase.
cat Command	Displays information about the size and location of BASIC object code.
catalog Command	Creates an entry in the master dictionary of the current account, making the specified BASIC or BASIC program executable directly from the TCL prompt.
cd Command	Changes the current working directory to the specified new directory.
charge-to Command	Changes the current accounting charges accumulation.
charges Command	Displays the current account usage statistics, including the total time logged on and CPU activity statistics.
check-account Macro	Performs a dummy save of an account by issuing the save command with the f, d, and i options.
check-dx Command	Looks through every file on the system to find and identify those that have a dx, dy, or dl in attribute 1 of the D-pointer.
check-file Command	Performs a consistency check on a file similar to that performed by the save command with the f, s, and t options.
check-files Macro	Performs a dummy save of the entire system.
check-resizing Command	Completes rehashing files in the process of being resized.
check-ws Command	Validates the integrity of the workspace for a given port.
check.pib Command	Displays the PIB information, such as PIB status, virtual return stack, workspace status, any basic programs being executed, as well as locks, peqs, files, items, connections and other objects being used by that PIB.
chg-device Command	Changes a tape device.
chksum Command	Calculates a hexadecimal checksum for either an entire file or a list of items in the file, and outputs the results to a file.
choose.term Command	Selects one of a variety of choices of terminal type characteristics as an alternative to using the term-type command.
cleanpibs Command	Clears tandem connects for all ports logged on before port 0.
clear-basic-locks Macro	Displays and clears all 64 BASIC execution locks.
clear-file Command	Clears the dictionary or data section of the specified file of all items and retains the primary file space area.
clear-index Command	Clears the specified B-tree index expression in the specified file, leaving only a null root.
clear-jobs Command	Selects items with the status logoff or completed, and deletes them from the dm,jobs, file.
clear-locks Command	Clears all locks, or specific locks according to the options provided.
cls Command	Clears the screen, leaving the cursor at the : prompt at the bottom of the screen.
cmdu Command	Produces a report of the last TCL command issued by every active user on the system.
coldstart Command	Initiates the sequence of activities that must be performed each time the system is powered on.
coldstart-accounts Command	Invoked by the coldstart to call the account-coldstart macro.
coldstart.log Command	Records the type of shutdown taking place into the errors file.
compare Command	Compares items line-by-line to find which lines have been inserted, deleted or changed.
compare-list Command	Forms a single list from two lists using the intersection, union, or exclusion operators.
compile Command	Invokes the BASIC compiler and translates the specified source code into executable object code with case-insensitivity.
compile-catalog Command	Compiles and catalogs a BASIC program.
compile-run Command	Compiles and runs a BASIC program.
compile.flash.all Command	Allows you to compile all BASIC programs currently compiled with FlashBASIC, either in one or all accounts on the system.
console-blank Command	Sets the blank out time or turn off the blank out feature.
control-chars Command	Enables or disables the entering of control characters at input, depending on the option specified.
conv-case Command	Converts the characters within specified items plus the item-ID to uppercase or lowercase, according to the options provided.
converse Command	Links the current process to a device.
copy Command	Copies items to an output device, to another item-ID, or to another file.
copy-list Command	Copies a saved list to either a new item-ID, a new file reference, or to the specified output device.
cp Command	Copies the specified items to the printer via the spooler.
create-abs Command	Sets aside a contiguous set of frames as the destination for loading the ABS code (the D3 virtual code).
create-account Command	Creates a new master dictionary, copies all the necessary items into it, and updates the mds file with the name and address.
create-file Command	Creates a new dictionary and data file, a dictionary-only file, or a new data section on an existing dictionary file; space is allocated and reserved if available.
create-index Command	Creates a new B-tree index in the specified file using the a (algebraic) processing code expression provided and ensures the a0 index case-sensitivity matches the item-ID case sensitivity.
create-macro Command	Creates an executable macro from the last TCL command entered and places the macro in the master dictionary of the current account.
create-nqptrs Command	Builds a Q-pointer for each D-pointer file in the dm account and adds them to the dm,newac, file.
crt-delimiters Command	Enables and disables the display of attribute and value marks.
ct Command	Invokes the copy command and copies the specified items to the terminal.
cvtcpy Utility	Copies a tape to another tape, including format and block conversions, and reads D3, CIE, Reality or Ultimate tape formats, with a block size up to 64 KB, and creates a D3 tape.

D
D3Tcl Command NOTE— This command is not actually run from TCL.	Connects a remote VME with a TCL command from MS-DOS.
date Command	Returns an internal, external, or Julian date derived from a date provided, or displays a calendar for the month and year of the date provided.
dcd Command	Toggles or displays the status of data carrier detect on the specified port.
debug Command	Enters the system debugger (if at TCL) or enters the BASIC/ debugger (if running a FlashBASIC program).
decatalog Command	Removes the compiled BASIC or FlashBASIC object code of the specified items from the dictionary of the specified file, and removes the corresponding command entry (or entries) from the master dictionary of the current account.
decrypt-file Command	Returns an encrypted file back to its original unencrypted format.
define-terminal Command	Displays the available terminal (driver) definitions and allows changing existing definitions or adding new ones.
define-up Command	Provides a front-end for defining a keyboard for the Update Processor.
delete Command	Deletes one or more items from the given file.
delete-account Command	Deletes an entire account, and all the associated files, returning the space used to the overflow table and removing the account name from the mds file.
delete-file Command	Releases all frames used by the specified file to the overflow table, and removes the file reference from the master dictionary of the current account.
delete-index Command	Removes either a specific B-tree index from a specified file, or all indexes if an asterisk is specified.
delete-list Command	Removes a list previously saved with a save-list command.
deoptimize Command	Removes the flash-compiled object code from the object code item, leaving the non-flash object code.
dev-att Command	Attaches an unattached port to the current process.
dev-det Command	Detaches the port currently attached from the current process.
dev-list Command	Lists all current devices on the system.
dev-make Command (UNIX)	Adds an entity to the system. This command is normally used to add devices to the system.
dev-make Command (Windows)	Creates devices connected to the VME.
dev-remov Command	Removes a specific device from the system.
diag Command	Invokes the internal system diagnostics utility.
dialer Command	Controls the dialer subsystem, which allows transferring data to remote systems over the phone in a batch mode.
dialer-copy Command	Queues one or more items for copy to a remote system through the dialer subsystem.
disc Command	Disconnects the current process from the D3 virtual machine.
div Command	Divides the first integer number provided by the second integer number provided and displays the result as an integer quotient and remainder.
divx Command	divides the first hexadecimal number by the second hexadecimal number and displays the result as a hexadecimal quotient and remainder.
dm Macro	Issues an exec abs command each time a user logs on to the dm account.
download Command	Downloads font files to a laser printer.
dtr-off Command	Turns off data terminal ready.
dtr-on Command	Turns on data terminal ready on another port, or the current port if none is specified.
dtx Command	Converts a given decimal (integer) number to its corresponding hexadecimal equivalent.
dump Command	Displays or prints the contents of one or more frames of the VME in ASCII (character), EBCDIC or hexadecimal format.

E
echo Command	Turns terminal character echo on or off.
edit Command	Invokes the line editor for entry or update of any item in the system (that is, BASIC programs, Procs, data items, and so on).
edit-list Command	Retrieves a previously saved list and enters the line editor (same as ed or edit).
encrypt-file Command	Encrypts data in a specified file.
end Command	Terminates a process on another port, or the current port if a port number is not specified.
enqueue-status Command	Displays information about the state of the local transaction logging disabled flag for either a specified line or all lines currently logged on.
environ Command	Manipulates the UNIX shell environment variables from TCL.
esc-data Command	Specifies that the code generated by pressing ESC (control [) is to be passed through as data.
esc-level Command	Specifies that pressing ESC pushes a level.
esc-toggle Command	Turns the function of the ESC key to either be treated as data (esc-data) or as a level-pushing mechanism (esc-level).
estimate-count Command	Displays a fast estimate of the number of items in a file.
exchange-Command	Switches item-IDs of the two specified items following the file reference.
exec Command	Runs the current process on the specified ABS area.
exec-stacking-off Macro	Disables nested executes to be performed in an atomic manner.
exec-stacking-on Macro	Enables nested executes to be performed in an atomic manner.
exit Command	Logs the D3 process off and disconnects it from the D3 virtual machine.
export Command	Exports D3 items to UNIX files.

F
f.modulo Command	Calculates a file modulo, based on estimated file characteristics.
f-resize Command	Examines existing file modulos (VME only) for every file found in the file-of-files file, and recalculates a new recommended modulo for each file.
fid Command	Displays information about a memory-resident frame.
field Command	Prints out the nth word in a list of words.
file-access-setup Command	Provides utilities for managing file update and retrieval locks on groups of files and users.
:files Command	Restores the entire file system from file-save media.
file-save Command	Invokes the procedure to perform a full backup of each file in the D3 file system.
file-sizer Command	Displays the D3 File Sizer Utility which allows automatic or manual resizing of D3 Windows or D3 UNIX files.
find Command	Searches a file for the existence of one or more strings of characters in any attribute and optionally creates and saves a list.
find2 Command	Invokes the search-system command.
fl Command	Forms a single list from two lists using intersection, union, or exclusion operators.
flashbasic Command	Toggles FlashBASIC on and off.
flip-list Command	Inverts the order of the specified select list.
flush Command	Flushes to disk all memory-resident buffers that are tagged as write-required.
flushd Command	Creates a new flush process when available buffers go below the percentage specified in criteria for the amount of time specified in interval.
font-parms Command	Used to upgrade fonts and is provided for conversion of fonts created before May 25, 1990.
format Command	Formats a floppy disk for use only with the D3 system.
free Command	Displays information on the used and unused frames on a D3 system.
fuser Command	Displays ownership information about a device.

G
generic-restore Command	Restores a specially formatted account-save created by certain utility programs.
get-fof Command	Returns the item-ID in the file-of-files file associated with the specified VME file.
get-list Command	Activates an item-list from the pointer-file file. The default file is the pointer-file file.
GetFsiRoot Command	Returns a string representing the root location of the FSI data files on D3 Windows.
GetLogonMode Command	Returns a string representing whether or not the Windows Authentication logon mode is enabled.
group Command	Displays a summary of information about each group in a file.

H
hot-backup Command (UNIX)	Allows the set up and control of a hot backup configuration.

I
ignore-signals Command	Forces the system to not attempt to push a level or go into the debugger when any character is input.
import Command	Imports UNIX files to D3 items.
index-select Command	Creates an active list based on a single key or a range of keys.
indexer Command	Rebuilds indexes on part or all of the files of the system.
init-ovf Command	Initiates the D3 overflow initialization, and is invoked as a phantom by the initovf command.
init-pibs Command	Assigns all ports a terminal type by updating attribute 2 in the pibs file.
initovf Command	Checks the overflow table to determine if it has previously been scrubbed and invokes the init-ovf command, if necessary.
inputwait Command	Displays a message, and waits for given time to execute commands.
iselect Command	Selects all of the item-IDs in the group that the specified item-ID hashes to, using the item command.
isselect Command	Selects and sorts all of the item-IDs in the group that the specified item-ID hashes to, using the item command.
item Command	Outputs the base FID of the group to which the specified item-ID hashes, and a list of all item-IDs that are currently hashed to the same group.

J
job-status Command	Returns status information of a job.

K
kill Command	Sends a UNIX signal to a D3 or UNIX process.
kill-resizing Command	Stops all currently active resizing processes.

L
ld Command	Presents the best guess of what one wants to see in a columnar listing of any dictionary.
ldf Macro	Lists the summary description (attribute 17) of each attribute-defining item in the specified file.
legend Command	Outputs a legend on the bottom of each page of a printed reports directed to the spooler, unless the legend suppress modifier (leg-supp) is in effect.
lerrs Macro	Performs a series of reports from the dm,errors, file.
lfd Macro	Produces a sorted listing of all file-defining items in the specified file, along with the description attribute from each file pointer.
lfs Macro	Contains the AQL sentence which uses the dm,file-of-files file.
lfsb Macro	Same as the lfsi macro except that the i-fms column becomes index-fms.
lfsi Macro	Same as the lfs macro except that the bytes column becomes i-bytes and the frames column becomes i-fms.
link-pibdev Command	Creates a logical link between the given (or current) process and the specified port number.
list-abs Macro	Produces a report of each D3 mode in the dm,abs, file, showing any modes it calls and those modes which are called.
list-Commands Macro	Produces a report showing every executable command in the specified master dictionary (md); this includes: Procs, macros, menus, cataloged FlashBASIC programs (BASIC commands) and D3 commands.
list-device Command	Displays the currently defined devices.
list-errors Macro	Produces a sorted report of the error messages logged into the dm,errors, file, beginning with the most recently logged message.
list-file-access Command	Program displays file access statistics for the desired files.
list-file-stats Command	Produces the file statistics report generated from the most recently executed file-save Command or account-save Command.
list-files Command	Produces a report of all file-defining items(D-pointers) and synonym-defining items (Q-pointers).
list-index Command	Lists all indexes for a given file name, account name, or for the system.
list-jobs Macro	Produces a report indicating the status of all phantom controlled processes currently in the dm,jobs, file.
list-lines Command	Displays communications protocol information for every port attached to the virtual machine.
list-lists Macro	Produces a sorted report of all previously saved lists in the pointer-file file.
list-lockq Command	Lists the VME processes that are enqueue (waiting) to lock a frame, that is currently locked by some other process.
list-locks Command	Displays the current status of all system, FlashBASIC, spooler, group, and item locks.
list-logoffs Command	Produces a report showing the history of logoffs recorded in the dm,errors, file, along with who logged off and the status of the logged off port.
list-macros Macro	Produces a sorted report of all items defined as macros in the specified account name or your local MD (if md is specified).
list-menu Command	Produces a documentation quality presentation format of menu(s).
list-menus Macro	Produces a sorted listing of all items defined as menus in the specified master dictionary.
list-obj Command	Outputs descriptive internal information about programs compiled for BASIC and FlashBASIC.
list-pibs Macro	Produces a report of each active port in the dm,pibs, file, showing the port number, the current user of that port and the current terminal/printer characteristics as defined by the term-type command.
list-resizing Macro	Lists the status of files currently being resized from the dm,resizing file.
list-restore-errors Command	Displays errors recorded during restore.
list-runtime-errors Macro	Produces a sorted report of error conditions logged into the dm,runtime-errors, file.
list-system-errors Macro	Produces a sorted report of error conditions logged into the dm,errors, file.
list-tandems Command	Lists the devices currently involved in a tandem association.
list-users Command	Produces a report of users currently logged on to the system.
listabs Command	Displays the current spooler assignment parameters for each process on the system.
listacc Command	Produces a report of system usage statistics from the dm,acc, file for all accounts, or for a specified account, or for a specific user-ID.
listbi Command	Lists the built-in c functions in the item UNIX.builtin, c.builtin (MS-DOS) and user.builtin located in the dm,messages, file.
listc Command	Invokes the list-label BASIC program to produce a columnar display of the item-IDs in the specified file, in the order of appearance in the file.
listconn Command	Produces a report of all items defined as connectives (also called modifiers) in the specified file reference.
listdict Command	Sorts the given file’s dictionary items by attribute count and by item-id then produces a report showing the contents of the various ADIs.
listfiles Command	Produces a report showing all file-defining items and synonym-defining items in an optionally specified file name or account name.
listpeqs Command	Displays the status of all spooler controlled print job elements.
listprocs Command	Produces a sorted report of all items defined as Procs in the specified file name.
listptr Command	Displays the printer control block status for all printers.
listverbs Command	Produces a sorted listing of all items defined as command in the specified account name.
load.mon2 Command	Displays a graphical map of the duty load of the D3 system, taking a snapshot of the system at a given time interval.
lock-beep Command	Enables/disables beeping on lock failure.
lock-break Command	Enables or disables the ability to unconditionally break during a lock failure.
lock-frame Command	Core locks a frame into real memory.
log-clear-file-off Macro	Turns off the logging of the clear-file command.
log-clear-file-on Macro	Turns on the logging of the clear-file command.
log-msg Command	Records the time and date that a particular macro is executed.
log-status Command	Displays the current status of the transaction logger.
logoff Command	Terminates a process on a given port and sends the port to the logon prompt.
logon Command	Logs on a port, other than the one currently being used, onto a specific account.
logon-lock Command	Turns on or off the logon lockout feature.
logon-reporting Command	Turns on or off the logon reporting feature which logs failed logon attempts to the errors file.
logon-timeout Command	Updates and displays the global and local logon timeout values.
logto Command	Terminates accounting on the current account, then moves to another specified account.
loop Command	Performs any TCL command a specific number of times, or continuously, until any key is pressed on the keyboard.

M
maxusers Command	Displays the number of licensed D3 users on the system, and/or sets the system in single or multiuser mode.
mirror Command	Attaches the current process (the master) to one or more slave processes.
mlist Command	Produces formatted assembly source code listing of the specified item list.
mload Command	Loads the assembled object code into the virtual memory address defined in the routine.
modem-off Macro	Invokes the xonoff command and passes it an f option.
modem-on Macro	Invokes the xonoff command and passes it an n option.
monitor-status Command	Produces a snapshot listing of information related to memory-resident frames.
mono-Command	Switches output to a monochrome display from a color display, or sets the visual attributes of the monitor.
mount-cd Command	Creates a directory in Linux called /mnt/cdrom.
move-file Command	Moves a file descriptor from one master dictionary to another.
mul Command	Multiplies the first integer number provided by the second integer number provided and displays the result as an integer number.
mulx Command	Multiplies the first hexadecimal number provided by the second hexadecimal number provided and displays the result as a hexadecimal number.
mverify Command	Compares the assembled object code in virtual memory against the corresponding itemlist in specified file name. Any frames with mismatches are reported.

N
net-errors Command	Sets or displays error handling behavior when accessing remote files.
net-status Macro	Displays statistics on local network usage.
network-setup Utility	Allows the setup and control of a D3 network. If no arguments are supplied, a menu displays.
network-status Command	Displays remote files opened by a line.
nframe-index Command	Produces a total of the number of frames in use by a specific B-tree index, or all indexes if indicated by an asterisk.
ntlfs Macro	Contains the AQL sentence which uses the dm,FileOfFiles file.
nt_cinfo Command	Obtains information about loaded C DLLs.
nt_cload Command	Loads a C DLL.
nt_cunload Command	Unloads a C DLL.
nt_dllinfo Command	Obtains information about loaded DLLs.
nt_dllload Command	Loads a DLL.
nt_dllunload Command	Unloads a DLL.
nt_eventlog Command	Displays or clears the Windows application or system event log.
nt_file-info Command	Displays file information for a specified file.
nt_getfsiaccount Command	Returns the current FSI account getting logged onto.
nt_heapwalk Command	Walks the ’heap’ of the given line and display the results in a human readable form.
nt_inv-flash Command	Removes a flashed program object in cache and loads the new flash program object.
nt_iotrace Command	Captures the i/o activity for a process id.
nt_listclients Command	Lists the active clients on the system.
nt_list-jobs Command	Lists server jobs running on the server since rebooting.
nt_list-resizing Command	Lists the files being resized and the files that have been resized.
nt_makefof Command	Creates the entry in the FileOfFiles.
nt_migrateacc Command	Migrates an account from the VME to the FSI.
nt_name Command	Obtains network information.
nt_osfi_start Command	Starts the OSFI server.
nt_osfi_stop Command	Stops the OSFI server.
nt_pinfo Command	Obtains and displays information about processes (threads).
nt_rel-tcp Command	Releases memory and closes tcp.
nt_resize Command	Starts the FSI file resizing process.
nt_resize-menu Command	Demonstrates the functionality of the four FSI utilities supplied by Rocket.
nt_restart_odbc Command	Restarts the ODBC server.
nt_telnetdisc Command	Inquires/sets/resets the Telnet disconnect feature.
nt_upgrade Command	Upgrades any d3 dataset with current changes.

O
odbc-setup Command	Allows you to start, stop, and configure the ODBC server.
off Command	Processing at all levels on the current line and returns control to the initial logon prompt.
okidata Command	Changes characteristics on Okidata printers.
onneterror Command	A globally cataloged subroutine that can be called from the FSI when a network error occurs during FlashBASIC file I/Os.
op Command	Invokes the Output Processor on specified items.
overflow Command	Displays the system overflow table which contains the addresses of available disk frames.
ovf-monitor Command	Monitors and displays overflow consumption on a port by port basis.

P
p Command	Turns on or off the display of terminal output.
paint Command	Displays items to the screen or printer in Update Processor format.
password Command	Allows adding, changing or removing a user or account password.
penv Command	Displays a list of all user D3 shell variables and the contents of those variables.
phantom-reset Command	Resets the specified phantom lines to available status.
phantom-status Command	Displays all phantom lines and whether they are busy, available, or transaction logger.
pibstat Command	Displays the current PIB status bit settings for a specified value.
pid Command	Displays the UNIX PID of a D3 process.
pitch-compile Command	Compiles a pitch file found in the dm,fonts,pitch file.
pitch-table Command	Builds a pitch table for a font file in the dm,fonts,descr file.
poke Command	Sends either a string of characters or one or more TCL commands to the input buffer of another port.
power-off Command	Brings the system to an orderly shutdown by logging off all users, flushing memory to disk, and parking the disk heads prior to halting the system.
pr-spool-job Command	Respools a spooler hold job.
prime Command	Calculates the next higher and lower prime number from a specified number.
print-err Command	Provides a means of displaying messages from the messages file in their output format.
print-error Command	Prints an error message from stacked data statements.
print-filter Command	Controls the ways attribute and value marks are displayed or printed.
printronix Command	Sets the vertical form length unit (VFU) for Printronix printers only.
psh Command	Executes a UNIX command and captures the results in a D3 item.
psr Command	Displays formatted output of the status of the currently active UNIX and/or D3 processes.
ptype Command	Returns whether a BASIC program is a main program or a subroutine.
pverify Command	Verifies the checksum for the object code of a BASIC program.

Q
qselect Command	Creates a list from the specified file reference and item list, similar to the get-list command.

R
reblock-ovf Command	Forces contiguous overflow blocks that exist in different internal tables to be compared and combined if possible.
reboot Command	Reloads the operating system from a currently executing system.
reclaim-ovf Command	Allows the user to recover all frames not used by the system to the overflow space, thus eliminating the necessity of a file-save/restore.
recover-item Command	Recovers the last item deleted by the CTRL+XO command in the Update Processor.
remote-cache Command	Increases the performance of updates over a network by sending groups of updates at a time.
rename-file Command	Changes the name of a file, both in the master dictionary and in the dictionary of the designated file reference.
renumber Command	Equivalent to running the bformat command, with the r option and a control table specifying no indentation.
:reset-async Command	Resets the current port or all ports to default values.
reset-port Command	Restarts suspended output and drains both the input and output terminal buffers.
reset-user Command	Reinitializes a process.
resize Command	Resizes a file to the desired modulo and increases or decreases the apparent contiguous portion (or modulo) of the specified file without requiring a file-restore.
restore-accounts Command	Restores all accounts that do not already exist on the system from the attached file-save tape or a tape created by an account-save with an active list of accounts.
rmbi Command	Removes one or more functions from the list of UNIX or C built-in functions.
run Command	Invokes BASIC run time, which attempts to load and execute a compiled BASIC program.
run-list Command	Runs a series of BASIC programs. As each one concludes, the next program is automatically executed.
runoff Command	Facilitates the preparation and maintenance of textual material such as memos, manuals, and so on.

S
s-dump Command	Writes items from a given file to the attached peripheral storage device in sorted order.
save Command	Invokes the backup procedure to save the entire file system, an individual account, or to perform an incremental save.
save-list Command	Writes the list of item-IDs generated by a select, sselect, qselect, or get-list command.
:scroll Command	Displays the output of a TCL command in a scrollable (text) window.
search Command	Searches a file for the existence of one or more strings of characters in any attribute and optionally creates and saves a list.
search-system Command	Searches every file in the D3 file system for the existence of one or more strings of characters in any attribute and optionally creates and saves a list.
sel-restore Command	Selectively restores items from either a file-save, account-save, incremental save, or transaction log media to a specific file.
send-message Command	Directs a text message to a specific port, a specific user-ID, all current users, or every device attached to the system.
set Command	Modifies the value of a D3 user shell variable.
set-8mm Command	Sets the 8mm data cartridge as the tape device, by invoking the set-device command and passing in the argument 8mm and an i option.
set-abs Command	Designates a file as the data section associated to the boot ABS, or control the boot ABS specifications.
set-active-update Command	Ensures that data fragments are cleaned-up from file-system frames whenever data is deleted from a file.
set-batch Command	Displays or changes the current sensitivity value for the interactive/batch trigger.
set-batchdly Command	Displays or changes the current sensitivity value for the interactive/batch trigger, as well as the weight of the trigger and the trigger cancel value.
set-baud Command	Sets the baud rate for the current port or for another port.
set-bootsleep Command	Sets the delay (in seconds) before the system is booted automatically.
set-break Command	Displays or changes the value of the break character used as an optional substitute for the BREAK key for the current port.
set-cmem Command	Displays or changes the size of the data area used for the BASIC/C or BASIC/GM Assembler interface for the current process.
set-compat Command	Allows a user (port), or the global environment, to be set to a particular Pick compatible environment.
set-compiler Command	Sets backward BASIC compiler compatibility.
set-date Command	Sets the system software date, and optionally the system hardware clock.
set-date-eur Command	Toggles the standard (American) date format to European/International format: dd/mm/yy for input and output purposes.
set-date-format Command	Allows changing the domestic time/date format using items from the date-format file.
set-date-std Command	Toggles the European/International date format to standard (American) format: mm/dd/yy for input and output.
set-date-window Command	Allows specifying the rollover point on your system.
set-decimal Command	Designates that a numeric expression of 1 is equal to 100 units.
set-def-tape-blk Command	Sets the default tape block.
set-device Command	Attaches the SCT, floppy disk, half-inch, or special devices.
set-dozens Command	Designates that a numeric expression of 1 is equal to 12 units.
set-dptr Command	Changes the first attribute of file-defining D-pointers, to set or reset special types, such as dx or dy.
set-esc Command	Specifies the value of the key to treat as the ESC key.
set-file Command	Creates or updates the synonym-defining item called qfile in the master dictionary of the current account.
set-floppy Command	Attaches the first floppy (in the list-device listing) drive to the current process for subsequent input or output activity.
set-flush Command	Displays or changes the value of the period of the flush and of the forced flush.
set-half Command	Attaches the 1/2-inch tape drive to the current process for subsequent input or output activity.
set-imap Command	Defines a keyboard input and/or a terminal output translation table, through which any sequence of keyboard input and terminal output characters can be translated into any other sequence of characters.
set-incremental Command	Enables or disables the incremental save feature.
set-iomap Command	Allows translatable input and output for each port on the system.
set-kbrd Command	Used to change between standard international keyboard maps for line 0 (zero).
set-num-format Command	Changes the currency sign, thousand, and decimal point in an m conversion, at a local or global level.
set-opendb-password Command	Sets or removes an encrypted password on an OpenDB host.
set-overflow-id Command	Toggles the overflow ID signature on and off.
set-ovf-local Command	Sets and displays the local overflow cache size.
set-ovf-reserve Command	Sets aside a specific number of frames as the spare tank in the event that the overflow table runs out of frames.
set-port Command	Displays or changes the communication speed and protocol for a specified port or displays the current setting if none of the communication parameters are specified.
set-remote-close Command	Toggles on and off the BASIC close command’s ability to close remote files.
set-remote-user Command	Used to allow the local user to utilize a different user and/or password when connecting to a remote OSFI server which has been started with the a option to force user/password authorization.
set-runaway-autoquit Command	Automatically terminates the specified process in the event of an overflow runaway condition.
set-runaway-limit Command	Establishes the maximum number of frames allowed before an overflow runaway condition occurs.
set-sct Command	Attaches the SCT drive to the current process.
set-shutdown-delay Command	Provided for installations which have disk-caching hard-disk controllers. This provides time for the disk to flush.
set-sound Command	Sets the system console sound level on port 0 only.
set-sym Command	Indicates the symbol table to use for references to system variables from within the system, or virtual debugger.
set-thousands Command	Designates that a numeric expression of 1 is equal to 1000 units.
set-time Command	Sets the current system time.
set-units Command	Designates that a numeric expression of 1 is equal to 1 unit.
setpib0 Command	Resets the system’s port 0 (console) to the correct terminal type.
setport Command	Sets all ports (except port 0) to 9600 baud, no parity, 1 stop bit, and 8 data bits.
setup-printer Command	Downloads fonts to a laser printer attached to a form queue.
shell-variable-off Macro	Disables shell variable replacement from TCL.
shell-variable-on Macro	Enables shell variable replacement from TCL.
shp-kill Command	Terminates a D3 printer shared with UNIX and all the associated processes.
shpstat Command	Examines or changes the status of shared BASIC programs that have been compiled with FlashBASIC.
shp-status Command	Displays status information about printers shared with UNIX, started by the startshp command.
shutdown Command	Initiates an orderly system shutdown sequence and should be executed before turning off or rebooting any D3 system.
sleep Command	Suspends further processing until the specified time expression is exhausted or reached.
sort-list Command	Retrieves a previously saved list, sorts it, then rewrites it to the file from which it was retrieved.
sort-users Command	Invokes the list-users BASIC program but sorts the output by user rather than by port number.
sortc Command	Invokes the sort-label command to produce a columnar display of the item-IDs in the specified file, in the order of appearance in the file.
sp-assign Command	Displays, changes or resets the current spooler output assignment options for the current process/user.
sp-close Command	Closes all current spooler entries previously opened by the current line with an sp-open command or an o option in conjunction with an sp-assign command.
sp-edit Command	Accesses existing spooler entries for processing or deletion.
sp-kill Command	Stops spooler entry output or removes printers and shared printers.
sp-open Command	Leaves the next spooler entry generated by the current process open upon completion of the output generating process.
sp-status Command	Displays the status of all spooler-controlled devices.
sp-tapeout Command	Retrieves (inputs) reports previously spooled to magnetic media and directs output to the spooler.
speller Command	Enables or disables the spelling checker for the current user/port only, or displays the status of the speller if no options are provided.
stack Command	Enables or disables the tcl-stacking function for the current port only, or displays the status of the stacker if no options are provided.
start-reclaim-ovf Command	Initiates the overflow reclamation process.
start.rtc Command	Initiates the system’s real-time clock.
start.ss Command	Starts the spooler and the phantom scheduler.
startlog Command	Activates the transaction logging subsystem.
startptr Command	Activates and initializes up to 2048 printers, although only up to four parallel printers are supported on PC systems.
startshp Command	Starts a shared printer under UNIX.
startspooler Command	Kills all printers associated with the spooler, then initializes the spooler and returns it to normal operation.
steal-file Command	Moves a file from another account into the current account.
stoplog Command	Stops the transaction logger and detaches the transaction logger tape.
stopptr Command	Stops the specified printer at the end of the current print job.
stopsched Command	Halts the phantom scheduler process.
sub Command	Subtracts the second integer number provided from the first integer number provided and displays the result as an integer number.
subx Command	Subtracts the second hexadecimal number provided from the first hexadecimal number provided and displays the result as a hexadecimal number.
syschk Command	Checks a system running under UNIX to detect abnormal situations.
sysid Command	Displays system configuration, options, and features.
system-coldstart Macro	Executes system initialization commands.

T
t-act Command	Selects a previously attached tape device as the currently active device to read and write to.
t-att Command	Attaches the tape unit or floppy disk drive to the current process unit and optionally assigns the block size to the tape I/O buffer.
t-bck Command	Backspaces the tape to the end of the previous file or a specified number of blocks.
t-bsf Command	Backspaces a given number of files.
t-bsr Command	Backspaces a given number of records.
t-cascade Command	Cascades or links one tape device to another tape device, either in a chain or a loop.
t-chk Command	Checks a tape for parity errors.
t-copy Command	Copies data from one device to another.
t-det Command	Detaches the tape from the current process, or from another process.
t-dump Command	Copies items from a given file to the attached peripheral storage device.
t-fsf Command	Forwards a tape a given number of files.
t-fsr Command	Forwards a tape a given number of records.
t-fwd Command	Moves the attached media forward to the next file, or moves the tape forward a specified number of blocks.
t-link Command	Links or cascades one tape device to another tape device, either in a chain or a loop.
t-load Command	Restores files from a tape that was generated by t-dump.
t-rdlbl Command	Reads the label from the attached magnetic media and initializes the internal label storage area.
t-read Command	Reads from the magnetic media unit attached to the current process and displays the contents of each block read to the terminal or printer.
t-rew Command	Rewinds the attached media to the beginning, or load point on the tape.
t-select Command	Attaches a tape device to the current process, but we recommend using the set-device TCL command.
t-space Command	Moves the attached media forward a specified number of files, displaying each tape label as it is encountered.
t-stat Command	Displays a report of the current attachment status for all tape devices defined on the system.
t-unload Command	Rewinds the attached tape. On D3 UNIX systems, this command does the usual tape unload.
t-verify Command	Validates the integrity of file-save or account-save backups.
t-weof Command	Writes an EOF mark at the current position on the attached magnetic media.
t-wtlbl Command	Writes a Pick-format (80-byte) tape label at the current position on the attached magnetic media.
tabs Command	Displays tab stops previously set via the editor (ed or edit) process, or assigns new tab stop positions for input (i) or output (o).
tail Command	Displays a specified number of trailing lines for each of the items in a specified item-list (that is, the bottom-most lines contained in an item).
tandem Command	Links the current port to another process.
tape-socket Command	Defines a tape system across a network.
tcl Command	Suspends the process on the specified port, pushes a level on that port, then executes the TCL command.
tcl-hdr Command	Enables or disables the display of TCL commands on all output directed to the spooler, or displays the current header status if no options are provided.
tcl-prompt Command	Sets the prefix to the TCL prompt.
tcls Command	Suspends the process on the specified port, pushes a level on that port, then executes the TCL command.
term Command	Changes or displays the current terminal and printer output characteristics for the current line.
term.font Command	Downloads fonts to a Wyse 60 terminal.
term-type Command	Reads the terminal and printer characteristics from attribute 2 of the PIBs file and automatically sets them, or sets them and updates the permanent settings for the current line.
termp Command	Prompts for the terminal and printer characteristics for the line on which the command is invoked.
termu Command	Automatically updates the term width and depth.
time Command	Displays the system time and date.
timedate Command	Sets or displays the status of the time and date display.
timeout Command	Sets the time (in seconds) to automatically log off due to inactivity.
tlog-restore Command	Restores data from a transaction log magnetic media.
tlqdisplay Command	Allows you to display the transactions within the transaction queue used by both the D3 Transaction Logger and Hot Backup components.
touch Command	Reads and rewrites all items, without changing them, in either specified files or in all files in specified accounts.
transaction Utility	System administration utility for transaction processing.
trap Command	Allows a TCL command (signal handler) to be executed upon receiving a specific signal.
truncate-ovf Command	Truncates the safe overflow table to 1 block from high-water to maxfid and kills the B-tree table.
txlog Command	Invokes a menu for administration of the transaction logging subsystem.
txlog-off Command	Turns off transaction log enqueueing for the current process.
txlog-on Command	Turns on transaction log enqueueing for the current process.
txlog-status Command	Retrieves the last status of the transaction logging subsystem.
type-ahead Command	Enables or disables the system-wide type ahead feature, or displays the current status if no options are provided.

U
ud Command	Invokes the Update Processor to edit ADIs or file-defining items in the dictionary of the specified file.
um Command	Displays the conversion units set by the set-units, set-dozens, set-decimal, or set-thousands commands.
unix Command	Invokes the sh command, to push a shell, and then automatically returns to D3 on completion.
unlink-pibdev Command	Unlinks a process from a port.
unlock-file Command	Clears file locks which have not been cleared through normal system operation.
unlock-frame Command	Clears the memory corelock previously core-locked with a lock-frame command.
unlock-group Command	Clears group locks.
unlock-item Command	Clears item locks that have not cleared through usual system operation.
unset Command	Deletes a D3 user shell variable.
update Command	Invokes the Update Processor for adding, changing, deleting, or cruising through data in a given file.
update-abs-stamp Command	Invoked by the abs.fid command.
update-logging Command	Toggles or displays the status of the transaction logger subsystem.
update-md Command	Updates command definitions in a specified account master dictionary, or in a list of master dictionaries.
update-prot Command	Toggles or displays the status of the file update protection scheme.
user.coldstart Command	Invoked by the coldstart to call the user.coldstart routine.
user-coldstart Macro	Performs the last step of the coldstart process and is the place where users can customize their own sequence of activities to perform each time the system is powered on or rebooted.
user-shutdown Macro	Called by the shutdown command as the first procedure in shutting down the machine.
useralarm Command	An alarm handler used by the trap command when a task is scheduled to be executed at a given time. When the alarm goes off, it scans the item dm,alarm.file, username to find what to do next.

V
verify-index Command	Verifies the integrity of one or all B-tree indexes in a specified file name.
verify-system Command	Verifies the integrity of the D3 system software by comparing computed checksums for the executable ABS frames with corresponding checksums stored in the data section of the file reference file.
video.demo Command	Demonstrates video display functions.
view Command	Displays a single item in a full screen window.

W
watch Command	Executes and re-executes a TCL command continuously until the user cancels the execution by pressing a key.
what Command	Displays the system configuration and the status of system locks, specified lines, spooler, and printers.
where Command	Displays the current execution status of all processes currently logged on to system, or for selected port numbers.
wherebt Macro	Invokes the wheres command with the bt parameter.
whered Macro	Invokes the wheres command with the db parameter.
whereindx Macro	Invokes the wheres command with the indx parameter.
wherelk Macro	Invokes the wheres command with the lk parameter.
whereovf Macro	Invokes the wheres command with ovf parameter.
wherepu Macro	Invokes the wheres command with the pu parameter.
wheres Command	Performs a variety of functions depending on the options or parameters provided, and displays a more readable form of the where command, including the user-ID, the account name, and the last command entered.
wheresp Macro	Invokes the wheres command with the sp parameter.
wheret Macro	Invokes the wheres command with the tp parameter.
which Command	Displays the implementation being used, the software serial number, the system ID number, the release level, and UNIX specific system information.
which-line Command	Puts the current port number into the Proc primary input buffer.
who Command	Displays the port number, user-ID, and account name for the current port, a specified port, or all ports.
who-info Command	Enables or disables who output at TCL.
whobt Macro	Invokes the wheres command with the bt parameter.
whod Macro	Invokes the wheres command with the db parameter.
whoindx Macro	Invokes the wheres command with the indx parameter.
wholk Macro	Invokes the wheres command with the lk parameter.
whopu Macro	Invokes the wheres command with the pu parameter.
whosp Macro	Invokes the wheres command with the sp parameter.
whot Macro	Displays the wheres information with the tp parameter.
whovf Macro	Invokes the wheres command with the ov parameter.
wlist Command	A simulation of the list command that additionally exploits B-tree indexes.
wselect Command	A simulation of the select command that additionally exploits B-tree indexes.
wsort Command	A simulation of the sort command that additionally exploits B-tree indexes.
wsselect Command	A simulation of the sselect command that additionally exploits B-tree indexes.

X
xcs Command	Enables or disables the extended character set for the current port or a specific port, or displays the status when no options are provided.
xcs-off Macro	Disables the extended character set function on a specified port, or the current port if omitted.
xcs-on Macro	Enables the extended character set function on a specified port, or the current port if omitted.
xonoff Command	Disables or enables x-on/x-off on a specified port, or the current port.
xtd Command	Converts a given hexadecimal number into its equivalent decimal (integer) format.

Z
z Command	Starts a phantom job.