Home
Documents
Training Guide

SECTION 7 – TESTING A CYBERTANK

SECTION BRIEF - This section describes the Cybertank Test Module (CTM), the Primary diagnostic tool for design problems.

7.1 THE CYBERTANK TEST MODULE.

OSI/CACD System 2 includes a facility used for testing cybertanks known as the Cybertank Test Module (CTM). The CTM is particularly helpful when a cybertank is not behaving as the designer intended. Such discrepancies are usually due to incorrectly formulated Al, and are known as “bugs”. The CTM is commonly referred to as the “debugger.”

7.1.1 loading the Simulation Design

In order to test a cybertank, you must first have a simulation design in which the cybertank to be tested is the Primary Cybertank. In this section, GAMMA will be tested using the simulation design GAMMASIM.
To begin testing your cybertank, select TEST CYBERTANK from the DESIGN menu. When the File Retrieval Panel (FRP) appears, select GAMMASIM.

7.1.2 The CTM Control Panel

After you Select the simulation design to be used for testing, the OSI/CACD loads the related cybertanks and battlefield, then transfers you to the CTM. The CTM automatically starts the simulation. The CTM is actually an extensively modified version of the Combat Simulation Module (CSM).
The CTM differs from the CSM in several ways. The instrument panel has been replaced by a display area, and the SIMULATE menu has been replaced by the DEBUGGER menu. The CTM operates in one of two modes – Trace Mode and Status Mode. The mode can be toggled by selecting and deselecting TRACE MODE ON from the DEBUGGER menu.

NOTE: If during the following sections of the Training Guide, GAMMA gets destroyed, select RESTART from the DEBUGGER menu.

7.2 TRACE MODE

When the CTM is in Trace Mode, as it is now, the display a r e on the right side of the screen shows the cybertank’s AI. The upper part of this display area shows the cybertank number and name (currently #01: GAMMA), and the label of the section of Al currently being executed. The lower part of this display area shows the cybertank’s “thoughts”.
A great deal can be learned by watching the cybertank’s behavior on the battlefield while examining its Al being processed. Trace Mode allows you to see the cybertank’s commands as they are being processed.

7.2.1 Pausing the Test

Press the PAUSE key to pause the test. The PAUSE key works the same way in the CTM as It does in the CSM. That is, pressing it toggles the pause mode on and off. See the OSI/CACD System 2 Reference Card to determine the PAUSE key for your particular terminal type.

7.2.2 Single Stepping

When the test is paused, pressing the STEP key causes the test to run just long enough to process one CCL command, after which the test remains paused. This allows you to examine the AI and its effects one command at a time. This feature is known as single stepping. See the OSI/CACD System 2 Reference Card to determine the STEP key for your particular terminal type.
Experiment with pausing and single stepping now.

7.3 STATUS MODE

Status Mode lets you examine the cybertank’s current status registers. These status registers are comprised of various System and User Variables used by the cybertank. User variables and certain System Variables can be altered for testing under specific conditions.

7.3.1 Selecting Status Mode

Change from Trace Mode to Status Mode by deselecting TRACE MODE ON from the DEBUGGER menu. The display area on the right side of the screen shows one of several different pages of status registers.

NOTE: When Trace Mode is on, you will notice a check mark in the Debugger menu. When Trace Mode is off, the check mark is removed.

Three groups of System Variables are displayed on the current page. Use the PAGE SELECT keys to view other pages. Consult the OSI/CACD System 2 Reference Card to determine which keys to use on your terminal.

7.3.2 Changing Status Registers

It is sometimes useful to change the value of a specific status register while testing a cybertank. This can help you check the cybertank’s response to a particular situation. Status registers can only be altered when you have paused the test.

NOTE: Not all of the status registers can be altered. Consult Part 2, Section 5.5 of the Engineer’s Handbook to determine which registers can be altered.

TO alter a status register, first use the PAGE SELECT keys until the appropriate register is displayed. Next, select the register by using either a mouse/joystick or the REGISTER SELECT keys (consult the OSI/CACD System 2 Reference Card to determine which keys to use on your terminal). The current value of the status register is highlighted. Finally, enter the new value using the keyboard and press RETURN.

NOTE: Most status registers have restrictions on what value can be entered. For example, the X-location of the cybertank ranges from 1-62. Entering a value larger than 62 is invalid.

Experiment with changing status registers. Changing the X location and Y Location under TANK relocates the cybertank to the new location entered.
When you are finished testing your cybertank, select EXIT from the DEBUGGER menu. The OSI/CACD transfers you to the ECM.

Toadstool's Home | Contact © 2003 Toadstool's Game Shrines. All Rights Reserved.