SHOW-FILE-FT-ATTRIBUTES

Einsatzhinweis

Funktion: Lokale Dateiattribute anzeigen

Benutzergruppe: FT-Benutzer

Aliasname: FTSHWF

Das Kommando ist nur bei Nutzung der FTAM-Funktionalität sinnvoll.

Funktionsbeschreibung

Mit dem Kommando SHOW-FILE-FT-ATTRIBUTES können Sie sich die FTAM-Attribute einer Datei im lokalen System anzeigen lassen. Damit können Sie feststellen, mit welchen Werten die Dateiattribute für Dateiübertragungs- und Dateimanagement-Aufträge für FTAM-Partner zur Verfügung stehen.

Für die Ausgabe der Attribute können Sie drei Varianten wählen:

• den Namen der Datei anzeigen

• eine Standardauswahl anzeigen

• alle Attribute der Datei anzeigen

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

Beschreibung der Operanden

FILE-NAME = <filename 1..54>

Name der Datei im lokalen System, deren Attribute angezeigt werden sollen. Die Attribute gelten nur für Partner, die mit Nutzung der FTAM-Funktionalität Dateien übertragen wollen. Bezüglich der Dateizugriffsrechte gilt die gleiche Regelung wie beim BS2000-Kommando SHOW-FILE-ATTRIBUTES.

Wird der Dateiname mit einem nicht eingehängten Public Volume Set angegeben, dann wird der Auftrag mit der Fehlermeldung FTR0020 abgelehnt.

INFORMATION =
Umfang der gewünschten Information. Es werden nur die Attribute angezeigt, die für Dateiübertragungs- und Dateimanagement-Aufträge zur Verfügung stehen.

INFORMATION = *STD
Gibt einen Standardumfang an Information aus.

INFORMATION = *ALL-ATTRIBUTES
Gibt alle verfügbaren Informationen zur Datei aus.

INFORMATION = *NAME-ONLY
Gibt nur den Namen der Datei aus.

OUTPUT = * SYSOUT(...)
Die Ausgabe erfolgt auf SYSOUT.

OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt auf SYSLST.

LAYOUT = *STD
Die Ausgabe wird in eine vom Anwender leicht lesbare Form gebracht.

LAYOUT = *CSV
Die Ausgabe erfolgt im Character Separated Values Format. Dies ist ein speziell im PC Umfeld weit verbreitetes, tabellenartiges Format, bei dem die einzelnen Felder durch das Separatorenzeichen Semikolon “;“ getrennt sind (siehe "SHOW-REMOTE-FILE-ATTRIBUTES SHOW-FILE-FT-ATTRIBUTES").

Kommando-Returncodes

(SC2)      SC1	Maincode	Bedeutung / garantierte Meldungen
20      64	FTR0020	Kommando wurde nicht ausgeführt. Sendedatei unbekannt.
33      32	CMD0221	Auftrag abgewiesen. Interner Fehler.
36      32	CMD0221	Auftrag abgewiesen. Inkonsistente Auftragsdaten.
83      32	CMD0221	Interner Fehler.
170      64	FTR2170	Auftrag abgewiesen. Fernes System: Funktion nicht unterstützt.

SC1/2 = Subcode 1/2 in Dezimal-Darstellung
Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“.

OPS-Variablen

Die folgende Tabelle zeigt die OPS-Variablen des Kommandos SHOW-FILE-FT-ATTRIBUTES mit dem Operanden INF=*ALL-ATTRIBUTES, die unterstrichenen Werte gelten für die Ausgabe mit dem Operanden INF=*STD. Bei der Operandeneingabe INF=*NAMES-ONLY wird nur das Element F-NAME (String) ausgegeben.

Element	Typ	Ausgabe
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	Wert

¹Das Element CHAR-SET wird nur versorgt, wenn DATA-TYPE=*CHARS ist.

Beispiel:

1. Sie wollen sich die Standardausgabe zur Datei LOKDATEI auf dem lokalen BS2000-Rechner ausgeben lassen.

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

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

   Kurzform:

   /SH-FI-FT LOKDATEI

2. Sie wollen umfassende Information zu den FTAM-Attributen der Datei LOKDATEI auf dem lokalen BS2000-Rechner.

   /SHOW-FILE-FT-ATTRIBUTES FILE-NAME=LOKDATEI,INFORMATION=*ALL-ATTRIBUTES
   %FILENAME=LOKDATEI
   %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
   

   Kurzform:

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