gtpo1m3pOperations

ZDBUG-Start and Clear the VisualAge TPF Debug Server

Use this command to do the following:

Requirements and Restrictions

Format




Start
starts the VisualAge TPF debug server. Once the server is started, you can use the TPF debug registration client with the TPF system.

STOp
stops the VisualAge TPF debug server. Once the server is stopped, you cannot use the TPF debug registration client with the TPF system.

Clear
clears all the trace entries. Any active debug sessions that have the associated entry cleared will be ended.

IP-ipaddr
specifies the Internet Protocol (IP) address of an entry, where ipaddr is a numeric IP address.

DISplay
displays the trace registration information, where:

ALL
displays the trace registration information for the trace-by-program and trace-by-terminal tables.

PROGram
displays the trace registration information for the trace-by-program table.

TERMinal
displays the trace registration information for the trace-by-terminal table.

ACTive
displays the trace registration information for the trace-by-program and trace-by-terminal tables only if the entry status is active.

NONactive
displays the trace registration information for the trace-by-program and trace-by-terminal tables only if the entry status is nonactive (that is, free or in use).

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZDBUG HELP

ZDBUG ?

Examples

The VisualAge TPF debug server is started in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDBUG START                                                             |
|                                                                                |
|System: CDBS0001I 14.53.12 VISUALAGE TPF DEBUG SERVER STARTED FOR HOST:         |
|                           9.117.197.67 (TPF31720C) ON PORT 8000                |
+--------------------------------------------------------------------------------+

The VisualAge TPF debug server is stopped in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDBUG STOP                                                              |
|System: CDBS0011I 14.53.12 TPF DEBUGGER HAS BEEN DISABLED                       |
+--------------------------------------------------------------------------------+

The VisualAge TPF debug server is not stopped in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDBUG STOP                                                              |
|System: CDBS00191I 14.53.12 AN ACTIVE TRACE ENTRY WAS FOUND. TPF DEBUGGER WAS NO|
|                            DISABLED. ALL NONACTIVE TRACE ENTRIES WERE REMOVED. |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, a single trace entry from the TPF debug registration client is removed from the VisualAge TPF debug server depending on the workstation IP address that is entered.

+--------------------------------------------------------------------------------+
|User:   ZDBUG CLEAR IP-9.117.198.100                                            |
|                                                                                |
|System: CDBS0012I 14.53.12 TRACE ENTRY HAS BEEN REMOVED FOR 9.117.198.100       |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, the trace entry is cleared while the entry is active.

+--------------------------------------------------------------------------------+
|User:   ZDBUG CLEAR IP-9.117.198.100                                            |
|System: CDBS0018W 14.53.12 IP ADDRESS 9.117.107.102 CLEARED WHILE ENTRY WAS ACTI|
|                                                                                |
+--------------------------------------------------------------------------------+

In the examples that follow, the following TPF debugger registration information is displayed:

+--------------------------------------------------------------------------------+
|User:   ZDBUG DISPLAY ALL                                                       |
|System: CSMP0097I 17.16.04 CPU-C SS-BSS  SSU-HPN  IS-01                         |
|        CDBS0013I 17.16.04 START OF DEBUGGER REGISTRATION INFORMATION           |
|                                                                                |
|                   TRACE BY PROGRAM TABLE                                       |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   STATE    USER TOKEN   PROGRAM MASK                       |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  Nonact                 QPK0                              |
|9.117.107.15    Pa     Nonact   BRADDK        CVZZQTA7                          |
|                                                                                |
|                                                                                |
|                   TRACE BY TERMINAL TABLE                                      |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   TERMINAL  STATE       USER TOKEN   PROGRAM MASK          |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.10    Debug  010004    Nonact      BILLCO        QTA7                 |
|9.117.107.249   Debug  010005    Act         ECSMYTH       QPM3QPM9             |
|9.117.107.102   Debug  010006    Nonact                    QPK0                 |
|9.117.107.15    Pa     010003    Nonact      BRAIN         CVZZQPK0QPM3QPM      |
|9.117.107.15    Debug  010007    Nonact      BGOLDBRG      ABCDCHJIGARB         |
|9.117.107.15    Pa     01000a    Nonact      KELLYK        CVZZQPM9             |
|9.117.107.249   Debug  010008    Nonact                    QPM3QPM9             |
|                                                                                |
+--------------------------------------------------------------------------------+

TPF debugger registration information is displayed in the following example only if the user entry is trace-by-program.

+--------------------------------------------------------------------------------+
|User:   ZDBUG DISPLAY PROGRAM                                                   |
|                                                                                |
|System: CDBS0014I 14.53.12 START OF DEBUGGER PROGRAM REGISTRATION INFORMATION   |
|                                                                                |
|                   TRACE BY PROGRAM TABLE                                       |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   STATE      USER TOKEN   PROGRAM MASK                     |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   DEBUG  Nonact                  CDBS                             |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

TPF debugger registration information is displayed in the following example only if the user entry is trace-by-terminal.

+--------------------------------------------------------------------------------+
|User:   ZDBUG DISPLAY TERMINAL                                                  |
|                                                                                |
|System: CDBS0015I 14.53.12 START OF DEBUGGER TERMINAL REGISTRATION INFORMATION  |
|                                                                                |
|                   TRACE BY TERMINAL TABLE                                      |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   TERMINAL   STATE      USER TOKEN   PROGRAM MASK          |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  010000     Nonact                  CVZZ                  |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, the active entries are displayed in the trace-by-terminal and trace-by-program tables.

+--------------------------------------------------------------------------------+
|User:   ZDBUG DISPLAY ACTIVE                                                    |
|System: CDBS0016I 14.53.12 START OF DEBUGGER ACTIVE REGISTRATION INFORMATION    |
|                                                                                |
|                   TRACE BY PROGRAM TABLE                                       |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   STATE      USER TOKEN   PROGRAM MASK                     |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  Act                    QPK0                              |
|                                                                                |
|                   TRACE BY TERMINAL TABLE                                      |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   TERMINAL   STATE   USER TOKEN   PROGRAM MASK             |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  010000      Act                  CDBS                    |
+--------------------------------------------------------------------------------+

In the following example, the nonactive entries are displayed in the trace-by-terminal and trace-by-program tables.

+--------------------------------------------------------------------------------+
|User:   ZDBUG DISPLAY NONACTIVE                                                 |
|System: CDBS0017I 14.53.12 START OF DEBUGGER NONACTIVE REGISTRATION INFORMATION |
|                                                                                |
|                    TRACE BY PROGRAM TABLE                                      |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   STATE      USER TOKEN   PROGRAM MASK                     |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  Nonact                   CVZZ                            |
|                                                                                |
|                    TRACE BY TERMINAL TABLE                                     |
|--------------------------------------------------------------------------------|
|WORKSTATION IP  TYPE   STATE      USER TOKEN   PROGRAM MASK                     |
|--------------------------------------------------------------------------------|
|                                                                                |
|9.117.107.102   Debug  010000                   CVZZ                            |
+--------------------------------------------------------------------------------+

Related Information