This document covers the following topics:
Display a list of cabinets sorted alphabetically by cabinet name.
You can either display a list of all cabinet types or of just a specific cabinet type (private, standalone, shared or public). You must specify the cabinet type in the parameter Start-cabinet-type.
This subprogram should be invoked iteratively until the return code 77 indicates the end of the list.
| Parameter | Format | In | Out | Remarks |
|---|---|---|---|---|
| Return-code | N2 | O | X | Input -1: no ET. |
| Cabinet | A8 | R | Any user can invoke this subprogram. | |
| Password | A8 | R | The password of the above cabinet. | |
| Start-cabinet | A8 | O | Start value. The name of a cabinet. If Start-cabinet is not specified, a list of all cabinets of the specified cabinet type is returned. | |
| Start-cabinet-type | N1 | R | 0=private cabinet, 1=standalone cabinet, 2=shared cabinet, 3=public cabinet, 9=all cabinet types. | |
| Number | N2 | O | The maximum number of cabinets that are returned with each call. When you do not specify a value, or when you specify a value greater than 20, the default value 20 is used. | |
| Cabinet-table (20) | ||||
| Cabinet-name | A8 | X | The name of the cabinet. | |
| Cabinet-type | A1 | X | 0=private cabinet, 1=standalone cabinet, 2=shared cabinet, 3=public cabinet. | |
| User-last-name | A32 | X | For cabinet type 0: the user's last name. For cabinet types 1, 2 and 3: the description of the cabinet. | |
| User-first-name | A32 | X | Is only used with cabinet type 0: the user's first name. | |
| User-initial | A1 | X | Is only used with cabinet type 0: the user's middle initial. | |
| Disallow-mail | A1 | X | Is only used with cabinet types 1, 2 and 3. If marked, the cabinet is not able to receive or send mail. | |
| Owner | A1 | X | If marked, an administrator has been specified as the owner of the cabinet. | |
| Administrator | A1 | X | Only applies to an administrator cabinet: X=system administrator, A=cabinet administrator, S=supervisor. | |
| Cabinet-ISN | P8 | X | The ISN of the cabinet. | |
| Work-parameter | A42 | For internal use. See The Work Parameter. | ||
| 00 | Success |
| 02 | Invalid cabinet name or - in batch mode only - locked cabinet |
| 03 | Password incorrect |
| 77 | End of list |
| 91 | Cabinet type not specified or specified incorrectly |
Z-120
Z-122
Z-123
Z-1200&0