This document covers the following topics:
Add a member to a shared cabinet. The member can be a private cabinet or another shared cabinet.
This subprogram can be used only by a supervisor or cabinet administrator.
If Profile-type 3 (special profile) is specified, the ID of the cabinet which contains the special profile must be entered in the Special-profile parameter. The special profile is then copied and used for this member whenever it accesses the shared cabinet. The Special-profile parameter is ignored for types 1 and 2.
When you add a member to a shared cabinet, the following rules apply:
the member must not contain a shared cabinet;
the cabinet specified in the parameter Shared-cabinet must not be a member of another shared cabinet;
the member must be the ID of a user or cabinet;
a shared cabinet cannot be a member of itself.
Successful termination of Z-ADD17A always results in an END TRANSACTION. You are not able to control transaction handling.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | X | ||
| Cabinet | A8 | R | The cabinet ID of a supervisor or cabinet administrator. | |
| Password | A8 | R | The password of the above cabinet. | |
| Shared-cabinet | A8 | R | The name of the shared cabinet to which you want to add a member. | |
| Member | A8 | R | The ID of a private or shared cabinet to be added as a member. | |
| Profile-type | A1 | O | 1=shared profile, 2=private profile or 3=special profile. If left blank, or if an invalid value is specified, the default (1) is used. | |
| Special-profile | A8 | R | Only required for Profile-type 3. The ID of the cabinet which contains the profile. This can be a private, shared, public or standalone cabinet. | |
| Member-ISN | P8 | X | The ISN of the new member. |
| 00 | Success |
| 02 | Invalid cabinet name |
| 03 | Password incorrect |
| 15 | Invalid administrator status |
| 32 | Member (address) could not be found |
| 90 | Member not added - contains a shared cabinet |
| 91 | Member not added - cabinet is a member of another shared cabinet |
| 92 | Member not added - error in parameter list |
| 93 | Member not added - cabinet members must be users or cabinets |
| 95 | Member not added - it is already a member of this list |
| 97 | A shared cabinet cannot be a member of itself |
| 98 | Shared cabinet does not exist |
| 99 | Special profile does not exist |
Z-120
Z-122
Z-123
Z-175
Z-198
Z-1200&0