Skip to content

Commit 80ffb6e

Browse files
committed
Work in progress
Signed-off-by: S. Julliand <sebjulliand@gmail.com>
1 parent b10ad50 commit 80ffb6e

File tree

8 files changed

+45
-14
lines changed

8 files changed

+45
-14
lines changed

.astro/types.d.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -391,5 +391,5 @@ declare module 'astro:content' {
391391

392392
type AnyEntryMap = ContentEntryMap & DataEntryMap;
393393

394-
export type ContentConfig = typeof import("../src/content/config.js");
394+
export type ContentConfig = typeof import("./../src/content/config.js");
395395
}
6.49 KB
Loading
11 KB
Loading
4.18 KB
Loading
7.32 KB
Loading
2.01 KB
Loading
3.35 KB
Loading

src/content/docs/developing/debug/index.mdx

Lines changed: 44 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -55,13 +55,13 @@ To debug a program from the Object Browser, right-click on the program object an
5555

5656
## General requirements
5757

58-
* PTFs
59-
* Certificates setup on the server
60-
* created in `/QIBM/UserData/IBMiDebugService/certs` by default
61-
* IBM i Debug extension
62-
* installed into Visual Studio Code
63-
* Local client certificate
64-
* can be imported with the 'Import local certificate' command
58+
* PTFs (see below)
59+
* IBM i Debug extension ([marketplace](https://marketplace.visualstudio.com/items?itemName=IBM.ibmidebug))
60+
* installed into Visual Studio Code
61+
* Debug Service Certificates setup
62+
* created in `/QIBM/UserData/IBMiDebugService/certs` by default
63+
* Debug Service certificate `debug_service.pfx`
64+
* Debug Service client certificate `debug_service.crt`
6565

6666
## Required PTFs
6767

@@ -92,16 +92,47 @@ After you have installed the PTFs, the connection inside of Visual Studio Code w
9292
## Configuring & starting the service
9393

9494
<CardGrid>
95-
9695
<Card>
96+
After connecting to a system in Code for IBM i, you can hover over the connection in the bottom status bar to check the Debugger version and status. The status will be `on` if both the Debug Server and Debug Service are running.
97+
</Card>
98+
<Card>
99+
![](./debug6.png)
100+
</Card>
101+
</CardGrid>
102+
<CardGrid>
103+
<Card>
104+
Clicking on the Debugger status will take you to the IBM i Debugger view. This view shows the status of the Debug Server and the Debug Service. It also allows to start/stop the Debug Server and manage the Debug Service.
105+
</Card>
106+
<Card>
107+
![](./debug7.png)
108+
</Card>
109+
</CardGrid>
97110

98-
After connecting to a system in Code for IBM i, if the PTFs are installed but the service is not configured (i.e. the certificates don't exist) you will see a notice asking if you'd like to open the Walkthrough to configure the Debug Service. Clicking the button will open the Walkthrough.
99-
100-
</Card><Card>
111+
### Start/stop the Server and Service
112+
<CardGrid>
113+
<Card>
114+
The start/stop/restart actions are located on the right of each status. Running one of these actions will refresh the statuses once it's done.
115+
</Card>
116+
<Card>
117+
![](./debug8.png)
118+
![](./debug9.png)
119+
</Card>
120+
</CardGrid>
101121

102-
![](./setup1.png)
122+
<Aside type="tip">
123+
Starting and stopping the Debug Server and Service requires the *ALLOBJ special authority.
124+
</Aside>
103125

104-
</Card></CardGrid>
126+
### Managing the Debug Service
127+
<CardGrid>
128+
<Card>
129+
If the Debug Service is not correctly configured, a warning sign will appear next to it. Expanding the Debug Service node will show the cause of the issue.
130+
</Card>
131+
<Card>
132+
![](./debug10.png)
133+
![](./debug11.png)
134+
</Card>
135+
</CardGrid>
105136

106137
<Aside type="tip">
107138
There only needs to be one instance of the Debug Service running and therefore the certificates should only be generated once. All developers share the Debug Service.

0 commit comments

Comments
 (0)