Configuring Triggerable Service Tasks - NEW! 🚀

The actions of triggerable tasks are performed by STENG peers and are usually related to long-lasting operations - such as transports.

The action performed is just to request the schedule of an operation from a subsystem, persist the exit code obtained in the RC variable (if present). When the service task has completed, the flow will not continue but will be put in a wait state (0 resources required) until the scheduled operation is completed. Only then the process engine will be woken up, the RC variable value will be updated overwriting the schedule exit code with the effective code of the performed action and finally the instance will be re-triggered to proceed to the next step.

All Triggerable Service Tasks are organized with the description of the service task and the variables it contains.

List of Triggerable Service tasks in alphabetical order:

By design, all triggerable service tasks wait for a trigger before proceeding to the next step and that is why they always throw a BpmServiceException when receiving a schedule return code that is not 0 (Return Code OK). Otherwise, they will wait for an event that will never come, since the schedule operation failed.

Bind VirtualBox

Description

Given a FileSet ID it will be bound to the provided VirtualBox name.

Variables

ParameterTypeRequiredDescription
File IDVariableType.LONG

Y

Fileset ID to operate the BIND operation to
Virtual BoxVariableType.VIRTUAL_BOX

Y

Virtual Box name where the given FileSet ID will be bound to

Data Shaper Processor

Description

The Data Shaper Processor service task is used in worfklow templates to be consumed in Input, Mediation and Output Contracts to invoke Data Shaper graphs.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster hosting a Data Shaper installation that will be used to execute the graph
PayloadVariableType.DATASHAPER_PAYLOAD

Y

This variable will be dynamically filled at contract level with the required information to invoke a Data Shaper graph. Follow these steps to configure it: 1. Select a Sandbox. 2. Choose one of the graphs in the selected Sandbox. 3. The variables required by the selected graph to be executed will appear.

Event Notification

Description

It emits a notification on "Generic local action" event on the notification channel specified in the service task.

Variables

ParameterTypeRequiredDescription
notificationChannelNameVariableType.
NOTIFICATION_CHANNEL

Y

Name of the Notification channel that will receive the event.
actNameVariableType.STRING

Y

Logical name of the operation, used by DataWatcher when rendering a given actCode.
actAttrsPrefixVariableType.STRING

Y

This attribute is the prefix used in Action attributes; default is "actAttrs_".
Action attributes are a list of variables injected at runtime in workflow context. Each attribute is structured as a couple of:

- name: string element containing the name of the attribute (starting with the mentioned prefix).
- value: string element containing the value of the attribute.
Example:
actAttrs_MyAttrName=
MyAttrValue
actOutcomeVariableType.ENUM

Y

Allowed values:

- running
- success (default)
- failure
actErrCodeVariableType.STRING

N

This attribute plays a role only when actOutcome is set to failure and indicates the error code associated to the failure.
actErrMsgVariableType.STRING

N

This attribute plays a role only when actOutcome is set to failure and indicates the error code associated to the failure.
dcNameVariableType.STRING

Y

Logical name of the data container, typically a filename.

GUnzip File

Description

It invokes the SpGunzip service on an input file (gzip archive) and Gunzip it, producing a new file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input FileVariableType.STRING

Y

The full pathname (with filename) for the file to be uncompressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Return Code variableVariableType.STRING

Y

The workflow variable where final return code will be written

GZip File

Description

It invokes the SpGzip compression service on an input file that produces a gzip archive.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input FileVariableType.STRING

Y

The full pathname (with filename) for the file to be compressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Compression strategyVariableType.COMPRESSION_STRATEGY_LEVEL

Y

The strategy level of compression
Compression levelVariableType.STRING

Y

The level of compression
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

ICAP

Description

It performs an antivirus/DLP check on a file inside the filebox using a specific ICAP engine and returns the outcome of the check.

Input Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
IcapVariableType.ICAP

Y

The ID of the ICAP engine that will perform the scan
File IDVariableType.LONG

Y

The ID of the file to be checked (Tip: if the file is in a "FileDetail" variable, its ID can be retrieved with: ${file.getRegistryId()} )
Scan modeVariableType.ENUM

N

Scan mode (ANTIVIRUS or DLP)
Icap methodVariableType.ENUM

N

