Tuxedo ART Job Details
Theme: Configure
Who Is It For? Automation Engineer
What Is It?
For information about defining a Tuxedo ART Job, refer to Running Tuxedo ART Jobs in the Tuxedo ART Agent online help.
- Script: The name of the script to run. Passed to the artjesadmin utility during job start
- Owner: Reserved for future use. Jobs run under the user configured for the agent and Tuxedo ART environment. Default value is * (asterisk)
- JESRoot Environment: Full path to the JES Root environment, used by the agent to retrieve the Tuxedo Job log
- Tuxedo Environment: Name of the environment script that sets up environment variables when connecting to the Tuxedo environment. Must include the .sh extension
Variables Tab
Variables are passed as name=value pairs to the Tuxedo ART environment.
- Name: The variable name in the job script to replace with the defined value. Must start with & (e.g., &TEST)
- Value: The variable value. Supports OpCon properties resolved at job start (e.g., [[$SCHEDULE DATE_j]], [[SI.C102]], [[$SCHEDULE DATE (-1d)]], SubStr([[$SCHEDULE DATE-BVH]],0,2)). Use Control-T keyins to select properties. SubStr extracts characters starting at the first position for the number of characters specified by the second argument (e.g., SubStr([[$SCHEDULE DATE-BVH]],0,2) extracts MM from MMDDYYYY)
Step Control Tab
Supports a maximum of 5 Step Control definitions per job.
- Step Name: The step name defined in the script
- Min CC: The minimum step completion code
- Max CC: The maximum step completion code
- Step Action: Only 'Send Trigger Message TO SAM' is supported (e.g., JEVENT=SS1TEST10)
- Trigger Message: The message sent to SAM for Agent Feedback. Must match an agent Feedback User Message match event definition (e.g., User Message match 'JEVENT=SS1TEST10')
Failure Criteria Tab
Supports advanced failure criteria.
- Comparison Operator: The operator for comparing the job's exit code to the failure criteria
- Valid Values: Range, Equal To, Not Equal To, Less Than, Less or Equal, Greater Than, Greater and Equal
- Value: The value compared against the job's exit code
- Valid Values: -2147483648 to 2147483647
- End Value: The end value for comparison when the operator is "Range"
- Valid Values: -2147483648 to 2147483647
- Result: The resulting job status when the criteria is true. Specify only on the first group; applies to all remaining groups
- Valid Values: Finish OK, Fail
- And/Or: How multiple failure criteria are evaluated together
- Valid Values: And, Or
- Anything Else: The result when the exit code falls outside the advanced criteria
- If Result is "Finish OK", Anything Else is "Fail"
- If Result is "Fail", Anything Else is "Finish OK"
Configuration Options
| Setting | What It Does | Default | Notes |
|---|---|---|---|
| Script | The name of the script to run. | * | — |
| Owner | Reserved for future use. | * | — |
| JESRoot Environment | Full path to the JES Root environment, used by the agent to retrieve the Tuxedo Job log | — | — |
| Tuxedo Environment | Name of the environment script that sets up environment variables when connecting to the Tuxedo environment. | — | — |
| Name | The variable name in the job script to replace with the defined value. | — | — |
| Value | The variable value. | — | — |
| Step Name | The step name defined in the script | — | — |
| Min CC | The minimum step completion code | — | — |
| Max CC | The maximum step completion code | — | — |
| Step Action | Only 'Send Trigger Message TO SAM' is supported (e.g., JEVENT=SS1TEST10) | — | — |
| Trigger Message | The message sent to SAM for Agent Feedback. | — | — |
| Comparison Operator | The operator for comparing the job's exit code to the failure criteria | — | — |
| End Value | The end value for comparison when the operator is "Range" | — | — |
| Result | The resulting job status when the criteria is true. | — | — |
| And/Or | How multiple failure criteria are evaluated together | — | — |
| Anything Else | The result when the exit code falls outside the advanced criteria | — | — |
FAQs
Q: What is required to define a Tuxedo ART job?
A Tuxedo ART job requires a Script name (passed to the artjesadmin utility), a JESRoot Environment path (for retrieving the job log), and a Tuxedo Environment script name (with .sh extension) for setting up environment variables.
Q: How are variables passed to the Tuxedo ART environment?
Variables are passed as name=value pairs via the Variables tab. Variable names must start with & (e.g., &TEST). Values support OpCon property tokens resolved at job start.
Q: What is the maximum number of Step Control definitions per job?
The Step Control tab supports a maximum of 5 Step Control definitions per Tuxedo ART job.
Glossary
SAM (Schedule Activity Monitor): The logical processor for OpCon workflow automation. SAM monitors schedule and job start times, dependencies, and user commands to determine job execution timing, and processes OpCon events.
Agent: An agent installed on a target platform that runs jobs in the native language of that platform and communicates results back to SAM via SMANetCom over TCP/IP.
Job: The fundamental unit of work in OpCon. A job defines what to run, on which machine, when to start, and what conditions must be met. Job results are tracked and can trigger events and notifications.
OpCon: Continuous' workflow automation platform. The OpCon server includes the database, SAM and Supporting Services (SAM-SS), and graphical user interfaces. agents installed on target platforms run jobs and report results.