Z-DIS05

This document covers the following topics:


Description

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.

Parameters

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.

Return Codes

00 Success
02 Invalid cabinet name
03 Password incorrect
77 End of list
91 Cabinet type not specified or specified incorrectly

Subprograms

Z-120
Z-122
Z-123
Z-1200&0