Character-based Querying and Reporting Tools User Guide > Character-based Querying and Reporting Tools User Guide > Report-Writer Statements > Report Setup Statements > .Name Statement--Assign a Name to a Report
Was this helpful?
.Name Statement--Assign a Name to a Report
The .name statement assigns a name to a report.
The .name statement has the following format:
.name | .nam reportname
The parameter for the .name statement is as follows:
reportname
The name of a report to which the next set of formatting statements apply. The reportname is a standard object which must comply with object naming rules. See Naming and Name Use Conventions on page 21 or Object Naming Conventions for ANSI/ISO Entry SQL-92 Compliant Databases on page 2.
Description
The .name statement is required and must be the first statement specified for a report. The program sreport stores the report in the database under the report name rather than the file name of the file containing the report specification statements.
Specifications for several reports can be stored in one text file by using several .name statements. Each occurrence of a .name statement signals the end of the previous report's specification statements and the beginning of a new report. You can then save the reports in the database by using sreport.
When executing a report directly by using the ‑i flag with the report command, you must have exactly one .name statement specifying one report only. The .name statement cannot appear in a file specified by an .include statement.
Examples
1. Denote the start of the report, abc:
.name abc
2. Denote the start of report, my_rep:
.name my_rep
Last modified date: 11/28/2023