Syntax
dirlogical-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
Parameter | Description |
|---|
logical-name | Logical name of the transfer server to execute the dir command. |
directory | 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:
| Panel |
|---|
dir remotesys=/home/max/tmp |
| Info |
|---|
|
dir remotesys=C:\home\max\tmp |
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.
| Panel |
|---|
dir s=/tmp/notfound
s: Listing for: /tmp/notfound
s: ---------- Error Analysis Report -- Begin -----------------
s: Message.....: No such file or directory (Path name: /tmp/notfound)
s: Function....: stat
s: Error Type..: SYSTEM Error Code..: 2, X'2'
s: Source......: udmfiou.c Line........: 1818
s: Date........: 2011.12.20 Time........: 14:08:04
s: ---------- Error Analysis Report -- End -------------------
s: Failed to retrieve full file listing for file spec, '/tmp/notfound', and current path, '/home/john' |
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.
| Panel |
|---|
dir s=/tmp/notfound*
s: Listing for: /tmp/notfound* |
This results in _rc = 0 and _lastrc = 0 and no files listed.
Sample Output
The following is a sample dir command output:
| Panel |
|---|
local: Listing for: /tmp
local: 2011-08-18 15:38:25 directory 86016 .
local: 2009-11-12 04:47:03 directory 544 ..
local: 2011-08-18 15:34:51 file 11748 ivp.syslog.log
local: 2011-08-12 01:50:07 directory 8192 PROD.UNV.UNVDB
local: 2011-08-12 01:50:07 external 6 UBROKER.STC02652.21D038B2.UCSCMP00.UCMSRV
local: 2011-08-12 01:50:07 FIFO 0 ubroker-prod-monitor
local: 2011-08-12 01:50:07 character 0 xps-2C92765F-50331656.ipc |
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
