Purpose
Attaches a debugger to a set point in a program to execute a series of commands.
Syntax
CALL PLITEST(Debug_Commands, Display Address, plitest_flags, plitest_debugger);
Parameters
plitest_debugger is a numeric value representing the type of CodeWatch debugger.
- 0 = Use Command-line CodeWatch.
- 1 = Use the GUI CodeWatch
Examples
This example shows usage of PLITEST, assuming use of the
-bigendian option when compiling.
dcl plitest entry(CHAR(1024) varying native, char(100) varying native, fixed bin(31) native );
dcl plitest_strings char(1024) varying native
init('shlib myprog.so;env myprog;br mylabel;c');
dcl plitest_host char(100) varying native init('10.24.11.80:0');
dcl plitest_debugger fixed bin(31) init(1);
/*1 = Use codewatch GUI debugger interface*/
call PLITEST(plitest_strings, plitest_host, plitest_debugger);
Restrictions
An XWindows Server such as
Micro Focus ViewNow must is needed if trying to display GUI CodeWatch on a Windows machine while running the user program on a UNIX/Linux server.
Description
PLITEST is an API called from User programs that causes a debugger to start, attach to a user program, and execute a series of commands before giving control to the user. A PLITEST call is typically inserted in a user application where debugging is to start at a given point in the execution flow.
You can use PLITEST to debug PL/I programs running under CICS, or use the plitest parameter of the -optexec option to do the same. See Compiler Options and Debugging PL/I Programs Under CICS for more information.