Z-ERA17

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

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

Subprograms

Z-0417
Z-120
Z-122
Z-123
Z-147
Z-150
Z-710
Z-713
Z-1200&0

Example

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