DECFILE - Verschlüsselte Datei in unverschlüsselte Datei umwandeln

Makrotyp: S-Typ (E-Form/M-Form/L-Form/C-Form/D-Form) (siehe "Typen von Makroaufrufen")

Der DECFILE-Makroaufruf wandelt eine verschlüsselte Datei in eine unverschlüsselte Datei um (siehe Makro ENCFILE auf "ENCFILE - Unverschlüsselte Datei in verschlüsselte Datei umwandeln").

Nach DECFILE sind alle Verschlüsselungsmerkmale (Verfahren und Kontrollstring für Crypto-Kennwort) im Katalogeintrag gelöscht.

Dateigenerationen

DECFILE kann nicht für einzelne Dateigenerationen angewendet werden, sondern nur für komplette Dateigenerationsgruppen. Innerhalb einer Dateigenerationsgruppe haben alle Generationen mit der Ausnahme von Bandgenerationen die gleichen Verschlüsselungsmerkmale wie der Gruppeneintrag.

Format

Operation	Operanden
DECFILE	,PATHNAM = <c-string 1..54: filename 1..54> / <var: char:54> ,EQUATES = YES / NO MF = L
	MF = D,PREFIX = D / <pre>
	MF = E,PARAM = <name 1..27>
	MF = C / M ,PREFIX = D / <pre> ,MACID = MAE / <macid>

Operandenbeschreibung

PATHNAM

Gibt die Datei an, die entschlüsselt werden soll. Das Crypto-Kennwort der Datei muss in der Crypto-Kennworttabelle der aufrufenden Task stehen.

=<c-string 1..54: filename 1..54>
Pfadname der Datei.

=<var: char:54>
Nur mit MF=M möglich:
Symbolische Adresse eines Speicherbereichs von 54 Byte, in dem der Pfadname der Datei abgelegt ist.

EQUATES

Gibt an, ob bei der Expansion des Parameterbereichs auch Equates für die Werte der Felder des Parameterbereichs generiert werden sollen.

= YES
Bei der Expansion des Parameterbereichs werden auch Equates für die Werte der Felder des Parameterbereichs generiert.

= NO
Bei der Expansion des Parameterbereichs werden keine Equates für die Werte der Felder des Parameterbereichs generiert.

Beispiel

:
MVC DECFMFC(YMAD#),DECFMFL
DECFILE MF=M,PREFIX=Y,PATHNAM='UMSATZ.3.QUARTAL.2004'
DECFILE MF=E,PARAM=DECFMFC
:
DECFMFC DECFILE MF=C,PREFIX=Y
DECFMFL DECFILE MF=L
:

Hinweise zur Programmierung

1. Alle RESERVED-Felder des Parameterbereichs müssen mit binären Nullen gelöscht sein.

2. Bei allen Änderungen im Parameterbereich, die nicht mithilfe von Makroaufrufen vorgenommen werden, ist der Aufrufer selbst für die Konsistenz des Parameterbereichs verantwortlich.

3. Beim nichtprivilegierten Aufruf (Funktionszustand TU) zeigt Register 1 auf den Parameterbereich.

4. Für die im Parameterbereich stehenden Namen erfolgt während der Funktionsausführung keine Umwandlung von Klein- in Großbuchstaben. Dagegen kann bei der Makro-Expansion je nach Compiler-Einstellung eine Umwandlung von Klein- in Großbuchstaben erfolgen.

Hinweise zur Funktionsausführung

• Dateisperren und Dateischutzattribute, die den Schreibzugriff auf den Katalogeintrag oder auf den Inhalt einer Datei verbieten, verhindern damit auch das Umwandeln der Datei mit DECFILE.

• Das Umwandeln einer Datei mit DECFILE erfordert das Eigentumsrecht der aufrufenden Task an der Datei. Die Umwandlung erfolgt also, wenn:

  • Die Datei unter der Benutzerkennung der aufrufenden Task liegt.

  • Die aufrufende Task unter einer Benutzerkennung mit dem Privileg TSOS läuft.

  • Die Benutzerkennung der aufrufenden Task Mit-Eigentümer der Datei und die Datei nicht temporär ist.

• Zusätzliche Funktionen für Tasks mit Privileg TSOS:
  Wenn die aufrufende Task das Privileg TSOS hat, sind zusätzlich folgende Funktionen möglich:

  • Es können auch temporäre Dateien, die nicht zur aufrufenden Task, sondern zu einer anderen Task gehören, angegeben werden.

  • Es können auch temporäre Dateien auf einem anderen Pubset als dem Default-Pubset der Benutzerkennung angegeben werden. (Diese werden bei Beendigung der aufrufenden Task nicht automatisch gelöscht.)

• Die Umwandlung der verschlüsselten Datei wird mit SAT protokolliert.
  Das hierbei ausgegebene AUDIT-Attribut wird dem Katalogeintrag der umzuwandelnden Datei entnommen (siehe Kommando CREATE-FILE, Operand AUDIT, im Handbuch „Kommandos“ [3]).

• RFA:
  DECFILE wird abgewiesen, wenn auf die umzuwandelnde Datei nur über RFA zugegriffen werden kann.

• Hilfsdatei:
  Beim Umwandeln mit DECFILE wird eine Hilfsdatei angelegt und bei Beendigung der Funktionsausführung automatisch gelöscht. In die Hilfsdatei wird der umgewandelte Dateiinhalt geschrieben. Die Hilfsdatei benötigt ebenso viel Plattenspeicherplatz wie die umzuwandelnde Datei.
  Der Dateiname der Hilfsdatei hat folgenden Aufbau:

  S.DMS.<tsn>.<date><time>.CRYPTO

Returncodes

Der Returncode wird im Standardheader der Parameterliste zurückgeliefert. Der Standardheader darf nicht im Read-only-Bereich liegen, sonst erfolgt Programmterminierung.

Standardheader: ccbbaaaa

Über die Ausführung des Makros DECFILE wird im Standardheader folgender Returncode übergeben (cc = SUBCODE2, bb = SUBCODE1, aaaa = MAINCODE):

X'cc'	X'bb'	X'aaaa'	Erläuterung
X'00'	X'00'	X'0000'	Kein Fehler
	X'01'	X'0554'	Format des Dateinamens unzulässig
	X'01'	X'0576'	a) Fehlerhafte Operandenkombination b) Nicht gelöschte UNUSED-Felder
	X'20'	X'0578'	Interner Fehler bei Überprüfung der Zugriffsrechte
	X'82'	X'0594'	Nicht genügend virtueller Speicher verfügbar
	X'20'	X'05C7'	Interner Fehler im DVS
	X'01'	X'05CB'	Fehlerhafter/unerlaubter erster Dateiname
	X'40'	X'05CF'	Kennwort nicht in Kennworttabelle
	X'40'	X'05FD'	Datei ist schreibgeschützt
	X'40'	X'0609'	Aktion für Systemdatei nicht erlaubt
	X'40'	X'0666'	Dateischutz verhindert Zugriff
X'01'	X'00'	X'066B'	Datei ist bereits entschlüsselt
X'00'	X'00'	X'066E'	Hilfsdatei verwenden
	X'01'	X'FFFF'	Falsche Funktionsnummer im Standardheader
	X'03'	X'FFFF'	Falsche Versionsnummer im Standardheader