WSGrid command-line utility
The WSGrid utility is a client application of the job scheduler message-driven interface. Use the WSGrid utility to facilitate control of WebSphere batch jobs by external workload schedulers, such as Tivoli Workload Scheduler.
The WSGrid utility is invoked by an external workload scheduler as part of a larger task choreography. The WSGrid utility submits a WebSphere batch job, then waits for its completion. The job log from the batch job is written to the standard output stream of the environment in which the WSGrid utility was invoked.
WSGrid supports three distinct ways of specifying a batch job. We can specify:
- An xJCL file.
- The name of an xJCL file in the job repository.
- A set of simple properties that describe the batch job.
Invocation
Use the following syntax for invoking the WSGrid utility:
Syntax:
- WSGrid{.bat|.sh}{-JVMOptions <jvm_options> -IIOP <scheduler_server_hostname>:<scheduler_server_iiop_port>}<job properties file>
The -JVMOptions parameter is optional and enables us to pass additional parameters to the JVM as needed. The -IIOP parameter is optional and enables us to pass the Scheduler server's hostname and IIOP port if it is something other than the default port of 2809. The job properties file is a fully-qualified path name to the file containing the WSGrid job properties. If specified alone, it must also contain WSGrid control properties.
- WSGrid{.bat|.sh}{-JVMOptions <jvm_options> -IIOP <scheduler_server_hostname>:<scheduler_server_iiop_port>}<control properties file><job properties file>
The control properties file is a fully-qualified path name to the file containing the WSGrid control properties.
- WSGrid{.bat|.sh}{-JVMOptions <jvm_options> -IIOP <scheduler_server_hostname>:<scheduler_server_iiop_port>}<control properties file><xJCL file>
The xJCL file is a fully-qualified path name to the file containing an xJCL job definition.
Related:
Configure the batch environment Job scheduler integration with external schedulers Set up the external scheduler interface using the default messaging provider WSGrid properties file examples