This document covers the following topics:
Add a member to an existing distribution list.
This subprogram is similar to Z-ADD17 with the exception that you can also specify the object type and object ISN.
You must either specify the parameters Object-name and Object-type or only the parameter Object-ISN. If the parameter Object-name is unique, parameter Object-type is not required.
You can specify the following in the parameter Object-name: 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 object previously listed.
When you add a user (Object-type 33), you must specify the user ID in the parameter Object-name.
When you specify a user name (Object-type 70) in the parameter Object-name, you can either specify the last name or both last name and first name. Last name and first name must be separated by a comma (for example: Long,Sonya); you must not insert a blank character.
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; and
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. | |
| Object-name | A20 | R* | The name of the object to be added as a member. See the description above. Specify either Object-name or Object-ISN, not both. | |
| Object-type | N2 | O | Only valid if Object-name is specified. Must be specified if Object-name is not unique. Type of member to be added to the distribution list. Must be one of the following: 1=address (nickname), 4=bulletin board, 5=cabinet, 10=distribution list, 33=user ID (private cabinet), 70=last name, 74=external address. | |
| Object-ISN | P10 | R* | The ISN of the object to be added as a member. Specify either Object-name or Object-ISN, not both. | |
| Mail-type | A1 | R | O=original, C=copy, B=blindcopy, P=private mail. Default: O. | |
| Member-ISN | P10 | X | The ISN of the new member in the distribution list. |
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 04 | ISN not found |
| 08 | Supply either ISN or name, not both |
| 09 | ISN does not point to correct object |
| 13 | Invalid object number |
| 24 | Security violation |
| 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 - is already part of this list |
| 94 | Member not added - member must be from your own cabinet |
| 95 | Member not added - incorrect member type |
| 96 | Address or name 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-710
Z-713
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 OBJECT-NAME (A20) 0080 1 OBJECT-TYPE (N2) 0090 1 OBJECT-ISN (P10) 0100 1 MAIL-TYPE (A1) /* O, C, B, P 0110 1 MEMBER-ISN (P10) 0120 END-DEFINE 0130 * 0140 MOVE 'CABINET' TO CABINET 0150 MOVE 'PASSWORD' TO PASSWORD 0160 MOVE 'DISTR LIST 1' TO DISTRIBUTION-NAME 0170 MOVE 'MEMBER' TO OBJECT-NAME 0180 MOVE 33 TO OBJECT-TYPE 0190 MOVE 'B' TO MAIL-TYPE 0200 * 0210 CALLNAT 'Z-ADD17B' RETURN-CODE 0220 CABINET 0230 PASSWORD 0240 DISTRIBUTION-NAME 0250 OBJECT-NAME 0260 OBJECT-TYPE 0270 OBJECT-ISN 0280 MAIL-TYPE 0290 MEMBER-ISN 0300 * 0310 IF RETURN-CODE EQ 0 0320 WRITE 'Member' OBJECT-NAME 'was added to distribution list' 0330 DISTRIBUTION-NAME 0340 ELSE 0350 WRITE 'Return code' RETURN-CODE 0360 END-IF 0370 * 0380 END