com.ibm.wsspi.batch.parallel

Class Parameterizer

  • All Implemented Interfaces:
    java.lang.Comparable


    public abstract class Parameterizer
    extends SPI
    Parameterizer is the abstract base class for the ParallelJobManager Parameterizer System Programming Interface (SPI). Use the Parameterizer SPI to parameterize a parallel job submission. The parameterization includes specifying the number of subjobs to create for a parallel job and the substitution properties to pass to each subjob.

    Implement the Parameterizer SPI, by extending this class and implementing the parameterize method.

    Configure this SPI with the following declaration in the xd.spi.properties file:

     spi.parallel.Parameterizer=<fully-qualified implementation class name>
     

    Notes:

    The xd.spi.properties file is located in:
     <WAS install root>/properties.  E.g.
     
           /WebSphere/AppServer/properties
     
    The jar file containing the implementation of this SPI should be stored in:
     <WAS install root>/lib/classes.  E.g.
     
           /WebSphere/AppServer/lib/classes
     
    You are responsible to create the classes directory if it does not already exist.
    • Constructor Summary

      Constructors 
      Constructor and Description
      Parameterizer() 
    • Method Summary

      Methods 
      Modifier and Type Method and Description
      java.lang.String getName()
      Returns the name of this SPI instance.
      abstract com.ibm.wsspi.batch.parallel.Parameters parameterize(java.lang.String logicalJobName, java.lang.String logicalTXID, java.util.Properties props)
      Parameterizes a parallel job submission.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • Parameterizer

        public Parameterizer()
    • Method Detail

      • parameterize

        public abstract com.ibm.wsspi.batch.parallel.Parameters parameterize(java.lang.String logicalJobName,
                                                           java.lang.String logicalTXID,
                                                           java.util.Properties props)
        Parameterizes a parallel job submission. Parameterization specifies:
        1. number of subjobs to dispatch for this parallel job
        2. substitution properties for each subjob

        This method is invoked by ParallelJobManager at start of parallel job processing.

        Parameters:
        logicalJobName - specifies name of the current parallel job. This name is the same each time you submit the same parallel job.
        logicalTXID - specifies a unique identifier for the current parallel job instance. This identifier defines a logical unit of work in which all subjobs for the current parallel job execute.
        props - specifies the input properties to the parallel job. These properties are user specified, but must include the reserved property, com.ibm.wsspi.batch.parallel.subjob.name, which specifies the name of the job definition (xJCL) in the job repository that serves as the template for all subjob instances belonging to this parallel job. Optional reserved property, com.ibm.wsspi.batch.parallel.logicalTXID, may also be specified to provide an external identifier for the parallel job's logical transaction.
        Returns:
        Parameters object that specifies parameterization for the current parallel job. This includes the number of subjobs to create for this parallel job instance and an array of Properties objects, one per subjob, that contains substitution properties for the target subjob xJCL. The number of elements in this array must equal the specified number of subjobs.
      • getName

        public java.lang.String getName()
        Description copied from class: SPI
        Returns the name of this SPI instance. Should return a unique identifier.
        Specified by:
        getName in class SPI
IBM WebSphere Application ServerTM
Release 8.5