ICAP method (REQMODE or RESPMODE)
Exception If HarmfulVariableType.BOOLEAN

N

Throws an exception in case of scan error (e.g. the scan has been completed successfully and the file is harmful/contains sensitive data)
Exception On FailureVariableType.BOOLEAN

N

Throws an exception in case of scan failure (e.g. the scan failed because of a connectivity error or an unexpected error from ICAP server)

Output Variables

ParameterTypeDescription
icap_rcVariableType.STRINGResult of scan.
For a detailed list of all the possible results, see the table below.
icap_rcDescriptionNotes
"0"Scan performed successfully, the file is safe
"64"Scan performed successfully, the file is harmfulThis result can be returned only if
throwExceptionIfHarmful == false
"2"Scan not performed, file not foundThis result can be returned only if
throwExceptionOnFailure == false
"3"Scan not performed, file too bigThis result can be returned only if
throwExceptionOnFailure == false
"4"Scan not performed, the ICAP server is unreachableThis result can be returned only if
throwExceptionOnFailure == false
"5"Scan not performed, the ICAP server returned an errorThis result can be returned only if
throwExceptionOnFailure == false
"32"Scan not performed, some other error prevented itThis result can be returned only if
throwExceptionOnFailure == false

List files VirtualBoX

Description

Given a VirtualBox name all files bound to, it will be put as ExternalFile objects in the resulting File List variable.

Variables

ParameterTypeRequiredDescription
Virtual BoxVariableType.VIRTUAL_BOX

Y

Virtual Box name where the given FileSet ID will be bound to
File ListVariableType.STRING

Y

Variable that will contain the list of files as a result of the current operation. (Tip: You can cycle through elements of a list using the Subprocess object)

Local Execute Shell Command

Description

It invokes the Execute Shell command service provider.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
ExecutableVariableType.STRING

Y

The command to be executed in the commandline
ArgumentsVariableType.STRING

N

List of arguments to be passed to the command execution
🚀 This field handles blanks and special characters. As per the standard Unix protection methods, enclose filenames in single or double quotes. Examples:
ls -l "/tmp/max/Dir with blanks"
ls -l '/tmp/max/Dir with blanks'
touch "/tmp/max/Dir with blanks/$aa%bb&cc()dd=[]dd{};:zz.txt"
Std OutVariableType.STRING

Y

Name of a variable that will be filled with standard output logging
Std ErrVariableType.STRING

Y

Name of a variable that will be filled with standard error logging
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written
Return code managementVariableType.BOOLEAN

N

If checked, it will forcefully fail the command if a Return Code that is not 0 is returned. Otherwise, it completes with SUCCESS whatever the RC will be for backward compatibility

Local FileSystem SpLs

Description

It invokes the "LS" command on filesystem that lists the content of a local file system folder.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
UsernameVariableType.STRING

N

Username used by this command
PasswordVariableType.STRING

N

Password for the username used by this command
PathVariableType.STRING

Y

Specify local path where file listing will be performed
ListVariableType.STRING

Y

Variable that will contain the list of files as a result of the current operation. (Tip: You can cycle through elements of a list using the Subprocess object)
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Local SpConv

Description

It invokes SPCONV conversion Command Service that converts an input file codepage and EOL, creating a new file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input FileVariableType.STRING

Y

The input file path for conversion
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file to be converted
Input Code PageVariableType.CODE_PAGE

Y

The codepage of the input file
Output Code PageVariableType.CODE_PAGE

Y

The codepage that will be written to the output file
Input EOLVariableType.EOL

N

The EOL used in the input file
Output EOLVariableType.EOL

N

The EOL that will be written in the output file
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written

Local SpGet

Description

It invokes the SPGet Service that retrieves a file from a Virtual File System folder and saves it to a local folder.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
SourceVariableType.VIRTUAL_PATH

Y

Virtual path where the file will be taken
FileVariableType.STRING

Y

Filename that will be taken in the previously set virtual path
Destination PathVariableType.STRING

Y

Destination path where the fill will be placed by the task
File NameVariableType.STRING

N

Filename that will be used for the final file
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation
Return Code variableVariableType.STRING

Y

The workflow variable where final return code will be written

Local SpPut

Description

It invokes the Local SpPut service that retrieves a file from a local folder and uploads to a Virtual File System.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
FileVariableType.STRING

