ASURXRPT external function
The ASURXRPT external function performs a variety of reporting tasks, as follows:
- Initialization
- Formatting
- Writing
- Page eject
- Termination
The following table describes ASURXRPT functionality:
ASURXRPT external function
Function | Example | Description |
|---|---|---|
init | rc = asurxrpt('init 30 suppress format1 format2 format3 . . .'); | After init, you can optionally specify the number of lines per page. The default is 66. Suppress is optional and prevents printing a column value when the value does not change from one row to the next. The last items in the argument string are the names of the stems that contain the format definitions. You can specify any number of formats. |
write | rc = asurxrpt('write format1 '); | Format and write a detail line to SYSPRINT. The second item in the argument string is the name of the stem that contains the format definition. |
eject | rc = asurxrpt('eject'); | Force a new top-of-page. The top-of-page format is not written until the next 'write' command is issued. Use this feature to change the report title at a variable control break. |
term | rc = asurxrpt('term'); | Release resources obtained during initialization and writing. |
ASURXRPT produces the return codes that the following table shows:
ASURXRPT return codes
Return codes | Description |
|---|---|
0 | Successful completion |
40 | Syntax error in report format definition |
41 | Error obtaining a REXX variable |
44 | General error; see message in RPTERRM |
48 | Error loading module IRXEXCOM |
When ASURXRPT fails, the variable RPTCODE is set, and the variable RPTERRM contains a printable diagnostic message.
Related topic