Windows

Debugging with MicroFocus Server Express

Unsolicited Dynamic Attachment Method

This method allow the normal execution of an XCICS program, and only when the user wants to start to debug, attaches the debugger (MicroFocus NetExpress) to the running process.

The following steps must be followed to start the animation of a TP program :

•	connect XCICS using the terminal emulator

•	enter the transaction:

CEDB ON

•	wait for terminal to switch in debugging status

•	take note of the PID shown on the screen (the PID is always shown in the X4J status bar)

•	start MicroFocus NetExpress

•	from the menu "Animate", select "Start Animating". The following dialog will open:

•	click on "Options" and the following dialog will appear:

•	turn on the "Attach to running process" and press OK. The following dialog will show up:

•	select the Process ID of your terminal process (shown in the XCICS terminal above) and click "Debug". Note the NetExpress shows the identifier in hexadecimal format

•	the dialog will close leaving the netexpress desktop unchanged. Go on the XCICS terminal screen and start the desired transaction (i.e. write transaction code and press ENTER)

•	the program code of the transaction will show up in the NetExpress window

•	Now you can debug using the NetExpress commands.

Note: when connecting XCICS with a TN3270 emulator (i.e. IBM Personal Communication), obviously no PID number is shown anywhere. In order to easily get the debug status of the terminal and the PID of the working process, simply enter on the screen

CEDB

Debugging with ACUCOBOL Extend

Thin client method

XCICS must be configured with the option "allow_acu_thin=yes", in order to allow programmers to debug on the ACUCOBOL thin client. To do that, the ACU thin client must be installed on the programmer workstation.

The following is the general procedure to debug a CICS program: the parameters on the CEDB command line vary depending on what you want to debug. However, the parameter THIN is always required

•	connect XCICS using the terminal emulator

•	open a DOS shell on the local PC, and run

acuthin --wait --port <port number> --restart

•	start the transaction CEDB with the desired parameters

CEDB ON,THIN=<thin client address>

The thin client address is the address of the workstation, followed by ":" and the port number.

To debug a specific XCICS terminal or a specific transaction code, add the parameters TERM or TRAN, as described below.

Example

On the workstation at IP 192.168.1.32, open the DOS shell and type:

C:\Acucorp\Acucbl700\AcuGT\bin> acuthin --wait --port 8000 --restart

On the XCICS terminal:

CEDB ON,THIN=192.168.1.32:8000,TRAN=ACCT

Debug of programs running on current terminal

The following steps must be followed to start the debug of a the current terminal:

•	connect XCICS using the terminal emulator

•	start the acuthin client

•	start the transaction CEDB with these parameters

CEDB ON,THIX=<thin client address>

•	wait for the terminal to switch in debug mode

•	enter the transaction code to debug

•	the ACUCOBOL debugger animator will start on the target thin client

The thin client address is the address of the workstation where acuthin is running, followed by ":" and the port number.

Debug of a specific transaction code

Whenever the programmer wants to debug a specific transaction code, even if running on another terminal or as a background task, the TRAN parameter must be provided, according to this procedure:

•	connect XCICS using the terminal emulator

•	start the acuthin client

•	start the transaction CEDB with these parameters

CEDB ON,THIN=<thin address>,TRAN=<transid>

Whenever the specified transid is started in the XCICS region, the ACUCOBOL debugger will start on the target thin client.

Debug of programs running on a specific terminal

Whenever the programmer wants to debug programs running on background terminal (ie. on a printer terminal), the TERM parameter must be provided, according to this procedure:

•	connect XCICS using the terminal emulator

•	start the acuthin

•	start the transaction CEDB with these parameters

CEDB ON,THIN=<display address>,TERM=<termid>

Whenever a transaction is started on the requested terminal identifier, the ACUCOBOL debugger will start on the target thin client.