Y

Filename that will be get in the previously set virtual path
SourceVariableType.STRING

Y

Source path where the file will be get
DestinationVariableType.VIRTUAL_PATH

Y

The destination virtual path were the file will be placed
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation applied to the transport
FilesetID createdVariableType.STRING

Y

Name of the variable that will contain the RegistryID (FilesetID) of the created file
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Local VirtualPath SpLs

Description

It invokes the VirtualPath SPLS command that lists the content of a Virtual File System folder.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Virtual PathVariableType.VIRTUAL_PATH

Y

The virtual path to use for file listing in the current operation. (Tip: It's a remote path, so plain String, not a VirtualPath)
File ListVariableType.STRING

Y

Variable that will contain the list of files as a result of the current operation. (Tip: You can cycle through elements of a list using the Subprocess object)
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written

Mail pull

Description

It invokes the SpMailPull command service that retrieves a Mail from a remote file system and writes it to a Virtual file system.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
VFS unverifiedVariableType.STRING

Y

The virtual file system where email(s) that are not verified will be placed
Remote pathVariableType.STRING

Y

The Remote Path
VFS verifiedVariableType.STRING

Y

The virtual file system where email(s) that are verified will be placed
VFS discardedVariableType.STRING

Y

The virtual file system where email(s) that are discarded will be placed
RawVariableType.STRING

Y

The virtual path folder name where the raw mail is stored
Attachment Virtual PathVariableType.STRING

N

The virtual path folder name where the attachment is stored
DispositionVariableType.STRING

N

The email desired disposition behavior
Return Code variableVariableType.STRING

N

The workflow variable where the final return code will be written

Mail push

Description

It invokes the SpMailPush command service that sends a Mail from a Virtual file system.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
ToVariableType.STRING

Y

The Destination of the email
FromVariableType.STRING

Y

The Sender of the email
SubjectVariableType.STRING

Y

The Subject of the email
BodyVariableType.STRING

Y

The body of the email
RawVariableType.STRING

Y

The virtual path folder name where the raw mail is stored
FileSet IdVariableType.LONG

N

The referenced FilesSet ID for this email
Mail SignVariableType.STRING

N

Whether the email sign is required or not
Alias SignVariableType.STRING

Y

The email sign alias key (mandatory if 'Sign Mail' is required)
Return Code variableVariableType.STRING

N

The workflow variable where the final return code will be written

Mail push templated

Description

It invokes SpMailPush templated command service.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
ToVariableType.STRING

Y

The Destination of the email
FromVariableType.STRING

Y

The Sender of the email
SubjectVariableType.STRING

Y

The Subject of the email
TemplateIdVariableType.STRING

Y

The identifier to the HTML template to be used for the body
Return Code variableVariableType.STRING

N

The workflow variable where the final return code will be written

PGP Crypt File

Description

It invokes the PGP Crypt service on an input file that produces a crypted file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input fileVariableType.STRING

Y

The full pathname (with filename) for the file to be crypted
Output fileVariableType.STRING

Y

The full pathname (with filename) for the output file
Operation securityVariableType.SECURITY_ OPERATION

Y

The security operation
RecipientVariableType.STRING

Y

The recipient of the file
Alias keyVariableType.STRING

Y

The alias key to use for encryption
Hash algorithmVariableType.SECURITY_ SIGNATURE_HASH_ALGO

Y

The hash algorithm of security signature
Cipher algorithmVariableType.SECURITY_ CHIPER_ALGO

Y

The cipher security algorithm
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written
PGP formatVariableType.STRING

Y

The PGP format in binary or ascii-armor

PGP Decrypt File

Description

It invokes PGP Decrypt service on an input crypted file and it produces a decrypted file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input fileVariableType.STRING

Y

The full pathname (with filename) for the file to be decrypted
Output fileVariableType.STRING

Y

The full pathname (with filename) for the output file
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written
PGP formatVariableType.STRING

Y

The PGP format in binary or ascii-armor

Remote SpLs

Description

It invokes the Remote SpLs service that lists the content of a remote folder.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Remote pathVariableType.STRING

Y

The remote path to use in the current operation. Tip: It's a remote path, so plain String, not a VirtualPath.
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation
ListVariableType.STRING

Y

Variable that will contain the list of files as a result of the current operation. (Tip: You can cycle through elements of a list using the Subprocess object)
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written

Remote SpMkdir

Description

It invokes the SpMkdir service that creates a new folder on a remote path.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Remote pathVariableType.STRING

Y

The remote path of the folder to create
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Remote SpMv

Description

It invokes the SpMv service that moves a file from a source location to a destination.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
SourceVariableType.STRING

Y

The source path to be moved
PathVariableType.STRING

Y

The destination path after the move command has been performed
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation applied to the transport
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Remote SpPull

Description

It invokes the SpPull service that retrieves a file from the file system and writes it to a virtual path.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Remote path and filenameVariableType.STRING

Y

The remote absolute path (path and filename) to pull the file from
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation applied to the transport
DestinationVariableType.VIRTUAL_PATH

Y

The destination virtual path where the file will be placed
Dest FilenameVariableType.STRING

Y

The name of the file to set once pulled
FilesetID createdVariableType.STRING

Y

The name of the variable that will contain the RegistryID (FilesetID) of the created file
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Remote SpPush

Description

It invokes the SpPush service that retrieves a file from a virtual path and writes it to a file system path.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
File IDVariableType.LONG

Y

The ID of the file to be pushed (Tip: if the file is in a "FileDetail" variable, its ID can be retrieved with: ${file.getRegistryId()} )
Remote PathVariableType.STRING

Y

The remote path to place the file into
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation applied to the transport
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Remote SpRm

Description

It invokes Remote SpRm service that removes a file identified in the remote path.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Remote pathVariableType.STRING

Y

The remote path to use in the current operation. Tip: It's a remote path, so plain String, not a VirtualPath
Transfer profileVariableType.TRANSFER_PROFILE

Y

The transferProfile to use. Tip: It's a configured server where the current task will happen.
Resource profileVariableType.RESOURCE_PROFILE

N

The resourceProfile, if any, to be applied during the operation
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written

Spjz Sub

Description

Submit JCL in zOS platform.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
DatasetVariableType.STRING

Y

Directory name
MemberVariableType.STRING

N

File name
JES Reader ClassVariableType.STRING

Y

JES Reader Class
FilesetIdVariableType.LONG

Y

The ID of the file to be used in ZOs job (Tip: if the file is in a "FileDetail" variable, its ID can be retrieved with: ${file.getRegistryId()} )
Return codeVariableType.STRING

Y

The workflow variable where the final return code will be written

Tar File

Description

It invokes the SpTar service on an input file and produces a tar output file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
FileVariableType.STRING

Y

The full pathname (with filename) for the file to be compressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

UnBind VirtualBox

Description

Given a FileSetID, the association between it and the provided VirtualBox name will be deleted.

Variables

ParameterTypeRequiredDescription
File IDVariableType.LONG

Y

Fileset ID to operate the BIND operation to
Virtual BoxVariableType.VIRTUAL_BOX

Y

Virtual Box name where the given FileSet ID will be bound to

UnTar File

Description

It invokes the SpUnTar service on a tar input file and produces an untar output file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
FileVariableType.STRING

Y

The full pathname (with filename) for the file to be uncompressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

UnZip File

Description

It invokes the SpUnZip service on a zip input file and produces an unzip output file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input FileVariableType.STRING

Y

The full pathname (with filename) for the file to be uncompressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Compression ModeVariableType.ENUM

N

The compression mode of Compression64Mode (ALWAYS or NEVER)
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written

Zip File

Description

It invokes the SpZip compression service on an input file and produces a zip output file.

Variables

ParameterTypeRequiredDescription
ClusterVariableType.CLUSTER

Y

The cluster to be used
Input FileVariableType.STRING

Y

The full pathname (with filename) for the file to be compressed
Output file PathVariableType.STRING

Y

The full pathname (with filename) for the output file
Compression StrategyVariableType.COMPRESSION _STRATEGY_LEVEL

Y

The strategy level of compression
Compression LevelVariableType.STRING

Y

The level of compression
Compression ModeVariableType.ENUM

N

The compression mode of Compression64Mode (ALWAYS or NEVER)
Return Code variableVariableType.STRING

Y

The workflow variable where the final return code will be written