openFT V12.1C (de)

&pagelevel(4)&pagelevel

Lange Ausgabeform Outbound (Beispiel, openFT <= V12.1C00)

%LOGGING-ID = 38735 RC = 0000 TIME = 2016-07-11 13:58:21

% TRANS = TO REC-TYPE= FT FUNCTION = TRANSFER-FILE
% PROFILE = PCMD = NONE STARTTIME= 2016-07-11 13:58:21

% TRANS-ID = 721206 WRITE = REPLACE REQUESTED= 2016-07-11 13:58:21

% TRANSFER = 10 kB CCS-NAME =
% SEC-OPTS = ENCR+DICHK, RSA-1024 / AES-256

% INITIATOR= TSOS INITSN = 83VV

% USER-ADM = TSOS
% PARTNER = LINUX01

% FILENAME = $USER1.FILE.TEST

% FNC-MODE = *TRANSPARENT

%LOGGING-ID = 38734 RC = 0000 TIME = 2016-07-11 13:58:21

% TRANS = TO REC-TYPE= FTAC FUNCTION = TRANSFER-FILE

% PROFILE = PRIV =

% INITIATOR= TSOS INITSN = 83VV
% USER-ADM = TSOS

% PARTNER = LINUX01

% FILENAME = $USER1.FILE.TEST

Lange Ausgabeform Outbound (Beispiel, openFT >= V12.1C10)

%LOGGING-ID = 113 RC = 0000 TIME = 2021-02-02 17:18:53

% TRANS = TO REC-TYPE= FT FUNCTION = TRANSFER-FILE

% PROFILE = PCMD = NONE STARTTIME= 2021-02-02 17:18:53

% TRANS-ID = 86017 WRITE = REPLACE REQUESTED= 2021-02-02 17:18:52

% TRANSFER = 32 kB CCS-NAME =

% INITIATOR= TSOS INITSN = 0AEJ

% USER-ADM = TSOS

% PARTNER = LOCSIN

% FILENAME = $USER1.LOCAL-FILE

% FNC-MODE = *TRANSPARENT

% REMOTE-FN= $USER1.REMOTE-FILE

Lange Ausgabeform Inbound (Beispiel)

LOGGING-ID = 38733 RC = 0000 TIME = 2016-07-11 13:49:44

% TRANS = FROM REC-TYPE= FT FUNCTION = TRANSFER-FILE

% PROFILE = PCMD = NONE STARTTIME= 2016-07-11 13:49:44
% TRANS-ID = 721204 WRITE = REPLACE STORETIME= 2016-07-11 13:49:44

% TRANSFER = 1 kB CCS-NAME =

% CHG-DATE = SAME
% SEC-OPTS = ENCR+DICHK+DENCR+DDICHK, RSA-1024 / AES-256

% INITIATOR= *REMOTE GLOB-ID = 66277

% USER-ADM = USER1
% PARTNER = LINUX01

% PTNR-ADDR= LINUX01

% FILENAME = TEST1
% FNC-MODE = *CHAR, FNCCS=iso88591

LOGGING-ID = 38732 RC = 0000 TIME = 2016-07-11 13:49:44

% TRANS = FROM REC-TYPE= FTAC FUNCTION = TRANSFER-FILE
% PROFILE = PROF1 PRIV = NO

% INITIATOR= *REMOTE GLOB-ID = 66277

% USER-ADM = USER1
% PARTNER = LINUX01

% PTNR-ADDR= LINUX01

% FILENAME = TEST1

Lange Ausgabeform eines ADM-Logging-Satzes (Beispiel)

LOGGING-ID = 45067 RC = 0000 TIME = 2016-08-29 09:43:57

TRANS = TO REC-TYPE= ADM FUNCTION = REM-ADMIN
TRANS-ID = 156730 PROFILE = Profil04

SEC-OPTS = ENCR+DICHK, RSA-2048 / AES-256

INITIATOR= *REMOTE GLOB-ID = 192929
USER-ADM = FTADMIN8

PARTNER = REMADMIN

ADM-CMD = SHOW-FT-LOGGING-RECORDS
ADMIN-ID =

ROUTING =

Erläuterung der Langform (spaltenweise)

Nachfolgend sind auch Felder und Werte beschreiben, die nur bei ADM-Logging-Sätzen auftreten können.

Bezeichnung	Erläuterung
LOGGING-ID	maximal zwölfstellige Nummer des Logging-Satzes
TRANS	Übertragungsrichtung:
	TO	Die Auftragsrichtung ist zum Partnersystem. Diese Richtung wird angegeben bei einem Sendeauftrag, d.h. die Daten werden zum Partner übertragen Auftrag zum Ansehen von fernen Dateiattributen Auftrag zum Ansehen von fernen Dateiverzeichnissen
	FROM	Die Auftragsrichtung ist zum lokalen System. Diese Richtung wird angegeben bei einem Empfangsauftrag, d.h. die Daten werden zum lokalen System übertragen Auftrag zum Ändern von fernen Dateiattributen¹ Auftrag zum Löschen von fernen Dateien
	BOTH	Filemanagement-Auftrag mit bidirektionaler Datenübertragung
