disinfo string types

The disinfo string types can be referenced here.

The string types are as follows:

Item Description
dskx A string type that starts with dsk describes a key. The type must be four letters long, and the fourth letter x indicates what action is taken when the key is received. The key types are:
Type
Action
dsks
Switch Screens
dskb
Block Input and Output
dske
End dscreen
dskq
Quit dscreen (exit status=1)
dskc
Create New Screen
dskp
Switch to Previous Screen
dskl
List Keys and Actions

Any other key type (that is, a string type dskx that does not end in s, b, e, q, p, or l) will cause no internal dscreen action, but will show up in the key listing and will be recognized and acted on. A type of dskn (n for No Operation) should be used when no internal dscreen action is desired.

The value string for each key has three substrings, which are separated by pipe ( | ) characters.

Note: Use \| to include the | character in one of the substrings.

The first substring is the sequence of characters that the terminal sends when the key is pressed. The second substring is a label for the key that is printed when a list of keys is displayed. The third substring is a sequence of characters that dscreen sends to the terminal when this key is pressed before performing the action this key requests.

dsp A string type of dsp describes a physical screen in the terminal. One dsp string should be present for each physical screen in the terminal. The value string for each physical screen has two substrings, which are separated by a pipe ( | ) character.

The first substring is the sequence of characters to send to the terminal to display and output to the physical page on the terminal.

The second substring is sent to the terminal when the page is used for something new. This second substring is often set to the clear screen sequence. It is sent under the following two conditions:

  1. When a new virtual terminal session is being created.
  2. When there are more virtual terminals than there are physical screens. If a virtual terminal is selected that requires dscreen to reuse one of the physical screens, it will send this sequence to the screen to indicate that the screen contents do not match the output of the virtual terminal connected.
Note: Running with more virtual terminals than physical screens can be confusing and is not recommended; it can be avoided by defining no more screen selection keys (dsks= ) than physical screens (dsp= ) in the dsinfo entry.
dst A String with a type of dst adjusts dscreen's input timeout. The value of the string is a decimal number. The timeout value is in tenths of seconds and has a maximum value of 255 (default=1 [or 0.1 seconds]).

When dscreen recognizes a prefix of an input key sequence but does not have all the characters of the sequence, it will wait for more characters to be sent until it is recognizable. If the timeout occurs before more characters are received, the characters are sent on to the virtual screen and dscreen will not consider these characters as part of an input key sequence.

It may be necessary to raise this value if one or more of the keys dscreen is to trigger on is actually a number of keystrokes (that is assigning Ctrl-Z 1, Ctrl-Z 2, Ctrl-Z 3, etc., for screen selection and Ctrl-Z N for new screen and so on).