ALTER-REPORT

Syntax

ALTER-REPORT  [HEADING={heading_name_txt_lit|_var|_col}]  [HEADING-SIZE={heading_size_int_lit|_var|_col}]  [FOOTING={footing_name_txt_lit|_var|_col}]  [FOOTING-SIZE={heading_size_int_lit|_var|_col}]

Description

Alters some of the report-specific functionality.

This command enables you to dynamically change the heading or footing sections that are active for the current report. You can also change how much space the heading or footing sections occupy.

If the HEADING or FOOTING value is set to NONE, the section is disabled for the current report.

If the HEADING or FOOTING value is set to DEFAULT, the section reverts to the setting that was in effect when the report was initiated.

If no HEADING or FOOTING value is set, the HEADING-SIZE or FOOTING-SIZE values affect the HEADING/FOOTING currently being used.

If the ALTER-REPORT command was not invoked from within a BEGIN-HEADING or BEGIN-FOOTING section and the page has not been written to, the assignment takes effect immediately; otherwise, it takes effect for the next page.

Parameters

Parameter	Description
HEADING	Specifies the name of the BEGIN-HEADING section to use.
HEADING-SIZE	Specifies the amount of space the BEGIN-HEADING section occupies on the page.
FOOTING	Specifies the name of the BEGIN-FOOTING section to use.
FOOTING-SIZE	Specifies the amount of space the BEGIN-FOOTING section occupies on the page

Example

The following example illustrates the ALTER-REPORT command:

begin-footing 2 name=confidental
  print 'Company Confidential' (1,1,0) center
  page-number (2,37,0)
end-footing

begin-footing 2       name=proprietary
  print 'Company Proprietary' (1,1,0) center
  page-number (2,37,0)
end-footing

begin-report
 alter-report 
   footing = 'Proprietary'
   footing-size = 6                     ! Increase depth

.
.
.
end-report

See The BEGIN-FOOTING and BEGIN-HEADING commands in this section.