9. PROCESSING › 9.4 Parameter Panel Build and Control Logic › 9.4.1 Screen File Control Records

9.4.1 Screen File Control Records

Parameters used by the VM Data Transfer Program are set using
a series of screen panels, as outlined in Chapter 7.  These
panels are processed under the control of XEDIT profile
macros which are written in REXX.  Screen panels are defined
in special control files.  This section outlines the control
statements to be used in building the various panels used by
the parameter setting routines.

A screen definition file such as VMTACT contains a series of
control words used to define the screen display.  Each
control word begins in column 1 with a colon.

RELATED CONTROL WORDS AND PARAMETERS

:*             -  A comment

:SCREEN        -  Starts a screen
    token 1    -  Screen name, 0 indicates defaults screen
    token 2    -  Identification field
    token 3    -  Name of external support function for this
                  screen

:LINE          -  Defines a screen line of text
    token 1    -  Line number
    token 2-n  -  Line text (if column 72 contains an
                  asterisk the following line is appended to
                  this line)

:TEXTATTR      -  Attribute definition for whole lines
    token 1    -  Line number
    token 2-n  -  Attributes (for XEDIT SET RESERVED command)

:FIELD         -  Defines a variable (field) section of a
                  line
    token 1    -  Line number
    token 2    -  Column number (for text - not an attribute)
    token 3    -  Field name (REXX variable name)
    token 4    -  Field length
    token 5-n  -  Field display attributes

:PFK           -  Define PF key
    token 1    -  Key number
    token 2-n  -  Key text (usually action and parameters)
    token n+1  -  A ? and text for displaying what the key
                  does (as determined by :PFKLINE)

:PFKLINE       -  Define PFK line for screen (normally to use
                  bottom lines of screen to display actions
                  of PF keys)
    token 1    -  Line number
    token 2-n  -  Key numbers for line

:CURSOR        -  Define initial cursor position for screen
    token 1    -  Line number
    token 2    -  Column

:MENU          -  Correlate menu selection character to new
                  screen name.  Variable @Menu must be used
                  as an entry field.
    token 1    -  Selection character
    token 2    -  Screen name

There are certain restrictions on the ordering of control
lines, and on certain token values.  See the discussion of
@ScreenFormat, Section 9.4.2.1.1., for details on these
restrictions.

For all screen definition commands that specify a line
number, the line can be specified as one of the following:

nn             -  an absolute line number
m              -  mid-line of the screen
m+n            -  screen mid-line plus a number of
                  additional lines
m-n            -  screen mid-line minus a number of lines
+nn            -  a number of lines from the top of the
                  screen
-nn            -  a number of lines from the bottom of
                  the screen

For example, on a 24 line screen,

m = line 11
m+4 = line 15
m-3 = line 8
-5 = line 17
+6 = line 6
 6 = line 6