PS_RUN_JOB

Verwenden Sie das Skriptelement PS_RUN_JOB, um einen PeopleSoft-Auftrag zu starten und seine Ausführung zu überwachen. Mit einem PeopleSoft-Job können mehrere PeopleSoft-Prozesse nacheinander oder gleichzeitig durchgeführt werden.

Wichtig!

  • Dieses Skriptelement erfordert, dass der Administrator die Benutzeroberfläche PROCESSREQUEST_SBB in der INI-Datei des Agenten installiert und aktiviert.
  • PS_RUN_JOB funktioniert nicht mit Inline-Bind-Variablen. Weitere Informationen finden Sie unter Nutzung von Bind-Variablen.

Schnittstelle: PROCESSREQUEST_SBB
PeopleSoft Version: 8+

Syntax

PS_RUN_JOB

    JOBNAME=...
    ,RUNCONTROLID=...
    [,RUNLOCATION=...]
    [,OUTPUTDEST=...]
    [,OUTDESTTYPE=...]
    [,OUTDESTFORMAT=...]
    [,OUTREGISTER=...]
    [,REPLICATE=...]

Parameter

  • PS_RUN_JOB
    Startet und überwacht einen PeopleSoft-Job.
  • JOBNAME=
    Name des PeopleSoft-Jobs, der gestartet und überwacht werden soll
    Hinweis: Der Name des PeopleSoft-Jobs bezieht sich auf die Definition im PeopleSoft Process Scheduler. Wenn Sie diesen Parameter verwenden, muss auch der Name des zugewiesenen Process Scheduler Batch Servers (Parameter RUNLOCATION) der zugehörigen Definition entsprechen.
    Format: Script-Literal
  • RUNCONTROLID=
    Run Control-ID des PeopleSoft-Jobs
    Format: Skript-Literal
  • RUNLOCATION=
    (Optional) Name eines zugewiesenen PeopleSoft Process Scheduler-Batch Servers, wie zum Beispiel PSUNX oder PSNT
    Hinweis: Der Name des PeopleSoft-Jobs (Parameter JOBNAME) verweist auf die Definition im PeopleSoft Process Scheduler. Der Name des zugeordneten Process Scheduler Batch Servers muss ebenfalls der zugehörigen Definition entsprechen, wenn dieser Parameter verwendet wird.
    Format: Script-Literal
  • OUTPUTDEST=
    (Optional) Verzeichnis, in das der PeopleSoft-Job seine Ausgabe schreibt
  • OUTDESTTYPE=
    (Optional) Ausgabetyp des PeopleSoft-Jobs, z. B. eine Datei,ein Drucker oder eine E-Mail
    Format: Skriptliteral
    Verwenden Sie die folgende Datenbankabfrage, um alle gültigen Werte zu sehen:

    select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTTYPE';

    Format: Script-Literal
  • OUTDESTFORMAT=
    (Optional) Ausgabetyp des PeopleSoft-Jobs, wie z. B. TXT, HTM oder PDF
    Format: Skriptliteral
    Verwenden Sie die folgende Datenbankabfrage, um alle gültigen Werte zu sehen:

    select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTFORMAT';

  • OUTREGISTER=
    (Optional) Gibt an, ob die durch den PeopleSoft-Befehl erzeugte Ausgabedatei in der Automation Engine registriert werden soll oder nicht.
    Zulässige Werte:

    • Hinweise:

    • 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

    • 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.
    • Stellen Sie sicher, dass der Verteilungs-Agent des PS-Systems richtig konfiguriert ist, damit die generierten Ausgabedateien an das Verzeichnis geliefert werden können, das in der Jobdefinition angegeben ist. Dies ist eine Voraussetzung, damit der PS-Agent die Dateien in die Automation Engine übertragen kann
    • 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. Jedoch hat der PS-Agent keinen Einfluss auf dieses Verhalten. Deshalb ist die Berichtsausgabedatei nicht verfügbar, weil sie das ausgewählte Ausgabeformat annimmt.

  • REPLICATE=
    (Optional) Gibt an, ob Child-Jobs/-Prozesse als JOBDs in der Automation Engine registriert werden sollen. Wenn auf YES gesetzt, werden sie in der Aufgabenliste der Process Monitoring-Perspektive angezeigt.

Beispiele

Im folgenden Beispiel werden optionale Parameter dazu verwendet, um die Ausgabe des PeopleSoft-Jobs als SPF-Datei in einem temporären Verzeichnis zu speichern.

PS_RUN_JOB JOBNAME='3SQR',RUNCONTROLID='sbb',RUNLOCATION=PSNT,OUTDESTTYPE='FILE',OUTDESTFORMAT='SPF',OUTPUTDEST='c:\temp'

Siehe auch:

seealso

Allgemeines zur PeopleSoft-JCL