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 |
Description |
Default Length |
Required |
|
|---|---|---|---|---|
|
An |
Address line n, where n has a value from |
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 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, |
|
|
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 |
|
|
Copyright © 2013 CA.
All rights reserved.
|
|