HCL Workload Automation, Version 9.4

submitJobStreamWithVarSub

Describes the submitJobStreamWithVarSub Web service for IBM Workload Scheduler for z/OS.

Description
Use this service to submit a job stream (application) in the IBM Workload Scheduler for z/OS plan and to assign values to any variables present in the included jobs. The variable substitution is performed only on promptable variables that are substituted at job set up phase. The other variables are substituted at submission time.
Note: The job stream must include no setup jobs. If it does, the following message is displayed:
EQQM229E 
   JCL BROWSE/EDIT CAN ONLY BE SELECTED FOR PROCESSOR WORKSTATIONS.
Input parameters
engineName
The name of the IBM Workload Scheduler for z/OS engine.
jsKey
The key identifying the job stream in the IBM Workload Scheduler for z/OS database. The valid format is jobStreamName.
schedTime
The input arrival time for the job stream.
deadlineTime
The completion dead line time for the job stream.
priority
The job stream priority value.
description
The job stream description. Maximum 24 characters.
groupName
The job stream group name. Maximum 16 characters.
ownerName
The job stream owner name. Maximum 16 characters.
ownerDescription
The job stream owner description. Maximum 24 characters.
authorityGroup
The job stream authority group. Maximum 8 characters.
dependenciesResolution
Specifies which type of dependencies are to be resolved. The value can be:
Y
Resolve both predecessor and successor dependencies.
N
Ignore all dependencies.
P
Resolve only predecessor dependencies.
S
Resolve only successor dependencies.
If no value is entered, the default is N.
variableTable
The name of the variable table associated with the job stream. Maximum 16 characters.
variableToBeSubstituted
An array of Property statements specifying the variables that will be substituted in the job stream. The Property statement is defined and documented in the TWS-Types.xsd file, and has the following form:
value
An array of values for the dataType.
dataType
A string identifying the variable for which you are supplying the value or values, and which can be found in the defined variable table.
Output
The service returns an array of the identifiers of the job streams that were actually submitted in the plan. Note that the plan object identifiers returned contain the '\0' character. This is not a valid character and must be replaced by a blank.