User Tools

Site Tools


cdc:dtcyber:v5.8.sz:config.section

Configuration Section

Unless otherwise indicated the following are CASE INSENSITIVE:

  • Keys
  • Section
  • Values

The following are CASE SENSITIVE:

  • File Names

Section Identifiers

Section identifiers help organize the configuration file into relevant parts that may be re-used for alternate configurations and tests.

Explore other sections:

deadstart Statement

REQUIRED Identifies the Section Name in the .INI file containing the representation of the deadstart panel.

+%22deadstart+Statement%22+%7B+statement+%3D+%22deadstart%22+%22%3D%22+value+.+value+%3D+%22section_name%22+.+%7D

equipment Statement

REQUIRED Identifies the Section Name in the .INI file containing the equipment definitions.

+%22equipment+Statement%22+%7B+statement+%3D+%22equipment%22+%22%3D%22+value+.+value+%3D+%22section_name%22+.+%7D

helpers Statement

Identifies the Section Name in the .INI file containing a list of pathnames of helper program start/stop scripts. This statement is optional. If not specified, then no helper programs are indicated, and none are started.

DEFAULT: โ€œโ€ (null string)

+%22helpers+Statement%22+%7B+statement+%3D+%22helpers%22+%22%3D%22+value+.+value+%3D+%22section_name%22+.+%7D

npuConnections Statement

Identifies the Section Name in the .INI file containing definitions of data communication features to be used by the emulated NPU or MDI. This is optional. If it is not specified, then no NPU/MDI data communication features are defined (e.g., interactive terminals, remote batch stations, trunks, etc.).

DEFAULT: โ€œโ€ (null string)

+%22npuConnections+Statement%22+%7B+statement+%3D+%22npuConnections%22+%22%3D%22+value+.+value+%3D+%22section_name%22+.+%7D

operator Statement

Identifies the Section Name in the .INI file containing the list of operator commands to be executed during startup. This is optional. If it is not specified, no operator commands are executed automatically during startup.

DEFAULT: โ€œโ€ (null string)

+%22operator+Statement%22+%7B+statement+%3D+%22operator%22+%22%3D%22+value+.+value+%3D+%22section_name%22+.+%7D

Machine Configuration

CEJ/MEJ Statement

Enables or disables the CPU exchange jump feature. This simulates the physical CEJ/MEJ switch that was found on the deadstart panels of most CDC mainframe models.

DEFAULT: 1

+%22CEJ%2FMEJ+Statement%22+%7B+statement+%3D+%22CEJ%2FMEJ%22+%22%3D%22+value+.+value+%3D+%28+%220%22+%7C+%221%22+%29+.+%7D

cpus Statement

Defines the number of central processor units to be emulated by this configuration.

DEFAULT: 1

+%22cpus+Statement%22+%7B+statement+%3D+%22cpus%22+%22%3D%22+value+.+value+%3D+%28%221%22+%7C+%222%22+%29+.+%7D

clock Statement

Sets the real-time clock increment value. When specified as 0, DtCyber uses the host computer's hardware clock to emulate the CDC mainframe's real-time clock. Normally, 0 is the recommended value. However, if the host computer does not have a hardware clock (not typical), the value should specify the number of 1-microsecond mainframe clock ticks per emulator execution cycle.

DEFAULT: 0

+%22clock+Statement%22+%7B+statement+%3D+%22clock%22+%22%3D%22+value+.+value+%3D+decimal_value+.+%7D

displayName Statement

Sets the label that will be displayed in the DtCyber operator prompt and host computer system window title.

DEFAULT: 0

+%22displayName+Statement%22+%7B+statement+%3D+%22displayName%22+%22%3D%22+value+.+value+%3D+string+.+%7D

ecsbanks Statement

Specifies the number of banks of ECS memory that the machine has. An ECS bank contains ~126K 60-bit words.

DEFAULT: 0

Warning

ecsbanks and esmbanks are mutually exclusive. Use one or the other. A machine cannot have both ECS and ESM.