PROFILE	Name des Profils, das für die Übertragung verwendet wurde (im FT-Logging-Satz leer)
TRANS-ID	Auftragsnummer
TRANSFER	Menge der übertragenen Daten
PROTECT	Gibt an, ob die Schutzattribute übertragen wurden. Wird nur ausgegeben, wenn diese Option im Übertragungsauftrag angegeben wurde
	SAME	Die Schutzattribute der Datei wurden mit übertragen.
SEC-OPTS	Sicherheitsoptionen und verwendete Verschlüsselungsalgorithmen. Diese Zeile wird nur ausgegeben, wenn mindestens eine der Optionen genutzt wurde.
	ENCR	Verschlüsselung der Auftragsbeschreibung
	DICHK	Datenintegritätsprüfung der Auftragsbeschreibung
	DENCR	Verschlüsselung des Dateiinhalts während der Übertragung
	DDICHK	Datenintegritätsprüfung der übertragenen Dateidaten
	LAUTH	Authentifizierung des lokalen Systems beim Partner (Authentifizierungsstufe 1)
	LAUTH2	Authentifizierung des lokalen Systems beim Partner (Authentifizierungsstufe 2)
	RAUTH	Authentifizierung des Partners im lokalen System (Authentifizierungsstufe 1)
	RAUTH2	Authentifizierung des Partners im lokalen System (Authentifizierungsstufe 2)
	RSA-nnnn	Länge des RSA-Schlüssels
	DES / AES-128 / AES-256	Verwendeter Verschlüsselungsalgorithmus
INITIATOR	Initiator (User-Id) bei lokal gestellten Aufträgen; bei Initiative im fernen System: *REMOTE
USER-ADM	Benutzerkennung, auf die sich die Aufträge im lokalen System beziehen
PARTNER	informiert über das beteiligte Partnersystem. Ausgegeben wird der symbolische Name, mit dem der Systemverwalter das Partnersystem in der Partnerliste eingetragen hat. Sind dynamische Partner zugelassen, kann das Partnersystem auch als Partneradresse ausgegeben werden.
PTNR-ADDR	Adresse des Partnersystems, wird nur bei Inbound-FTP-Aufträgen ausgegeben. Bei Aufträgen über das openFT- oder FTAM-Protokoll wird der BCAM Prozessorname des Partners ausgegeben.
FILENAME	Dateiname bzw. Vor- oder Nachverarbeitung im lokalen System. Handelt es sich bei der Datei um ein Bibliothekselement, so hat die Ausgabe das Format <Bibliotheksname>/<Typ>/<Elementname>[(<Version>)].
FNC-MODE	Codierungsmodus für Dateinamen und Folgeverarbeitung:
	*TRANSPARENT	Dateinamen und Folgeverarbeitung werden in einer festen binären Codierung unabhängig von lokal eingestellten Zeichensatz dargestellt (transparenter Modus).
	*CHAR, FNCCS=ccs	Dateinamen und Folgeverarbeitung werden in ihrer Zeichendarstellung dargestellt (Zeichenmodus). ccs gibt den Zeichensatz an, der für die Erstellung des FT- Auftrags relevant war, z.B. iso88591 auf Unix- Systemen.
ADM-CMD	wird nur beim ADM-Logging-Satz ausgegeben: Administrationskommando ohne Parameter
ADMIN-ID	wird nur beim ADM-Logging-Satz ausgegeben: im BS2000 immer leer, da nur auf einem Fernadministrations-Server relevant
ROUTING	wird nur beim ADM-Logging-Satz ausgegeben: Routing-Information der zu administrierenden openFT-Instanz
RC	Reason-Code. Er gibt an, ob ein Auftrag erfolgreich ausgeführt oder warum er abgelehnt bzw. abgebrochen wurde. Wenn ein FT-Auftrag aus „FTAC-Gründen“ (z.B. 2169) abgelehnt wurde, können Sie den genauen Grund für den Abbruch nur dem FTAC- Logging-Satz des ablehnenden Systems entnehmen. Weitere Information zum Reason-Code können Sie mit dem BS2000-Kommando HELP-MSG- INFORMATION (FTCxxxx für Typ FTAC bzw. FTRxxxx für Typ FT) abfragen.
REC-TYPE	Angabe, ob es sich um einen FT-, FTAC- oder ADM-Logging-Satz handelt.
PCMD	Status der Folgeverarbeitung:
	NONE	Es war keine Folgeverarbeitung angegeben.
	STARTED	Eine Folgeverarbeitung wurde gestartet.
	NOT-STARTED	Eine Folgeverarbeitung konnte nicht gestartet werden.
PRIV	Gibt an, ob das benutzte Berechtigungsprofil privilegiert ist
WRITE	Schreibregel.
	NEW	Die Datei wird neu angelegt. Gibt es schon eine Datei mit diesem Namen, wird die Übertragung abgebrochen.
	EXT	Eine existierende Datei wird erweitert, sonst wird sie neu angelegt
	REPLACE	Eine existierende Datei wird erweitert
