Message file for named users (HFSINFO)

Use of the HFSINFO file is optional and is applicable only to named users as opposed to anonymous users. If no HFSINFO file is specified, no messages are displayed to the client when the user changes HFS directories. If an HFSINFO file is specified, then each time the user changes HFS directories, the FTP server will search for the specified file name in the new directory. If the server finds a matching file, the files contents are displayed to the client. If no match is found, no messages are displayed to the client.

Wild cards can be specified as the last character of the HFSINFO file name, such as "readme*". This could result in multiple matches. If the server finds multiple matches, only the contents of the first match are displayed to the client.

Example:
The user configures the HFSINFO filename as: readme*

The file /u/user1/readme_user1 contains the words:
Entering directory /user1

The file /u/user1/xx/readme_xx contains the words:
Entering directory /xx

When the client logs in, and changes directories, the following is displayed to the client:

D:\>ftp 9.42.103.112
Connected to 9.42.103.112.
220-FTPD1 IBM FTP CS V1R4 at MVS171.tcp.raleigh.ibm.com, 21:06:42 on 2002-10-29.

220-MY BANNER MESSAGE.  THIS IS MY EMAIL ADDRESS myaddress@us.mycompany.com
220 Connection will not timeout.
User (9.42.103.112:(none)): user1
331 Send password please.
Password:
230 USER1 is logged on.  Working directory is "/u/user1".
ftp> cd xx
250-Entering directory /xx
250 HFS directory /u/user1/xx is the current working directory
ftp> cd ..
250-Entering directory /user1
250 HFS directory /u/user1 is the current working directory
ftp> cd xx
250 HFS directory /u/user1/xx is the current working directory
ftp>

In this example, when the user first changes to directory, xx, the message "250-Entering directory /xx" is displayed. The user next backs up to directory, user1, and the message "250-Entering directory /user1" is displayed. However, when the user changes to directory, xx, for the second time, no message is displayed. The server displays the HFSINFO message only the first time a directory is entered. Because the server maintains a finite history of directory changes, if the user performs frequent directory changes, it is possible the client will see the message more than just the first time.

To show a message to the client when changing HFS directories, enter the HFS file containing the message.

Syntax rules: