Z-SEARCH

This document covers the following topics:


Description

Return a list of documents, reference documents, folders/files or user-defined objects, which have the specified keywords.

The returned list contains only one kind of object (as specified in the parameter Object-number). Only the objects containing all specified keywords are returned.

This subprogram does not consider system objects (i.e. documents and reference documents which have been created by the administrator in cabinet SYSCNT).

Objects in the Wastebasket do not contain keywords.

This subprogram should be invoked iteratively until the return code 77 indicates the end of the list.

If the returned list is to contain more than 99999 results, you must use Z-SRCHX.

Parameters

Parameter Format In Out Remarks
Return-code N2 O X Input -1: no ET.
Cabinet A8 R   The cabinet in which the list is to be returned.
Password A8 R   The password of the above cabinet.
Keywords A15/1:6 R   The keywords of the objects that you are searching for. You can specify up to 6 keywords. A keyword must not contain an asterisk (*).
Object-number N2 R   The kind of object to be returned: 11=document, 13=folder/file, 27=reference document, 80 to 99=user-defined object.
Object-table (20)
  Object-name A32   X The name of the object which contains all specified keywords. The following applies to folders and files: digits 1 to 15 contain the folder name, digits 16 to 30 contain the file name (or blank, if the object is a folder).
  ISN P8   X The ISN of the object.
Work-parameter A160     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
13 Invalid object number
54 At least one keyword was invalid
77 End of list
90 Returned list is too large (>99999)

Subprograms

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