Name

---

  DXFINISH

Author

---

  Craig B. Markwardt, NASA/GSFC Code 662, Greenbelt, MD 20770
  craigm@lheamail.gsfc.nasa.gov

Purpose

---

  Sets an IDL breakpoint to stop upon return of the current procedure

Calling Sequence

---

  DXFINISH [ , NLEVELS ]

Description

---

  DXFINISH is a convenience routine for setting IDL breakpoints.
  DXFINISH sets a breakpoint so that when the current procedure
  finishes, execution will stop. Often when debugging one wants to
  let the current procedure complete but stop at the next level.
  DXFINISH does exactly that.
  DXFINISH examines the state of the current IDL call stack,
  determines at what point the current procedure will return, and
  sets a breakpoint there. Note that the procedure in which the
  breakpoint is set must be compiled and on disk.
  By default the breakpoint is set with the ONCE keyword.

Inputs

---

  NLEVELS - Number of call levels up to set breakpoint. Default is
            1.

Keywords

---

  ONCE - if set, then the breakpoint will only occur once. Default
          value is SET, so ONCE=0 must be passed explicitly to
          disable this function.

Example

---

  dxfinish
  Set breakpoint in calling procedure.

See Also

---

  BREAKPOINT, DXBREAK, DXCLEAR

Modification History

---

  Written, 15 Apr 2000