Description of output fields of SHOW-REMOTE-FILE-ATTRIBUTES

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

binary file directory

CHARACTERSET 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 wish to output the standard information on the REMFILE in the BS2000 computer with the symbolic name HUGO under the login JIM with account number A1234FT and password C’PWD’.

   /SHOW-REMOTE-FILE-ATTRIBUTES PARTNER = HUGO,FILE-NAME = REMFILE,       -

   /                              TRANSFER-ADMISSION = (JIM,A1234FT,C'PWD')

   %*r-pxeacd--- JIM                  1234567890 Apr 30 11:55 REMFILE

   Short form:

   /SH-REM-FI-ATT HUGO,REMFILE,,(JIM,A1234FT,'PWD')

2. You wish to output detailed information on the attributes of the REMFILE file on the FTAM partner system with the symbolic name HUGO under the login JIM with the account number A1234FT and password C’PWD’:

   /SHOW-REMOTE-FILE-ATTRIBUTES PARTNER = HUGO,FILE-NAME = REMFILE,          -

   /                              TRANSFER-ADMISSION = (JIM,A1234FT,C'PWD'),    -
/                              INFORMATION = *ALL-ATTRIBUTES

   %FILENAME=REMFILE

   %CRE     JIM
%MOD     DATE=Apr 28 15:54

   %RECORD-FORMAT=v

   %ACCESS=RIGHTS=r-pxeacd---      FILESIZE=123456

   Short form:

   /SH-REM-FI-ATT HUGO,REMFILE,,(JIM,A1234FT,'PWD'),*ALL

3. You wish to obtain comprehensive information concerning the attributes of the POSIX files in the remote system compute1. The transfer admission for the remote system is number13.

   1. The output relates to the POSIX directory file:

      /SHOW-REMOTE-FILE-ATTRIBUTES compute1,*DIR(’./file’),,number13

      %*r-pxeacd--- AXL                       2416640 Feb 13 10:18 FUTURE-E.28

      %*r-pxeacd--- AXL                      26365952 Feb 09 09:36 FUTURE-E.26
%tr-pxeacd--- AXL                          2048 Feb 16 15:24 TEST

      %*r-pxeacd--- AXL                        524288 Jan 26 10:11 NSTD

   2. Output is requested for the POSIX file named file.test:

      /SHOW-REMOTE-FILE-ATTRIBUTES compute1,‘./file.test‘,,number13

      %*r-pxeacd--- axl 2048 Feb 17 15:50 ./file.test

   3. The output is requested for the entire directory:

      /SHOW-REMOTE-FILE-ATTRIBUTES compute1,*DIR(‘./.‘),,number13

      %*r-pxeacd--- axl                           0 Feb 17 16:55 Z1.FUTURE-

      F.780

      %*r-pxeacd--- axl                           0 Feb 22 10:05 Z1.FUTURE-

      F.1060

      %*r-pxeacd--- axl                      261389 Feb 17 11:32 F-703-0BUP
%*r-pxeacd--- axl                           0 Feb 20 10:39 SCRATCH

      %*r-pxeacd--- axl                       21511 Feb 22 10:46 Z3.FUTURE-

      F.107

      %*r-pxeacd--- axl                      199355 Feb 17 11:20 Z1.FUTURE-

      F.739

      %*r-pxeacd--- axl                       19899 Feb 17 10:23 Z1.FUTURE-
F.693

      %*r-pxeacd--- axl                           0 Feb 15 20:40 F-291-0BM8

      %*r-pxeacd--- axl                           0 Feb 15 16:28 F-172-0BM7
%*r-pxeacd--- axl                        2048 Feb 17 15:50 file.test

4. All files that start with FILE. are to be displayed:

   /SHOW-REMOTE-FILE-ATTRIBUTES compute1,*DIR(file.),,number13

   %*r-pxeacd--- AXL                       2416640 Feb 13 10:10 INCOMING
%*r-pxeacd--- AXL                      26365952 Feb 09 09:36 OUTGOING

5. All characteristics of the file FILE.TEST should be displayed in CSV format at the system PARTBS2:

   /SH-REM-FI PARTBS2,FILE.TEST,,transadm,OUT=*SYSOUT(*CSV),INF=*ALL

   FileName;StorageAccount;CreIdentity;CreTime;ModIdentity;ModTime;

   ReaIdentity;ReaTime;AtmIdentity;AtmTime;FileType;CharSet;RecFormat;

   RecSize;FileAvail;AccessRights;FileSize;MaxFileSize;LegalQualif;CcsName

   "FILE.TEST";*NSPEC;"UID";*NSPEC;*NSPEC;2012-07-05 14:43:13;*NSPEC;

   *NSPEC;*NSPEC;*NSPEC;*NSPEC;*NSPEC;*VAR;*NSPEC;*NSPEC;r-pxeacd---;2048;

   *NSPEC;*NSPEC;*NSPEC

6. The properties of the PLAM library TESTLIB are to be displayed.

   PLAM libraries are addressed as directory structures:
   Library/Type/Member or Library/Type/Member()/Member(Version)

   1. To list all types of a library:

      /SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB'),,TRANSADM

      %dr-pxeacd--- TSOS                      Jul 25 13:06 s

      %dr-pxeacd--- TSOS                      Jul 25 13:06 x

   2. To list all members of a type:

      /SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB/S'),,TRANSADM

      *r-pxeacd--- TSOS                2048    Jul 25 13:05 test

      dr-pxeacd--- TSOS                      Jul 25 13:06 test()
*r-pxeacd--- TSOS                2048    Jul 25 13:06 test.outfile

      Note:
      All members of a type are listed as files in the directory of this type. When transfer takes place, the highest version (or Version @) is supplied. If more than one version of a member exists, a Member() directory is also displayed in which the other versions of the member are contained.

   3. To list all additional versions of the member test:

      /SHOW-REM-FIL-ATTR PCVQ7C2,*DIR('TESTLIB/S/test()'),,TRANSADM

      *r-pxeacd--- TSOS 2048 Jul 25 13:06 test(12)

   4. To display the highest version of the member test:

      /SHOW-REM-FIL-ATTR PCVQ7C2,'TESTLIB/S/test',,TRANSADM

      *r-pxeacd--- TSOS 2048 Jul 25 13:05 testlib/s/test

   5. To display Version 12 of the member test:

      /SHOW-REM-FIL-ATTR PCVQ7C2,'TESTLIB/S/test()/test(12)',,TRANSADM

      *r-pxeacd--- TSOS                2048    Jul 25 13:06
testlib/s/test()/test(12)