Option ATTRIBUTES

Die Spezifikationen der Ressourcendefinition, die mit einem CREATE- oder CSD-Befehl installiert wird, werden über den Wert der Option ATTRIBUTES übertragen. Dieser Wert ist eine Zeichenfolge, die die Attribute der Ressource auflistet.

Sie geben Attribute und Attributwerte im Textformat auf dieselbe Weise wie in einer CEDA DEFINE-Anzeige an. Diese Zeichenfolge wird während der Ausführung des Befehls CREATE oder CSD analysiert und muss folglich vollständig aus Text ohne Variablennamen in einer einzigen Zeichenfolge bestehen. Die Syntax in der Zeichenfolge wird für jeden CREATE- oder CSD-Befehl angegeben, wobei dieselben Konventionen wie für die Befehlssyntax gelten, mit Ausnahme dieser Attributwerte. Die Inhalte werden jedoch nicht vom Umsetzungsprogramm geparst, das nur wie im Hauptdiagramm dargestellt die Befehlssyntax prüft.

Attributwerte werden im Wesentlichen so angezeigt wie in den CEDA DEFINE-Anzeigen. Da die DEFINE-Anzeigen jedoch vorformatiert sind und ATTRIBUTES-Zeichenfolgen nicht, müssen Sie die folgenden Regeln beachten:
  • Attribute können in einer beliebigen Reihenfolge angezeigt werden (Sie müssen die Reihenfolge im Syntaxdiagramm oder im CEDA-Befehl nicht befolgen).
  • Der Name eines Attributs muss dem im Syntaxdiagramm gezeigten Namen oder der im entsprechenden CEDA-DEFINE-Eintrag zulässigen Abkürzung entsprechen (siehe die Erläuterung zu DEFINE in den Befehlen der Transaktion CEDA zur Ressourcenverwaltung ).
    Hinweis : Abkürzungen können sich von Veröffentlichung zu Veröffentlichung ändern, daher ist es am sichersten, die vollständige Schreibweise zu verwenden.
  • Die Attributzeichenfolge wird nicht in Großbuchstaben konvertiert. Die Eingaben in CEDA und das Dienstprogramm DFHCSDUP werden hingegen konvertiert. Attributnamen werden unabhängig davon erkannt, ob Sie Groß-, Klein- oder gemischte Groß-/Kleinschreibung verwenden, ebenso wie die von CICS® zugewiesenen Wertnamen (die im Syntaxdiagramm in Großbuchstaben dargestellt sind). Andere Zeichenwerte, Ressourcennamen und Nachrichtentexte werden beispielsweise so verwendet, wie sie auftreten und müssen daher in der beabsichtigen Schreibweise bereitgestellt werden.
  • Der Argumentwert muss, falls vorhanden, den Regeln für dasselbe Attribut in einer CEDA DEFINE-Anzeige folgen. Wenn eine begrenzte Anzahl möglicher Werte vorhanden ist, werden sie im Attributdiagramm in Großbuchstaben aufgelistet. Andernfalls gibt das Diagramm nur die Form des Werts mithilfe der folgenden Konventionen an:
    charn
    Eine Zeichenfolge der Länge n oder, wenn das Argument eine variable Länge haben kann, die maximale Länge n.
    hexn
    Eine Zeichenfolge mit Hexadezimalzeichen der Länge n oder, wenn das Argument eine variable Länge haben kann, die maximale Länge n.
    n1-n2
    Die Zahl im Bereich n1 bis n2.
    Hinweis : Sie können Leerzeichen am Ende von Zeichenargumenten, X'00' am Ende von Hexadezimalargumenten und führende Nullen in numerischen Argumenten weglassen.
  • Sie können ein oder mehrere Leerzeichen verwenden, um Attribute zur besseren Lesbarkeit zu trennen. Ein Leerzeichen ist nur zwischen einem Attribut, das kein Argument aufweist, und dem nächsten Attribut erforderlich. Kommas und andere Trennzeichen sind nicht zulässig. Leerzeichen können auch zwischen Attributnamen und der Klammer, die das Argument umgibt, stehen, sowie zwischen den Klammern und dem Argumentwert. Dies ist jedoch beides nicht notwendig. Daher sind diese beiden ähnlichen Kombinationen beide korrekt:
        ATTRIBUTES ( ‘UCTRAN (NO)RTIMEOUT (10 )’)
    ATTRIBUTES(‘ UCTRAN(NO)   RTIMEOUT( 10) ’ )
  • Es sind keine Anführungszeichen innerhalb der Attributzeichenfolge erforderlich (Sie benötigen sie um die gesamte Zeichenfolge herum, wenn Sie wie im Beispiel oben ein Literal verwenden). Wenn Sie Anführungszeichen in Ihrem Text (zum Beispiel im Beschreibungsattribut) verwenden möchten, verwenden Sie zwei Anführungszeichen für jedes Anführungszeichen, das Sie im Text anzeigen möchten, so wie Sie das auch in Literalkonstanten tun, die Anführungszeichen enthalten.
  • Sehr wenige Attribute erfordern eine Spezifikation und das Auslassen einer solchen entspricht dem Nicht-Angeben eines Werts für ein Attribut in der CEDA-Anzeige. Dort, wo der Standardwert immer gleich bleibt, wird er in den Diagrammen auf dieselbe Weise wie in den Syntaxdiagrammen angezeigt. Einige Standardwerte hängen jedoch von den Werten anderer Attribute ab und diese werden nicht angezeigt. (Sie können nicht Ihre eigenen Standardwerte für CREATE-Befehle erstellen, weil diese nicht die CSD-Datei verwenden.)
  • Für einige Ressourcentypen können Sie Standardwerte für alle Attribute verwenden. Wenn Sie dies tun möchten, legen Sie für die Länge der Zeichenfolge in der Option ATTRLEN den Wert null fest. Sie müssen in diesem Fall weiterhin die Option ATTRIBUTES angeben. Auch wenn der Datenwert, den Sie bereitstellen, nicht untersucht wird.
  • Sie können die Option ATTRLEN weglassen, wenn sie nicht Null ist, wenn es sich um die Länge der in ATTRIBUTES angegebenen Variablen handelt und Sie nicht in C®/370 codieren, wie in Argumentlängen erklärt.

Wenn Sie einen Fehler bei der Zeichenfolge ATTRIBUTES machen, löst CICS die Bedingung INVREQ mit dem entsprechenden RESP2-Wert aus. RESP2 Werte für CREATE- und CSD-Befehle listen die geltenden RESP2 Werte auf.