LIST request

The LIST request retrieves a list of records from the specified database or data set. The first entry in the list is made available for processing. Other records in the list can be retrieved using the SELECT request.

When you use the LIST request, the resulting list consists only of the common segments of the records. For a description of the data fields that make up the common segment of each record, see Program interface record format. To retrieve a complete record, you must use the SELECT request.

After a successful LIST request for a particular resource code, the list remains available until you build a new list for the same resource code, or until a TERM request. This means that you can have several active lists if required, but only one at a time for each resource code.

When retrieving current plan occurrences and operations, the default is to retrieve all matching objects except those in deleted status. When STATUS is provided as an argument, the specified selection overrides the default processing.

In case of large amount of data, the use of queries without filter argument might exceed any available storage and needs to be limited. For program interface applications, invoked by a clist and IKJEFT01, a test allocation is done finding out how much storage is available (between a minimum of 32KB and a maximum of 64MB) and thereafter a fraction (1/4) of it is allocated to receive the unknown amount of data from the HCL Workload Automation subsystem.