Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
1151487
1151487
Syntax

Wiki Markup*dir* _logical\-name_\[=_directory_\]

Anchor
1151489
1151489
Description

...

Anchor
1151835
1151835
Parameters

...

cellspacing0
styletext-align: left; width: 504pt;
classTable_with_Header

...

...

Parameter

...

...

Description

...

styleborder-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

...

...

Logical name of the transfer server to execute the dir command.

...

...

directory

...

...

Directory to list. This can be a relative path.

Anchor
1151855
1151855
Examples

...


Anchor
1152962
1152962
To list the contents of the current directory:

Panel
dir remotesys


Anchor
1152965
1152965
To list the contents of the /home/max/tmp directory:

Panel
dir remotesys=/home/max/tmp


Info
titleWindows
dir remotesys=C:\home\max\tmp


Anchor
1152968
1152968
To list the contents of the relative path tmp directory:

Panel
dir remotesys=tmp

Anchor
1153036
1153036
(The output will be the same as /home/max/tmp assuming that the current working directory is /home/max.)

...

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.

...

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:

...