This document covers the following topics:
Erase a member from a distribution list.
You cannot erase a member from a distribution list that has been created for a shared cabinet.
You can specify the following in the parameter Member-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 member previously listed.
When you delete a user, you can either specify the user's last and first name or user ID in the parameter Member.
When you specify a bulletin board, a nickname or the user's last and first name in parameter Member, you must also specify the parameter Member-type.
If only one member with the specified name is contained in the distribution list, the parameter Member-type is not necessary.
If the member name is not unique and a member type has not been specified, return code 91 is issued. To prevent return code 91, you should specify parameter Member-type.
If you specify an asterisk (*) in the parameter Member-name, all members of the distribution list are deleted.
| 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 which contains the member to be erased. | |
| Member-name | A20 | R* | The name of the member to be erased. Or an asterisk (*) to erase all members of the distribution list. Either Member-name or Member-ISN, not both. | |
| Member-type | N2 | O | 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. | |
| Member-ISN | P10 | R* | The ISN of the member to be deleted. Either Member-ISN or Member-name, not both. |
| 00 | Success |
| 02 | Invalid cabinet name |
| 03 | Password incorrect |
| 04 | ISN was not found |
| 08 | Supply either ISN or name, not both |
| 09 | ISN does not point to the correct object |
| 30 | Distribution list name invalid |
| 32 | Member could not be found |
| 51 | Invalid member name |
| 53 | Requested object does not exist |
| 90 | Distribution list belongs to a shared cabinet |
| 91 | Member name is not unique |
| 92 | Invalid member type |
| 93 | No member was erased from the distribution list |
Z-0417
Z-120
Z-122
Z-123
Z-147
Z-150
Z-710
Z-713
Z-1200&0
0010 DEFINE DATA LOCAL 0020 1 RETURN-CODE (N2) 0030 1 CABINET (A8) 0040 1 PASSWORD (A8) 0050 1 DISTRIBUTION-NAME (A12) 0060 1 MEMBER-NAME (A20) 0070 1 MEMBER-TYPE (N2) 0080 1 MEMBER-ISN (P10) 0090 END-DEFINE 0100 * 0110 MOVE 'USER ID' TO CABINET 0120 MOVE 'PW' TO PASSWORD 0130 MOVE 'DISTR 1' TO DISTRIBUTION-NAME 0140 MOVE 'USER2 ID' TO MEMBER-NAME 0150 MOVE 33 TO MEMBER-TYPE 0160 * 0170 CALLNAT 'Z-ERA17' RETURN-CODE 0180 CABINET 0190 PASSWORD 0200 DISTRIBUTION-NAME 0210 MEMBER-NAME 0220 MEMBER-TYPE 0230 MEMBER-ISN 0240 * 0250 IF RETURN-CODE EQ 0 0260 WRITE 'Member' MEMBER-NAME 'from distribution list' 0270 DISTRIBUTION-NAME 'was erased' 0280 ELSE 0290 WRITE 'Return code' RETURN-CODE 0300 END-IF 0310 * 0320 END