A - Seite 1 - -------------------------------------------------------------------- | README-Datei zu JV V15.1A (BS2000/OSD) | | Ausgabe: Januar 2012 | -------------------------------------------------------------------- Die vorliegende Datei enthaelt die bekannten Aenderungen zum Handbuch [1] JV V15.0A Jobvariablen Ausgabe Dezember 2010 Bestellnummer: U3616-J-Z125-10 Dieses Handbuch ist auch fuer JV V15.1A gueltig. Inhaltsverzeichnis ================== 1 Neue Funktionen ..................................... Seite 2 1.1 Neue Kommandos ..................................... Seite 2 2 Geaenderte Funktionen ............................... Seite 5 2.1 Aenderungen / Ergaenzungen in den Kommandos ........ Seite 5 2.2 Aenderungen / Ergaenzungen in den Makros ........... Seite 7 A - Seite 2 - 1 Neue Funktionen 1.1 Neue Kommandos * Neue EDIT-Kommandos fuer Jobvariablen. ======================================== Anforderung: Erstellung von EDIT-Kommandos analog zu MODIFY-Kommandos. Zur besseren Handhabung werden im gefuehrten Dialog die aktuell eingestellten Werte vorgegeben, die der Anwender sonst zunaechst durch SHOW-Kommandos selbst ermitteln muesste. * EDIT-JV-Kommando(SDF) ======================= Inhalt einer Jobvariablen aendern Gefuehrten Dialog fuer MODIFY-JV aktivieren Anwendungsbereich: JOB-VARIABLES Privilegierung: STD-PROCESSING HARDWARE-MAINTENANCE OPERATING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION Funktionsbeschreibung: Das Kommando aktiviert fuer das Kommando MODIFY-JV den gefuehrten Dialog. Soweit technisch moeglich und sinnvoll, werden dabei die vordefinierten Default-Werte der einzelnen Operanden durch Werte ersetzt, die fuer die angegebene Jobvariable aktuell gueltig sind. Format |--------------------------------------------------------------| | EDIT-JV Kurzname: EDJV | |--------------------------------------------------------------| | | | JV-NAME = | | , OUTPUT-FORMAT = *CHARACTER / *HEXADECIMAL | | ---------- | | , PASSWORD = *NONE / / / | | ----- | | | | | |--------------------------------------------------------------| Operandenbeschreibung JV-NAME = Name der Jobvariablen, fuer die ein gefuehrter Dialog eingeleitet werden soll. Die Operanden werden mit den speziell fuer diese Jobvariable gueltigen Werten versorgt. OUTPUT-FORMAT = Bestimmt die Ausgabeform. OUTPUT-FORMAT = *CHARACTER Ausgabe im Zeichenformat. OUTPUT-FORMAT = *HEXADECIMAL Ausgabe in sedezimaler Form. A - Seite 3 - PASSWORD = *NONE / / / Schreib- bzw. Lesekennwort der zu aendernden JV. Der Operand PASSWORD hat folgende Besonderheiten: - Im gefuehrten Dialog ist das Eingabefeld automatisch dunkel-gesteuert. - Das eingegebene Kennwort wird nicht protokolliert. Kommando-Returncode (SC2) SC1 Maincode Bedeutung 0 CMD0001 Kommando ohne Fehler ausgefuehrt Treten waehrend der Verarbeitung von S-Variablen Fehler auf, werden die entsprechenden SDF-P-Kommando-Returncodes zurueckgegeben. A - Seite 4 - * EDIT-JV-ATTRIBUTES-Kommando(SDF) ================================== JV-Merkmale aendern Gefuehrten Dialog fuer MODIFY-JV-ATTRIBUTES aktivieren Anwendungsbereich: JOB-VARIABLES Privilegierung: STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION Funktionsbeschreibung Das Kommando aktiviert fuer das Kommando MODIFY-JV-ATTRIBUTES den gefuehrten Dialog. Soweit technisch moeglich und sinnvoll, werden dabei die vordefinierten Default-Werte der einzelnen Operanden durch Werte ersetzt, die fuer die angegebene Jobvariable aktuell gueltig sind. Format |--------------------------------------------------------------| | EDIT-JV-ATTRIBUTES Kurzname: EDJVA | |--------------------------------------------------------------| | JV-NAME = | | | |--------------------------------------------------------------| Operandenbeschreibung JV-NAME = Name der Jobvariablen, fuer die ein gefuehrter Dialog eingeleitet werden soll. Die Operanden werden mit den speziell fuer diese Jobvariable gueltigen Werten versorgt. Kommando-Returncode (SC2) SC1 Maincode Bedeutung 0 CMD0001 Kommando ohne Fehler ausgefuehrt Zusaetzlich koennen alle Kommando-Returncodes der Kommandos MODIFY-JV-ATTRIBUTES und SHOW-JV-ATTRIBUTES zurueckgeliefert werden. Treten waehrend der Verarbeitung von S-Variablen Fehler auf, werden die entsprechenden SDF-P-Kommando-Returncodes zurueckgegeben. A - Seite 5 - 2 Geaenderte Funktionen 2.1 Aenderungen / Ergaenzungen in den Kommandos * DELETE-JV ============ Das Kommando DELETE-JV wird zum Loeschen von Jobvariablen verwendet. Die Auswahl der Jobvariablen erfolgte bisher nur ueber den Pfadnamen (Katalogkennung, Benutzerkennung und JV-Name), voll- oder teilqualifiziert, mit oder ohne Wildcards. Ab JV Version 15.1A kann die ueber den Pfadnamen getroffene Auswahl ueber die Selektionsoperanden weiter eingeschraenkt werden. Es werden nur diejenigen JV's ausgewaehlt, die die in den Selektionsoperanden beschriebenen Merkmale aufweisen. Wird ein Selektionsoperand nicht angegeben oder hat er den Wert ANY, erfolgt die Auswahl unabhaenig von dem entsprechenden Merkmal. Achtung! Um sicher zu gehen, dass auch die richtigen Jobvariablen mit der angegebenen Selektion geloescht werden ist es dringend ratsam zuerst ein SHOW-JV-ATTRIBUTES-Kommando mit der entprechenden Selektion abzusetzen. Das Loeschen von Jobvariablen kann nicht mehr rueckgaengig gemacht werden! |--------------------------------------------------------------| | DELETE-JV | |--------------------------------------------------------------| | | | . | | . | | . | | | | [,SELECT = *ALL | *BY-ATTRIBUTES ( | | ---- | | [,ACCESS = *ANY | *READ | *WRITE ] | | ---- | | [,USER-ACCESS = *ANY | *ALL-USERS | *OWNER-ONLY ] | | ---- | | [,PASSWORD = *ANY | *NONE | *READ-PASSWORD | | | ---- *WRITE-PASSWORD ] | | [,CREATION-DATE = *ANY | datum | (datum,datum) | | | ---- | | datum(TIME= *ANY | (zeit,zeit) | | | ---- | | (zeit[,]) | ([,]zeit)) || | | | (datum(zeit),datum(zeit)) ] | | | | [,EXPIRATION-DATE = *ANY | datum | (datum,datum) | | | ---- | | datum(TIME= *ANY | (zeit,zeit) | | | ---- | | (zeit[,]) | ([,]zeit)) || | | | (datum(zeit),datum(zeit)) ] | A - Seite 6 - | | | [,BASIC-ACL = *ANY | *YES | *NONE | | | ---- | | (OWNER = *ANY | *NO-ACCESS | | | ---- | | (READ = *ANY | *YES | *NO | | ---- | | ,WRITE = *ANY | *YES | *NO) ) | | ---- | | (,GROUP = *ANY | *NO-ACCESS | | | ---- | | (READ = *ANY | *YES | *NO | | ---- | | ,WRITE = *ANY | *YES | *NO) ) | | ---- | | (,OTHERS = *ANY | *NO-ACCESS | | | ---- | | (READ = *ANY | *YES | *NO | | ---- | | ,WRITE = *ANY | *YES | *NO) ) ] | | ---- | | [,GUARDS = *ANY | *YES | *NONE | | | ---- | | (READ = *ANY | *NONE | filename | | ---- | | ,WRITE = *ANY | *NONE | filename ) ] | | ---- | | [,MANAGEMENT-CLASS = *ANY | *NONE | manclass ] | | ---- | | [,PROTECTION-ACTIVE = *ANY | *LEVEL-0 | *LEVEL-1 | | | ---- *LEVEL-2 ] | | [,SIZE = *ANY | int | (int,int) | (int[,]) | ([,]int)]| | ---- | | )] | |--------------------------------------------------------------| OPERANDENBESCHREIBUNG: siehe SHOW-JV-ATTRIBUTES-Kommando A - Seite 7 - 2.2 Aenderungen / Ergaenzungen in den Makros * ERAJV ======== Der Macro ERAJV wird zum Loeschen von Jobvariablen verwendet. Die Auswahl der Jobvariablen erfolgte bisher nur ueber den Pfadnamen (Katalogkennung, Benutzerkennung und JV-Name), voll- oder teilqualifiziert, mit oder ohne Wildcards. Ab JV Version 15.1A kann die ueber den Pfadnamen getroffene Auswahl ueber die Selektionsoperanden weiter eingeschraenkt werden. Es werden nur diejenigen JV's ausgewaehlt, die die in den Selektionsoperanden beschriebenen Merkmale aufweisen. Wird ein Selektionsoperand nicht angegeben oder hat er den Wert ANY, erfolgt die Auswahl unabhaenig von dem entsprechenden Merkmal. Auf Macroebene erfolgt die Angabe der Selektionoperanden mit dem Macro JVSEL. Die Verknuepfung mit der "normalen" ERAJV-Parameterliste erfolgt durch Hinterlegung der Adresse der JVSEL-Parameterliste im Feld IDJEJVS der ERAJV-Parameterliste. Ist das Feld IDJEJVS auf Null gesetzt erfolgt keine Auswahl ueber die Selektionsoperanden. Der Macro ERAJV wurde um einen neuen Parameter erweitert: (Achtung: nur moeglich bei SVC190 und Version = 1!) SELADDR = Falls der Parameter nicht angegeben wird, wird das Feld IDJEJVS auf Null gesetzt. Das bedeutet, dass keine Auswahl ueber die Selection gewuenscht wird. Funktion siehe STAJV Macro.