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 or - in batch mode only - locked cabinet
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