This document covers the following topics:
Add a member to an existing distribution list.
You can specify the following in the parameter Member: a Con-nect user, a bulletin board, a cabinet, another distribution list or an external node (for example, a Telex or SNADS node). You can also specify a nickname for any type of member listed before.
When you add a user, you can either specify the user's last name or user ID in the parameter Member.
The parameter Mail-type indicates whether the member of the distribution list is to receive an original, a copy, a blindcopy or private mail.
When you add a member to a distribution list, the following rules apply:
the member must not contain a shared cabinet;
the member must not contain other distribution lists;
the distribution list must not be a member of another list;
when you add a distribution list to another distribution list, the member must be from your own cabinet;
a distribution list cannot be a member of itself;
you cannot add a member to a distribution list of a shared cabinet.
Note:
You can use Z-ADD10 to create
a distribution list.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | The cabinet in which the distribution list is stored. | |
| Password | A8 | R | The password of the above cabinet. | |
| Distribution-name | A12 | R | The name of the distribution list to which you want to add the member. | |
| Member | A20 | R | The name of the member to be added. See the description above. | |
| Mail-type | A1 | R | O=original, C=copy, B=blindcopy, P=private mail. Default: O. | |
| Member-ISN | P8 | X | The ISN of the new member. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 30 | Distribution list name invalid |
| 32 | Member (address) could not be found |
| 51 | Invalid name |
| 53 | Requested object does not exist |
| 90 | Member not added - contains a shared cabinet |
| 91 | Member not added - contains other distribution lists |
| 92 | Member not added - list is a member of another list |
| 93 | Member not added - it is already part of this list |
| 94 | Member not added - member must be from your own cabinet |
| 95 | Member not added - incorrect member type encountered |
| 96 | Address is not unique |
| 97 | A distribution list cannot be a member of itself |
| 98 | Member not added - error in parameter list |
| 99 | Member cannot be added to shared cabinet distribution lists |
Z-120
Z-122
Z-123
Z-147
Z-175
Z-198
Z-1200&0
0010 DEFINE DATA 0020 LOCAL 0030 1 RETURN-CODE (N2) 0040 1 CABINET (A8) 0050 1 PASSWORD (A8) 0060 1 DISTRIBUTION-NAME (A12) 0070 1 MEMBER (A20) 0080 1 MAIL-TYPE (A1) /* O,C,B,P 0090 1 MEMBER-ISN (P8) 0100 END-DEFINE 0110 * 0120 MOVE 'CABINET' TO CABINET 0130 MOVE 'PASSWORD' TO PASSWORD 0140 MOVE 'DISTR-1' TO DISTRIBUTION-NAME 0150 MOVE 'MEMBER' TO MEMBER 0160 MOVE 'B' TO MAIL-TYPE 0170 * 0180 CALLNAT 'Z-ADD17' RETURN-CODE CABINET PASSWORD 0190 DISTRIBUTION-NAME MEMBER MAIL-TYPE MEMBER-ISN 0200 * 0210 IF RETURN-CODE EQ 0 0220 WRITE 'MEMBER WAS ADDED TO DISTRIBUTION LIST' 0230 ELSE 0240 WRITE 'RETURN CODE' RETURN-CODE 0250 END-IF 0260 * 0270 END