Syntax
| Wiki Markup |
|---|
*dir* _logical\-name_\[=_directory_\] |
Description
The dir command provides a listing of the specified directory.
If no directory is specified, the current working directory (or qualifier) is used as the specified directory.
When the dir argument results in a "not found" condition, the dir command ends with _rc = 8 and _lastrc = 0 (see #dir "not found" condition, below).
| Note |
|---|
|
The dir command is valid only for the hfs file system. |
IBMÂ i | hfs supports the root and QOpenSys file systms under IFS. |
|---|
|
z/OS | hfs supports the UNIX System Services file system. |
|---|
|
Parameters
| HTML Table |
|---|
| cellspacing | 0 |
|---|
| style | text-align: left; width: 504pt; |
|---|
| class | Table_with_Header |
|---|
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 144pt; |
|---|
| | Parameter |
| Table Cell (td) |
|---|
| style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 360pt; |
|---|
| | Description |
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | logical-name |
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | Logical name of the transfer server to execute the dir command. |
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | directory |
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | Directory to list. This can be a relative path. |
|
|
Examples
The following examples assume that the logical name
remotesys is valid.
To list the contents of the current directory:
To list the contents of the
/home/max/tmp directory:
To list the contents of the relative path
tmp directory:
(The output will be the same as
/home/max/tmp assuming that the current working directory is
/home/max.)
| Anchor |
|---|
| dir "not found" condition |
|---|
| dir "not found" condition |
|---|
|
dir "not found" condition
If the dir argument results in a "not found" condition, the dir command ends with _rc = 8 and _lastrc = 0.
This results in _rc = 8 and _lastrc = 0.
In the instance where a wild card is used, finding no files to return results in _rc = 0 and _lastrc = 0.
This results in _rc = 0 and _lastrc = 0 and no files listed.
Sample Output
The following is a sample dir command output:
Each file type is identified as:
- "file": Files and symbolic links
- "directory": Directories
- "FIFO": FIFOs
- "character": UNIX domain socket and other character devices
- "block": Block oriented devices
- "socket": Socket links
- "external": External links (z/OS only)
- "unknown": File type could not be determined