Einsatzhinweis
Funktion: Partnersysteme auflisten
Benutzergruppe: FTAC-Benutzer und FTAC-Verwalter
Voraussetzung für die Nutzung dieses Kommandos ist der Einsatz von openFT-AC.
Funktionsbeschreibung
Mit dem Kommando FTSHWRGE können Sie sich auflisten lassen, mit welchen Partnersystemen Sie per File Transfer kommunizieren können. Zusätzlich zum Namen des Partnersystems wird die Sicherheitsstufe ausgegeben, die der FT-Verwalter diesem System beim Eintrag in die Partnerliste zugeordnet hat. Um zu klären, welche Grundfunktionen Sie nutzen dürfen, müssen Sie sich zusätzlich mit dem Kommando FTSHWADS über die Vorgaben Ihres Berechtigungssatzes informieren.
Als FTAC-Verwalter können Sie sich mit FTSHWRGE alle Partnersysteme auflisten lassen, mit denen Ihr FT-System per File Transfer kommunizieren kann. Außerdem können Sie sich für jede beliebige Benutzerkennung des Systems anzeigen lassen, welche Partnersysteme von dieser Kennung aus erreicht werden können.
Format
FTSHWRGE |
USER-IDENTIFICATION = *OWN / <name 1..8> ,SELECT-PARAMETER = *ALL / *PARAMETERS(...) *PARAMETERS(...) PARTNER = *ALL / <text 1..200 with-low> ,OUTPUT = *STDERR (...) / *STDOUT(...) *STDERR (...) / *STDOUT(...) LAYOUT = *STD / *CSV |
Beschreibung der Operanden
USER-IDENTIFICATION =
Kennung, für welche die erreichbaren Partnersysteme aufgelistet werden.
USER-IDENTIFICATION = *OWN
Mit diesem Parameter erhält der FTAC-Benutzer alle Partnersysteme aufgelistet, mit denen er mindestens eine Grundfunktion nutzen darf.
Der FTAC-Verwalter erhält alle erreichbaren Partnersysteme aufgelistet.
USER-IDENTIFICATION = <name 1..8>
Als FTAC-Benutzer können Sie nur die eigene Benutzerkennung angeben, die Ausgabe entspricht der für *OWN.
Als FTAC-Verwalter können Sie sich für eine beliebige Benutzerkennung anzeigen lassen, welche Partnersysteme von dieser Kennung aus erreicht werden können.
SELECT-PARAMETER =
Legt Auswahlkriterien für die Partnersysteme fest.
SELECT-PARAMETER = *ALL
Informiert über alle erreichbaren Partnersysteme.
SELECT-PARAMETER = *PARAMETERS(PARTNER = <text 1..200 with-low>)Informiert über das angegebene Partnersystem. Sie können den Namen aus der Partnerliste oder die Adresse des Partnersystems angeben. Dabei erhalten Sie folgende Informationen:
Ob Sie überhaupt mit diesem Partnersystem kommunizieren dürfen
Welche Sicherheitsstufe dem Partnersystem zugeordnet wurde.
Näheres zu Partneradressen siehe Abschnitt „Partneradressen angeben“.
OUTPUT =
Ausgabemedium für die Liste der Partnersysteme.
OUTPUT = *STDERR (...)
Die Ausgabe erfolgt auf SYSTSPRT bzw. auf SYSERR, wenn dieser DDNAME definiert ist.
OUTPUT = *STDOUT(...)
Die Ausgabe erfolgt auf SYSPRINT.
LAYOUT = *STD
Bringt die Ausgabe in eine vom Anwender leicht lesbare Form.
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 Abschnitt FTSHWRGE).
Beispiel
Stefan Meier möchte sich über die Sicherheitsstufe des Rechners KAUFDACK informieren. Das geht mit dem folgenden Kommando:
FTSHWRGE SELECT-PARAMETER=(PARTNER-NAME=KAUFDACK)
Kurzform:
FTSHWRGE SEL=(KAUFDACK)
Er erhält folgende Ausgabe:
|
|
Die Spalte SECLEV enthält die Sicherheitsstufe des jeweiligen Partnersystems, dessen Name in der Spalte PARTNER-NAME aufscheint.
Hätte Stefan für SELECT-PARAMETER=*ALL angegeben (oder diesen Operanden ganz weggelassen), hätte er eine gleich aufgebaute, jedoch längere Liste aller erreichbaren Partnersysteme erhalten.