:PUT_ATT

Verwenden Sie die Script-Anweisung :PUT_ATT, um den Wert des Objektattributs während des Generierungsprozesses zu ändern. Die für ein Objekt definierten Attribute beeinflussen die Verarbeitung des Objekts. Mit dieser Script-Anweisung können Sie diese Objektattribute dynamisch ändern und neue Werte zuweisen, wenn die Aufgabe generiert wird. Die neuen Werte sind nur für die aktuelle Generierung gültig und werden nicht dauerhaft im Objekt gespeichert.

Wenn Sie Objektattribute dynamisch ändern, beachten Sie die Reihenfolge, in der Scripts auf den Prozess-Seiten verarbeitet werden, sowie die Ausführungsphasen. Das Ändern von Attributen ist nur vor der Verarbeitung eines Objekts sinnvoll und kann zu unerwünschten Ergebnissen führen, wenn Sie die Ausführungsphasen nicht berücksichtigen.

Beispiel: Eine Aufgabe ist so konfiguriert, dass sie zur Laufzeit generiert wird. Eine :PUT_ATT-Anweisung auf der Pre-Prozess-Seite der Aufgabe setzt die Queue (Attribut QUEUE). Das System prüft jedoch die verfügbaren Slots und den Status der Queue, bevor es das Script auf der Pre-Prozess-Seite verarbeitet. Die Aufgabe beginnt in der Queue, die Sie mit der :PUT_ATT-Anweisung festgelegt haben, aber das Limit der neuen Queue wird nicht überprüft, und die Aufgabe kann zu früh starten.

Mehr Informationen:

• Seite "Attribute"
• Ausführungsphasen
• Generierung zum Aktivierungszeitpunkt oder zur Laufzeit

Syntax

: PUT_ATT Attribut = Wert

• :PUT_ATT
  Ändert den Wert eines Attributs

• Attribut
  Name des zu ändernden Attributs
  Format: AE name

• Wert
  Neuer Wert, der dem Attribut zugewiesen werden soll
  Format: Script-Literal, Script-Variable oder Script-Funktion

Hinweise:

• Welchen Wert Sie einem bestimmten Attribut zuweisen können, hängt von der Systemumgebung ab.
• Wenn das Objekt konfiguriert ist, um die Aufgabe zur Laufzeit zu generieren, können Sie den Starttyp des Objekts nicht durch eine :PUT_ATT-Anweisung ändern.
• Attribute können verschiedene maximale Längen besitzen. Die :PUT_ATT-Anweisung prüft nicht den angegebenen Wert. Wenn der Wert die maximal zulässige Länge des Attributs überschreitet, wird der Wert abgeschnitten.
• Die Anweisung ändert nicht den Inhalt von Script-Variablen.
• Wenn Sie die folgenden Attribute festlegen möchten, müssen Sie die :PUT_ATT-Anweisung auf der Pre-Prozess-Seite verwenden:
  • ATTR_DLG
  • HOST
  • SYSLST_DB
  • SYSLST_FILE
  • SYSOUT_DB
  • SYSOUT_FILE
  • OL
  • OO (BS2000-Jobs)

Wichtig:

• Verwenden Sie :PUT_ATT nicht auf der ! Prozess-Seite eines Ereignisobjekts oder auf einer Post-Prozess-Seite. Diese Anweisung hat keine Auswirkung, wenn Sie sie auf diesen Seiten verwenden.
• Sie können die Attribute eines bestimmten Objekts, wie z. B. des Login-Objekts, nur mit einer :PUT_ATT-Anweisung ändern, wenn der Benutzer Schreibrechte (W) sowohl für den alten als auch für den neuen Wert des Attributs hat.
• Sie können den Starttyp " " nur einem sofort startenden Job oder einer bereits definierten Gruppe zuordnen. Jede andere Spezifikation verursacht einen Fehler bei der Generierung.
• Sie können eine :PUT_ATT-Anweisung nicht verwenden, um die Agentengruppe zu ändern. Agentengruppen werden aufgelöst und der Agent ausgewählt, bevor das Script verarbeitet wird. Sie können die Anweisung jedoch verwenden, um einen anderen Agenten auszuwählen. Verwenden Sie die Script-Funktion PREP_PROCESS_AGENTGROUP, um die Agenten einer Agentengruppe zu lesen. Weitere Informationen finden Sie unter PREP_PROCESS_AGENTGROUP.
• :PUT_ATT-Befehle, die in früheren Versionen von Rapid Automation-Agenten definiert wurden, funktionieren möglicherweise nicht mehr, wenn sich die Attribute von RA-Jobs in neuen Versionen der Rapid Automation-Agenten ändern. Verwenden Sie Objektvariablen für Feldersetzungen anstelle von :PUT_ATT-Befehlen für bestimmte Rapid Automation-Attribute. Weitere Informationen finden Sie auf der Seite "Variablen".

Tipp:Sie können diese Script-Anweisung auf der Seite Script verwenden, um die maximale Anzahl paralleler Läufe zu begrenzen (Attribut: MAX_PARALLEL_TASKS). In diesem Fall wird das Limit erst nach der Verarbeitung des Scripts überprüft, wenn die Aufgabe zur Laufzeit generiert wird.

Beispiele

: SET  &TYPE# = GET_ATT(EVENT_TYPE)
:PUT_ATT EVENT_CHECK_METHOD2 = "FILE_STABLE"
:PRINT &TYPE#

Die Script-Funktion GET_ATT weist der Script-Variablen &TYPE# den Wert FA zu. Nach dem :PUT_ATT-Aufruf ist der Ereignistyp FT, da das Attribut FILE_STABLE zum Dateisystemereignis gehört. Die Variable &TYPE# beinhaltet noch den Wert FA.

Das folgende Beispiel zeigt, wie Sie einem Objekt einen neuen Agenten zuordnen:

: PUT_ATT HOST = "UNIX02"

Siehe auch: