Das Programm sample3 wird folgendermaßen aufgerufen: sample3 dvz1
Name und Zugangsberechtigung zum fernen System werden dann im Dialog erfragt.
Das Programm liest die Einträge des Dateiverzeichnisses dvz1 auf einem fernen System und gibt sie auf dem Bildschirm aus. Das Dateiverzeichnis muss absolut angegeben werden oder relativ zum HOME-Verzeichnis des Benutzers (siehe "Dateiübertragung") bzw. zur im Berechtigungsprofil festgelegten Benutzerkennung im fernen System. Im Beispiel werden maximal die Informationen von 10 Einträgen ausgegeben, auch wenn im angegebenen Dateiverzeichnis mehr als 10 Dateien/Verzeichnisse vorhanden sind.
Das Programm ist folgendermaßen aufgebaut:
Mit der Funktion ft_showdir() werden Informationen über den Inhalt des angegebenen Dateiverzeichnisses im fernen System gelesen.
Dabei wird ein Puffer zur Verfügung gestellt, der die Informationen von insgesamt 10 Dateien oder Verzeichnissen aufnehmen kann.
Zusätzlich wird die Anzahl der Einträge geliefert.