Dokument erstellen

Mit dem Befehl DOCUMENT CREATE können Sie entweder ein leeres Dokument oder ein Dokument mit Daten erstellen. Die Daten können eine Zeichenfolge, ein Binärdatenblock, eine Dokumentschablone oder ein Datenpuffer sein.

Informationen zu diesem Vorgang

Um ein Dokument zu erstellen, das Daten enthält, können Sie Optionen für den Befehl EXEC CICS® DOCUMENT CREATE wie folgt angeben:

Eine Zeichenfolge einschließen (Option TEXT).
Einen Block mit Binärdaten einschließen (Option BINARY).
Verwenden Sie eine Dokumentschablone, die durch ihren Schablonennamen angegeben wird (Option TEMPLATE).
Inhalt eines Datenpuffers einschließen (Option FROM).
Geben Sie Werte für alle Symbole in der Dokumentschablone oder für das durch die Option FROM (Option SYMBOLLIST) angegebene Element an.

Der Befehl DOCUMENT CREATE hat eine Option DOCTOKEN, die obligatorisch ist und einen 16–byte -Datenbereich erfordert. Der Dokumenthandler verwendet den Operanden DOCTOKEN, um ein Token zurückzugeben, mit dem das Dokument bei nachfolgenden Aufrufen identifiziert wird.

Diese Beispiele zeigen, wie eine Anwendung EXEC CICS DOCUMENT-Befehle verwenden kann, um ein Dokument zu erstellen. In Java™ -Anwendungen können Sie die CICS -Java-Klassenbibliothek (JCICS) verwenden, um auf Dokumentservices zuzugreifen. Die Klasse Document stellt die Java-Implementierung der EXEC CICS DOCUMENT-Befehle bereit. Die Klassendokumentation finden Sie in der Javadoc unter JCICS class reference.

Vorgehensweise

Verwenden Sie den Befehl EXEC CICS DOCUMENT CREATE mit der Option DOCTOKEN, um ein leeres Dokument zu erstellen und sein Token zurückzugeben.
In diesem Beispiel wird ein leeres Dokument erstellt und das Token in der 16-stelligen Variablen MYDOC zurückgegeben:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC)
```
Mit der Option TEXT können Sie ein Dokument erstellen, das eine von Ihrem Anwendungsprogramm angegebene Zeichenfolge enthält.
Wenn Sie beispielsweise eine Zeichenfolgevariable mit dem Namen DOCTEXT definieren und diese mit Dies ist ein Beispiel für Text, der einem Dokument hinzugefügt werden soll initialisieren, können Sie mit dem folgenden Befehl ein Dokument erstellen, das aus dieser Textzeichenfolge besteht:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC1)
TEXT(DOCTEXT)
LENGTH(53)
```
Diese Zeichenfolge wird unverändert zum Dokument hinzugefügt und CICS führt keine Symbolsubstitution für das Dokument durch.
Mit der Option BINARY können Sie ein Dokument erstellen, das Binärdaten enthält, die beim Senden der Daten keiner Codepagekonvertierung unterzogen werden.
In diesem Beispiel wird ein Dokument erstellt, das aus dem Inhalt eines Datenbereichs als Binärdaten besteht:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC2)
BINARY(DATA-AREA)
```
CICS führt keine Symbolsubstitution für diese Daten durch und markiert die Daten, sodass sie beim Senden des Dokuments an den Empfänger nicht in eine Client-Codepage konvertiert werden.
Verwenden Sie die Option TEMPLATE, um ein Dokument mit einer Dokumentvorlage zu erstellen, die Sie für CICS mithilfe einer DOCTEMPLATE-Ressourcendefinition definiert haben:
1. Definieren Sie eine 48-Byte-Variable, wie z. B. TEMPLATENAME, und initialisieren Sie sie mit dem Wert des 48-Zeichen-Namens der Schablone, wie im Attribut TEMPLATENAME der zugehörigen DOCTEMPLATE-Ressourcendefinition angegeben.
2. Wenn Ihre Dokumentschablone keine Symbole enthält oder Sie die Standardwerte für die Symbole verwenden möchten, können Sie den Befehl DOCUMENT CREATE ohne die Option SYMBOLLIST verwenden.
  Beispiel:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC3)
TEMPLATE(TEMPLATENAME)
```
  Es ist wichtig zu beachten, dass Sie nur Werte für die Symbolsubstitution angeben können, bevor oder zu dem Zeitpunkt, zu dem die Dokumentschablone in das Dokument eingefügt wird. Sie können die ersetzten Werte der Symbole nicht ändern, nachdem die Schablone eingefügt wurde.
3. Wenn Sie Werte für Symbole in der Dokumentschablone festlegen möchten, verwenden Sie den Befehl DOCUMENT CREATE mit der Option SYMBOLLIST.
  Beispiel:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC3)
TEMPLATE(TEMPLATENAME)
SYMBOLLIST('ORDER_NUMBER=0012345')
LISTLENGTH(20)
```
Verwenden Sie die Option FROM, um ein Dokument unter Verwendung eines Datenpuffers zu erstellen.
Der Datenpuffer kann Symbolverweise enthalten, die auf dieselbe Weise wie Symbolverweise in Dokumentschablonen ersetzt werden.
Beispiel:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC4)
FROM(BUFFER)
SYMBOLLIST('ORDER_NUMBER=0012345')
LENGTH(LEN)
```