Console Commands

Help

help

List all available commands.

help <cmd>

Provide help for <cmd>.

Close Console Window

close_console_window

Close the local X-Windows or WIN32 console window. DtCyber remains running and operates in headless mode until a remote console application connects or open_console_window is executed.

Deadstart Machine

deadstart

Initiates a system deadstart, as if the deadstart button on the system console is pressed.

Disassemble Emulated System Memory

disassemble CP|CPU,<fwa>[,<count>]

Disassemble <count> (default 1) CPU instructions starting from address <fwa>. If <fwa> is expressed as an octal number, it is interpreted as a word address. If <fwa> is expressed as a hexadecimal number (e.g., 0x0012ad80) and <fwa> addresses CYBER 180 memory assigned to NOS/VE, <fwa> is interpreted as a byte address.

CP / CPU = Central Processor

disassemble PP<nn>,<fwa>[,<count>]

Disassemble <count> (default 1) instructions in PP nn starting from address <fwa>.

PP = Peripheral Processor

Disconnect Remote Console

disconnect_remote_console

Forcefully disconnects a remote console application, returning control to the local console window.

Dump Emulated System Memory

dump_memory CM|EM,<fwa>[,<count>]

Dump <count> (default 1) words of central memory starting from address <fwa>. If <fwa> is expressed as an octal number, it is interpreted as a word address. If <fwa> is expressed as a hexadecimal number (e.g., 0x0012ad80) and central memory (CM) is being dumped, <fwa> is interpreted as a byte address (useful for dumping CYBER 180 memory).

• CM = Central Memory
• EM = Extended Memory

dump_memory PP<nn>,<fwa>[,<count>]

Dump <count> (default 1) words of PP nn's memory starting from address <fwa>.

PP = Peripheral Processor

Enter Keys Into Virtual Console

enter_keys <key-sequence>

Supply a sequence of key entries to the system console .

Special keys:

     ! - end sequence without sending <enter> key
     ; - send <enter> key within a sequence
     _ - send <blank> key
     ^ - send <backspace> key
     % - keyword delimiter for keywords:
         %year% insert current year
         %mon%  insert current month
         %day%  insert current day
         %hour% insert current hour
         %min%  insert current minute
         %sec%  insert current second
     # - delimiter for milliseconds pause value (e.g., #500#)

System Idle Detection and Throttling

idle

Display current idle detection and throttling parameters

idle <on|off>

Turn system idle detection on/off

idle <num_cycles>,<sleep_time>

Set number of cycles before sleep and sleep time

sleep_time number of microseconds (Linux/MacOS) or milliseconds (Windows) for which execution should be suspended before resuming

idle B<buffer_count>

Set number of allocated network buffers below which the NPU/MDI is considered to be idle.

Load Cards into Virtual Reader

load_cards <channel>,<equipment>,<filename>[,<p1>,<p2>,…,<pn>]

Load specified card file with optional parameters.

if filename is the asterisk * character AND a dedicated INPUT directory has been configured for the card reader, the next file is automatically selected (oldest modification date first) for submission.

If a dedicated OUTPUT directory has been configured for the card reader, the selected deck is MOVED from the INPUT directory to the OUTPUT directory and renamed with a unique serial suffix prior to pre-processing. The original deck is left untouched.

If a dedicated OUTPUT directory has NOT been configured for the card reader, the selected deck is ERASED from the INPUT directory after it has been pre-processed for submission.

Files which are submitted outside the confines of either of these two directories are left, untouched, but are pre-processed for submission.

If parameters are specified with the command, the specified values replace references within the loaded deck. The syntax of a reference within a deck is ${<n>}, where <n> is the ordinal of the parameter; 1 is the first parameter, 2 is the second, and so on.

Decks may also contain embedded directives and references to properties in property files. The syntax of an embedded property reference is:

${<path>:<section-name>:<property-name>[:<default-value>]}

where:

<path> Pathname of a property file.

<section-name> Name of a section within the property file.

<property-name> Name of a property definition within the specified section.

<default-value> Optional value to be used when the specified file, section, or property are not found.

Embedded directives begin with the character ~ (tilde) which must occur as the first character of a line. The recognized directives are:

~include <path>[,<p1>,<p2>,…,<pn>] A reference to the pathname of a file that is included in the submitted deck. The contents of the file replace the directive in the deck referencing it. Optionally, parameters may be provided, and these replace references to them within the included file. Included files may also contain embedded directives and references to properties.

~eof End of file. An end of file indication replaces the directive in the submitted deck.

~eoi End of information. An end of information indication replaces the directive in the submitted deck.

~eor End of record. An end of record indication replaces the directive in the submitted deck.

Load Disk onto Removable Disk Drive

load_disk <channel>,<equipment>,<unit>,<filename>

Load specified disk.

Load Tape onto Virtual Tape Drive

load_tape <channel>,<equipment>,<unit>,<r|w>,<filename>

Load specified tape.

r = Read w = Write

Open Console Window

open_console_window

Open the local X-Windows or WIN32 console window. DtCyber exits headless mode operation.

Pause emulation to reduce CPU Load

The emulator will pause and the dtCyber console will await the “Enter” key to resume execution

Remove Cards

remove_cards <channel>,<equipment>[,<pathname>]

Remove cards from card punch and write them to a file. If a file pathname is provided, cards are written to the specified file. Otherwise, DtCyber creates a unique file name and writes cards to that file.

Remove Paper from Line Printer

remove_paper <channel>,<equipment>[,<pathname>]

Remove paper from line printer and write it to a file. If a file pathname is provided, paper is written to the specified file. Otherwise, DtCyber creates a unique file name and writes paper to that file.

Show Disk

show_disk

Show status of all disk units.

Show Equipment

show_equipment

Show status of all attached equipment.

Set Key Interval

set_key_interval <millisecs>

Set the interval between key entries to the system console. Used by enter_keys

Set Key Wait Interval

set_keywait_interval <millisecs>

Set the interval between keyboard scans of the emulated system console. Used by the system console emulator

Show Network

show_network [<net-type>[,<net-type>…]]

Show status of data communication interfaces.

Set Operator Port

set_operator_port <port>

Set the TCP port on which to listen for operator connections.

Show State

show_state [pp[<n>],…][ch[<n>],…][,cp[<n>],…]

Show state of PP's, channels, and/or CPU's.

Show Tape

show_tape

Show status of all tape units.

Show Unit Record Devices

show_unitrecord

Show status of all line printers, card readers, and card punches.

Show dtCyber Version

show_version

Show version of dtCyber.

Shutdown dtCyber

shutdown

Terminates emulation.

Unload Disk

unload_disk <channel>,<equipment>,<unit>

Unload specified removable disk unit.

Unload Tape

unload_tape <channel>,<equipment>,<unit>

Unload specified tape unit.