+%22ecsbanks+Statement%22+%7B+statement+%3D+%22ecsbanks%22+%22%3D%22+values.+values+%3D+%28+%220%22+%7C+%221%22+%7C+%222%22+%7C+%224%22+%7C+%228%22+%7C+%2216%22+%29.+%7D

esmbanks Statement

Specifies the number of banks of ESM memory that the machine has. An ESM bank contains ~131K 60-bit words.

DEFAULT: 0

Warning

ecsbanks and esmbanks are mutually exclusive. Use one or the other. A machine cannot have both ECS and ESM.

+%22esmbanks+Statement%22+%7B+statement+%3D+%22esmbanks%22+%22%3D%22+values.+values+%3D+%28+%220%22+%7C+%221%22+%7C+%222%22+%7C+%224%22+%7C+%228%22+%7C+%2216%22+%29.+%7D

idle Statement

Enables or disables CPU and NPU/MDI idle detection.

DEFAULT: OFF

+%22idle+Statement%22+%7B+statement+%3D+%22idle%22+%22%3D%22+value.+values+%3D+%28+%22on%22+%7C+%22off%22+%29.+%7D

idleCycles Statement

Specifies the number of consecutive emulator cycles where the mainframe CPU is detected to be in its idle loop before the host system CPU is idled.

LINUX/UNIX DEFAULT: 50 WINDOWS DEFAULT: 7000

+%22idleCycles+Statement%22+%7B+statement+%3D+%22idleCycles%22+%22%3D%22+value.+values+%3D+integer.+%7D

idleTime Statement

Specifies the amount of time that the host CPU will be idled per idle cycle when mainframe idle has been detected. For Linux/Unix, the value is specified in microseconds. For Windows, it is specified in milliseconds.

LINUX/UNIX DEFAULT: 60 WINDOWS DEFAULT: 1

+%22idleTime+Statement%22+%7B+statement+%3D+%22idleTime%22+%22%3D%22+value.+values+%3D+integer.+%7D

ipAddress Statement

Specifies the source IP address to which DtCyber will bind all of the sockets it creates. When an IP address other than 0.0.0.0 is specified, sockets will be associated implicitly with a specific network interface. Thus, this statement can condition DtCyber to bind its sockets to a specific hardware interface, or to a virtual interface such as a TAP interface, enabling multiple instances of DtCyber to run on the same physical host without having UDP/TCP port conflicts. Specifying 0.0.0.0 (the default) causes sockets to be bound effectively to all available interfaces.

DEFAULT: 0.0.0.0

+%22ipAddress+Statement%22+%7B+statement+%3D+%22ipAddress%22+%22%3D%22+ipAddress.+%7D

memory Statement

Defines the size of the machine's central memory, in 60-bit words. The value is expressed in octal. For mainframe model CYBER865, the value must be one of 1000000, 2000000, 3000000, or 4000000. For mainframe model CYBER875, the value must be one of 4000000, 10000000, 14000000, or 20000000. For other models, the value must be at least 40000.

DEFAULT: 1000000 (octal)

+%22memory+Statement%22+%7B+statement+%3D+%22memory%22+%22%3D%22+octal_value.+value+%3D+octal_value+.+%7D

model Statement

Defines the mainframe model that DtCyber will emulate.

DEFAULT: 6400

+%22model+Statement%22+%7B+statement+%3D+%22model%22+%22%3D%22+value+.+value+%3D+%28+%226400%22+%7C+%22CYBER73%22+%7C+%22CYBER173%22+%7C+%22CYBER175%22+%7C+%22CYBER865%22+%7C+%22CYBER875%22+%29+.+%7D

Note

Model names are case insensitive.

networkInterface Statement

Requests DtCyber to start/stop a network interface automatically when it starts up and shuts down, respectively. This can be used, for example, to start/stop a TAP interface automatically.

+%22networkInterface+Statement%22+%7B+statement+%3D+%22networkInterface%22+%22%3D%22+device+%5B+%22%2C%22+scriptpath+%5D+.+%7D