TIME	Zeitpunkt, wann der Logging-Satz geschrieben wurde
FUNCTION	Definition der FT-Funktion:
	TRANSFER-FILE: Datei übertragen MOVE-FILE: Datei übertragen mit Löschen der Sendedatei (nur Inbound) READ-FILE-ATTRIBUTES: Dateiattribute lesen DELETE-FILE: Datei löschen CREATE-FILE: neue Datei erzeugen MODIFY-FILE-ATTRIBUTES: Dateiattribute ändern READ-DIRECTORY: Dateiverzeichnis lesen CREATE-DIRECTORY: Dateiverzeichnis einrichten MODIFY-DIRECTORY: Dateiverzeichnis ändern DELETE-DIRECTORY: Dateiverzeichnis löschen LOGIN: inbound FTP-Zugang REM-ADMIN: Fernadministration
STARTTIME	Zeitpunkt des Auftragsbeginns
STORETIME	Zeitpunkt der Auftragsannahme (inbound)
REQUESTED	Zeitpunkt der Auftragsannahme (outbound)
CCS-NAME	Name des Zeichensatzes, der ggf. für die Umcodierung verwendet wird.
CHG-DATE	gibt an, ob das Änderungsdatum der Sendedatei für die Empfangsdatei übernommen wird.
	SAME	Das Änderungsdatum der Sendedatei wird übernommen.
INITSN	TSN, von der aus der Auftrag erteilt wurde, wird nur bei Outbound-Aufträgen eingetragen.
GLOB-ID	globale Auftrags-Identifikation, wird nur bei Inbound-Aufträgen von openFT- Partnern angezeigt (INITIATOR=REMOTE). Sie stimmt mit der Auftrags- Identifikation (=TRANSFER-ID) auf der Initiator-Seite überein.
REMOTE-FN	Ab openFT V12.1C10: Dateiname im entfernten System (outbound). Wenn die Datei ein Bibliothekselement ist, erfolgt die Ausgabe im Format <Bibliotheksname>/<Typ>/<Elementname>[(<Version>)].

¹Beim Ändern der Zugriffsrechte einer Datei von einem FTAM-Partnersystem aus werden zwei Logging-Sätze geschrieben. Hierbei wird vor der PARTNER-Angabe keine Richtung ausgegeben.

Beispiele

Der FT-Verwalter will sich alle Logging-Sätze der Benutzerkennung Meier ansehen, die zwischen dem 01.09. 2016 und 31.12.2016 protokolliert wurden. Wenn Sie Eigentümer der Benutzerkennung Meier sind, dann können Sie den Operanden OWNER-IDENTIFICATION= weglassen.

/SHOW-FT-LOGGING-RECORDS SELECT=*PARAMETERS(OWNER-IDENTIFICATION=Meier, -

/ CREATION-TIME=*INTERVAL(FROM=2016-09-01(00:00), -

/ TO=2016-12-31(23:59))),NUMBER=*ALL

Den ersten Satz der Ausgabe wollen Sie ausführlich sehen.

/SHOW-FT-LOG-REC (OWN=Meier,CRE-TIME=*INTERVAL(FROM=2016-09-01(00:00), -

/ TO=2016-12-31(00:00))),INF=*ALL

Der (FT- oder FTAC-) Verwalter will sich alle Logging-Sätze ausgeben lassen. Er wünscht eine Ausgabe aller Informationen in möglichst kompakter Form, weil er die Logging-Sätze vor dem Löschen sichern möchte. Daher wählt er die Kombination "ausführliche Form der Ausgabe" und "Ausgabe im CSV-Format". Das erreicht er mit dem folgenden Kommando:
/SHOW-FT-LOG-REC SELECT=*ALL,NUMBER=*ALL,INF=*ALL,OUTPUT=*SYSLST(*CSV)
Für die Ausgabe umfangreicher Informationen kann dieses Kommando mehrere Minuten benötigen.
Der FT- oder FTAC-Verwalter möchte sich die Namen der aktuellen Logging-Datei sowie der Offline-Logging-Dateien ausgeben lassen:
/SHOW-FT-LOG-REC INF=*LOGGING-FILES
% $SYSFJAM.SYSLOG.L120806.L132626
% $SYSFJAM.SYSLOG.L120806.L132615

Der openFT-Administrator möchte alle Protokollierungssätze anzeigen, die für den Dateinamen REMOTE-FILE erstellt wurden. In der Kurzausgabe wird nur der Name der lokalen Datei angezeigt.

/SHOW-FT-LOGGING-RECORDS SELECT=*PARAMETERS(FILE-NAME=REMOTE-FILE, -

/ ),NUMBER=*ALL

%TYP LOGG-ID TIME RC PARTNER INITIATOR INIT USER-ADM FILENAME

%2021-03-19

%T 113 17:18:53 0000 >LOCSIN TSOS 0AEJ TSOS $USER1.LOCAL-FILE

Um den entfernten Dateinamen zu sehen, muss das lange Ausgabeformat verwendet werden: