Starting the debug server

You can use the ZINET commands to define and start the debug server on the z/TPF system so that you can request a connection to the debug server from IBM TPF Toolkit.

Before you begin

If you want to define and start a secure debug server, you must load the secure debug server configuration file to the z/TPF system with all required fields defined. Some fields in the configuration file specify the file locations for the required certificates that are needed to complete a Transport Layer Security (TLS) handshake.
If you want to define and start a nonsecure debug server, you do not need to create or load the secure debug server configuration file.

About this task

The z/TPF debugger, dump viewer, and entry control block (ECB) monitor can be run in 1052 state on your z/TPF system.

TCP/IP, pools (ZPOOL 1052), and the debug listener must be ready for use at 1052 state before you use the z/TPF debugger.

Procedure

Enter the ZINET ADD command on the z/TPF system to define the z/TPF debug server.
- To define a nonsecure debug server, use the XPARM parameter to specify the port number. The default port number is 8000. The server name specified must be DBUG. For example:
```
ZINET ADD SERVER-DBUG PGM-CDBI MODEL-DAEMON ACT-AUTO STATE-1052 XPARM-8000
```
- To define a secure debug server, specify the secure keyword for the XPARM parameter, which indicates that the z/TPF debug server uses TLS. If you do not specify this value, the z/TPF debug server is started without TLS enabled. To specify a port value, use the port keyword. When the secure keyword is specified and a port number is not provided, the default port number 8001 is used. For example:
```
ZINET ADD SERVER-DBUG PGM-CDBI MODEL-DAEMON ACT-AUTO STATE-1052 XPARM-secure port 8001
```
The debug servers that are active on all processors in a loosely coupled complex must be all secure or all nonsecure.
Enter the ZINET START command on z/TPF system to start the z/TPF debug server.
For example:
```
ZINET START SERVER-DBUG
```

Results

The z/TPF debug server now can listen for requests from TPF Toolkit.

To view the information about the z/TPF debug server, enter the ZINET DISPLAY command with the SERVER parameter specified.

User:   ZINET DISPLAY S-DBUG

System: INET0031I 09.32.50 START OF ZINET DISPLAY OF ACTIVE SERVER
        SERVER - DBUG PROCID - B ACTIVATION - AUTO
        PGM - CDBI PARM -
        PROTOCOL - PORT - 00000 MODEL - DAEMON _
        SERVERRORS - 00000 SERVETIME - 00000 USER - nobody
        MAXPROC - 00001 TIMEOUT - 00000 STATE - 1052
        AORLENGTH - 00000 BACKLOG - 00000
        XPARM - secure port 8001
        IP - ANY SOCKET - 00000000/00000000 COUNT - 0000000013
        TOTAL COUNT - 0000000013 _
        END OF DISPLAY+