Library /sys$common/syshlp/dbg$help.hlb DEBUG, Language Support, RPG_II, EXAMINE Command *Conan The Librarian (sorry for the slow response - running on an old VAX) |
The EXAMINE command enables you to look at the contents of a variable, the current table entry, an array element, or the I/O buffer. To examine an array variable, use array syntax as in the following example: DBG> EXAMINE ARR3(9) ! Display element 9 of array ARR3 DBG> EXAMINE ARRY(1:7) ! Display elements 1-7 of array ARRY Specifying a table name enables you to examine the entry retrieved from the last LOOKUP operation. To display the contents of the I/O buffer, specify the name of the input file, update file, or output file, followed by the string $BUF. For example, the following command displays the contents of the I/O buffer for the input file INPUT: DBG> EXAMINE INPUT$BUF The following command displays the ASCII equivalent of the string STRING, which is 6 characters long: DBG> EXAMINE/ASCII:6 STRING To examine a variable which contains the at sign (@), use %NAME as follows: DBG> EXAMINE %NAME 'ITEM@' To examine a nonexternal indicator, precede it with the string *IN. For example: DBG> EXAMINE *IN56 *IN56: "0" If an indicator is set off, 0 is displayed. If an indicator is set on, 1 is displayed. You cannot examine external indicators in this manner. To examine external indicators, you must first link the program with the /NOSYSSHR qualifier; then, use the CALL command, as in the following example which displays the value of U5: DBG> CALL RPG$EXT_INDS(5) value returned is 0
|