GemStone/S 64 Bit Topaz User's Guide

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.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

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

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

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

TEMPORARY

THREAD

THREADS

TIME

UNPROTECTMETHODS

UP

WHERE