display

Syntax

display [on_clipboard_line] <line> "<pri>" [<wrap>] ["<sec>"]

[if_flag <flag>] [<keyword_parms>];

Terse form

dsp

Type

Softkey return strings (FDM only) - code x'98'

FDM Function - Opcode 3

Parameters

Stores the screen information that is defined in the following parameters, in the Status Display page, and displays the status page on the screen. The <line> parameter points to the line in the Status Display where the store should start.

This statement is interchangeable with the put statement (see put).

Description

<line> is the line number of the Status Display page on which the data is to be displayed and is a decimal number between 1 and 33.
The line number may be optionally preceded with 'on_clipboard_line'. This is for compatibility with the Bellcore definition.
<pri> is a character string to be displayed in the primary display area.
<wrap> is an optional parameter to set or reset the wrap indicator. Use && to set the wrap indicator, and || to reset it. You can also set and reset the wrap indicator using the 'wi=' keyword parameter.
<sec> is an optional character string to be displayed in the secondary display area.
<flag> is the optional number of a flag (1 to 7) and should only be coded if immediately following 'if_flag'. In this case, the display operation is performed only if the flag is set.
<keyword_parms> are a number of optional keyword parameters which take defaults according to most common usage. These can occur anywhere within the statement between the instruction word and the ending semi-colon. Valid keywords for this instruction are:
- <lrci=c> (default), or <lrci=l, r or i> to set the centered, left justified, right justified or indented formatting.
- <wi=0> (default), or <wi=1> to set the wrap indicator.

References

SR-INS-002461 (Softkeys), SR-INS-002461 (FDM Scripts).

Notes

Parameter substitutions are possible for <pri> and <sec> fields.
If the primary field (<pri>) is more than 20 characters, and the secondary field has not been coded, the primary field is split into two parts (the first part is 20 characters long, the second contains the remainder of the original primary definition), and the wrap indicator will be forced on.

Example

display 4 "Left" "Right";

dsp 4 "Hello" && "Goodbye" wi=1 if_flag 7;

dsp 4 "Prim" || "Sec";

dsp 4 "Display data";

dsp on_clipboard_line 5 "data" lrci=c wi=0 if_flag 5;