Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

7.25.1 DEF_LINE Parameters

ACROSS_SEP

DESIGN

FIELDS

FOR_REPORT

HEAD_COND

IDENTIFY

DOWN_SEP

NAME

SPACE_AFT

SPACE_BEF

TEXT


Anchor
NAME
NAME
NAME

Specifies the name that is to be assigned to the group of report print lines defined by this command. The name specified must be unique within the function.

Anchor
FIELDS
FIELDS
FIELDS

Specifies the field(s) that are to be printed on the report. An expandable group expression is allowed in this parameter.

Only RDML fields are supported.

Anchor
SPACE_BEF
SPACE_BEF
SPACE_BEF

Specifies the number of lines on the report that should be spaced before the detail line(s) are printed. The default value is 1 but any value in the range 0 to 100 can be specified.

Anchor
SPACE_AFT
SPACE_AFT
SPACE_AFT

Specifies the number of lines on the report that should be spaced after the detail line(s) are printed. The default value is 1 but any value in the range 0 to 100 can be specified.

Anchor
TEXT
TEXT
TEXT

Allows the specification of up to 50 "text strings" that are to appear on the screen panel or report. Each text string specified is restricted to a maximum length of 20 characters.

When a text string is specified it should be followed by a row/line number and a column/position number that indicates where it should appear on the screen panel or report.

For example:

...

   TEXT(('ACME' 6 2)('ENGINEERING' 7 2))

specifies 2 text strings to appear at line 6, position 2 and line 7, position 2 respectively.

...

The presence of a text map is indicated by a TEXT parameter that looks like this example:

...

   TEXT((*TMAPnnn 1 1))

where "nnn" is a unique number (within this function) that identifies the stored text map.

...

  • Never specify *TMAPnnn identifiers of your own or change *TMAPnnn identifiers to other values. Leave the assignment and management of *TMAPnnn identifiers to the screen and report design facilities.

  • When copying a command that has an *TMAPnnn identifier, remove the *TMAPnnn references (ie: the whole TEXT parameter) from the copied command. If you fail to do this, then the full function checker will detect the duplicated use of *TMAPnnn identifiers, and issue a fatal error message before any loss occurs.

  • Never remove an *TMAPnnn identifier from a command. If this is done then the associated text map may be deleted, or reused in another command, during a full function check or compilation. Loss of text details is likely to result.

  • Never "comment out" a command that contains a valid *TMAPnnn identifier. This is just another variation of the preceding warning and it runs the same risks of loss or reuse of text.

  • Never specify *TMAPnnn values in an Application Template. In the template context *TMAPnnn values have no meaning. Use the "text string" format in commands used in, and initially generated by, Application Templates.


Anchor
FOR_REPORT
FOR_REPORT
FOR_REPORT

Specifies the report with which this command should be associated. Up to 8 reports can be produced by a function at one time. Each report is identified by a number in the range 1 to 8. The default value for this report is report number 1.

Anchor
DESIGN
DESIGN
DESIGN

Specifies the design/positioning method which should be used for fields that do not have specific positioning attributes associated with them.*ACROSS, which is the default value for the DEF_LINE command, indicates that fields should be designed "across" the report line (ie: one after another).

*DOWN indicates that the fields should be designed "down" the report page (ie: one under another).

Anchor
IDENTIFY
IDENTIFY
IDENTIFY

Specifies the default identification method to be used for fields that do not have specific identification attributes associated with them.

...

*NOID indicates that no identification of the field is required. Only the field itself should be included into the report line(s).

Anchor
DOWN_SEP
DOWN_SEP
DOWN_SEP

Specifies the spacing between lines on the report that should be used when automatically designing a report. The value specified must be a number in the range 1 to 10. The default value for the DEF_LINE command is 5.

Anchor
ACROSS_SEP
ACROSS_SEP
ACROSS_SEP

Specifies the spacing between columns on the report that should be used when automatically designing a report. The value specified must be a number in the range 0 to 10. The default value for the DEF_BREAK command is 1.

Anchor
HEAD_COND
HEAD_COND
HEAD_COND

Optionally specifies the name of a condition that indicates whether any column heading line(s) associated with fields in this detail print line are to be printed in the header area of the report.*NONE, which is the default value, indicates that no controlling condition applies, and any column headings associated with this detail line should always be printed in the report header area, regardless of which detail line is actually being printed.

...