Detailed output, examples

ftshw bs2partn!aaa.e42 transbs2 -l
   FILENAME=:6QCA:$HUGO.AAA.E42
   CRE   HUGO DATE=Mar 17 13:01
   MOD   DATE=Mar 17 13:01 
   REA   DATE=Mar 17 13:01 
   BINARY-FILE
   RECORD-FORMAT=u RECORD-SIZE=32767
   ACCESS-RIGHTS=r-pxeacd---   FILESIZE=32768
ftshw zospart!test.clist transzos -l
   FILENAME=test.clist
   CRE   OPFTWIT 
   MOD   DATE=Apr 03 2017
   RECORD-FORMAT=v RECORD-SIZE=648        FILE-AVAILABILITY=i 
   ACCESS-RIGHTS=r-pxeacd---   FILESIZE=587860

Explanation of fields

file type

specifies the file type. This field can be assigned any of the following values:

t	File contains text
b	File contains binary data
d	Directory
*	No information available on the file structure

The comprehensive output is displayed as follows:

BINARY-FILE	Binary file
DIRECTORY	Directory
CHARACTERSET	Text file

The character set from which the characters in the text file originate is also specified for text files (CHARACTERSET=). The field can be assigned the following values:

g	GraphicString: the file can contain characters from the G0 set of ISO646, or from the G0 set of ISO8859-1 and the G1 set of ISO8859-1.
c	GeneralString: the file can contain characters from the C0 set of ISO646 and either from the G0 set of ISO646 or from ISO8859-1 and from the G1 set of ISO8859-1.
i	IA5String: the file can contain characters from the C0 set and the G0 set of ISO646.
v	VisibleString: the file can contain characters from the G0 set of ISO646.

access rights and permitted actions

contains information on the access rights which can be used for the file or the directory.

For files, this field can be assigned any of the following values:

r	File can be sent.
i	Units of data can be added. 1)
p	File can be overwritten.
x	File can be extended, i.e., data can be appended to it.
e	Units of data can be deleted from the file.
a	File attributes can be read.
c	File attributes can be modified.
d	File can be deleted.
t	Traversal 1)
v	Reverse traversal 1)
r	Random access 1)

¹⁾These values are only relevant for FTAM.

For directories (-d is specified), this field can be assigned any of the following values:

r	All files of the directory can be listed.
pxe	Under the directory, files and directories can be created, extended, and deleted.
a	Directory attributes can be read.
c	Directory attributes can be modified.
d	The directory can be deleted.

file creator

identifies the creator of the file. In BS2000, the information refers to the user ID under which the file is created. In the Unix system, this value also identifies the owner of the file.

The field can be up to 12 characters in length.

STORAGE-ACCOUNT

contains the account number used when calculating the cost of storing the file in the remote system.

If the partner returns an account number under FTAM, this is appended to the file owner in the standard output.

FILESIZE - current file size in bytes

contains the current file size in bytes. If the output is followed by a "K", the output is in kilobytes. If it is followed by an "M", the output is in megabytes. This value is only as precise as the value returned by the partner system. Since files are created differently in different systems, different values can be displayed for files of the same size from different systems. Some filestores assign a multiple of a basic unit, e.g. blocks, for file storage. It is therefore advisable not to take this value to be the actual file size; it should be used for guidance only.

date and time of last modification to file contents

contains information on when the file contents were last modified. In the case of modifications made within the last six months, the value is given in the form month day time (e.g. Jan 31 15:13); for earlier modifications, the form is month day year (e.g. Jan 31 2017).

FILENAME

contains the name of the file.

The following values are part of the comprehensive output:

CRE, MOD, REA, ATM - how the file was last used

contains information on how the file was last accessed. The following types of access are displayed:

CRE	Creating the file
MOD	Modifying the file contents (overwrite, extend)
REA	Reading the file (send), only relevant for FTAM
ATM	Modifying the file attributes, only relevant for FTAM

It is important to remember that it is up to the remote system to determined which information it returns. Therefore, the information line on file use may look different and may contain different information, depending on the partner system. Generally, this section will at least indicate how the file was created.

However, additional information on modifying the file contents or file attributes, or sending a file may not be included. Information on how the file was last used may not be available either.

name of the last file user

identity of the last file user who accessed the file using a particular type of access.

CCS-NAME

Name of the CCS used to encode the file.

RECORD-FORMAT

contains the format of the records transferred. The field can be assigned the following values:

v	Variable length records
f	Fixed length records
u	No defined record length or the record length is hidden in the transmission format, e.g. records are terminated with a CRLF (Carriage Return Line Feed).

RECORD-SIZE

contains the maximum length of the records to be transferred.

FILE-AVAILABILITY

The field can be assigned the following values:

i	File available immediately (immediate).
d	File not available immediately (deferred). The partner is responsible for interpreting the term deferred. In the case of openFT partners on BS2000 or z/OS, this means that the file has been migrated.

MAX-FILESIZE

contains the maximum possible file size in bytes (FTAM-specific value). This value is only as precise as the value returned by the partner system. Since files are created differently in different systems, different values can be displayed for files of the same size.

LEGAL-QUALIFICATION

contains a legal qualification for the file (corresponds to a copyright, FTAM specific).