The following table is sorted alphabetically by symbol name. The same table sorted by value is provided after the Notes, below.
Symbol |
Value |
Notes |
Description |
44 |
1 |
Force immediate ATE disconnect |
|
68 |
(none) |
Change underline attribute |
|
AG_AUTOPARENT |
87 |
3 |
? tab(-10,AG_AUTOPARENT); ctrlid; chr(127); see MX_AUTOPARENT |
13 |
3 |
Set beveling flags |
|
70 |
3,5 |
Select Windows folder |
|
74 |
3,5 |
Check ATE network state |
|
65 |
3 |
Perform clipboard operations |
|
AG_CLRINBUF |
106 |
1,3 |
Clears the ATE client input buffer: ? tab (-10,AG_CLRINBUF); chr(127). Note that MX_CLRINBUF will automatically issue this command, so you would normally only use AG_CLRINBUF separately in specialized situations. |
20 |
3,5 |
Edit GUI control |
|
64 |
1,5 |
Retrieve ATE date and time |
|
107 |
(none) |
Run Delayed Operation in Background |
|
AG_DESIGN |
61 |
6 |
Design mode operations |
114 |
4,5 |
Counts or deletes files based on various filter attributes. |
|
53 |
1 |
Set disconnect password |
|
110 |
(none) |
Activate Windows "Dpi Per Monitor awareness |
|
112 |
4,5 |
Implements both destructive and non-destructive drag-drop modes |
|
33 |
3 |
Event wait |
|
57 |
(none) |
Output system message |
|
31 |
3,5 |
Get file stats |
|
113 |
4,5 |
Get / set a file's modification, creation or access time |
|
28 |
(none) |
Flash Window |
|
22 |
1,2,5 |
FTP |
|
29 |
1,2 |
Set FTP login / password |
|
AG_FTPSYNC |
55 |
1,2 |
Used internally with ATSYNC.LIT. Inquire if interested. |
111 |
3,5 |
Return the DPI for workstation and monitor |
|
45 |
4,5 |
Get ATE environment variable |
|
AG_GETFLAGS |
92 |
6 |
? tab(-10,AG_GETFLAGS); opcode; chr(127); Retrieves a single digit (0 or 1) followed by a CRLF, indicating if theme support is active on the client. |
115 |
4,5 |
Retrieves the name of the user's locale on the client workstation. |
|
47 |
3,5 |
Display open/save file dialog |
|
71 |
3,5 |
Retrieve Windows path |
|
AG_HANDSHAKE |
85 |
1 |
Send/receive various info with ATE client |
36 |
1, 6 |
Set ATE keyboard hold |
|
79 |
1,3,5 |
Set / retrieve timeout period |
|
35 |
3 |
Image processing |
|
78 |
5 |
Test for foreground status |
|
21 |
3,5 |
Edit menu control |
|
3 |
(none) |
Play Windows sound |
|
4 |
3,5 |
Display OK / cancel message box |
|
17 |
3,5 |
Display standard message dialog |
|
1 |
(none) |
Set minimized window title |
|
32 |
3,5 |
Make directory |
|
100 |
(none) |
Set / Restore AutoMouse |
|
AG_NEWPRODUCT |
6 |
6 |
Allows override of certain info in the ABOUT box |
69 |
4,5 |
Set / retrieve OPTIONS for ATE |
|
66 |
3,5 |
Get OS info |
|
AG_PALETTE |
15 |
5 |
Query colors. See Define or Query Color Palette. |
105 |
(none) |
Play Sound File |
|
AG_RAWDATA |
83 |
1 |
Send raw data |
49 |
1,3 |
Release ATE keyboard release |
|
16 |
(none) |
Reset window |
|
40 |
(none) |
Save / restore screen with ID |
|
102 |
3,4,5 |
Set / Retrieve SBR Flags |
|
109 |
(none) |
Control Scrollback Bar |
|
82 |
(none) |
Send keyboard characters |
|
15 |
(none) |
Define or query color palette |
|
50 |
(none) |
Set Mouse Cursor |
|
77 |
3,4 |
Set environment variable |
|
24 |
3,5 |
Shell execute |
|
72 |
3,5 |
Create a shortcut |
|
AG_SHOWFONT |
99 |
(none) |
Deprecated. Display font info. |
27 |
3 |
Show window |
|
54 |
1 |
Auxiliary port control |
|
34 |
(none) |
Enable / disable status lines |
|
26 |
3 |
Associate A-Shell and Windows colors |
|
63 |
(none) |
Change RGB Value |
|
76 |
4,5 |
Clear / set / query ATE trace flags |
|
39 |
(none) |
Display wallpaper |
|
108 |
3,5 |
Get / Set WEBCACHE Options |
|
23 |
5 |
Execute Windows command line |
|
56 |
3,5 |
Display printer selection dialog |
|
46 |
3,5 |
Get / set / load / save settings |
|
2 |
(none) |
Change the title that displays on the title bar of the A-Shell window |
|
62 |
(none) |
Enable / disable wrap |
|
25 |
5 |
Call SBX as a function (numeric) |
|
73 |
(none) |
Call SBX as a function (no return value) |
|
75 |
5 |
Call SBX as a function (string) |
Notes
1 | Applies only to ATE. It may be technically possible to use the command in non-ATE situations, but it doesn’t make much sense. |
2 | Requires that an FTP service be activated on the server, which uses the same root directory as A-Shell running on the server (which is rarely the case with Windows). |
3 | The MX_xxx or AUI_xxx equivalent is preferable, as it will be simpler to use (no need for an INPUT statement to retrieve the result) and will automatically route the command to the ATE client or handle locally on the application server, depending on the environment. Note, however, that in some cases, the MX_xxx or AUI_xxx equivalent may support an option of whether to perform the function on the server or forward it to the ATE client, whereas the AG_xxx functions are always sent to the client. See the MX_xxx / AUI_xxx documentation for details. In the case of A-Shell/Windows without ATSD, the client and server are effectively the same. |
4 | Similar to the MX_xxx equivalent, but always works relative to the client PC, whereas the MX_xxx equivalent always works relative to the application server. In the case of A-Shell/Windows without ATE, the two are functionally the same. |
5 | In lieu of using ? Tab(-10, AG_xxx) followed by some form of INPUT to retrieve the response, we recommend the use of the MX_AGWRAPPER function as a way of combining the two operations into a single subroutine (provided server is running A-Shell and the MX_AGWRAPPER function is available). |
6 | Used mostly or entirely for internal purposes only. Please inquire if you want more information on this function. |
Table Sorted by Value
Symbol |
Value |
Notes |
Description |
1 |
(none) |
Set minimized window title |
|
2 |
(none) |
Change the title that displays on the title bar of the A-Shell window |
|
3 |
(none) |
Play Windows sound |
|
4 |
3,5 |
Display OK / cancel message box |
|
AG_NEWPRODUCT |
6 |
6 |
Allows override of certain info in About box |
13 |
3 |
Set beveling flags |
|
15 |
(none) |
Define or query color palette |
|
AG_PALETTE |
15 |
5 |
Query colors. See Define or Query Color Palette. |
16 |
(none) |
Reset window |
|
17 |
3,5 |
Display standard message dialog |
|
20 |
3,5 |
Edit GUI control |
|
21 |
3,5 |
Edit menu control |
|
22 |
1,2,5 |
FTP |
|
23 |
5 |
Execute Windows command line |
|
24 |
3,5 |
Shell execute |
|
25 |
5 |
Call SBX as a function (numeric) |
|
26 |
3 |
Associate A-Shell and Windows colors |
|
27 |
3 |
Show window |
|
28 |
(none) |
Flash Window |
|
29 |
1,2 |
Set FTP login / password |
|
31 |
3,5 |
Get file stats |
|
32 |
3,5 |
Make directory |
|
33 |
3 |
Event wait |
|
34 |
(none) |
Enable / disable status lines |
|
35 |
3 |
Image processing |
|
36 |
1, 6 |
Set ATE keyboard hold |
|
39 |
(none) |
Display wallpaper |
|
40 |
(none) |
Save / restore screen with ID |
|
44 |
1 |
Force immediate ATE disconnect |
|
45 |
4,5 |
Get ATE environment variable |
|
46 |
3,5 |
Get / set / load / save settings |
|
47 |
3,5 |
Display open/save file dialog |
|
49 |
1,3 |
Release ATE keyboard release |
|
50 |
(none) |
Set Mouse Cursor |
|
53 |
1 |
Set disconnect password |
|
54 |
1 |
Auxiliary port control |
|
AG_FTPSYNC |
55 |
1,2 |
Used internally with ATSYNC.LIT. Inquire if interested. |
56 |
3,5 |
Display printer selection dialog |
|
57 |
(none) |
Output system message |
|
AG_DESIGN |
61 |
6 |
Design mode operations |
62 |
(none) |
Enable / disable wrap |
|
63 |
(none) |
Change RGB Value |
|
64 |
1,5 |
Retrieve ATE date and time |
|
65 |
3 |
Perform clipboard operations |
|
66 |
3,5 |
Get OS info |
|
68 |
(none) |
Change underline attribute |
|
69 |
4,5 |
Set / retrieve OPTIONS for ATE |
|
70 |
3,5 |
Select Windows folder |
|
71 |
3,5 |
Retrieve Windows path |
|
72 |
3,5 |
Create a shortcut |
|
73 |
(none) |
Call SBX as a function (no return value) |
|
74 |
3,5 |
Check ATE network state |
|
75 |
5 |
Call SBX as a function (string) |
|
76 |
4,5 |
Clear / set / query ATE trace flags |
|
77 |
3,4 |
Set environment variable |
|
78 |
5 |
Test for foreground status |
|
79 |
1,3,5 |
Set / retrieve timeout period |
|
82 |
(none) |
Send keyboard characters |
|
AG_RAWDATA |
83 |
1 |
Send raw data |
AG_HANDSHAKE |
85 |
1 |
Send/receive various info with ATE client |
AG_AUTOPARENT |
87 |
3 |
? tab(-10,AG_AUTOPARENT); ctrlid; chr(127); see MX_AUTOPARENT |
AG_GETFLAGS |
92 |
6 |
? tab(-10,AG_GETFLAGS); opcode; chr(127); Retrieves a single digit (0 or 1) followed by a CRLF, indicating if theme support is active on the client. |
AG_SHOWFONT |
99 |
(none) |
Deprecated. Display font info. |
100 |
(none) |
Set / Restore AutoMouse |
|
102 |
3,4,5 |
Set / Retrieve SBR Flags |
|
105 |
(none) |
Play Sound File |
|
AG_CLRINBUF |
106 |
1,3 |
Clears the ATE client input buffer: ? tab (-10,AG_CLRINBUF); chr(127). Note that MX_CLRINBUF will automatically issue this command, so you would normally only use AG_CLRINBUF separately in specialized situations. |
107 |
(none) |
Run Delayed Operation in Background |
|
108 |
3,5 |
Get / Set WEBCACHE Options |
|
109 |
(none) |
Control Scrollback Bar |
|
110 |
(none) |
Activate Windows "Dpi Per Monitor awareness |
|
111 |
3,5 |
Return the DPI for workstation and monitor |
|
112 |
4,5 |
Implements both destructive and non-destructive drag-drop modes |
|
113 |
4,5 |
Get / set a file's modification, creation or access time |
|
114 |
4,5 |
Counts or deletes files based on various filter attributes. |
|
115 |
4,5 |
Retrieves the name of the user's locale on the client workstation. |