Previous Topic: Rules for Processing Each Data Record (When Adding or Changing)Next Topic: Rules for Processing Each Data Record (When Adding or Changing)


RPTDEF Control Statement

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
Keyword

Description

Default Length

Required

ARCH

Archival criteria number

The data value must be numeric and from
0–99.

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
0–255.

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
0–255.

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
0–255.

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
0–255.

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,
NDISTID, WRITER, or DAYS
is specified.

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
0–255.

 

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
0–32766.

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
0–255 or "*". A zero value or "*" indicates that each line of the report page, up to 255 lines, 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.

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
NE or ^= not equal to
LT or < less than
GT or > greater than
LE or <= less than or equal to
GE or >= greater than or 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
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

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
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

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

More information:

Using Combinations of the DENTNO, DRELNO, DISTID, and ODISTID Parameters

Using the IENTNO Parameter

Using the TENTNO Parameter