ftshwf

Note on usage

Function: Display the attributes of a local file

User group: FT user

Functional description

The command is above all useful in connection with FTAM partners. For openFT partners, information about binary-fixed file can be displayed.

With ftshwf, you can display the FTAM attributes of a file in the local system. Thus, you can define the file attribute values for file transfer and file management requests involving FTAM partners.

There are three options for outputting the attributes:

• Display the file name

• Display a default selection of file attributes

• Display all attributes of the file

Output is written to standard output.

A precise description of standard output and detailed output can be found in the section “Description of file attribute display”.

Format

ftshwf -h |

<file name 1..512>
[ -s | -l ][ -csv ]

Description

-h

Displays the command syntax on the screen. Entries after the -h are ignored.

file name

Indicates the file whose attributes are to be displayed. Some of the attributes displayed only apply for FTAM partners who wish to transfer files with openFT-FTAM.

-s

Only the file name is output (short).

-l

All information available on the file in the partner system is output.

neither -s nor -l specified:

The standard information is displayed. The amount of information and the layout of the output are described in the section “Description of file attribute display”.

-csv

You use -csv to specify that the file attributes are to be output in CSV format. The values are output separated by semicolons. If -csv is specified then output is always complete (in the same way as for -l) irrespectively of whether -l is specified simultaneously or not.

Examples

1. You wish to output the standard scope of information on the locfile file on the local

   system. ftshwf locfile Output on Unix systems: *ripxeacd--- john 214 Apr 30 11:55	/home/john/locfile (Unix systems)
   Output on Windows systems: *ripxeacd--- john 214 Apr 30 11:55	C:\john\locfile (Windows systems)

2. You wish to output detailed information on the FTAM attributes of the

   locfile file on the local system.

   ftshwf locfile -l

   Output on Unix systems:

   FILENAME=/home/john/locfile
   CRE   otto
   MOD   DATE=Apr 28 15:54
   REA   DATE=Apr 30 09:01
   ATM   DATE=Apr 28 15:54
   FILE-AVAILABILITY=i
   ACCESS-RIGHTS=ripxeacd---     FILESIZE=214
   

   Output on Windows systems:

   FILENAME=C:\john\locfile

   CRE otto DATE=Apr 28 15:54

   MOD DATE=Apr 28 15:54

   REA DATE=Apr 30 09:01

   FILE-AVAILABILITY=i

   ACCESS-RIGHTS=ripxeacd---       FILESIZE=214

3. Example of a file with the attribute

   binary fixed that is evaluated for openFT partners, see the command ftmodf :

   ftshwf binfix.06 -l

   Output on Unix systems:

   FILENAME=/home/special/binfix.06
   CRE   special
   MOD   DATE=Nov 28 15:54
   REA   DATE=Dez 05 10:01
   ATM   DATE=Dez 05 15:54
   BINARY-FILE  RECORD-FORMAT=f  RECORD-SIZE=14156
   FILE-AVAILABILITY=i
   ACCESS-RIGHTS=ripxeacd---     FILESIZE=42468
   

   Output on Windows systems:

   FILENAME=C:\special\binfix.06

   CRE     special DATE=NOV 26 16:31

   MOD     DATE=Nov 28 15:54
REA     DATE=Dez 05 10:01

   BINARY-FILE    RECORD-FORMAT=f    RECORD-SIZE=14156

   FILE-AVAILABILITY=i

   ACCESS-RIGHTS=ripxeacd---       FILESIZE=42468