PS_RUN_PROCESS

Startet und überwacht einen PeopleSoft-Prozesses.

Syntax

PS_RUN_PROCESS

     

    PROCESSNAME=...
    ,PROCESSTYPE
    =...
    ,RUNLOCATION
    =...
    ,
    RUNCONTROLID=...
    [
    ,OUTPUTDEST=...]
    [
    ,OUTDESTTYPE=...]
    [
    ,OUTDESTFORMAT=...]

    [,OUTREGISTER]=...

    [,REPLICATE=...]

Syntax

Beschreibung/Format

PROCESSNAME=

Name des PeopleSoft-Prozesses, der zu initiieren und zu überwachen ist.
Format: Script-Literal

PROCESSTYPE=

Prozesstyp des PeopleSoft-Prozesses
Format: Script-Literal

RUNLOCATION=

Name eines zugewiesenen PeopleSoft Process-Scheduler-Batch-Servers, beispielsweise PSUNX oder PSNT.
Format: Script-Literal

RUNCONTROLID=

Run Control-ID des PeopleSoft-Prozesses.
Format: Script-Literal

OUTPUTDEST=

Verzeichnis, in welches der PeopleSoft-Prozess seine Ausgabe schreibt.
Format: Script-Literal

OUTDESTTYPE=

Ausgabetyp des PeopleSoft-Prozesses, beispielweise Datei, Drucker oder E-Mail.
Format: Script-Literal

Alle zulässigen Werte können mit der folgenden Datenbankabfrage angezeigt werden:
select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTTYPE';

Schnittstelle: PROCESSREQUEST und PROCESSREQUEST_SBB
PeopleSoft-Version: 8+

OUTDESTFORMAT=

Dateiformat, in dem die Ausgabe des PeopleSoft-Prozesses gespeichert werden soll, beispielweise TXT, HTM oder PDF.
Format: Script-Literal

Alle gültigen Werte können mit der folgenden Datenbankabfrage angezeigt werden:
select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTFORMAT';

Schnittstelle: PROCESSREQUEST und PROCESSREQUEST_SBB
PeopleSoft-Version: 8+

OUTREGISTER=

Gibt an, ob die durch den PeopleSoft-Befehl erzeugte Ausgabedatei in der Datei Automation Engine registriert werden soll oder nicht.

Mögliche Werte: "YES" | "NO", wobei NO die Standardeinstellung ist.

Der Name der Ausgabedatei setzt sich aus den PS-Befehlsparametern (OUTDESTTYPE, OUTDESTFORMAT und OUTPUTDEST) und der Instanz-Nummer zusammen.

Beispielformat: <Pfad><Job/Prozessname>_<Instanznummer>.<Ausgabetyp>

Beispiel: c:\temp\DDDAUDIT_31126.PDF

Hinweise: Bitte stellen Sie sicher, dass der PS-Agent auf die generierte Ausgabedatei zugreifen kann, damit er sie in die Automation Engine abrufen kann. Daher muss der PS-Agent entweder auf dem gleichen Gerät wie das PS-System installiert sein oder zumindest Zugriff auf seine Dateifreigabe haben.

Die Einstellung YES bewirkt, dass die Ausgabedatei im Fenster Reports auf der Benutzeroberfläche zum Herunterladen zur Verfügung steht. Siehe Externe (Verzeichnis-)Reports.

Achtung! Das Ausgabeformat ist abhängig vom Prozesstyp. Beispielsweise ist TXT nicht für alle Prozesstypen verfügbar. In diesem Fall greift das PS-System auf einen Standardwert zurück. Dies kann jedoch nicht vom PS-Agenten bestimmt werden, sodass die Reportausgabedatei nicht verfügbar ist, da sie das gewählte Ausgabeformat annimmt.

Hinweise: Bitte stellen Sie sicher, dass der Verteilungsagent des PS-Systems richtig konfiguriert ist, damit die erzeugten Ausgabedateien in das in der Jobdefinition angegebene Verzeichnis geliefert werden können; dies ist Voraussetzung dafür, dass der PS-Agent die Dateien in die Automation Engine überträgt.

REPLICATE=

Gibt an, ob Child-Jobs/-Prozesse als JOBDs in der Datei Automation Engine registriert ist. Wenn auf "YES" gesetzt, werden sie in der Aufgabenliste der Process Monitoring-Perspektive angezeigt.

Das Script-Element erzeugt eine Prozessanfrage für einen PeopleSoft-Prozess und überwacht dessen Durchführung. Das Ende des PeopleSoft-Prozesses wird anhand des Ausführungsstatus erkannt, welcher in der PeopleSoft-Datenbank gespeichert wurde.

Name und Typ des PeopleSoft-Prozesses beziehen sich auf die Prozess-Definitionen in "Process-Scheduler-Manager" von PeopleSoft. Ebenso muss der Name des zugewiesenen Process-Scheduler-Batch-Servers einer Definition entsprechen.

OUTPUTDEST, OUTDESTTYPE und OUTDESTFORMAT sind weitere optionale Parameter, die verwendet werden können, um die Ausgabe des PeopleSoft-Prozesses zu spezifizieren.

Einige Parameter des Script-Elements sind von der eingesetzten PeopleSoft-Version abhängig und in der Syntax-Tabelle gekennzeichnet.

Beispiele

Das erste Beispiel führt den PeopleSoft-Prozess THR200 des SQR-Report-Prozesstyps aus.

PS_RUN_PROCESS PROCESSNAME='THR200',PROCESSTYPE='SQR

Report',RUNLOCATION='PSUNX',RUNCONTROLID='mlc',OUTPUTDEST='/tmp/'

Das zweite Beispiel verwendet die optionalen Parameter dazu, um die Ausgabe des PeopleSoft-Prozesses als PDF-Datei in ein temporäres Verzeichnis zu speichern.

PS_RUN_PROCESS PROCESSNAME='DDDAUDIT',PROCESSTYPE='SQR

Report',RUNLOCATION='PSNT',RUNCONTROLID='sbb',OUTDESTTYPE='FILE',OUTDESTFORMAT='PDF',OUTPUTDEST='c:\temp'

Siehe auch: