hotkeys Definition/Update Processor, hotkeys Definition/Update Processor

hotkeys

Command hotkeys Definition/Update Processor
Applicable release versions: AP
Category Update Processor (113)
Description allows calling Pick/BASIC subroutines from dictionaries using the UP command "<ctrl>+xnumber", where "number" is a number between "0" through "9".

There are 11 dictionary attributes in both the file-defining and attribute-defining items related to "hotkeys". They are defined as "hotkey.all", "hotkey0", "hotkey1", etc., through "hotkey9".

Hotkey subroutine calls are available in addition to subroutine calls from "output-conversion", "correlative" or "input-conversion".

To call a Pick/BASIC subroutine while in the Update processor on a particular attribute, type "<ctrl>+xnumber".

Only the program(s) on one dictionary will be executed by each command. There may be more than one subroutine called on an attribute. (Use "<ctrl>+v" to multi-value call statements.)

The subroutine that gets executed is dependent on the following set of priorities:

If there is a subroutine called on "hotkey.all" (attribute 20) in the current attribute-defining item, it will be executed, regardless of the value of "number".

If there is not a subroutine called on "hotkey.all", the subroutine called on attribute<20> + "number" of the current attribute-defining item will be executed . Note: If "number" = "0", the subroutine on "hotkey.0" (attribute 30), if present, will be executed.

If there are no subroutines called in the attribute-defining item, the file-defining item is used.

If there is a subroutine called on "hotkey.all" (attribute 20) in the file-defining item, it will be executed, regardless of the value of "number".

If there is not a subroutine called on "hotkey.all", the subroutine called on attribute<20> + "number" of the current file-defining item will be executed . Note: If "number" = "0", the subroutine on "hotkey.0" (attribute 30), if present, will be executed.

The following table illustrates the rules by which hotkey references are interpreted.

Att# Dict.name Subroutine call UP command
<20> hotkey.all call default <ctrl>+x<0-9>
<21> hotkey1 call one <ctrl>+x1
<22> hotkey2 call two <ctrl>+x2
<23> hotkey3 call three <ctrl>+x3
<24> hotkey4 call four <ctrl>+x4
<25> hotkey5 call five <ctrl>+x5
<26> hotkey6 call six <ctrl>+x6
<27> hotkey7 call seven <ctrl>+x7
<28> hotkey8 call eight <ctrl>+x8
<29> hotkey9 call nine <ctrl>+x9
<30> hotkey0 call zero <ctrl>+x0
Syntax
Options
Example
:ud filename test
dictionary-code    a
attribute-count    5
substitute-header
structure
output-conversion  
correlative
attribute-type     l
column-width       20
input-conversion   
macro              
output-macro
description
hotkey.all         
hotkey1            call list.states
                   call list.country
hotkey2      
hotkey3      
hotkey4      
hotkey5      
hotkey6      
hotkey7      
hotkey8      
hotkey9      
hotkey0      

In this example, when the operator enters "<ctrl>+x1" from the 
attribute "test", the subroutines "list.states" and 
"list.country" are executed. After "list.country" 
completes, control returns to UP and remains in the item "test".
Purpose
Related output-conversion
correlative
input-conversion
up.x
attribute.defining.items
hotkey0
hotkey1
hotkey2
hotkey3
hotkey4
hotkey5
hotkey6
hotkey7
hotkey8
hotkey9
file.defining.items
tcl.ud
hotkey.all
up

hotkeys

Command hotkeys Definition/Update Processor
Applicable release versions: AP
Category Update Processor (113)
Description allows calling Pick/BASIC subroutines from dictionaries using the UP command "<ctrl>+xnumber", where "number" is a number between "0" through "9".

There are 11 dictionary attributes in both the file-defining and attribute-defining items related to "hotkeys". They are defined as "hotkey.all", "hotkey0", "hotkey1", etc., through "hotkey9".

Hotkey subroutine calls are available in addition to subroutine calls from "output-conversion", "correlative" or "input-conversion".

To call a Pick/BASIC subroutine while in the Update processor on a particular attribute, type "<ctrl>+xnumber".

Only the program(s) on one dictionary will be executed by each command. There may be more than one subroutine called on an attribute. (Use "<ctrl>+v" to multi-value call statements.)

The subroutine that gets executed is dependent on the following set of priorities:

If there is a subroutine called on "hotkey.all" (attribute 20) in the current attribute-defining item, it will be executed, regardless of the value of "number".

If there is not a subroutine called on "hotkey.all", the subroutine called on attribute<20> + "number" of the current attribute-defining item will be executed . Note: If "number" = "0", the subroutine on "hotkey.0" (attribute 30), if present, will be executed.

If there are no subroutines called in the attribute-defining item, the file-defining item is used.

If there is a subroutine called on "hotkey.all" (attribute 20) in the file-defining item, it will be executed, regardless of the value of "number".

If there is not a subroutine called on "hotkey.all", the subroutine called on attribute<20> + "number" of the current file-defining item will be executed . Note: If "number" = "0", the subroutine on "hotkey.0" (attribute 30), if present, will be executed.

The following table illustrates the rules by which hotkey references are interpreted.

Att# Dict.name Subroutine call UP command
<20> hotkey.all call default <ctrl>+x<0-9>
<21> hotkey1 call one <ctrl>+x1
<22> hotkey2 call two <ctrl>+x2
<23> hotkey3 call three <ctrl>+x3
<24> hotkey4 call four <ctrl>+x4
<25> hotkey5 call five <ctrl>+x5
<26> hotkey6 call six <ctrl>+x6
<27> hotkey7 call seven <ctrl>+x7
<28> hotkey8 call eight <ctrl>+x8
<29> hotkey9 call nine <ctrl>+x9
<30> hotkey0 call zero <ctrl>+x0
Syntax
Options
Example
:ud filename test
dictionary-code    a
attribute-count    5
substitute-header
structure
output-conversion  
correlative
attribute-type     l
column-width       20
input-conversion   
macro              
output-macro
description
hotkey.all         
hotkey1            call list.states
                   call list.country
hotkey2      
hotkey3      
hotkey4      
hotkey5      
hotkey6      
hotkey7      
hotkey8      
hotkey9      
hotkey0      

In this example, when the operator enters "<ctrl>+x1" from the 
attribute "test", the subroutines "list.states" and 
"list.country" are executed. After "list.country" 
completes, control returns to UP and remains in the item "test".
Purpose
Related output-conversion
correlative
input-conversion
up.x
attribute.defining.items
hotkey0
hotkey1
hotkey2
hotkey3
hotkey4
hotkey5
hotkey6
hotkey7
hotkey8
hotkey9
file.defining.items
tcl.ud
hotkey.all
up