DIR (Wyświetlenie listy pozycji katalogu, bibliotek lub plików – List Directory Entries, Libraries, or Files)

Podkomenda DIR klienta FTP IBM® i służy do wyświetlania bibliotek i ich zawartości lub listy katalogów i pozycji katalogów w systemie zdalnym.

Podkomenda klienta FTP

DIr [nazwa] [(Disk]

name (nazwa)
Nazwa katalogu lub biblioteki. Domyślną wartością jest cały bieżący katalog lub biblioteka. Aby dany katalog lub biblioteka stały się bieżącymi, należy użyć komendy Katalog roboczy (Working Directory – CD). Sposób podawania zestawu plików zdalnych zależy od systemu. W większości systemów jest dozwolone używanie symbolu gwiazdki (*). Jeśli na przykład systemem zdalnym jest produkt IBM i, podkomenda DIR MYLIB/MYFILE.* spowoduje utworzenie listy wszystkich podzbiorów zbioru MYFILE w bibliotece MYLIB.

Istnieją dwa dopuszczalne formaty nazw plików, których można używać. W powyższym przykładzie użyto formatu NAMEFMT 0. Więcej informacji o nazewnictwie plików FTP zawiera sekcja NAMEFMT (Wybranie formatu nazw plików – Select File Naming Format).

(Disk
Zapisuje wynik działania komendy DIR w pliku * CURLIB/DIROUTPUT.DIROUTPUT. Wynik ten nie jest wyświetlany na ekranie.

Jeśli systemem zdalnym jest produkt IBM i, informacje te obejmują:

  • dla zbiorów baz danych, obiekty *FILE i ich podzbiory,
  • dla plików hierarchicznego systemu plików (HFS):
    • Wszystkie foldery usług biblioteki dokumentów (QDLS) i ich zawartość, czyli inne foldery lub dokumenty.
    • Wszystkie woluminy optyczne (QOPT) i ich zawartość, czyli katalogi lub pliki.

Komendy DIR należy używać ostrożnie. Jeśli komenda DIR zostanie podana bez parametrów, serwer utworzy listing wszystkich plików znajdujących się w bieżącym katalogu. Lista ta może być znacznie dłuższa niż użytkownik oczekuje.

Aby uzyskać listę nazw plików znajdujących się w danym katalogu, należy użyć podkomendy List (LS).