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


DISTDEF Control Statement

The DISTDEF control statement is used to add, change, delete, and rename distribution definitions. The parameters and their meanings and defaults are presented in the following table:

DISTDEF
Keyword

Description

Default Length

Required

An

Address line n, where n has a value from
1–9

72

No

CLASS

SYSOUT class

1

No

CONNECT

Indicates whether output is being sent to CA Connect destination.

The data values are Y, N, and blank. The default is N.

1

No

DESC

Description for distribution list

40

No

DEST

Destination for printing reports

17

No

DISTID

Distribution identifier

32

Yes

EFORMAT

Email format name

8

No

EMAIL

Email address for DISTID

60

No

FUNCTION

Processing function

The data values are:

2

No

 

Blank

Adds or changes distribution definitions; this is the default

 

 

 

D

Deletes the distribution definition; only the DISTID parameter is used

 

 

 

DL

Deletes all distribution specifications, a series of distribution entries, or an individual distribution entry

See the topic Using Combinations of LENTNO, LRELNO, LDISTID, and LODISTID Parameters later in this section.

 

 

 

R

Renames the distribution definition; only the ODISTID and DISTID parameters are used, and specifies the original and new distribution identifiers

 

 

 

SL

Sorts distribution specifications for the distribution list 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.

 

 

 

U

Updates the distribution identifier or distribution list

 

 

LDAYS

Distribution List distribution days for distribution identifier

Specify LDISTID 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 LDAYS 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

LDEL

Deletion indicator for distribution identifier in distribution list

The data values are Y, N, and blank.

1

No

LDEST

Destination of printed reports for distribution identifier in distribution list

The parameters LDISTID, LDEST, LGROUP, LNDISTID, LWRITER, and LDAYS are used together to add a single distribution specification to the distribution list.

If LGROUP is omitted or the data record contains a blank value for LGROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group.

If LGROUP is specified and the data record contains a nonblank value for LGROUP, then the distribution identifier is added to the end of the last group.

If the data record contains a blank value for LDISTID, no distribution specification is added for the record.

LDEST is only added to the definition, if specified, for the first distribution identifier for a group.

17

No

LDISTID

Distribution identifier to be added to a distribution list

To create a distribution list, specify the LDISTID field.

The parameters LDISTID, LDEST, LGROUP, LNDISTID, LWRITER, and LDAYS are used together to add a single distribution specification to the distribution list.

If LGROUP is omitted or the data record contains a blank value for LGROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group.

If LGROUP is specified and the data record contains a nonblank value for LGROUP, then the distribution identifier is added to the end of the last group.

If the data record contains a blank value for LDISTID, no distribution specification is added for the record.

LDEST is only added to the definition, if specified, for the first distribution identifier for a group.

See the topic Using Combinations of LENTNO, LRELNO, LDISTID, and LODISTID Parameters later in this section.

32

Yes,
if LDEL, LDEST, LGROUP,
LNDISTID, LWRITER, or LDAYS
is specified.

LENTNO

Distribution identifier entry number in distribution list

The data value identifies the distribution entry by number that is to be updated (function U), deleted (function DL), 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.

See the topic Using Combinations of LENTNO, LRELNO, LDISTID, and LODISTID Parameters later in this section.

3

No

LGROUP

Grouping indicator for distribution identifier in distribution list

The parameters LDISTID, LDEST, LGROUP, LNDISTID, LWRITER, LDAYS are used together to add a single distribution specification to the distribution list.

If LGROUP is omitted or the data record is blank for LGROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group.

If LGROUP is specified and the data record contains a nonblank value for LGROUP, then the distribution identifier is added to the end of the last group.

If the data record is blank for LDISTID, no distribution specification is added.

1

No

LNDISTID

Number of copies of the report to be produced for distribution identifier in distribution list

The parameters LDISTID, LDEST, LGROUP, LNDISTID, and LWRITER are used together to add a single distribution specification to the distribution list.

If LGROUP is omitted or the data record contains a blank value for LGROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group.

If LGROUP is specified and the data record contains a nonblank value for LGROUP, then the distribution identifier is added to the end of the last group. If the data record contains a blank value for LDISTID, no distribution specification is added for the record.

3

No

LODISTID

Original distribution identifier in distribution list

Identifies the distribution identifier in the distribution that is to be updated (function U), deleted (function DL), or after which an entry is to be inserted (function blank).

See the topic Using Combinations of LENTNO, LRELNO, LDISTID, and LODISTID Parameters later in this section.

32

No

LOUT

Output indicator for distribution identifier in distribution list

Specify LDISTID with this parameter.

The data values are T (tracking), Y, N, E (Email), and blank.

1

No

LREPRT

Reprint indicator for distribution identifier in distribution list

The data values are Y, N, and blank.

1

No

LRELNO

Distribution identifier relative entry number in distribution list

The data value identifies the relative occurrence of the distribution identifier (LODISTID or LDISTID data value) that is to be updated (function U), deleted (function DL), 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.

See the topic Using Combinations of LENTNO, LRELNO, LDISTID, and LODISTID Parameters later in this section.

3

No

 

LRVIEW

View restriction indicator for distribution identifier in distribution list

The data values are Y, N, and blank.

1

No

LWRITER

External writer name of printed reports for distribution identifier in distribution list

The parameters LDISTID, LDEST, LGROUP, LNDISTID, LWRITER, and LDAYS are used together to add a single distribution specification to the distribution list.

If LGROUP is omitted or the data record is blank for LGROUP, then the distribution identifier is added to the end of the distribution specifications as a new, single-identifier group.

If LGROUP is specified and the data record contains a nonblank value for LGROUP, then the distribution identifier is added to the end of the last group.

If the data record is blank for LDISTID, no distribution specification is added for the record.

8

No

ODISTID

Original distribution identifier for Rename function

32

Yes, for the Rename function

WEBSVR

Web Server NUMBER (1-4) for DISTID

1

No

WRITER

External writer name

8

No