The syntax for this command is as follows:
GENERATEREP {nn} <requestor ID> [<cmd option>]
GENERATEREP {nn} ALL [- <report 1> [,<report 2> ....]] [\<requestor ID>] [<cmd option>]
GENERATEREP {nn} + <report 1> [,<report 2> ....] [\<requestor ID>] [<cmd option>]This command can be used to
Force the generate of a report from system {nn} by using <requestor ID> to specify which report to generate.
Force the generate of ALL reports belonging to system {nn}, with the option of excluding some reports.
Force the generate if some reports from system {nn}.
The GENERATEREP command queues a report generate for a start time of now.
Notes:
The client does not participate in these generates.
It is not recommended that the GENERATEREP command be used in production.
Parts of the command syntax:
{nn} – This is the index associated with the system. Use the INDEX command to get the appropriate index for the system.
<requestor ID> – This is the identifier from a report generate session.
<report 1>, <report 2> – These are report names.
<cmd option> – This is an optional command qualifier which is used to direct the report build to behave differently. Choose from one of the following:
# – Report code files are retained, instead of removed.
@ – Produce a compiler listing for each of the reports included in the build. Each listing contains expanded INCLUDE files. The output appears in the *BD directory for the BLD (NGEN28SYS/BLD) job number.
& – Produce an analysis of the report(s) being built. The output appears in the file called <system>/REPORT/ANALYSIS/<BLD mix#> on <dictionary pack>.
$ – For each report included in the build, activate code to produce method call statistics for the report's execution. When a report is executed, the output appears in a CSV file called <system>/<report>/TIMINGS/<report mix#>.
* – For each report included in the build, activate code to produce COBOL85 compiler Statistics for the report's execution. When a report is executed, the output appears under the *BD directory or the NGENBD backup directory for the report’s mix number. A special version of NGEN28/ENVIRONMENT – NGEN28/ENVIRONMENT_STATS – must be installed in the Runtime before the report build starts. Contact the Engineering support to obtain a copy of the report.
Use the <requestor ID> with the GENERATEREP command to recover a partially completed report generate. This variant of the GENERATEREP command can only be used if some report generates failed during the last generate session. Use the REPORTS {nn} command to view the status of reports for system {nn}. For those reports still being generated, the information includes the current requestor ID. You can also browse the generate log for system {nn} to determine the requestor ID for reports (Refer to SHOWLOG command).
Use the ALL argument with the GENERATEREP command to generate all reports in the system. You might exclude some reports by using the minus (-) sign and listing the reports to be excluded, separated by a comma (,). The report generate starts from the FTP complete stage.
Use + argument with the GENERATEREP command to list a few reports to generate.
Use the \<requestor ID> qualifier with the ALL or the + argument to associate the correct ../REPINFO/<requestor ID> file with the next generate. Currently, this is only necessary if the previous report generate included new or changed signatures on segment methods. If a subsequent system generate has occurred, this qualifier is not required. The format of <requestor ID> is nnnnnnn. The report generate starts from the FTP complete stage.
Use the # qualifier at the end of any of the GENERATEREP command variations to indicate that you want to retain the ./REP_CODE/. report COBOL85 code files, instead of allowing them to be deleted, before the reports are compiled. By default, the ./ REP_CODE/. report COBOL85 code files for the report(s) are removed before compilation to force full report and stub compile(s). If they are retained, report compiles for the COBOL85 report and ALGOL stub depends on timestamp checks between the COBOL85 WORK source and the ./REP_CODE/. file.
Refer to REPORTS, ADDREP, ADDSYS and SHOWLOG commands for more information.
Only one system or report request can be manually generated at a time.