List Files in Cloud API

Use the Qicc_list_files_in_cloud API to list the files in a cloud resource. You can use this API to verify that particular files are in the cloud.

Required Parameter Group:
1 Resource name Input Char(10)
2 Cloud file name Input Char(**)
3 Handle I/O Byte(4)
4 File list Output Char(**)
5 Error code I/O Error code structure
Threadsafe: No

Required Parameter Group

Resource name
INPUT; CHAR(10)

This is the unique name of the resource. The name is between 1 and 10 characters long and must be left-justified and padded with spaces.

Cloud file name
INPUT; CHAR(**)

This is optional. You can specify characters and a wildcard to return files that are stored in the resource, for example you can specify A* to return files that start with A. If not specified, all files are returned.

Handle
I/O; BYTE(4)

An ID that uniquely identifies the list, and the location in the list, that the function is working with. Set this value to 0 (zero) for the first function call. When the function returns it sets the handle value. Pass this handle back in on subsequent calls to this function.

File list
OUTPUT; CHAR(**)

The first file name in the list that matches the pattern defined in the Cloud file name parameter. Call the function repeatedly to get all names in the list; each call returns the next name in the list. When every name in the list has been returned, the value is empty.

Error code
I/O; Error code structure

The error code information structure in the ERRC0100 format. For information, see the Error code parameter topic in the IBM Documentation.