JAMS Reference Manual
Contents Index JAMS Home Support

JAMS Reference Manual
Previous Contents Index

DEFINE JOB

Creates or replaces a Job Definition.

Format

DEFINE JOB job-name

Parameters

job-name

The Job Name of the Job which you want to create or replace.

Description

The DEFINE JOB command is used to create or replace an entire Job Definition. The DEFINE JOB command marks the beginning of a Job definition. The JAMS> prompt changes to JOB_DEF> until the Job Definition is complete.

Usually, the DEFINE JOB command is part of a JAMS command procedure which contains the entire definition. You can use the EXTRACT JOB command to create a complete DEFINE JOB command procedure.

restrictions

You must be authorized to create or replace the Job Definition. Additional security checks are made based upon the contents of the Job Definition.
related commands

Qualifiers

/REPLACE

This qualifier is used to specify whether you want to create or replace the Definition. If you omit this qualifier, the Definition will be created if it does not exist and replaced if it does exist. If you specify /REPLACE, an error will be returned if the definition does not exist and no changes will be made. If you specify /NOREPLACE, an error will be returned if the definition exists and no changes will be made.

Syntax Diagram

The complete syntax for a Job definition is:
DEFINE JOB job-name
SYSTEM system-id
  • DESCRIPTION quoted-string [, quoted-string]

  • BATCH QUEUE queue-name

  • PRIORITY MODIFIER integer

  • USERNAME username

  • RETAIN
    • ALWAYS
    • ERROR
    • FOR delta-time
    • NEVER

  • SUBMIT ON HOLD

  • RESTARTABLE

  • SUPPRESS MENU

  • NOTIFY SUBMITTER

  • [NO] KEEP LOGS

  • [NO] PRINT LOGS

  • [NO] TIMESTAMP LOGS

  • SCHEDULE WINDOW named-time
  • SCHEDULE RANGE time TO time

  • MISSED ACTION
    • ABORT
    • CONTINUE
    • NONE
    • RESCHEDULE
    • RESTART

  • NOTIFY MISSED

  • DEFAULT SUBMIT DATE date-specification

  • DEFAULT SUBMIT TIME time

  • SCHEDULED DATE date-specification

  • EXCEPT FOR date-specification

  • SCHEDULED TIME time

  • RESUBMIT EVERY delta-time UNTIL end-time
    • BASED ON
      • SCHEDULED
      • START
      • END
      TIME

  • [NO] AUTO SUBMIT

  • NONWORKDAYS
    • IGNORE
    • DEFER
    • SCHEDULE

  • parameter-specification...

  • report-specification...

  • dependency-specification...

    • SOURCE FILE file-specification
    • COMMAND command-line

  • METHOD method-name

  • AGENT NODE agent-node-name

  • TIMESTAMP LOGS
  • NO TIMESTAMP LOGS

  • resource-specification...

  • SOURCE IS
  • jobs source code
  • END_SOURCE

  • PRECHECK JOB job-name

  • PRECHECK INTERVAL delta-time

  • RECOVERY SEVERITY
    • SUCCESS
    • INFORMATIONAL
    • WARNING
    • ERROR
    • FATAL

  • RECOVERY JOB job-name

  • RECOVERY INSTRUCTIONS
  • recovery instructions
  • END_RECOVERY

  • MAIL NOTIFICATION quoted-string

  • REPLY NOTIFICATION quoted-string

  • OPERATOR NOTIFICATION quoted-string

  • NOTIFICATION JOB job-name

  • NOTIFY SEVERITY
    • SUCCESS
    • INFORMATIONAL
    • WARNING
    • ERROR
    • FATAL
    • NEVER

  • STALLED TIME delta-time

  • RUNAWAY ELAPSED TIME delta-time

  • RUNAWAY ELAPSED PERCENT integer

  • RUNAWAY CPU TIME delta-time

  • RUNAWAY CPU PERCENT integer

  • SHORT ELAPSED TIME delta-time

  • SHORT ELAPSED PERCENT integer

  • SHORT CPU TIME delta-time

  • SHORT CPU PERCENT integer

  • SHORT SEVERITY
    • SUCCESS
    • INFORMATIONAL
    • WARNING
    • ERROR
    • FATAL

  • ACL (acl)

END_JOB

The syntax for a parameter specification is:

PARAMETER parameter-name
  • PROMPT quoted-string

  • TEXT LENGTH integer
  • INTEGER LENGTH integer
  • DATE
  • TIME

  • DEFAULT VARIABLE variable-name

  • DEFAULT FORMAT format

  • DEFAULT VALUE quoted-string

  • [NO] REQUIRED

  • [NO] MUST_FILL

  • [NO] ALLOW_ENTRY

  • [NO] UPPERCASE

  • [NO] HIDE

  • HELP quoted-string

END_PARAMETER

The syntax for a report specification is:

REPORT report-id
  • DESCRIPTION quoted-string

  • LOGICAL logical-name

  • QUEUE queue-name

  • FORM form-name

  • COPIES integer

  • RETENTION integer

  • FILENAME file-specification

  • QUALIFIERS quoted-string

END_REPORT

The syntax for a job dependency is:

DEPENDS ON JOB [node::]job-name
  • SEVERITY
    • SUCCESS
    • INFORMATIONAL
    • WARNING
    • ERROR
    • FATAL

  • SINCE JOB job-name
    • SEVERITY
      • SUCCESS
      • INFORMATIONAL
      • WARNING
      • ERROR
      • FATAL
  • [NO] SINCE JOB

  • WITHIN [integer DAYS [AND]] [integer HOURS]

  • WAIT IF QUEUED

END_DEPEND

The syntax for a variable dependency is:

DEPENDS ON VARIABLE variable-id
  • CHANGED
  • TRUE
  • FALSE
  • = value
  • < value
  • > value
  • <= value
  • >= value
  • <> value

END_DEPEND

Previous Next Contents Index
JAMS Copyright © 2000, MVP Systems, Inc. All rights reserved.