SYSPROG Command Overview

The system administrator should make a special effort to become familiar with the documentation of those commands used to set up and maintain the system. This section presents the administrative commands and Procs that are available only in the SYSPROG account. These commands and procs are first summarized alphabetically, then arranged into functional groups. See the final topics in this section for full descriptions and syntax of the SYSPROG account commands.

ACCOUNT-RESTORE

Restores one or more accounts from a FILE-SAVE or ACCOUNT-SAVE backup medium.

ACCOUNT-SAVE

Copies the specified account(s) to backup media.

ADD-ACCOUNTS

Restores all accounts that are present on a FILE-SAVE or ACCOUNT-SAVE backup medium but not on disk.

AUTO-DISCONNECT

Allows certain mvBase clients the capability to disconnect from the mvBase server with a custom delay that reserves the client’s line.

AUTO-LOGOFF

Automatically logs off a specified process after either a designated period of inactivity or the loss of an incoming DTR signal.

BUILD-LOCK-XREF

Builds the FILE-XREF file, which contains file paths for all accounts on the system.

CLAIM

Recovers blocks of contiguous frames from the POVF Linked Space.

COLD-START

Carries out the housekeeping and system verification procedures that are required any time the system is started up.

CONSOLE-ON/CONSOLE-OFF

The CONSOLE-ON command assigns the system console to any process. Use CONSOLE-OFF to disable this feature.

COUNT-TRANS

Lists the number of update logging transactions in the queue that are waiting to be dequeued.

CREATE-ACCOUNT

Creates new user accounts.

CREATE-WS

Creates additional workspace areas for use by the EXECUTE statement in mvBASIC.

DEFINE-CURSOR

Runs the System Cursor Definition Utility, which allows administrators to specify cursor functions for unsupported terminals.

DELETE-ACCOUNT

Deletes an account and all of its files from the system.

DISCONNECT

Forces a disconnect of an mvBase client connection.

DUMP

Displays the contents of disk frames, including information about forward and backward links.

EXECUTE-SYSTEM-SWITCH

Runs during coldstart to define the behavior of features which, for mvBase, are now available in more than one flavor.

FILE-SAVE

Saves the entire data area of the disk to backup medium.

:FILELOAD

Restores the entire data area of the disk using any full filesave backup medium.

IDATE

Sets the system date format to the international standard.

INCR-SAVE

Performs an incremental filesave.

INIT-CURSOR

Initializes pointers to the terminal definition file (CURSOR).

:INIT-TAPE

Resets all logical tape units or floppy disk drives to their default assignments given at coldstart, and it clears all tape buffers.

LINK-LINE/UNLINK-LINE

The LINK-LINE command links an unattached communications line to a process. Use UNLINK-LINE to detach a line from a process.

LINK-WS

Links process workspace while the system is up and running.

LIST-ABORTS

Displays the Software Abort Log from TCL in the SYSPROG account.

LIST-DISK-ERRS

Lists all disk errors logged in the SYSTEM-ERRORS file.

LIST-FILE-STATS

Lists statistics on all files most recently saved to backup media.

LIST-GFE-LOG

Lists all Group Format Errors (GFEs) logged in the SYSTEM-ERRORS file.

LIST-RUNTIME-ERRORS

Lists all mvBasic Run-Time errors logged in the RUNTIME-ERRORS file.

LIST-SECURITY-LOG

Lists all security violations logged in the SECURITY-LOG file.

LIST-SOFTRAPS

Lists all native softrap aborts logged in the SYSTEM-ERRORS file.

LIST-SYSTEM-SWITCHES

Shows the current setting of all the system switches.

LISTLINES

Displays information about the configuration of mvBase lines and ranges of lines.

LOCK-FRAME

Locks a specified frame in memory.

LOCKOUT

Prevents prospective users from logging on once a specified number of invalid attempts to log on have occurred.

LOCKOUT-STATUS

Displays the parameters currently in effect from the LOCKOUT command.

