CALL PLITEST(Debug_Commands, Display Address, plitest_flags, plitest_debugger, plitest_string, plitest_host);
plitest_string is a string representing the IP address and port where you want to route the debugging session. This is useful for remote debugging.
pltest_host is a name designator for the IP and port.
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);
This example uses plitest_string, plitest_debugger, and plitest_host to start the debugger.
dcl plitest_string char(1024) varying native static init(
'shlib mqplidrv.dll;env mqplidrv;br plitest_label;br %exit[det;q];c');
dcl plitest_debugger fixed bin(31) native static init(0);
dcl plitest_host char(100) varying native static init('');
call PLITEST(plitest_string, plitest_host, plitest_debugger);
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.