The RPTDEF control statement is used to add or change report definition attributes. The parameters and their meanings and defaults are presented in the following table:
|
RPTDEF |
Description |
Default Length |
Required |
|||||
|---|---|---|---|---|---|---|---|---|
|
ARCH |
Archival criteria number The data value must be numeric and from |
2 |
No |
|||||
|
ARCHID |
Archival Report identifier |
32 |
No |
|||||
|
BANNER |
Model banner page name |
8 |
No |
|||||
|
BURST |
Burst indicator for IBM 3800 printing. The data values are Y, N, and blank. |
1 |
No |
|||||
|
CC |
Carriage control identifier |
1 |
No |
|||||
|
CCOL |
Control break column number The data value must be numeric and from A zero or blank value for CCOL, CLEN, or CLINE field indicates that the value is not to be changed. Provide values for all three control break fields for a newly created control report. |
3 |
No |
|||||
|
CHARn |
Character arrangement table name n, where n is a value from 1–4 |
4 |
No |
|||||
|
CLASS |
SYSOUT class |
1 |
No |
|||||
|
CLEN |
Control break field length The data value must be numeric and from A zero or blank value for CCOL, CLEN, or CLINE field indicates that the value is not to be changed. Provide values for all three control break fields for a newly created control report. |
3 |
No |
|||||
|
CLINE |
Control break line number The data value must be numeric and from A zero or blank value for CCOL, CLEN, or CLINE field indicates that the value is not to be changed. Provide values for all three control break fields for a newly created control report. |
3 |
No |
|||||
|
CNORM |
Control break normalization indicator This indicator determines whether to ignore leading blanks in the control break data. The data values are Y, N, and blank. |
3 |
No |
|||||
|
COPIES |
Copies indicator The data values are Y, N, and blank. |
1 |
No |
|||||
|
COPYGn |
IBM 3800 copy group n, where n is a value from 1–8 The data value must be numeric and from |
3 |
No |
|||||
|
CSEP |
Control break separator banner page name |
8 |
No |
|||||
|
DAYS |
Report distribution days for distribution identifier Specify DISTID with this parameter. This field identifies the days of the week from Monday to Sunday that output is to be produced for the distid. A "Y" or "N" can be specified for each of these days to indicate whether output is to be produced. The default for the DAYS field is "YYYYYYY". By default, the day that a report is processed by CA Deliver is based on the date and time that the job was submitted and the setting of the BEGINDAY initialization parameter. If the time that the job is submitted is less than the BEGINDAY initialization parameter specification, the day is considered part of the previous day's cycle. |
7 |
No |
|||||
|
DEL |
Deletion indicator The data values are Y, N, and blank. |
1 |
No |
|||||
|
DENTNO |
Distribution identifier entry number The data value identifies the distribution entry by number that is to be updated (function U), deleted (function DD), or to locate where the entry is to be inserted (function blank). The data value must be from 0–32767. To specify a larger default length (3), override the field length using the statement. If you use DENTNO to delete a REPT type distribution entry, both the REPT and all associated DIST entries are deleted. |
3 |
No |
|||||
|
DESC |
Report description |
40 |
No |
|||||
|
DEST |
Destination for printed reports The parameters DISTID, DEST, GROUP, NDISTID, WRITER, and DAYS are used together to add a single distribution specification to the report definition. If GROUP is omitted or the data record contains a blank value for GROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group. If GROUP is specified and the data record contains a nonblank value for GROUP, then the distribution identifier is added to the end of the last group. If the data record contains a blank value for DISTID, no distribution specification is added for the record. DEST is only added to the definition, if specified, for the first distribution identifier for a group. |
17 |
No |
|||||
|
DISTID |
Distribution identifier to be added to the definition The parameters DISTID, DEST, GROUP, NDISTID, WRITER, and DAYS are used together to add a single distribution specification to the report definition. If GROUP is omitted or the data record contains a blank value for GROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group. If GROUP is specified and the data record contains a nonblank value for GROUP, then the distribution identifier is added to the end of the last group. If the data record contains a blank value for DISTID, no distribution specification is added for the record. DEST is only added to the definition, if specified, for the first distribution identifier for a group. If DTYPE is specified and the data record contains a value of 'R', then the DISTID represents the dynamic report id. If DTYPE is specified and the data record contains a value of 'D', then the DISTID represents the dynamic distribution id. |
32 |
Yes, if DEL, DEST, DTYPE, GROUP, |
|||||
|
DRELNO |
Distribution identifier relative entry number The data value identifies the relative occurrence of the distribution identifier (ODISTID or DISTID data value) that is to be updated (function U), deleted (function DD), or after which an entry is to be inserted (function blank). The data value must be from 0–32767. To specify a larger default length (3), override the field length using the statement. If you use DRELNO to delete a REPT type distribution entry, both the REPT and all associated DIST entries are deleted. |
3 |
No |
|||||
|
DTYPE |
Distribution identifier type for dynamic report |
1 |
No |
|||||
|
|
Specify DISTID with this parameter. |
|
||||||
|
|
The data values are: |
|
||||||
|
|
Blank |
For non-dynamic reports |
|
|||||
|
|
R |
Identifies the distribution identifier as a dynamic report name |
|
|||||
|
|
D |
Indicates the distribution identifier as a dynamic distribution name |
|
|||||
|
|
After a distribution identifier is defined with a DTYPE of R or D it cannot be updated (U) to another DTYPE value. Use a delete (DD) and add function instead of an update (U) when the wrong DTYPE is specified. If DTYPE=R is specified during a delete (DD), only dynamic report ids that match the DISTID are deleted. If DTYPE=D is specified during a delete (DD), only dynamic distribution names that match the DISTID are deleted. If you use DTYPE of R to delete a REPT type distribution entry, both the REPT and all associated DIST entries are deleted. If you use DTYPE of D to delete a DIST entry, and it is the only DIST entry defined to the associated REPT entry, both the DIST and REPT entries are deleted. |
|
||||||
|
FCB |
Forms control image name |
4 |
No |
|||||
|
FLASH |
IBM 3800 forms flash overlay name |
4 |
Yes, if FLASHCT is specified |
|||||
|
FLASHCT
|
IBM 3800 forms flash count Data values must be numeric and from
|
3
|
No
|
|||||
|
|
||||||||
|
FORM |
Special forms name |
8 |
No |
|||||
|
FORMDEF |
Form definition name for the IBM 3800 printing subsystem |
6 |
No |
|||||
|
FUNCTION |
Processing function The data values are as follows: |
2 |
No |
|||||
|
DD |
Deletes all distribution specifications, a series of distribution entries, or an individual distribution entry. For more information about processing function, see the topic Using Combinations of DENTNO, DRELNO, DISTID, DTYPE, and ODISTID Parameters later in this section. |
|||||||
|
DI |
Deletes all special instructions or an individual special instruction entry See the topic Using the IENTNO Parameter later in this section. |
|||||||
|
DT |
Deletes all text specifications or an individual text specification entry. |
|||||||
|
DV |
Deletes all variable specifications or an individual variable entry. Variable specification entries that are currently defined within a dynamic report’s distribution specification cannot be deleted. |
|||||||
|
D |
Deletes the report definition and all references to it; only the RID parameter is used. |
|||||||
|
R |
Renames the report definition (only the ORID and RID parameters are used), and specifies the original and new report identifiers, respectively |
|||||||
|
SD |
Sorts distribution specifications for the report in ascending sequence If distribution identifiers are grouped, the group is sorted first and then merged into the list based on the first distribution identifier in the group. |
|||||||
|
SV |
Sorts variable specifications for the report in ascending sequence. |
|||||||
|
U |
Updates the report definition, report distribution data, report text, or report special instruction. |
|||||||
|
Blank |
Adds or changes report definitions; this is the default |
|||||||
|
GROUP |
Grouping indicator for distribution identifier The parameters DISTID, DEST, GROUP, NDISTID, WRITER, and DAYS are used together to add a single distribution specification to the report definition. If GROUP is omitted or the data record is blank for GROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group. If GROUP is specified and the data record contains a nonblank value for GROUP, then the distribution identifier is added to the end of the last group. If the data record is blank for DISTID, no distribution specification is added for the record. |
1 |
No |
|||||
|
GROUPID |
Name of the output group to be used when the report is printed. If an archival copy of the report is sent to a View FSS collector, this name identifies the member name in the SARINDEX data set which contains archive control statements for the report. |
8 |
No |
|||||
|
IENTNO |
Special instruction entry number The data value identifies the special instruction entry by number that is to be updated (function U), deleted (function DI), or to locate where the entry is to be inserted (function blank). The data value must be from 0–32766. |
3 |
No |
|||||
|
INST |
Special instruction line to be added The INST parameter is used to add one instruction line to the end of instructions for the report definition. If the data record is blank for INST, no instruction line is added for the record. Any trailing blanks in the data value are truncated from the instruction line. To retain trailing blanks, enclose the instruction line within single quotation marks within the data record. A single quotation mark within the instruction line must be coded as one single quotation mark. Do not duplicate single quotation marks. |
75 |
No |
|||||
|
LATE |
Late time based on a 24-hour clock in a hh:mm format (for example, 14:20) |
5 |
No |
|||||
|
MODIFY |
Copy modification module name |
4 |
Yes, if TRC is specified |
|||||
|
NDISTID |
Number of copies of the report to be produced for the distribution identifier The parameters DISTID, DEST, GROUP, NDISTID, WRITER, and DAYS are used together to add a single distribution specification to the report definition. If GROUP is omitted or the data record contains a blank value for GROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group. If GROUP is specified and the data record contains a nonblank value for GROUP, then the distribution identifier is added to the end of the last group. If the data record contains a blank value for DISTID, no distribution specification is added for the record. |
3 |
No |
|||||
|
ODISTID |
Original distribution identifier Identifies the distribution identifier that is to be updated (function U), deleted (function DD), or after which an entry is to be inserted (function blank). |
32 |
No |
|||||
|
OPTCDJ |
OPTCD=J indicator for 3800 printing The data values are Y, N, and blank. |
1 |
No |
|||||
|
ORID |
Original report identifier for the Rename function |
32 |
Yes, for the Rename function |
|||||
|
OUT |
CA View output indicator Specify DISTID with this parameter. The data values are T (tracking), Y, N, E (Email), and blank. |
1 |
No |
|||||
|
PAGEDEF |
Page definition name for the IBM 3800 printing subsystem |
6 |
No |
|||||
|
PRMODE |
Process mode required to print a SYSOUT data set Specify LINE, PAGE, or a valid mode printer defined specifically for your site. |
8 |
No |
|||||
|
PRSET |
Printer setup name |
8 |
No |
|||||
|
PRTY |
Priority at which a SYSOUT data set enters the output queue Specify a decimal value from 1 (lowest priority) to 255 (highest priority) or a space or 0. If a space or 0 is entered, it is treated as a null and nullifies any existing PRTY value. |
3 |
No |
|||||
|
REPRT |
Reprint indicator The data values are Y, N, and blank. |
1 |
No |
|||||
|
RID |
Report identifier |
32 |
Yes |
|||||
|
RVGE5 |
View restriction indicator The data values are Y, N, and blank. The parameter is the same as RVIEW but retained for compatible with older releases. |
1 |
No |
|||||
|
RVIEW |
View restriction indicator The data values are Y, N, and blank. |
1 |
No |
|||||
|
TENTNO |
Number that identifies the identification text entry by the number to be updated (function U), deleted (function DT), or to locate where the entry is to be inserted (function blank) Data values must be in the range |
3 |
No |
|||||
|
TEXT |
Report identification text The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. If the data record contains a blank value for TEXT or a blank value for TEXTLINE, then no identification text specification is added for the record. Any trailing blanks in the data value for TEXT are truncated. To retain trailing blanks, enclose the identification text within single quotation marks within the data record. Leading blanks are retained if they are enclosed in single quotation marks on the input record. A single quotation mark within the identification text must be coded as one single quotation mark. Do not duplicate single quotation marks—the text is always entered "as is"; it is not translated to uppercase. |
53 |
Yes, if either TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, or TEXTTYPE is specified |
|||||
|
TEXTCOL |
Column number on report page to look for report identification text The data values must be in the range 0–32760 or "*". A zero value or "*" indicates that the entire report line is to be scanned for the report identification text. The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. If the data record contains a blank value for TEXT, then no identification text specification is added for the record. To specify a larger default length (3) for TEXTCOL, override the field length using the statement. |
3 |
No |
|||||
|
TEXTLINE |
Line number on report page to look for report identification text The data value must be in the range The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. If the data record contains a blank value for TEXT, then no identification text specification is added for the record. |
3 |
Yes, if TEXT or TEXTCOL is specified |
|||||
|
TEXTECOL |
Ending Column number on report page to look for report identification text The data values must be in the range of a space or 0-32760. A zero and space indicate that the parameter is not used. The data value must not be less than the specified TEXTCOL value. The TEXTCOL to TEXTECOL range must also be large enough to contain the Report identification text value specified in the TEXT parameter. The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. If the data record contains a blank value for TEXT, then no identification text specification is added for the record. To specify a larger default length (3) for TEXTECOL, override the field length using the statement. |
3 |
No |
|||||
|
TEXTELIN |
Ending Line number on report page to look for report identification text The data values must be in the range of a space or 0-255. A zero and space indicate that the parameter is not used. The value must not be less than the specified TEXTLINE value. The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. If the data record contains a blank value for TEXT, then no identification text specification is added for the record. |
3 |
No |
|||||
|
TEXTOP |
Text comparison operator Text in the report is compared to the text in the database. Specify one of the following values: EQ, blank = equal to The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. |
2 |
No |
|||||
|
TEXTREUS |
Segment reusability indicator The data values are Y, N, and blank. The parameters TEXT, TEXTCOL, TEXTLINE, TEXTECOL, TEXTELIN, TEXTOP, TEXTREUS, and TEXTTYPE are used together to add a single report identification text entry to the end of the specifications for the report definition. |
1 |
No |
|||||
|
TEXTTYPE |
Type of text entry Specify one of the following values: |
1 |
No |
|||||
|
|
A, & |
Continuation test using "and" logic |
|
|
||||
|
|
B |
Beginning test on overlapping segment |
|
|
||||
|
|
E |
Ending test on overlapping segment |
|
|
||||
|
|
O, | |
Continuation test using "or" logic at the segment level |
|
|
||||
|
|
P |
Tests for selecting a page overlapping segment |
|
|
||||
|
|
R |
Continuation test using "or" logic for previous statement |
|
|
||||
|
|
X |
Beginning test on exclusive segment |
|
|
||||
|
|
Blank |
Treat as X for first entry and A for entries other than first |
|
|
||||
|
TRC |
IBM 3800 copy modification table reference character |
1 |
No |
|||||
|
UCS |
Universal character set name |
4 |
No |
|||||
|
USCOLn |
Control break column number of user field number n, where n equals 1–9 Data values must be numeric and from A blank value for the USCOLn, USLENn, or USLINEn field indicates that the value is not to be changed. Provide values for all three related user fields when initially setting their values. To remove their values, specify a zero value for all three related user fields. |
3 |
No |
|||||
|
USLENn |
Control break field length of user field number n, where n equals a value from 1–9 Data values must be numeric, and from A blank value for the USCOLn, USLENn, or USLINEn field indicates that the value is not to be changed. Provide values for all three related user fields when initially setting their values. To remove their values, specify a zero value for all three related user fields. |
3 |
No |
|||||
|
USLINEn |
Control break line number of user field number n, where n is a value of 1–9 Data values must be numeric and from 0–255. A blank value for the USCOLn, USLENn, or USLINEn field indicates that the value is not to be changed. Provide values for all three related user fields when initially setting their values. To remove their values, specify a zero value for all three related user fields. |
3 |
No |
|||||
|
VENTNO |
Number that identifies the variable specification entry by the number to be updated (function U), deleted (function DV), or to locate where the entry is to be inserted (function blank) Data values must be in the range 0–32766. |
3 |
No |
|||||
|
VARNAME |
Name used to uniquely identify the variable for this report location. The field consists of 1-8 alphanumeric (A-Z, 0-9) or national (@, #, $) characters. The first character must be alphabetic or national |
8 |
Yes, if either VARCOL, VARLINE,, or VARLEN Is specified |
|||||
|
VARCOL |
Column number on the page where variable data is to be extracted The data values must be in the range 0–32760. A zero and space indicate that the parameter is not used. The parameters VARNAME, VARCOL, VARLINE and VARLEN are used together to add a single variable specification. Default: 1 To specify a larger default length (3) for VARCOL, override the length parameter in VARCOL=(column,length) |
3 |
No |
|||||
|
VARLINE |
Line number on the page where variable data is to be extracted The data value must be in the range 0–255. A zero and space indicate that the parameter is not used. The parameters VARNAME, VARCOL, VARLINE and VARLEN are used together to add a single variable specification. Default: 1 |
3 |
No |
|||||
|
VARLEN |
Length of the variable data The data values must be in the range of a space or 0-32. A zero and space indicate that the parameter is not used. The parameters VARNAME, VARCOL, VARLINE and VARLEN are used together to add a single variable specification. Default: 1 If VARCOL + VARLEN exceed 32760, VARLEN is adjusted to correct value automatically. To specify a larger default length (3) for VARLEN, override the length parameter in VARCOL=(column,length). |
3 |
No |
|||||
|
WRITER |
External writer name for printed reports or Email format override for email reports The parameters DISTID, DEST, GROUP, NDISTID, WRITER, and DAYS are used together to add a single distribution specification to the report definition. If GROUP is omitted or the data record is blank for GROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group. If GROUP is specified and the data record contains a nonblank value for GROUP, then the distribution identifier is added to the end of the last group. If the data record is blank for DISTID, no distribution specification is added for the record. |
8 |
No |
|||||
|
Copyright © 2013 CA.
All rights reserved.
|
|