PANEL RUNTIME
The format of the PANEL RUNTIME commands is shown.
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)|((field_ids) attribute_values)
- (specified for SEND and CONVERSE only) dynamically sets attributes to override those specified
in the panel definition.
- field_id
- specifies the field whose attributes are dynamically set. It must be a variable name associated with the field. If you specify a list of fields, they must be enclosed with parentheses.
- attribute_values
- specifies the attributes to set. Only the stated attributes are changed; other attributes
default to what was statically defined. For example, if BLUE is specified for a field that was
originally defined as RED and UNDERLINE, that field becomes BLUE and UNDERLINE.
For the list of attributes, see Attributes.
- 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).To avoid unexpected results, such as changing attributes in the underlying panel while displaying this second panel, or the display of characters from the underlying panel in the second panel, use the following guidelines:
- If you use variables in the second panel, position the panel in a blank area of the underlying panel.
- Position the second panel so that it ends at the right boundary of the screen, or it is followed by only blank columns of the underlying panel.
- 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.
Attributes
- 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. An 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:
- 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.
- 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.
For input, leading and trailing blanks and leading and trailing pad characters are not stripped.
For output, leading and trailing blanks and leading and trailing pad characters are not stripped. Data is truncated on the right, if necessary. Truncation does not cause a break in execution, but results in a Return Code of 4 and Reason Code of 117. Pad characters replace null positions to the right of the variable data.
- LEft
- specifies that the field is left justified.
For input, leading and trailing blanks and leading and trailing pad characters are stripped.
For output, leading blanks are stripped, and nulls to the right of the variable data are replaced by pad characters. After leading blanks are stripped, data is truncated on the right, if necessary. Truncation does not cause a break in execution, but results in a Return Code of 4 and Reason Code of 117.
- RIght
- specifies that the field is right justified.
For input, leading and trailing blanks and leading and trailing pad characters are stripped.
For output, trailing blanks are stripped, and nulls to the left of the variable data are replaced by pad characters. After trailing blanks are stripped, data is truncated on the left, if necessary. Truncation does not cause a break in execution, but results in a Return Code of 4 and Reason Code of 117. For output, pad characters replace null and blank positions to the left of the variable data.
- 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.