PANEL RUNTIME

The format of the PANEL RUNTIME commands follow.
Read syntax diagramSkip visual syntax diagram
>>-PANEL--+-Send-----+--panel_name------------------------------>
          +-Receive--+               
          +-Converse-+               
          +-Test-----+               
          +-End------+               
          '-Generate-'               

>--+----------------------------+------------------------------->
   '-FIle--(--directory_name--)-'   

>--+-------------------------------+---------------------------->
   '-CUrsor--(--+-field_id----+--)-'   
                '-row--column-'        

>--+-----------------------------------------+--+-------+------->
   '-ATtrib--(--field_id attribute_values--)-'  '-ALarm-'   

>--+---------+--+-----------------------------+--+--------+----->
   '-NOErase-'  '-POsition--(--row--column--)-'  +-FReekb-+   
                                                 '-LOckkb-'   

                              .-UNProtect-.  .-NORmal----.   
>--+----------+--| options |--+-----------+--+-----------+------>
   '-CLrinput-'               +-PRotect---+  +-BRight----+   
                              '-SKip------'  '-INVisible-'   

                                 .-NOJustify-.   
>--+-GReen-----+--+-BLInk-----+--+-----------+------------------>
   +-RED-------+  +-REVerse---+  +-LEft------+   
   +-BLUe------+  '-UNDerline-'  '-RIght-----'   
   +-TUrquoise-+                                 
   +-WHite-----+                                 
   +-YEllow----+                                 
   +-PInk------+                                 
   '-DEfcolor--'                                 

           .-NULls--.                            
>--PAd--(--+--------+--)--NUMeric--CUrsor--MDT-----------------><
           +-BLAnks-+                            
           '-char---'                            

Operands

Send
is the panel command that sends a panel.
Receive
is the panel command that receives a panel.
Converse
is the panel command that sends a panel and waits for operator input.
Test
is the panel command that displays a panel. An intermediate file (panel object) is not created and variable substitutions are not attempted.
End
is a command that terminates the panel session. Command releases all storage held by the panel facility. This command does not have arguments and any arguments supplied are ignored.
Generate
is an explicit command that creates a panel object. The panel is not displayed.
panel_name
specifies the name of the panel to input/output or generate.
FIle()
specifies the name of the RFS directory (directory_name) containing this panel. (Specified for all panel commands except END.)
CUrsor()
(specified for SEND and CONVERSE only) positions the cursor on the panel.
field_id
specifies the REXX variable name where the cursor should be positioned on the panel.
row
specifies the row within the panel where the cursor should be positioned. The row value is relative to the starting row of the panel. The default starting row of the panel is 1, but may be changed using the POSITION() keyword.
column
specifies the column within the panel where the cursor should be positioned. The column value is relative to the starting column of the panel. The default starting column of the panel is 1, but may be changed using the POSITION() keyword.
ATtrib(field_id attribute_values)
(specified for SEND and CONVERSE only)
field_id
specifies the field whose attributes are dynamically set. It must be a variable name associated with the field. The field list must be enclosed with parenthesis. Only the attributes stated are changed and the other attributes default to what was statically defined. A field defined originally as RED and UNDERLINE remains underlined if only blue is stated dynamically.
ALarm
(specified for SEND and CONVERSE only) sounds the bell when displaying panel. (The default is no alarm).
NOErase
(specified for SEND and CONVERSE only) do not erase the screen before displaying this one. (The default is erase before a panel write).
POsition()
(specified for SEND, CONVERSE, and RECEIVE only) positions the panel on the output screen. Row (row) and column (column) specifies where the top left corner of the panel should begin. (The default is row 1 col 1). For example, POS(5 10) means to have the panel start in row 5 and column 10, the actual movement is 4 rows down and 9 columns to the right.
FReekb
(specified for SEND and CONVERSE only) frees the keyboard, allowing operator input. (This is the default.)
LOckkb
(specified for SEND and CONVERSE only) locks the keyboard.
CLrinput
(specified for SEND and CONVERSE only) clears all input fields before displaying the panel. Variable substitution is not attempted and pad characters fill the input area.

Options

UNProtect
specifies that the field is not protected from operator input.
PRotect
specifies that the field is protected from operator input.
SKip
specifies a protected field with the auto-skip feature. Operator entering a character in the last position of the previous unprotected field causes the cursor to skip over this field.
NORmal
specifies that the field is not highlighted.
BRight
specifies that the field is highlighted.
INVisible
specifies that the field is invisible.
GReen
RED
BLUe
TUrquoise
WHite
YEllow
PInk
DEfcolor
are the choices for the color.
Note:
  1. When you do not specify a default color, the color is based on the field type and intensity values: protect/normal displays blue, protect/bright displays white, unprotect/normal displays green, and unprotect/bright displays red.
  2. If any field on a panel has explicitly specified a color (including DEFCOLOR), all bright fields with DEFCOLOR or no color specified are displayed white and all normal fields with DEFCOLOR or no color specified are displayed green. This is a 3270 hardware limitation and not the panel facility.
BLInk
specifies that the field blinks.
REVerse
specifies that the field is in reverse video.
UNDerline
specifies that the field is underlined.
NOJustify
specifies that no justification is done (left justified but blanks are not stripped).
LEft
specifies that the field is left justified (leading blanks will be stripped).
RIght
specifies that the field is right justified (trailing blanks will be stripped).
PAd()
specified only in context of fields having variables. In an unprotected field the pad character fills the character positions that are not occupied by a variable value. In a protected field, the pad character is similar but the scope of the fill area is not the whole field as in the unprotected field. It is bound by where the variable starts, within the protected field to either the end of the field or the start of the next variable or text.
NULls
specifies that a field will be padded with the null character.
BLanks
specifies that a field will be padded with blanks.
char
specifies a single character to be used to pad a field.
NUMeric
specifies a field is numeric (unprotected field only).
CUrsor
specifies that the cursor is positioned at the beginning of this field. If multiple cursor fields are defined, then the last one defined contains the cursor. The cursor is placed in the top left corner if a cursor field is not defined.
MDT
(specified for SEND and CONVERSE only) sets the modify bit tag for all input fields on the panel.


rvse306.html | Timestamp icon Last updated: Monday, 5 June 2017