Chapter 17: Process Automation Jobs

Chapter 17: Process Automation Jobs

Process Automation Jobs 
Process Automation jobs let you launch CA Process Automation processes and monitor
them to completion.
Note: To run these jobs, your system requires CA WA Agent for UNIX, Linux, or Windows
and CA WA Agent for Web Services.
You can define the following Process Automation jobs:
Process Automation Process Execution
Lets you directly execute a CA Process Automation process.
Process Automation Start Request Form
Lets you submit a Start Request Form to execute a CA Process Automation process.
The Start Request Form sets the values for the current execution of the process.


Define a Process Automation Process Execution Job 
You can define a Process Automation Process Execution job to execute a CA Process
Automation process.
Follow these steps: 
1. Insert a job and specify the following attributes in the definition:
job_type: PAPROC 
Specifies that the job type is Process Automation Process Execution.
machine 
Specifies the name of the machine on which the job runs.
endpoint_URL 
Specifies the target endpoint address URL in a Web Service or Process
Automation job.
pa_name 
Specifies the fully qualified name of the process or Start Request Form in a
Process Automation job.

2. (Optional) Specify optional Process Automation Process Execution attributes.
■ job_class
■ job_terminator
■ owner
■ pa_monitor_progress
■ pa_parameter
■ pa_trace
3. (Optional) Specify common attributes that apply to all jobs.
The Process Automation Process Execution job is defined.
 Define a Process Automation Start Request Form Job


Notes:
■ Attributes that have a default value automatically apply to the job definitions;
therefore, they are optional. For example, jobs with no specified job type are
defined as command jobs by default. Other optional attributes specify information
that is not required but affects how or when a job runs, such as attributes that
specify scheduling conditions.
■ Some optional attributes are common to all job types but others apply to certain
jobs types only. Optional attributes that apply to all job types are known as
common optional attributes. For more information about common optional
attributes and the values that you can specify for them (including their default
values when applicable), see the Reference Guide.
■ For information about required attributes and job type specific optional attributes,
see the procedure topics that provide instructions for defining jobs.
■ This guide provides instructions for defining jobs interactively. You also create job
definitions in script files and then import them using the jil command or use CA
WCC to define them. For more information about the JIL command and JIL syntax,
see the Reference Guide. For more information about using CA WCC to define the
job, see the CA Workload Control Center Workload Scheduling Guide.

Example: Execute a CA Process Automation Process
This example executes a CA Process Automation process named /CAWAAE/Test Process
using the agent on the localhost machine and connecting to a CA Process Automation
installation on capamach.It uses the credentials from pamadmin@capamach to
authenticate on the Process Automation installation and passes values for the process
variable named strTestName. It will monitor the process until the process completes
and report success or failure at that time.
insert_job: execproc
job_type: PAPROC
machine: localhost
endpoint_URL: "http://capamach:8080/itpam/soap"
pa_name: "/CAWAAE/Test Process"
owner: pamadmin@capamach
pa_monitor_progress: Y
pa_parameter: param_name="strTestName", param_value="PA Test"
Define a Process Automation Start Request Form Job
You can define a Process Automation Start Request Form job to submit a Start Request
Form to execute a CA Process Automation process. The Start Request Form sets the
values for the current execution of the process.
. Define a Process Automation Start Request Form Job


Follow these steps: 
1. Insert a job and specify the following attributes in the definition:
job_type: PAREQ
Specifies that the job type is Process Automation Start Request Form.
machine
Specifies the name of the machine on which the job runs.
endpoint_URL
Specifies the target endpoint address URL in a Web Service or Process
Automation job.
pa_name
Specifies the fully qualified name of the process or Start Request Form in a
Process Automation job.
pa_path
Specifies the path of the Start Request Form.
Note: The path specified must end in a / character.

2. (Optional) Specify optional Process Automation Start Request Form attributes.
■ job_class
■ owner
■ pa_monitor_progress
■ pa_parameter
■ pa_trace
3. (Optional) Specify common attributes that apply to all jobs.
The Process Automation Start Request Form job is defined.
 Attributes with Default Values


Notes:
■ Attributes that have a default value automatically apply to the job definitions;
therefore, they are optional. For example, jobs with no specified job type are
defined as command jobs by default. Other optional attributes specify information
that is not required but affects how or when a job runs, such as attributes that
specify scheduling conditions.
■ Some optional attributes are common to all job types but others apply to certain
jobs types only. Optional attributes that apply to all job types are known as
common optional attributes. For more information about common optional
attributes and the values that you can specify for them (including their default
values when applicable), see the Reference Guide.
■ For information about required attributes and job type specific optional attributes,
see the procedure topics that provide instructions for defining jobs.
■ This guide provides instructions for defining jobs interactively. You also create job
definitions in script files and then import them using the jil command or use CA
WCC to define them. For more information about the JIL command and JIL syntax,
see the Reference Guide. For more information about using CA WCC to define the
job, see the CA Workload Control Center Workload Scheduling Guide.

Example: Submit a Start Request Form
This example submits a Start Request Form named Process A in the /CAWAE/ path. It
uses the credentials of the pamadmin@capamach user to authenticate the user on the
Process Automation installation on capamach.The Start Request Form has a field called
strTestName that will be populated with the value "PA Test" before the form is
submitted. The process will be tracked to completion.
insert_job: runsrf
job_type: PAREQ
machine: localhost
endpoint_URL: "http://capamach:8080/itpam/soap"
pa_name: "Process A"
pa_path: /CAWAAE/
owner: pamadmin@capamach
pa_monitor_progress: Y
pa_parameter: param_name="strTestName", param_value="PA Test"
Attributes with Default Values
Attributes that have a default value automatically apply to the job definition. Therefore,
you do not have to specify those attributes in the definition. Your agent administrator
can define some default values on the agent in the agentparm.txt file.
If you specify the attribute in a job definition, it overrides the default.
 Attributes with Default Values


The following Process Automation job attributes have default values:
owner
Specifies the Process Automation user. These credentials will be validated on the
Process Automation server.
Default: The user who invokes JIL to define the job
pa_monitor_progress
 Indicates whether the process is tracked to completion.
Default: Y; the process is tracked to completion.
pa_trace
Indicates whether a trace of SOAP messages is written to the spool file.
Default: N (A trace of SOAP messages is not written to the spool file.)
Note: For more information about JIL job types and other job definition attributes, the
values that you can specify for those attributes, and JIL syntax, see the Reference Guide.

Example: Track a Process Automation Process to Completion
The pa_monitor_progress attribute in the following job definition overrides the default
value.
insert_job: pam1
job_type: PAPROC
endpoint_url: "http://canor01-vm2k3c:8080/itpam/soap"
machine: paagent
owner: pamadmin@capamach
pa_name: "/ITPAM Tutorials/S01 Getting started/L01 Creating a Simple Process/L01-2
Running the Process/Running the Process"
pa_monitor_progress: Y
pa_trace: N