Beispiel 2: Default-Wert ändern

Standardmäßig wird beim Anlegen einer neuen Datei mit dem Kommando CREATE-FILE vereinbart, dass von fremden Benutzerkennungen auf die Datei nicht zugegriffen werden darf (USER-ACCESS = OWNER-ONLY). Für Dateien, die unter der Benutzerkennung EXAMPLE eingerichtet werden, soll aber standardmäßig der Zugriff von fremden Benutzerkennungen möglich sein.

Das lässt sich dadurch erreichen, dass für die Benutzerkennung EXAMPLE eine Benutzersyntaxdatei eingerichtet wird, in der das Kommando CREATE-FILE entsprechend verändert wird.

Hinweis

Default-Werte können auch sehr flexibel (d.h. ohne Modifizierung von Syntaxdateien) als task-spezifische Default-Werte definiert werden. Task-spezifische Default-Werte werden jedoch nur bei der Eingabe im interaktiven Dialog ausgewertet. Für das nachfolgende Beispiel könnte der Default-Wert auch task-spezifisch vereinbart werden:

/!create-file user-access=*all-users

Weitere Einzelheiten zu task-spezifischen Default-Werten siehe Handbuch „Einführung in die Dialogschnittstelle“ [1].

/set-logon-parameters example,... —————————————————————————————————————  (1)
 .
 .
/create-file demo.1 ———————————————————————————————————————————————————  (2)
/show-f-attr demo.1,inf=*par(security=*yes) ———————————————————————————  (3)
%0000000003 :2OSG:$EXAMPLE.DEMO.1

%  ------------------------------- SECURITY     -----------------------------
%  READ-PASS  = NONE        WRITE-PASS = NONE        EXEC-PASS  = NONE
%  USER-ACC   = OWNER-ONLY  ACCESS     = WRITE       ACL        = NO
%  AUDIT      = NONE        FREE-DEL-D = *NONE       EXPIR-DATE = NONE
%  DESTROY    = NO         FREE-DEL-T = *NONE       EXPIR-TIME = NONE
%  SP-REL-LOCK= NO
%:2OSG: PUBLIC:      1 FILE  RES=         3 FRE=        3 REL=        3 PAGES
 .
 .
/start-sdf-a ——————————————————————————————————————————————————————————  (4)
%  BLS0517 MODULE 'SDAMAIN' LOADED
%  SDA0001 'SDF-A' VERSION '04.1E10' STARTED
//open-syntax-file sdf.user.syntax,,*crea —————————————————————————————  (5)

                                                                                       

(1)	Unter der Benutzerkennung EXAMPLE wird eine Task gestartet.
(2)	Mit dem Kommando CREATE-FILE wird ein Benutzerkatalogeintrag für die Datei DEMO.1 eingerichtet.
(3)	Die Schutzmerkmale der Datei DEMO.1 werden ausgegeben. Sie ist nicht mehrbenutzbar (USER-ACC = OWNER-ONLY).
(4)	SDF-A wird geladen und gestartet.
(5)	Die Benutzersyntaxdatei SDF.USER.SYNTAX wird eröffnet und dabei neu angelegt. Wenn eine unter der Benutzerkennung EXAMPLE katalogisierte Benutzersyntaxdatei diesen Namen hat, wird sie für Tasks der Benutzerkennung EXAMPLE bei der LOGON-Verarbeitung automatisch aktiviert. Standardmäßig sind die aktivierte Systemsyntaxdatei und die aktivierte Gruppensyntaxdatei als Referenzdateien zugewiesen. Kommandodefinitionen, die in den Referenzdateien stehen, können in der eröffneten Benutzersyntaxdatei verändert werden.

//show *oper(prot,orig=*com(create-file)),siz=*max ————————————————————  (6)
PROTECTION = *STD

     *STD or *PARAMETERS()
     Specifies the protection attributes of the file
     STRUCTURE: *PARAMETERS
          PROTECTION-ATTR = *BY-DEF-PROT-OR-STD
            .
            .
            .
          USER-ACCESS = *BY-PROTECTION-ATTR
              *BY-PROTECTION-ATTR or *OWNER-ONLY or *ALL-USERS or
               *SPECIAL
              Specifies whether external user IDs may access the file
          BASIC-ACL = *BY-PROTECTION-ATTR
            .
            .
            .
