Die Syntax der BCAM-Kommandosprache wird im Folgenden in drei Tabellen erklärt. Es handelt sich bei den BCAM-Kommandos überwiegend nicht um SDF-Kommandos, lediglich die Darstellung ist SDF-angenähert.
Tabelle 1: Metasyntax
In den Kommando-/Anweisungsformaten werden bestimmte Zeichen und Darstellungsformen verwendet, deren Bedeutung in Tabelle 1 erläutert wird.
Tabelle 2: Datentypen
Variable Operandenwerte werden durch Datentypen dargestellt. Jeder Datentyp repräsentiert einen bestimmten Wertevorrat. Die Anzahl der Datentypen ist beschränkt auf die in Tabelle 2 beschriebenen Datentypen.
Die Beschreibung der Datentypen gilt für alle Kommandos und Anweisungen. Deshalb werden bei den entsprechenden Operandenbeschreibungen nur noch Abweichungen von Tabelle 2 erläutert.
Tabelle 3: Zusätze zu Datentypen
Zusätze zu Datentypen kennzeichnen weitere Eingabevorschriften für Datentypen. Die Zusätze schränken den Wertevorrat ein oder erweitern ihn. Im Handbuch werden folgende Zusätze in gekürzter Form dargestellt:
lower-case | low |
Die Beschreibung der Zusätze zu den Datentypen gilt für alle Kommandos und Anweisungen. Deshalb werden bei den entsprechenden Operandenbeschreibungen nur noch Abweichungen von Tabelle 3 erläutert.
Table 1: Metasyntax
Kennzeichnung | Bedeutung | Beispiele | |||||||||||||||||||||||||||||||||||||||||
GROSSBUCHSTABEN | Großbuchstaben bezeichnen Schlüsselwörter (Kommando-, Anweisungs-, Operandennamen, Schlüsselwortwerte) und konstante Operandenwerte. Schlüsselwortwerte beginnen mit * | HELP-SDF | |||||||||||||||||||||||||||||||||||||||||
SCREEN-STEPS = *NO | |||||||||||||||||||||||||||||||||||||||||||
GROSSBUCHSTABEN in Halbfett | Großbuchstaben in Halbfett kennzeichnen garantierte bzw. vorgeschlagene Abkürzungen der Schlüsselwörter. | GUIDANCE -MODE = *YES | |||||||||||||||||||||||||||||||||||||||||
= | Das Gleichheitszeichen verbindet einen Operandennamen mit den dazugehörenden Operandenwerten. | GUIDANCE -MODE = *NO | |||||||||||||||||||||||||||||||||||||||||
< > | Spitze Klammern kennzeichnen Variablen, deren Wertevorrat durch Datentypen und ihre Zusätze beschrieben wird (siehe „Tabelle 2: Datentypen" und „Tabelle 3: Zusätze zu Datentypen" ). | SYNTAX-FILE = <filename 1..54> | |||||||||||||||||||||||||||||||||||||||||
Unterstreichung | Der Unterstrich kennzeichnet den Default-Wert eines Operanden. | GUIDANCE -MODE = *NO | |||||||||||||||||||||||||||||||||||||||||
/ | Der Schrägstrich trennt alternative Operandenwerte. | NEXT-FIELD = *NO / *YES | |||||||||||||||||||||||||||||||||||||||||
(...) | Runde Klammern kennzeichnen Operandenwerte, die eine Struktur einleiten. | , UNGUIDED-DIALOG = *Y ES (...) / *NO | |||||||||||||||||||||||||||||||||||||||||
[ ] | Eckige Klammern kennzeichnen struktureinleitende Operandenwerte, deren Angabe optional ist. | SELECT = [ *BY-ATTRIBUTES](...) | |||||||||||||||||||||||||||||||||||||||||
Einrückung | Die Einrückung kennzeichnet die Abhängigkeit zu dem jeweils übergeordneten Operanden. |
| |||||||||||||||||||||||||||||||||||||||||
| Der Strich kennzeichnet zusammengehörende Operanden einer Struktur. Sein Verlauf zeigt Anfang und Ende einer Struktur an. Innerhalb einer Struktur können weitere Strukturen auftreten. Die Anzahl senkrechter Striche vor einem Operanden entspricht der Strukturtiefe. |
| |||||||||||||||||||||||||||||||||||||||||
, | Das Komma steht vor weiteren Operanden der gleichen Strukturstufe. | GUIDANCE-MODE = *NO / *YES ,SDF-COMMANDS = *NO / *YES | |||||||||||||||||||||||||||||||||||||||||
,list-poss(n): | Aus den list-poss folgenden Operandenwerten kann eine Liste gebildet werden. Ist (n) angegeben, können maximal n Elemente in der Liste vorkommen. Enthält die Liste mehr als ein Element, muss sie in runde Klammern eingeschlossen werden. | list-poss: *SAM / *ISAM list-poss(40): <structured-name 1..30> list-poss(256): *OMF / *SYSLST(...) / <filename 1..54> | |||||||||||||||||||||||||||||||||||||||||
Kurzname: | Der darauf folgende Name ist ein garantierter Aliasname des Kommando- bzw. Anweisungsnamens. | HELP-SDF Kurzname: HPSDF | |||||||||||||||||||||||||||||||||||||||||
*none | Unterstrichene Kleinbuchstaben kennzeichnen Operandenwerte, die nur durch Weglassen des Operanden oder des Operandenwertes angegeben werden können. | DIAG = *none / STOP | |||||||||||||||||||||||||||||||||||||||||
*ALL | *all kennzeichnet Operandenwerte, die nur durch Weglassen des Operandenwertes angegeben werden können | A-IP = *all / <x-string 1 .. 8> |
Metasyntax
Tabelle 2: Datentypen
Datentyp | Zeichenvorrat | Besonderheiten | ||||||||||||
name | A...Z | darf nicht nur aus 0...9 bestehen | ||||||||||||
group-name | A...Z Länge: | |||||||||||||
application-name | A...Z Länge: | $ als erstes Zeichen in application-name ist nur für Systemanwendungen zulässig | ||||||||||||
sokhost-name | A...Z Länge: | alphanumerische Zeichenfolge, die in mehrere durch Punkt oder Bindestrich getrennte Teilzeichenfolgen gegliedert sein kann | ||||||||||||
nea-name | alphanumerische Zeichen | besteht aus den ersten acht Zeichen des Anwendungsnamens und den ersten acht Zeichen des Rechnernamens, jeweils linksbündig und mit Leerzeichen aufgefüllt. | ||||||||||||
osi-name | alphanumerische Zeichen; | |||||||||||||
socket-name | alphanumerische Zeichen; | |||||||||||||
alphanum-name | A...Z | |||||||||||||
cat-id | A...Z | maximal 4 Zeichen; | ||||||||||||
command-rest | beliebig | |||||||||||||
composed-name | A...Z Bindestrich | alphanumerische Zeichenfolge, die in mehrere durch Punkt oder Bindestrich getrennte Teilzeichenfolgen gegliedert sein kann. | ||||||||||||
c-string | EBCDIC-Zeichen | ist in Hochkommata einzuschließen; | ||||||||||||
date | 0...9 Strukturkennzeichen: | Eingabeformat: jjjj-mm-tt
| ||||||||||||
device | A...Z | Zeichenfolge, die maximal 8 Zeichen lang ist und einem im System verfügbaren Gerät entspricht. In der Dialogführung zeigt SDF die zulässigen Operandenwerte an. Hinweise zu | ||||||||||||
fixed | +, - | Eingabeformat: [zeichen][ziffern].[ziffern]
muss mindestens eine Ziffer, darf aber außer dem Vorzeichen maximal 10 Zeichen (0…9, Punkt) enthalten | ||||||||||||
filename | A...Z Bindestrich | Eingabeformat: [:cat:][$user.] { datei | datei(nr) | gruppe gruppe{ (*abs) | (+rel) | (-rel) } } :cat: wahlfreie Angabe der Katalogkennung; Zeichenvorrat auf A…Z und 0…9 eingeschränkt; max. 4 Zeichen; ist in Doppelpunkte einzuschließen; $user. wahlfreie Angabe der Benutzerkennung; $. (Sonderfall) datei Datei- oder Jobvariablenname; | ||||||||||||
filename (Forts.) | #datei (Sonderfall) # oder @ als erstes Zeichen kennzeichnet je nach Systemparameter temporäre Dateien und Jobvariablen. datei(nr) Banddateiname nr: Versionsnummer; gruppe Name einer Dateigenerationsgruppe (Zeichenvorrat siehe unter "datei") gruppe{ (*abs) | (+rel) | (-rel) } (*abs) absolute Generationsnummer (1..9999); (+rel) relative Generationsnummer (0..99); | |||||||||||||
integer | 0...9, +, - | + bzw. - kann nur erstes Zeichen sein (Vorzeichen). | ||||||||||||
partial-filename | A...Z Bindestrich | Eingabeformat: [:cat:][$user.][teilname.]
teilname wahlfreie Angabe des gemeinsamen ersten Namensteils von Dateien und Dateigenerationsgruppen in der Form: | ||||||||||||
posix-filename | A...Z | Zeichenfolge, die maximal 255 Zeichen lang ist. | ||||||||||||
posix-pathname | A...Z Sonderzeichen | Eingabeformat: [/]part1[/.../partn] wobei parti ein posix-filename ist; | ||||||||||||
product-version | A...Z Punkt |
wobei m, n, s und o jeweils eine Ziffer und a ein Buchstabe ist. | ||||||||||||
structured-name | A...Z | alphanumerische Zeichenfolge, die in mehrere durch Bindestrich getrennte Teilzeichenfolgen gegliedert sein kann; | ||||||||||||
text | beliebig | Das Eingabeformat ist den jeweiligen Operandenbeschreibungen zu entnehmen. | ||||||||||||
time | 0...9 Strukturkennzeichen: | Angabe einer Tageszeit Eingabeformat::
führende Nullen können weggelassen werden | ||||||||||||
vsn |
|
| ||||||||||||
|
| |||||||||||||
x-string | Sedezimal: | ist in Hochkommata einzuschließen; | ||||||||||||
x-text | Sedezimal: | ist nicht in Hochkommata einzuschließen; |
Data types
Tabelle 3: Zusätze zu Datentypen
Zusatz | Bedeutung | |||||||||||||||||||||
x..y unit | beim Datentyp integer: Intervallangabe
| |||||||||||||||||||||
x..y special | bei den übrigen Datentypen: Längenangabe Bei den Datentypen catid, date, device, product-version, time und vsn wirddie Längenangabe nicht angezeigt.
| |||||||||||||||||||||
with | Erweitert die Angabemöglichkeiten für einen Datentyp. | |||||||||||||||||||||
-compl | Bei Angaben zum Datentyp date ergänzt SDF zweistellige Jahresangaben der Form jj-mm-tt zu:
| |||||||||||||||||||||
-low | Groß- und Kleinschreibung wird unterschieden. | |||||||||||||||||||||
-path-compl | Bei Angaben zum Datentyp filename ergänzt SDF die Katalog- und/oder die Benutzerkennung, falls diese nicht angegeben werden. | |||||||||||||||||||||
-under | Erlaubt Unterstriche '_' beim Datentyp name. | |||||||||||||||||||||
with (Forts.) -wild(n) | Teile eines Namens dürfen durch die folgenden Platzhalter ersetzt werden. n bezeichnet die maximale Eingabelänge bei Verwendung von Platzhaltern. | |||||||||||||||||||||
BS2000- Platzhalter | Bedeutung | |||||||||||||||||||||
* | Ersetzt eine beliebige, auch leere Zeichenfolge. Ein * an erster Stelle muss verdoppelt werden, sofern dem * weitere Zeichen folgen und die eingegebene Zeichenfolge nicht mindestens einen weiteren Platzhalter enthält. | |||||||||||||||||||||
Punkt am | Teilqualifizierte Angabe eines Namens. | |||||||||||||||||||||
/ | Ersetzt genau ein beliebiges Zeichen. | |||||||||||||||||||||
<s x :s y > | Ersetzt eine Zeichenfolge, für die gilt:
Stelle für die Zeichenfolge mit der höchst möglichen Codierung steht (enthält nur die Zeichen X' FF'). | |||||||||||||||||||||
<s1,...> | Ersetzt alle Zeichenfolgen, auf die eine der mit s angegebenen Zeichenkombinationen zutrifft. s kann auch die leere Zeichenfolge sein. Jede Zeichenfolge s kann auch eine Bereichsangabe "sx:sy" sein (siehe oben). | |||||||||||||||||||||
with-wild(n) (Forts.) | ||||||||||||||||||||||
-s | Ersetzt alle Zeichenfolgen, die der angegebenen Zeichenfolge s nicht entsprechen. Das Minuszeichen darf nur am Beginn der Zeichenfolge stehen. Innerhalb der Datentypen filename bzw. partial-filename kann die negierte Zeichenfolge -s genau einmal verwendet werden, d.h. -s kann einen der drei Namensteile cat, user oder datei ersetzen. | |||||||||||||||||||||
Platzhalter sind in Generations- und Versionsangaben von Dateinamen nicht erlaubt. In Benutzerkennungen ist die Angabe von Platzhaltern der Systemverwaltung vorbehalten. Platzhalter können nicht die Begrenzer der Namensteile cat (Doppelpunkte) und user ($ und Punkt) ersetzen. | ||||||||||||||||||||||
POSIX-Platzhalter | Bedeutung | |||||||||||||||||||||
* | Ersetzt eine beliebige, auch leere Zeichenfolge. Ein * an erster Stelle muss verdoppelt werden, sofern dem * weitere Zeichen folgen und die eingegebene Zeichenfolge nicht mindestens einen weiteren Platzhalter enthält. | |||||||||||||||||||||
? | Ersetzt genau ein beliebiges Zeichen. Ist als erstes Zeichen außerhalb von Hochkommata nicht zulässig. | |||||||||||||||||||||
[cx -cy ] | Ersetzt genau ein Zeichen aus dem Bereich cx und cy einschließlich der Bereichsgrenzen. cx und cy müssen einfache Zeichen sein. | |||||||||||||||||||||
[s] | Ersetzt genau ein Zeichen aus der Zeichenfolge s. | |||||||||||||||||||||
[!cx -cy ] | Ersetzt genau ein Zeichen, das nicht in dem Bereich cx und cy einschließlich der Bereichsgrenzen enthalten ist. cx und cy müssen einfache Zeichen sein. | |||||||||||||||||||||
[!s] | Ersetzt genau ein Zeichen, das nicht in der Zeichenfolge s enthalten ist. Die Ausdrücke [!s] und [!c x -c y ] können kombiniert werden zu [!s 1 c x -c y s 2 ]. | |||||||||||||||||||||
with (Forts.) -wild-constr(n) |
| |||||||||||||||||||||
Platzhalter | Bedeutung | |||||||||||||||||||||
* | Entspricht der Zeichenfolge, die durch den Platzhalter * in der Auswahlzeichenfolge ausgewählt wird. | |||||||||||||||||||||
Punkt am | Entspricht der teilqualifizierten Angabe eines Namens in der Auswahlzeichenfolge. | |||||||||||||||||||||
/ oder ? | Entspricht dem Zeichen, das durch den Platzhalter / oder ? in der Auswahlzeichenfolge ausgewählt wird. | |||||||||||||||||||||
<n> | Entspricht der Zeichenfolge, die durch den n-ten Platzhalter in der Auswahlzeichenfolge ausgewählt wird; n = <integer> | |||||||||||||||||||||
Zuordnung der Platzhalter zu entsprechenden Platzhaltern in der Auswahlzeichenfolge:
| ||||||||||||||||||||||
with-wild-constr (Forts.) | Bei Konstruktionsangaben sind folgende Regeln zu beachten:
| |||||||||||||||||||||
with-wild-constr (Forts.) | Beispiele:
1) Punkt am Ende des Namens kann Namenskonvention widersprechen (z.B bei vollqualifizierten Dateinamen) | |||||||||||||||||||||
without | Schränkt die Angabemöglichkeiten für einen Datentyp ein. | |||||||||||||||||||||
-cat | Die Angabe einer Katalogkennung ist nicht erlaubt. | |||||||||||||||||||||
-corr | Eingabeformat: [[C]' ][V][m]m.na[' ] | |||||||||||||||||||||
-gen | Die Angabe einer Dateigeneration oder Dateigenerationsgruppe ist nicht erlaubt. | |||||||||||||||||||||
-man | Eingabeformat: [[C]' ][V][m]m.n[' ] | |||||||||||||||||||||
-odd | Der Datentyp x-text erlaubt nur eine gerade Anzahl von Zeichen. | |||||||||||||||||||||
-sep | Beim Datentyp text ist die Angabe der folgenden Trennzeichen nicht erlaubt: ; = ( ) < > 'BLANK' (also Strichpunkt, Gleichheitszeichen, runde Klammer auf und zu, Größerzeichen, Kleinerzeichen und Leerzeichen) | |||||||||||||||||||||
-temp-file | Die Angabe einer temporären Datei ist nicht erlaubt (siehe #datei bzw. @datei bei filename). | |||||||||||||||||||||
without (Forts.) | ||||||||||||||||||||||
-user | Die Angabe einer Benutzerkennung ist nicht erlaubt. | |||||||||||||||||||||
-vers | Die Angabe der Version (siehe "datei(nr)") ist bei Banddateien nicht erlaubt. | |||||||||||||||||||||
-wild | Die Datentype posix-filename bzw. posix-pathname dürfen keine Musterzeichen enthalten. | |||||||||||||||||||||
mandatory | Bestimmte Angaben sind für einen Datentyp zwingend erforderlich. | |||||||||||||||||||||
-corr | Eingabeformat: [[C]' ][V][m]m.naso[' ] | |||||||||||||||||||||
-man | Eingabeformat: [[C]' ][V][m]m.na[so][' ] | |||||||||||||||||||||
-quotes | Angaben zu den Datentypen posix-filename bzw. posix-pathname müssen in Hochkommata eingeschlossen werden. |
Zusätze zu Datentypen
BCAM-Kommandos in alphabetischer Reihenfolge
Die Darstellung der BCAM-Kommandos erfolgt in alphabetischer Reihenfolge. Am Beginn jeder Kommandobeschreibung befindet sich eine Tabelle, die die möglichen Kommandoquellen für dieses Kommando auflistet. Am Ende jeder Kommandobeschreibung findet sich eine Tabelle mit den Meldungen und Quittungen für dieses Kommando.
Mit den Kommandos DCSTART, DCOPT, BCMOD und BCOPTION stellen Sie BCAM individuell ein. Der Abschnitt „Operandeneinstellungen" gibt einen Überblick über die Lebensdauer, Funktion und Voreinstellung dieser BCAM-Einstellungen.