Wildcard search scope (LISTSUBDIR)

Indicate whether wildcard searches should span subdirectories or apply only to the current working directory.

This option is available when configuring an FTP client or an FTP server. If you are configuring a client, it applies when issuing an mput * command. If you are configuring a server, it applies when issuing any of the following commands: mget * , ls * , or mdelete * . This setting only applies when the * wildcard is used and it searches only the subdirectories of the current path. It does not search multiple depths of subdirectories.

Example

Directory: "/u/user1/xx" contains the following files and subdirectory:
areadme (file)
file_xx (file)
readme_xx (file)
ggg (subdirectory)

Directory "u/user1/xx/ggg" contains the following file and subdirectory:
file_ggg (file)
zzz (subdirectory)

Directory "u/user1/xx/ggg/zzz" contains the following file and subdirectory:
file_zzz (file)
rrr (subdirectory)

The following display shows these files and directories:

250 HFS directory /u/user1/xx is the current working directory
ftp> ls -l
200 Port request OK.
125 List started OK
total 40
-rwx------   1 IBMUSER  0             48 Oct 29 21:14 areadme
-rwx------   1 IBMUSER  0             10 Nov  1 16:02 file_xx
drwxrwxrwx   3 IBMUSER  0           8192 Nov  1 16:00 ggg
-rwx------   1 IBMUSER  0             23 Oct 29 21:06 readme_xx
250 List completed successfully.
260 bytes received in 0.03 seconds (8.67 Kbytes/sec)
ftp> cd ggg
250 HFS directory /u/user1/xx/ggg is the current working directory
ftp> ls -l
200 Port request OK.
125 List started OK
total 24
-rwx------   1 IBMUSER  0              6 Nov  1 16:00 file_ggg
drwxr-x---   3 IBMUSER  0           8192 Nov  1 16:01 zzz
250 List completed successfully.
133 bytes received in 0.02 seconds (6.65 Kbytes/sec)
cd zzz
250 zFS directory /u/user1/xx/ggg/zzz is the current working directory
ftp> ls -l
200 Port request OK.
125 List started OK
total 24
-rwx------   1 IBMUSER  0              4 Nov  1 16:00 file_zzz
drwxr-xr-x   2 IBMUSER  0           8192 Nov  1 16:01 rrr
250 List completed successfully.
133 bytes received in 0.01 seconds (13.30 Kbytes/sec)

If you select "Restrict wildcard searches to only current working directory", the client will see the following:

257 "/u/user1/xx" is the HFS working directory.
ftp> ls *
200 Port request OK.
125 List started OK
areadme
file_xx
readme_xx
250 List completed successfully.
29 bytes received in 0.02 seconds (1.45 Kbytes/sec)

If you select "Wildcard searches should span subdirectories", the client will see the following:

257 "/u/user1/xx" is the HFS working directory.
ftp> ls *
200 Port request OK.
125 List started OK
areadme
file_xx
ggg/file_ggg
readme_xx
250 List completed successfully.
42 bytes received in 0.04 seconds (1.05 Kbytes/sec)
Differences

When spanning subdirectories with the wildcard, * , the file ggg/file_ggg is shown. However, the file ggg/zzz/file_zzz is not shown since the subdirectory span is only one level deep.