//edit *oper(prot,orig=*com(create-file)) —————————————————————————————  (7)
//mod-oper def='PARAMETERS' ———————————————————————————————————————————  (8)
//edit *oper(user-acc) ————————————————————————————————————————————————  (9)
//mod-oper def='ALL-USERS' ———————————————————————————————————————————— (10)

                                                                                       

(6)	Der Operand PROTECTION des Kommandos CREATE-FILE wird in der ausführlichsten Form ausgegeben.
(7)	Es wird auf den Operanden PROTECTION des Kommandos CREATE-FILE positioniert, d.h. der Operand PROTECTION wird aktuelles Objekt der bearbeiteten Benutzersyntaxdatei SDF.USER.SYNTAX.
(8)	Der Operand, der aktuelles Objekt ist (PROTECTION), soll PARAMETERS als Default-Wert haben. Diese Änderung ist erforderlich, damit die folgende Änderung (siehe Arbeitsschritt 9 und 10) auch dann wirksam wird, wenn der struktureinleitende Wert PARAMETERS nicht explizit angegeben wird. Der Wert *STD enthält implizit die Festlegung USER-ACCESS=*BY-PROTECTION-ATTR (entspricht USER-ACCESS= *OWNER-ONLY, wenn mit SECOS keine andere Default-Protection vereinbart ist).
(9)	Es wird auf den Operanden USER-ACCESS des gerade bearbeiteten Kommandos CREATE-FILE positioniert, d.h. dieser Operand wird aktuelles Objekt der eröffneten Benutzersyntaxdatei SDF.USER.SYNTAX.
(10)	Der Operand, der aktuelles Objekt ist (USER-ACCESS), soll ALL-USERS als Default-Wert haben.

//show *oper(prot,orig=*com(create-file)),siz=*max ———————————————————— (11)
PROTECTION = *STD

     *STD or *PARAMETERS()
     Specifies the protection attributes of the file
     STRUCTURE: *PARAMETERS
          PROTECTION-ATTR = *BY-DEF-PROT-OR-STD
            .
            .
            .
          USER-ACCESS = *ALL-USERS
              *BY-PROTECTION-ATTR or *OWNER-ONLY or *ALL-USERS or
               *SPECIAL
              Specifies whether external user IDs may access the file
          BASIC-ACL = *BY-PROTECTION-ATTR
            .
            .
            .
//end
/mod-sdf-opt synt-file=*add(*std) ————————————————————————————————————— (12)
/create-file demo.2 ——————————————————————————————————————————————————— (13)
/show-f-attr demo.2,inf=*par(security=*yes) ——————————————————————————— (14)
%0000000003 :2OSG:$EXAMPLE.DEMO.2

%  ------------------------------- SECURITY     -----------------------------
%  READ-PASS  = NONE        WRITE-PASS = NONE        EXEC-PASS  = NONE
%  USER-ACC   = OWNER-ONLY  ACCESS     = WRITE       ACL        = NO
%  AUDIT      = NONE        FREE-DEL-D = *NONE       EXPIR-DATE = NONE
%  DESTROY    = NO         FREE-DEL-T = *NONE       EXPIR-TIME = NONE
%  SP-REL-LOCK= NO
%:2OSG: PUBLIC:      1 FILE  RES=         3 FRE=        3 REL=        3 PAGES
 .
 .
/exit-job

                                                                                       

(11)	Der Operand PROTECTION des gerade bearbeiteten Kommandos CREATE-FILE wird in der ausführlichsten Form ausgegeben.

(12)	Die Benutzersyntaxdatei $EXAMPLE.SDF.USER.SYNTAX wird aktiviert.
(13)	Mit dem Kommando CREATE-FILE wird ein Benutzerkatalogeintrag für die Datei DEMO.2 eingerichtet.
(14)	Die Schutzmerkmale der Datei DEMO.2 werden ausgegeben. Sie ist mehrbenutzbar (USER-ACC = ALL-USERS).