IBM BJ0NJML Integration Guide - Page 169

Handlers For example, the file name MX_MXASSETInterface_10971102668641398.xml indicates that the file was generated from a system to send data to the external system EXTSYS1. The file name also indicates that the file contains the MXASSETInterface publish channel. CMDLINE Handler The CMDLINE handler is a handler that takes a command and an endpoint as input. The CMDLINE handler uses the SSH protocol to run the command on the target system and return the results. The metadata parameter that is passed during a system invocation when the handler is called is a map that contains the name of the endpoint that represents the target system. The caller can target any system at run time when the system passes the endpoint to the command handler. The caller uses whatever configuration the endpoint has at the time of the system invocation. The CMDLINE handler has the following properties: T CMDTIMEOUT - The timeout value for command execution T CONNTIMEOUT - The timeout value for the connection T USERNAME - The user name for the connection T PASSWORD - The password for corresponding user name T HOST - The host name of target where command is run T PORTNO - The port number of target where the command is run T IGNORESETUPERR - The boolean value to ignore an error running the setup command T RETRYINTERVAL - The time to wait between retrying a command T MAXRETRY - The number of attempts to run a command before returning an exception T SSHEXIT - The Java exit class that can be implemented to customize processing of the handler The data parameter is a byte array representation of an XML document. The data parameter contains the following information: T The tags that correspond to the setup command T The working directory T The command to run T Any substitution parameters Endpoints and Handlers 155