SHOW-FILE-FT-ATTRIBUTES

Note on usage

Function: Display local FT file attributes

User group: FT User

Alias name: FTSHWF

The command is only useful in conjunction with FTAM functionality.

Functional description

With the SHOW-FILE-FT-ATTRIBUTES command you can display the FTAM attributes of a file in the local system. Thus, you can determine 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 default information

• Display all file attributes

Format

SHOW-FILE-FT-ATTRIBUTES / FTSHWF

FILE-NAME = <filename 1..54>

,INFORMATION = *STD / *ALL-ATTRIBUTES / *NAME-ONLY

,OUTPUT = *SYSOUT (...) / *SYSLST(...)

*SYSOUT (...) / *SYSLST(...)

LAYOUT = *STD / *CSV

Operands

FILE-NAME = <filename 1..54>

File in the local system whose attributes are to be displayed. These attributes only apply to FTAM partners wishing to use FTAM functionality to transfer files.
The same access rules apply as for the SHOW-FILE-ATTRIBUTES command in BS2000. If the file name is specified with an unattached Public Volume Set, the request is rejected with the error message FTR0020.

INFORMATION =

Amount of information required. Only those attributes available for file transfer and file management requests are displayed.

INFORMATION = *STD
The default range of information is to be output.

INFORMATION = *ALL-ATTRIBUTES
All available information is output to the file.

INFORMATION = *NAME-ONLY
Only the file name is output.

OUTPUT = * SYSOUT(...)
Output is to SYSOUT.

OUTPUT = *SYSLST(...)
Output is to SYSLST.

LAYOUT = *STD
Output is put into a user-friendly form for reading.

LAYOUT = *CSV
Output occurs in Character Separated Values format. This is a special, tabular format, widely used in the PC world, in which the individual fields are separated by a semicolon “;” (see section “SHOW-REMOTE-FILE-ATTRIBUTES/ SHOW-FILE-FT-
ATTRIBUTES”).

Command return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
20	64	FTR0020	The command was not executed. Send file unknown.
33	32	CMD0221	Request rejected. Internal error.
36	32	CMD0221	Request rejected. Request data inconsistent.
83	32	CMD0221	Internal error.
170	64	FTR2170	Request rejected. Remote system: Function not supported.
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes”.

OPS variables

The following table shows the OPS variables of the command SHOW-FILE-FT-
ATTRIBUTES with the operand INF=*ALL-ATTRIBUTES, the underlined values are valid for the output with the operand INF=*STD. For the operand input INF=*NAMES-ONLY only the element F-NAME (String) is output.

Element	Type	Output
F-NAME	String
STOR-ACCOUNT	String
CRE	Struct
.USER	String
.DATE	String	yyyy-mm-dd
.TIME	String	hh:mm:ss
MODIFY	Struct
.USER	String
.DATE	String	yyyy-mm-dd
.TIME	String	hh:mm:ss
READ	Struct
.USER	String
.DATE	String	yyyy-mm-dd
.TIME	String	hh:mm:ss
MOD-ATTR	Struct
.USER	String
.DATE	String	yyyy-mm-dd
.TIME	String	hh:mm:ss
DATA-TYPE	String	*CHAR / *BINARY / *DIR / *NO-INFO
CHAR-SET 1	String	*GRAPHIC / *GENERAL / *IA5 / *VISIBLE
REC-FORM	String	*VAR / *FIXED / *UNDEF
REC-SIZE	Integer
F-AVAIL	String	*IMMED / *DEFERRED
ACCESS-RIGHTS	Struct
.READ-F	String	*YES / *NO
.INS-DATA-UNIT	String	*YES / *NO
.REPLACE-F	String	*YES / *NO
.EXTEND-F	String	*YES / *NO
.ERASE-DATA-UNIT	String	*YES / *NO
.READ-ATTR	String	*YES / *NO
.MOD-ATTR	String	*YES / *NO
.DEL-F	String	*YES / *NO
.TRAVERSAL	String	*YES / *NO
.REV-TRAVERSAL	String	*YES / *NO
.RANDOM	String	*YES / *NO
F-SIZE	Integer
MAX-F-SIZE	Integer
LEGAL-QUALIFICATION	String
CCS-NAME	String	Value

¹The element CHAR-SET is only assigned if DATA-TYPE=*CHARS.

Examples

1. You wish to output detailed information on the FTAM attributes of the LOCFILE on the local BS2000 system.

   /SHOW-FILE-FT-ATTRIBUTES FILE-NAME = LOCFILE

   %*r-pxeacd--- MAIER 1234567890 Apr 30 11:55 LOCFILE

   Short form:

   /SH-FI-FT LOCFILE

2. You wish to output detailed information on the FTAM attributes of the LOCFILE on the local BS2000 system.

   /SHOW-FILE-FT-ATTRIBUTES FILE-NAME=LOCFILE,INFORMATION=*ALL-ATTRIBUTES
   %FILENAME=LOCFILE
   %CRE   MAIER DATE=Nov 19 11:55
   %MOD   DATE=Apr 28 15:54
   %REA   DATE=Apr 30 09:01
   %RECORD-FORMAT=v
   %ACCESS=RIGHTS=r-pxeacd---   FILESIZE=123456
   

   Short form:

   /SH-FI-FT-AT LOCFILE,*A