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

    • Logging In Linked

    • Logging In RPC

  • Setting Up a Login Initialization File .topazini

    • Error handling and output

    • Alternatives to automatic initialization

    • Special care needed when 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

  • Other Types of Logins

    • X509-Secured

    • Solo Scripting

  • Multiple Execution Environments

• 1.2 Interacting with Topaz

  • 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 Byte Values

  • Committing and Aborting Transactions

  • Importing files: topaz commands and GemStone code

  • Handling text outside the ASCII range

  • Capturing Your Topaz Session In a File

    • Writing to multiple log files

• 1.4 Using Topaz for Scripting

  • Topaz commands in text files

  • Embedding Topaz within shell scripts

  • Topaz Solo for Scripting

    • Object creation and memory use

  • Topaz solo connecting to a running stone

  • Scripting with topaz solo using she-bang

  • Topaz Solo Scripting using bash to pass arguments

  • Invoking Operating System Functionality from Topaz

• 1.5 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.6 Advanced Topaz features

  • Structural Access To Objects

    • Examining Instance Variables with Structural Access

  • Specifying Objects

    • Object Specification Formats

  • 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

  • Breakpoints

• 2.2 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

• 2.3 Debugging in a different Gem

3. Command Dictionary

• ABORT

• ALLSTACKS

• BEGIN

• BREAK

• CATEGORY

• CLASSMETHOD

• COMMIT

• CONTINUE/C

• DEBUGGEM

• DEBUGRUN

• DEFINE

• DISASSEM

• DISPLAY

• DOIT

• DOWN

• DUMPOBJ

• EDIT

• ENV

• ERRORCOUNT

• EXEC

• EXIT

• EXITIFNOERROR

• EXPECTBUG

• EXPECTERROR

• EXPECTVALUE

• FILEFORMAT

• FILEOUT

• FR_1

• FR_CLS

• FRAME

• GCITRACE

• HELP

• HIERARCHY

• HISTORY

• IFERR

• IFERR_CLEAR

• IFERR_LIST

• IFERROR

• IMPLEMENTORS

• INPUT

• INSPECT

• INTERP

• LEVEL

• LIMIT

• LIST

• LISTW / L

• LITERALS

• LOADUA

• LOGIN

• LOGOUT

• LOGOUTIFLOGGEDIN

• LOOKUP

• METHOD

• NBRESULT

• NBRUN

• NBSTEP

• OBJ1 / OBJ2

• OBJ1Z / OBJ2Z

• OBJECT

• OMIT

• OUTPUT

• PAUSEFORDEBUG

• PKGLOOKUP

• POLLFORSIGNAL

• PRINTIT

• PROTECTMETHODS

• QUIT

• RELEASEALL

• REMARK

• REMOVEALLCLASSMETHODS

• REMOVEALLMETHODS

• RUN

• RUNBLOCK

• RUNENV envId

• SEND

• SENDERS

• SET

• SHELL

• STACK

• STATUS

• STEP

• STK

• STRINGS

• STRINGSIC

• SUBCLASSES

• SUBHIERARCHY

• TEMPORARY

• TFILE

• THREAD

• THREADS

• TIME

• TMETHOD

• TOPAZWAITFORDEBUG

• UNPROTECTMETHODS

• UP

• WHERE

A. Topaz Command-Line Syntax