Description of output fields of FTSHW

CHARACTERSET – File type

This specifies the file type. This field can have the following values in the default output:

t	file contains text
b	file contains binary data
d	directory
*	no information on data structure available

The long output form is as follows:

BINARY-FILE DIRECTORY CHARACTERSET

binary file directory text file *

For text files (CHARACTERSET=), the character set of the characters of the text file is indicated. The field can have the following values:

g	graphic string *) 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	general string *) The file can contain characters from the C0 set of ISO646 and either from the G0 set of ISO646 or ISO8859-1 and from the G1 set of ISO8859-1.
i	IA5 string *) The file can contain characters from the C0 set and G0 set of ISO646.
v	visible string *) The file can contain characters from the G0 set of ISO646.

Values marked with * are only relevant for FTAM.

ACCESS-RIGHTS – Access rights

Contains information about how a file can be accessed. The field can contain the following values:

r	file can be sent.
i	data units can be entered. *)
p	file can be overwritten.
x	file can be expanded, i.e. data can be added to the file.
e	data units can be deleted from the file.
a	file attributes can be read.
c	file attributes can be modified.
d	file can be deleted.
t	access direction forwards (traversal) *)
v	access direction backwards (reverse traversal) *
r	random access *)

Values marked with * are only relevant for FTAM.

File creator

Identity of the person who created the file. In BS2000, the information consists of the user ID under which the file is created. In Unix systems, this value generally indicates the owner of the file. The field can be up to 32 characters long.

STORAGE-ACCOUNT – Account number

FTAM-specific value. It contains the account number for which the costs are calculated for saving the file in the remote system.

FILESIZE – Current file size in bytes

This contains the current size of the file in bytes. The output is only as accurate as the information returned by the partner system. Since the files can be set up differently in different systems, files of the same size may have different values in this field, depending on the system. Some memories assign multiples of basic units, or blocks, for file storage. Therefore, it is important that the value indicated here not be taken as the actual size, but rather be treated as a guideline.

In the case of LMS library members, it is particularly important to note that the displayed size is generally smaller than the file resulting from the transfer since library members can always be stored in compressed form (see the section “Structure of a library” in the LMS manual).

Date and time of last modification of file contents

This contains information on the time of the last modification. For modifications which have been made in the past six months, the output takes the form MonthDayTime (e.g. Apr 25 15:13); for modifications which were made over six months ago, the form is MonthDayYear (e.g. Apr 30 2017).

FILENAME – File name

This contains the file name.

The following values are only included in the long output form:

CRE, MOD, REA, ATM – Type of last file use

This contains information about how the file was last accessed. The following actions can be displayed:

CRE	file creation
MOD	modification of file contents (overwriting, expansion)
REA *	read file (send)
ATM *	modification of file attributes

Values marked with * are only relevant for FTAM.

It must be noted that it is left to the remote system to determine what information will be returned. Therefore, the lines with the information on the file use may look different for each partner system and contain different information. Generally, the information about the creation of the file is supplied, if nothing else.

Information about the modification of file contents or file attributes, about sending a file, or about when the file was last used may not be included.

Name of last file user

Identity of the last user who accessed the file in a particular way.

RECORD-FORMAT – Record format

This contains the format of the transferred records. Possible values are:

v	variable length records
f	uniform length records
u	no record structure or variable length records, all of which are terminated by CRLF (carriage return line feed) for transfer.

RECORD-SIZE – Maximum record length

This contains the maximum length of the transferred records.

FILE-AVAILABILITY – File availability

FTAM-specific value. The field can have the following values:

i	the file is available immediately (immediate).
d	the file is not available immediately (deferred).
	The meaning of the word “deferred” is determined by the partner system.

MAX-FILESIZE – Possible file size in bytes

FTAM-specific value. It contains the possible file size. The specification is only as accurate as the information sent by the partner system. Since the files can be set up differently in different systems, files of the same size may have different values in this field, depending on the system. Therefore, it is important that the value indicated here not be taken as the actual size, but rather be treated as a guideline.

