Skip to content

Commit b58ac4e

Browse files
committed
add SELF docs
1 parent fbe5cb9 commit b58ac4e

File tree

5 files changed

+42
-7
lines changed

5 files changed

+42
-7
lines changed

.astro/types.d.ts

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -325,6 +325,13 @@ declare module 'astro:content' {
325325
collection: "docs";
326326
data: InferEntrySchema<"docs">
327327
} & { render(): Render[".mdx"] };
328+
"quickstart.mdx": {
329+
id: "quickstart.mdx";
330+
slug: "quickstart";
331+
body: string;
332+
collection: "docs";
333+
data: InferEntrySchema<"docs">
334+
} & { render(): Render[".mdx"] };
328335
"settings/connection.mdx": {
329336
id: "settings/connection.mdx";
330337
slug: "settings/connection";
@@ -353,13 +360,6 @@ declare module 'astro:content' {
353360
collection: "docs";
354361
data: InferEntrySchema<"docs">
355362
} & { render(): Render[".mdx"] };
356-
"tips/quickstart.mdx": {
357-
id: "tips/quickstart.mdx";
358-
slug: "tips/quickstart";
359-
body: string;
360-
collection: "docs";
361-
data: InferEntrySchema<"docs">
362-
} & { render(): Render[".mdx"] };
363363
"tips/setup.mdx": {
364364
id: "tips/setup.mdx";
365365
slug: "tips/setup";

src/content/docs/extensions/db2i/index.mdx

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,41 @@ The Db2 for i extension adds a view called Schema Browser which allows the user
8080

8181
If you are using the Schema Browser to browse objects, you are able to use the 'View contents' icon when hovering over a table, view, or alias to cause a basic SQL select statement to be generated and executed.
8282

83+
## SQL Error Logging Facility (SELF)
84+
85+
SQL Error Logging Facility (SELF) offers a comprehensive view that can help users understand specific SQL errors or warnings. The SELF view can be accessed through the IBM i panel next to the Results View.
86+
87+
![](./selfcodes.png)
88+
89+
Each item in the SELF view is for a specific `SQLCODE` which is displayed in parenthesis. The `SQLCODE` tracks the actual error or warning triggered by a given SQL statement.
90+
91+
- An error SQLCODE must be preceded by a single minus sign ('-').
92+
- A warning SQLCODE can be preceded by an optional plus sign ('+').
93+
94+
When an item is expanded or hovered over, information about the `SQLCODE` is displayed such as the Job Name, Call Stack, Additional Details, and the SQL statement. The counter on the right of each item denotes the number of occurrences(🔥) of the specific `SQLCODE` . Once the number of occurrences for a given code is greater than 100, we display 💯.
95+
96+
### Enabling SELF in VSCode
97+
98+
To capture SQL errors or warnings, enable the SELF Default in your VSCode settings. This will be the Default `SYSIBMADM.SELFCODES` global variable for all jobs. By default, the `SELFCODES` level is set to *NONE.
99+
100+
- *ERROR specifies all SQLCODEs that are error conditions (negative values).
101+
- *WARN specifies all SQLCODEs that are warning conditions (positive
102+
values).
103+
- *ALL specifies all SQLCODEs that are error or warning conditions.
104+
- *NONE turns off SELF processing.
105+
106+
![](./selfdefault.png)
107+
108+
The SELF Level can also be set on a per job basis by right clicking on the active job in the [SQL Job Manager](#sql-job-manager)
109+
110+
### Auto Refresh
111+
112+
![](./selfauto.png)
113+
114+
We added the option for users to configure `Auto Refresh` on the SELF view. When enabled, the SELF view will update on a constant interval (every 30 seconds). The SELF view can be cleared by clicking the trash icon.
115+
116+
Additional documentation of SELF can be found [here](https://www.ibm.com/docs/en/i/7.5?topic=tools-sql-error-logging-facility-self)
117+
83118
## Visual Explain
84119

85120
We have added Visual Explain into the database extension with a more lightweight approach of explain data. The typically run button on the document now has options to either run, run and explain or explain without running, which will show the explain nodes and node details in the same result set view.
96.6 KB
Loading
1.32 MB
Loading
1.05 MB
Loading

0 commit comments

Comments
 (0)