LOGOFF

Logs a specified process off the system.

LOGON

Lets an administrator log another user or process on to the mvBase system, and has been superseded by the TANDEM command.

MAXUSERS

Sets the maximum number of users who can log on to the system at any one time.

MODEM-ON/MODEM-OFF

MODEM-ON and MODEM-OFF enable and disable (respectively) DTR flow control, which makes it possible to start and stop data transmission between the system and peripheral devices. These commands have been superseded by the PROTOCOL command.

PASSWORD

Sets a password for a new account, or changes or deletes an existing password.

POKE

Inserts a TCL command or a character string in the input buffer of another process. POKE has been superseded by the TANDEM command.

RESET-CURSOR

Resets all terminal definition pointers and disables all mvBASIC @( ) functions.

RESET-ITEM-LOCKS

Clears all item locks in the item locks table.

RESET-SECURITY-LOG

Clears the SECURITY-LOG file.

RESET-TAPE

Cancels a logical tape unit assignment to a physical tape device or floppy disk drive.

RESTORE

Restores the specified dictionary, data file, or account from a filesave backup medium.

SAVE

Copies to backup medium all or part of the data area of the disk.

SEL-RESTORE

Restores from backup medium one or more items in a file.

SET-DATE

Sets or changes the current system date.

SET-DATE-WINDOW Command

Sets the rollover point on your system.

SET-TAPE

Assigns a logical tape unit to a physical tape device or floppy disk drive.

SET-TERM

Sets the system-wide default characteristics for terminals and printers.

SET-TIME

Sets or changes the current system time.

:SHUTDOWN

Shuts down the system before rebooting or turning off the power.

STACK-ON/STACK-OFF

Turns on the TCL Stacker for the specified process. STACK-OFF disables this feature.

STARTPTR

Initializes or restarts a system printer.

:STARTSPOOLER

Initializes the Spooler without coldstarting the entire system.

SYSTEM-SWITCH

A front end to EXECUTE-SYSTEM-SWITCH, used to display and/or change the setting of a switch or a class of switches.

TANDEM

Allows the display and control of another process on your terminal.

TLOG-CLEAR

Clears the update logging queue without dequeueing entries.

TLOG-DEQUEUE

Starts the transaction logging process.

TLOG-DQ

Starts transaction logging. This command is a synonym for the TLOG-DEQUEUE command.

TLOG-MONITOR

Displays the transaction logger’s status every specified number of seconds.

TLOG-RESTORE

Uses the taped output of transaction logging as input and restores transactions onto the existing database.

TLOG-RESUME

Restarts a transaction logging process that was suspended by the TLOG-SUSPEND command, and creates a new transaction logging session.

TLOG-STATUS

The TLOG-STATUS command displays the status of the transaction logger from any process.

TLOG-STOP

Ends the current transaction logging process.

TLOG-SUSPEND

Temporarily suspends transaction logging.

UDATE

The UDATE command sets the system date format to the United States standard.

:ULOG-ON/:ULOG-OFF

:ULOG-ON starts update logging; the :ULOG-OFF command stops update logging.

ULOG-SKIP

Specifies which files are to be excluded from update logging even though they are listed in the FILE-XREF file.

UNLINK-LINE

Unlinks and detaches a line from a process.

UNLOCK-FRAME

Removes the core lock from a specified frame.

USER-COLD-START

Called from the COLD-START Proc and customizes the coldstart procedure.

VERIFY

Verifies the operating system software against check-sum items other than CHECK-SUM, which is in the ERRMSG file. Offers additional flexibility over the VERIFY-SYSTEM command.

VERIFY-SYSTEM

Verifies the integrity of the operating system software.

WHAT

Displays a system status report.

WHERE

Displays the location and status of all currently active processes.

See Also

Using the SYSPROG Account and Commands

SYSPROG Account Overview

The SYSTEM Dictionary

SYSPROG Commands Grouped by Similar Function

SYSPROG Command Reference