LEGAL-QUALIFICATION – Legal qualification

FTAM-specific value which contains the legal qualifications for a file (in lieu of a copyright).

Examples

1. You want to view the properties of the PS file dat1 with a variable record format of the length 255 on a z/OS system with the partner name ZOS2PART:

   To do this, you can issue the following command under TSO:

   FTSHW ZOS2PART,FILE-NAME=DAT1,TRANS-ADM=(USERID,ACCT,PASSWORD),INF=*ALL

   FILENAME=DAT1

     CRE     OPFT000

   MOD     DATE=Mar 25 00:00

   RECORD-FORMAT=v RECORD-SIZE=255          FILE-AVAILABILITY=i

   ACCESS-RIGHTS=r-pxeacd---     FILESIZE=8192

2. You want to view the properties of the file

   dat2 on a BS2000 system with the partner name BS2PART:

   FTSHW BS2PART,FILE-NAME=DAT2,TRANS-ADM=(USERID,ACCT,PASSWORD),INF=*ALL

   FILENAME=DAT2

     CRE     OPENFT
  MOD     DATE=Mar 10 2012

     CHARACTERSET=g

     RECORD-FORMAT=f RECORD-SIZE=80
  ACCESS-RIGHTS=r-pxeacd---     FILESIZE=2048

3. You want to view the properties of the file

   dat3 on the Windows system with the partner name WINPC and to do so, specify the FTAC transfer admission FTACTRANSADM:

   FTSHW WINPC,FILE-NAME=DAT3,TRANS-ADM=('FTACTRANSADM')

   *r----a----- FT:mueller 27185709 Sep 17 2016 DAT3

   The command for detailed output is as follows:

   FTSHW WINPC,FILE-NAME=DAT3,TRANS-ADM=('FTACTRANSADM'),INF=*ALL

   FILENAME=DAT3

     CRE     FT:mueller

     MOD     DATE=Sep 17 2016
  RECORD-FORMAT=u FILE-AVAILABILITY=i

     ACCESS-RIGHTS=r----a-----     FILESIZE=27185709

4. You want to view the properties and members of the PO library
   OPFT000.POBIB.CLIST on a z/OS system with the user ID opft000 and the partner name ZOS2PART:

   FTSHW ZOS2PART,*DIR=('OPFT000.POBIB.CLIST')

                  ,TRANS-ADM=(OPFT000,ACCT,PASSWORD)

     *r-pxeacd--- OPFT000                0    Jul 16 00:00 MEMBER1

     *r-pxeacd--- OPFT000                0    Jul 16 00:00 MEMBER2
  *r-pxeacd--- OPFT000                0    Jul 16 00:00 MEMBER3

   The command for detailed output is as follows:

   FTSHW ZOS2PART,*DIR=('OPFT000.POBIB.CLIST')

                  ,TRANS-ADM=(OPFT000,ACCT,PASSWORD),INF=*ALL

     FILENAME=MEMBER1

     CRE     OPFT000
  MOD     DATE=Jul 16 00:00

     RECORD-FORMAT=f RECORD-SIZE=80           FILE-AVAILABILITY=i

     ACCESS-RIGHTS=r-pxeacd---     FILESIZE=0
  FILENAME=MEMBER2

     CRE     OPFT000

     MOD     DATE=Jul 16 00:00
  RECORD-FORMAT=f RECORD-SIZE=80           FILE-AVAILABILITY=i

     ACCESS-RIGHTS=r-pxeacd---     FILESIZE=0

     FILENAME=MEMBER3
  CRE     OPFT000

     MOD     DATE=Jul 16 00:00

     RECORD-FORMAT=f RECORD-SIZE=80           FILE-AVAILABILITY=i
  ACCESS-RIGHTS=r-pxeacd---     FILESIZE=0