device is the name of the interface device to start/stop, e.g., tap0. scriptpath is the pathname of the script that will be called to start/stop the interface. The default is ./ifcmgr. Three parameters are passed to the script: 1) the device name, 2) the IP address specified by the ipAddress statement, above, 3) the keyword start or stop, depending upon whether DtCyber is starting or shutting down.

osType Statement

Defines the type of operating system that will run on the mainframe for this configuration. This affects various features of the emulation, including how CPU idle is detected, how end of output jobs is detected, etc.

DEFAULT: NONE

+%22osType+Statement%22+%7B+statement+%3D+%22osType%22+%22%3D%22+value+.+value+%3D+%28+%22COS%22+%7C+%22KRONOS%22+%7C+%22MACE%22+%7C+%22none%22+%7C+%22NOS%22+%7C+%22NOSBE%22+%29+.+%7D

persistDir Statement

DEFAULT: โ€œโ€ (nullstring)

This value must point to a pre-existing directory which will contain the persistent shadow objects used by dtCyber containing information to be used between restarts.

+%22persistDir+Statement%22+%7B+statement+%3D+%22persistDir%22+%22%3D%22+valid_os_path+.+valid_os_path+%3D+%22directory_name%22+.+%7D

platoconns Statement

Specifies the maximum number of concurrent connections accepted by the PLATO NIU.

DEFAULT: 4

Deprecation

This statement is deprecated. Use parameters of the niu-in equipment definition instead.

+%22platoconns+Statement%22+%7B+statement+%3D+%22platoconns%22+%22%3D%22+value+.+value+%3D+decimal_number+.+%7D

platoport Statement

Defines the TCP port number on which the PLATO NIU will listen for connections from PLATO terminals.

DEFAULT: 5004

Deprecation

This statement is deprecated. Use parameters of the niu-in equipment definition instead.

+%22platoport+Statement%22+%7B+statement+%3D+%22platoport%22+%22%3D%22+value+.+value+%3D+%22valid_tcp_port%22+.+%7D

pps Statement

Defines the octal number of peripheral processor units to be emulated by this configuration.

DEFAULT: 12 (octal)

+%22pps+Statement%22+%7B+statement+%3D+%22pps%22+%22%3D%22+value+.+value+%3D+%28%2212%22+%7C+%2224%22+%29+.+%7D

# of pps defined Channels Available
(octal) (octal)
12 20
24 40

setMhz Statement

Sets the cycle counter frequency in MHz.

DEFAULT: 0

Note

This value is currently unused.

+%22setMhz+Statement%22+%7B+statement+%3D+%22setMhz%22+%22%3D%22+value+.+value+%3D+decimal_value+.+%7D

telnetconns Statement

Specifies the maximum number of concurrent connections accepted by the 6676 multiplexor.

DEFAULT: 4

Deprecation

This statement is deprecated. Use parameters of the mux6676 equipment definition instead.

+%22telnetconns+Statement%22+%7B+statement+%3D+%22telnetconns%22+%22%3D%22+value+.+value+%3D+decimal_number+.+%7D

telnetport Statement

Defines the TCP port number on which the 6676 multiplexor will listen for Telnet connections.

DEFAULT: 5000

Deprecation

This statement is deprecated. Use parameters of the mux6676 equipment definition instead.

+%22telnetport+Statement%22+%7B+statement+%3D+%22telnetport%22+%22%3D%22+value+.+value+%3D+%22valid_tcp_port%22+.+%7D

trace Statement

Establishes the debug trace mask used by DtCyber. The trace mask is an integer value where each bit enables/disables a trace feature, as defined below:

Bits Trace Feature
0-19 Trace instruction execution of respective PP
29 Trace CPU exchange
30 Trace CPU instruction execution

DEFAULT: 0

+%22trace+Statement%22+%7B+statement+%3D+trace+%22%3D%22+value+.+value+%3D+mask+.+%7D

cdc/dtcyber/v5.8.sz/config.section.txt ยท Last modified: 2024/05/27 20:03 by Kevin Jordan