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:
Display all current breakpoints.
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.
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.
Display the path to which the DBGSRC environment variable is currently set.
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)
Display all dynamic memory segments that are currently in use.
Display all ELBs that are currently open.
Display the error that caused the current error trap.
Display current Synergy DBL memory usage as well as the number of segment reclamations that occurred during program execution.
Display Synergy compiler/runtime options and flags.
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.
Display the current mode for the STEP command (STEP OVER or STEP INTO).
Display the current STOP mode (STOP ON or STOP OFF) as set by the SET command.
Display the current CALL or XCALL traceback. (This option displays the same information as the TRACE command.)
Display the current error trap mode (TRAP ON or TRAP OFF) as set by the SET command.
Display the current UNINITIALIZED state as set by the SET command.
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.
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.
|
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. |
The CLASSES option has the following syntax:
CLASSES [opts] [name] [...]
opts
(optional) One or more of the following class options:
Display class information for all classes that have (or at one time had) instantiation.
Display object information.
Display the first referencing source line or creation line.
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!)
