GemStone/S 64 Bit Topaz User's Guide

1. Getting Started with Topaz

• 1.1 Getting started with Topaz

  • Overview of a GemStone Session

  • Remote Versus Linked Versions

  • Invoking Topaz

  • Topaz Commands

  • Logging In to GemStone

    • Configurations that do not require setting host information

  • Setting Up a Login Initialization File .topazini

    • Error handling and output

    • Alternatives to automatic initialization

    • Setting gemnetid in .topazini

  • Multiple Concurrent GemStone Sessions

    • Multiple sessions in the RPC version of Topaz

    • Multiple sessions in the Linked version of Topaz

    • Topaz sessions vs. GemStone sessions

  • Transaction state

• 1.2 Interacting with Topaz

  • The Help Command

  • Interrupting Topaz and GemStone

  • Logging Out

  • Leaving Topaz

• 1.3 Executing GemStone Smalltalk Expressions

  • Strings vs. Unicode strings

  • Controlling the Display of Results

    • Display Level

    • Setting Limits on Object Displays

    • Displaying Variable Names, OOPs, and Hex Byte Values

  • Committing and Aborting Transactions

• 1.4 Input from and Output to Files

  • Topaz Scripts

    • Taking Topaz Input from a File

    • Embedding Topaz within shell scripts

    • Handling text outside the ASCII range

  • Capturing Your Topaz Session In a File

    • Writing to multiple log files

• 1.5 Invoking Operating System Functionality

• 1.6 Using Topaz for Code Development

  • Creating Methods

  • Using a Text Editor to Edit Methods

  • Listing Methods, Categories, and other information

  • Filing Out Classes and Methods

    • Code outside the ASCII range

• 1.7 Advanced Topaz features

  • Structural Access To Objects

    • Examining Instance Variables with Structural Access

  • Specifying Objects

    • Object Identity Specification Formats

    • Literal Object Specification Formats

    • Specifying Method Selectors

  • Topaz Variables

    • Creating Variables

    • Displaying Current Variable Definitions

    • Clearing Variable Definitions

  • Sending Messages

2. Debugging Your GemStone Smalltalk Code

• 2.1 Step Points and Breakpoints

• 2.2 Setting, Clearing, and Examining Breakpoints

• 2.3 Examining the GemStone Smalltalk Call Stack

  • Proceeding After a Breakpoint

  • Examining and Modifying Temporaries and Arguments

  • Select a Context for Examination and Debugging

  • Multiple Call Stacks

3. Command Dictionary

• ABORT

• ALLSTACKS

• BEGIN

• BREAK

  • Method Breakpoints

  • Displaying Breakpoints

  • Disabling and Enabling Breakpoints

  • Deleting Breakpoints

  • Examples

• CATEGORY

• CLASSMETHOD

• COMMIT

• CONTINUE/C

• DEBUGRUN

• DEFINE

• DISASSEM

• DISPLAY

• DOIT

• DOWN

• EDIT

  • Creating or Modifying Blocks of GemStone Smalltalk Code

  • Creating or Modifying GemStone Smalltalk Methods

• ENV

• ERRORCOUNT

• EXEC

• EXIT

• EXITIFNOERROR

• EXPECTBUG

• EXPECTERROR

  • Further arguments to EXPECTERROR

• EXPECTVALUE

• FILEFORMAT

• FILEOUT

• FR_CLS

• FRAME

• GCITRACE

• HELP

• HIERARCHY

• HISTORY

• IFERR

• IFERR_CLEAR

• IFERR_LIST

• IFERROR

• IMPLEMENTORS

• INPUT

• INSPECT

• INTERP

• LEVEL

• LIMIT

• LIST

  • Browsing Dictionaries and Classes

  • Listing Methods

  • Listing Step Points

  • Listing Breakpoints

• LISTW / L

• LITERALS

• LOADUA

• LOGIN

• LOGOUT

• LOGOUTIFLOGGEDIN

• LOOKUP

  • Finding and Listing Methods

  • Pasting from stack frames

• METHOD

• NBRESULT

• NBRUN

• NBSTEP

• OBJ1 / OBJ2

• OBJ1Z / OBJ2Z

• OBJECT

• OMIT

• OUTPUT

• PAUSEFORDEBUG

• PKGLOOKUP

• PRINTIT

• PROTECTMETHODS

• QUIT

• RELEASEALL

• REMARK

• REMOVEALLCLASSMETHODS

• REMOVEALLMETHODS

• RUN

• RUNBLOCK

• SEND

• SENDERS

• SET

• SHELL

• STACK

  • Display the Active Call Stack

  • Display or Redefine the Active Context

  • Save the Active Call Stack During Further Execution

  • Display All Call Stacks

  • Redefine the Active Call Stack

  • Remove Call Stacks

• STATUS

• STEP

• STK

• STRINGS

• STRINGSIC

• SUBCLASSES

• SUBHIERARCHY

• TEMPORARY

• THREAD

• THREADS

• TIME

• UNPROTECTMETHODS

• UP

• WHERE

A. Topaz Command-Line Syntax