Creating Payload Processing Batch Controls
The last step is to create payload processing monitor batch controls based on the Payload Processing Monitor Template (D1-PLPRM) template. You can create separate batch controls for each head end system or for specific payload types, or any combination of both. For example, you might create a separate batch control for Itron OpenWay usage payloads and device event payloads. Creating specific batch controls allows more control when setting up batch process scheduling for payload processing. For instance, you may want to run usage payload processing every hour, but device payload processing every two hours.
To create a payload processing monitor batch control, search for the “Payload Processing Monitor Template” (D1-PLPRM) batch control, click Duplicate, enter a unique code for the duplicate batch control and click OK.
This new batch control can be used to process payloads received from head end systems.
Payload Processing Batch Control Parameters
Payload processing batch processing is controlled by the following parameters:
Parameter Name
Description
Detailed Description
Required?
includeFiles
Include Files
The pattern for types of files to pick up during polling. The parameter supports the "glob" syntax for using wildcard characters.
True
fileLocation
File Location
The Object Storage bucket to poll files from. This should be the Value of the File Location Extendable Lookup value for the appropriate bucket (usage or event).
True
processingConfiguration
Processing Configuration
The Value of the SGG Payload Processing Configuration Extendable Lookup value
True
errorLocation
Error Location
The Object Storage bucket where defected portions of payload and related rejection details are stored. This should be the Value of the File Location Extendable Lookup value for the appropriate “error” bucket.
True
postProcessingAction
Post Processing Action
Defines what happens to a file after it has been processed: delete (default), archive or rename. If "archive" is selected, an archive bucket should be provided.
False
archiveLocation
Archive Location
The Object Storage bucket where processed files are moved to. Required if the Post Processing Action is "archive". This should be the Value of the File Location Extendable Lookup value for the appropriate “archive” bucket.
False
processedFileExtension
Processed File Extension
The text to be appended to the file name after the file has been processed. Default is "PROCESSED".
False
maxRaiseSize
Maximum Raise Size
This parameter defines the maximum number of files that the batch program would submit for processing on each polling cycle. Default is No Maximum.
False
DIST-THD-POOL
Thread Pool
Thread pool name to use if the DEFAULT thread pool is not desired.
False
Note:
Refer to Creating Object Storage Locations for lists of suggested Object Storage buckets for each adapter.