Please enable JavaScript to view this site.

A-Shell Reference

exitcode, if specified, receives a value to indicate how the field was exited. Note that for a specific value (except 0) to be returned, it must be activated by a corresponding type code (for the positive EXITCODEs), or by the funmap parameter controlling function key usage (for the negative exitcodes).

The number of command or function keys is limited by your terminal and function key translation module, subject to a maximum of 127 for direct function keys, and 999 for "virtual" function keys using the chr(7)+chr(250)+###. sequence.. Note that we use the terminology Command Keys (Cmdx) in place of Function Keys (Fxx) to underscore the idea that they can be mapped on to the physical function keys any way you like.

When |K (Windows keyboard mode) is NOT used, the Shift+Arrow keys work like function keys (same as they do in text mode), and will generate exitcodes based on the <tdv>.IFX translation table. The standard exitcodes for the shifted arrows are: -36, -37, -38 and -39. See FIXTRN.LIT for details on editing translation tables.

Value

Symbol

Description

0

 

Return (Enter), or Tab when |K code used.

1

EXC_ESC

Escape (if neither E nor W codes used), or Ctrl+W if the |W code used.

2

EXC_LEFT

Left-Arrow (^H) or Escape (when E code used), or Shift+Tab when |2 used.

3

EXC_UP

Up-Arrow (^K) when enabled with 3 code, , or Shift+Tab when in GUI mode (|G)

4

EXC_PGUP

Page-Up (^R) when enabled with 4 code

5

EXC_DOWN

Down-Arrow (^J) when enabled with 5 code

6

EXC_PGDN

Page-Down (^T) when enabled with 6 code

7

EXC_TAB

Tab (when enabled with T code)

8

EXC_HELP

Help (?) when enabled with ? code

9

EXC_HOME

Home (Control ^) when enabled with 9 code

10

EXC_CTRLC

Ctrl+C Trap (when enabled with V code). See also Ctrl+C Behavior.

11

EXC_TIME

Field timed out

12

EXC_RIGHT

Right-Arrow (^L) when enabled with L code

13

 

Spacebar (when enabled with 7 code) or user selected an item in the dropdown area of combo box using Enter or Click (when enabled with ||m code).

14

 

Rubout or Delete (when enable with 8 code)

15

 

Ctrl+E (when enabled with the k code)

16

 

Ctrl+B (when enabled with the |B code)

17

 

Ctrl+O (when enabled with the |O code)

18

 

Ctrl+Z (when enabled with the |Z code)

19

 

Ctrl+A (when enabled with the |a code)

20

 

Ctrl+W (when enabled with the |w code)

21

 

Ctrl+U (when enabled with the |U code)

22

 

Ctrl+N (when enabled with the |N code)

25

 

Ctrl+P (when enabled with the |Q code)

26

 

Ctrl+S (when enabled with the |S code)

27

 

Ctrl+X (when enabled with the |XX three-character code)

29

 

User clicked on dropdown button in Self Service Combo Box

30

 

(Auto-Complete) User has modified the field and then paused or hit Down-Arrow; INFLD requests an updated setdef parameter containing the drop-down list configuration and contents.

31

 

(Auto-Complete) User has hit Ctrl+Down-Arrow from bottom item of auto-complete list request additional items. Application may replace list with new data, or just add to the existing list, at its option.

-1

 

(Cmd1) (When enabled via translation table and/or (funmap))

-2

 

(Cmd2) etc.

-35

 

Shift+Tab; note 1

-65

 

Ctrl+Page-Down; note1

-66

 

Ctrl+Page-Up; note1

-67

 

Ctrl+Home; note 1

-68

 

Ctrl+End; note 1

-69

 

Click on close-tab "x" button in TabX control

-75

 

File(s) dragged-and-dropped on to a control with the WS_EX_ACCEPTFILES attribute. See MX_DRAGDROP.

-###

 

(Virtual function key) Triggered by a function key or a mouse-click on a field which was programmed to send the sequence chr(7)+chr(250)+"###." where ### is any number. See hlpidx.

 

Comments

The upper bit of the funmap parameter must be set in order to enable the specified exitcode. This can be accomplished by setting funmap = -1, enabling all function key exits as well, or by adding 2^31 to any other funmap value.

See Also