SHOW

Examine debugger options and program state information

WTSupported in traditional Synergy on Windows

 

USupported on UNIX
VSupported on OpenVMS
SHOW [/PAGE] [option, ...]

Arguments

/PAGE

(optional) Stops the output every 24 lines and waits for input (CR to get the next page and <EOF> to terminate input). On Windows, the output will vary based on the values of DBG_HEIGHT and DBG_WIDTH. (/PAGE can alternatively be placed at the end of the line.)

option

(optional) One or more of the following options, separated by a comma and/or a space:

BREAK

Display all current breakpoints.

CHANNELS [/FULL]

Display all Synergy DBL channels that are currently open, along with their open mode, submode, and filename. If /FULL is specified, the filename is the full Windows filename, including physical path. If no channels are opened, a message to that effect is displayed.

CLASSES [opts] [name] [...]

Display information about the currently instantiated classes. If specified, CLASSES must be the last option on the command line. See Showing instantiated classes for more detailed information.

DBGSRC

Display the path to which the DBGSRC environment variable is currently set.

DLL

Display all open DLL handles and the complete filename of the associated DLL, in the order in which they were opened. The same DLL is listed multiple times if it was opened multiple times. (Windows only)

DYNMEM

Display all dynamic memory segments that are currently in use.

ELB

Display all ELBs that are currently open.

ERROR

Display the error that caused the current error trap.

MEMORY

Display current Synergy DBL memory usage as well as the number of segment reclamations that occurred during program execution.

OPTIONS

Display Synergy compiler/runtime options and flags.

STACK

Display the current Synergy DBL stack parameters: the size of the stack, how much of the stack is currently in use, and the maximum number of bytes that have been used.

STEP

Display the current mode for the STEP command (STEP OVER or STEP INTO).

STOP

Display the current STOP mode (STOP ON or STOP OFF) as set by the SET command.

TRACE

Display the current CALL or XCALL traceback. (This option displays the same information as the TRACE command.)

TRAP

Display the current error trap mode (TRAP ON or TRAP OFF) as set by the SET command.

UNINITIALIZED

Display the current UNINITIALIZED state as set by the SET command.

VARIABLE var_list

Display the type and size of one or more variables. If present, VARIABLE must be the last keyword on the SHOW command line, followed by one or more variable names separated by spaces and/or commas.

WATCH

Display any watchpoints.

Discussion

The SHOW command displays the current values for the debugger options set with the SET command, as well as a variety of program state information.

If you don’t specify any options, the SHOW command displays all of the current debugger options and program state information. You can place more than one option, separated by spaces and/or commas, on the same line.

If the amount of output is large, you can use the /PAGE option to page the output.

Note

If you want to use the SHOW DYNMEM command and you are using UI Toolkit, we recommend that you use SHOW DYNMEM after calling the U_FINISH routine, since Toolkit also uses dynamic memory.

Showing instantiated classes

The CLASSES option has the following syntax:

CLASSES [opts] [name] [...]

opts

(optional) One or more of the following class options:

/ALL

Display class information for all classes that have (or at one time had) instantiation.

/OBJECTS

Display object information.

/LINES

Display the first referencing source line or creation line.

/WARNINGS

Display only objects with circular references.

name

(optional) A class name path.

If no class names are specified, all classes that have current instantiations will be included. This information will include the name and the number of instantiated objects for each class.

If CLASSES is specified in conjunction with other SHOW options, CLASSES must be the last option specified on the line. If CLASSES is not the last option on the line, any option that follows CLASSES will be interpreted as a name.

You can specify more than one class by separating them (along with their class options) with commas or spaces.

Examples

The following example shows the current breakpoints, STEP mode, error trap mode, and Synergy DBL stack parameters.

SHOW BREAK, STEP, TRAP, STACK

The example below displays information about each class and the number of instantiated objects for each class.

DBG> show classes /all
  Class cmdtest.b : 0 instances
  Class cmdtest.d : 1 instance
  Class cmdtest.e : 1 instance
  Class cmdtest.loon : 1 instance

The following example displays the object ID, the number of references, and any circular references.

DBG> show classes /obj cmdtest.d

  Class cmdtest.d : 1 instance
    Object id 1, refs 2 (circular!)

The example below displays the creation line for the object.

DBG> show classes /lines cmdtest.d

  Class cmdtest.d : 1 instance : 1st ref at line 92 in TD2 (objcmds.dbl)

The example below indicates that a circular reference exists.

DBG> show classes /warn cmdtest.d
  Class cmdtest.d : 1 instance
    Object id 1, refs 2 (circular!)