Send File

Operation Name

Send File

Function Overview

Run the Send File command (utlsend).

Properties

Properties

For information about using variables, refer to "variables".
Basic settings
Item name Required/Optional Use of Variables Description Remarks
Name Required Not available Enter a name that is used on the script canvas.  
Required settings
Item name Required/Optional Use of Variables Description Remarks
HULFT Environment Settings Required Not available Select a global resource.
For details on setting a global resource, refer to "Global Resource Properties".
  • [Add]:
    Adds a new global resource.
  • [Edit list]:
    Opens the Edit Resource List screen on which you can edit the settings of a global resource.
  • When you select a global resource, the application automatically acquires a list of the File ID, the Transfer Group ID, and the Host Information that have been registered in HULFT, and you can view those values as options for each field.
File ID Required Available Enter or select a value for the File ID to be sent.
  • Specify in alphanumeric characters up to 8 bytes in size, if HULFT7 is selected in [HULFT Environment Settings].
  • Specify in alphanumeric characters up to 50 bytes in size, if HULFT7 is not selected in [HULFT Environment Settings].
Synchronization Preference Required Not available Enable or disable the Synchronous Transfer Request.
  • [Synchronous Transfer]: (Default)
  • [Asynchronous Transfer]:
  
Synchronous Transfer Timeout Required Not available Select the preference of the Synchronous Transfer Timeout.
  • [Use HULFT Settings]: (Default)
    HULFT setting value is used.
  • [Set Timeout Value]:
    The time that you specify for the Timeout (Sec.) is used.
  • This field is enabled when you select 'Synchronous Transfer' for the Synchronization Preference.
Timeout (Sec.) Optional Available Enter a timeout value.
  • Specify a number in the range of '10' to '259200.'
  • This field is enabled when you select 'Set Timeout Value' for the Synchronous Transfer Timeout.
Option
Item name Required/Optional Use of Variables Description Remarks
Send File Name Optional Available Enter a Send file name.

Click [Browse] button to activate the file Selectr and select the file.
  • Specify in characters up to 200 bytes in size.
  • Use an absolute path for the DataSpider file system to specify a file path.
  • The application cannot send files in the database file system.
  • You cannot use Characters forbidden in the DataSpider file system other than the path delimiter character '/.'
  • If this field is not set, the application uses the file name that is registered in the Send Management Information.
Send Destination Required Not available Select the method of specifying the destination.
  • [Transfer Group]: (Default)
  • [Host Name]:
  • Depending on the selected method of specifying the send destination, the input item name changes to [Transfer Group] or [Destination Host of Sending].
Transfer Group Optional Available Enter or select a transfer group.
  • This field is enabled when you select 'Transfer Group' for the Send Destination.
  • Specify in alphanumeric characters up to 8 bytes in size, if HULFT7 is selected in [HULFT Environment Settings].
  • Specify in alphanumeric characters up to 50 bytes in size, if HULFT7 is not selected in [HULFT Environment Settings].
  • If this field is not set, the application uses the group name that is registered in the Send Management Information.
Destination Host of Sending Optional Available Enter or select the destination host of sending.
  • This field is enabled when you select 'Host Name' for the Send Destination.
  • Specify in alphanumeric characters up to 68 bytes in size.
  • If this field is not set, the application uses the host name that is registered in the Send Management Information.
Priority Preference Required Not available Select the method of specifying the priority.
  • [Use HULFT Default Value]: (Default)
    HULFT default value is used.
  • [Specify Priority]:
    The value that you specify for the Priority is used.
  
Priority Optional Available Enter the priority.
  • Specify a number in the range of '1' to '256'.
  • Relatively small values have higher priority.
  • This field is enabled when you select 'Specify Priority' for the Priority Preference.
Message settings
Item name Required/Optional Use of Variables Description Remarks
Message0 Optional Available Enter a message.
  • Specify in characters up to 50 bytes in size.
  • If these fields are not set, the application does not send a message to the host on the receiving side.
Message1
Message2
Message3
Message4
Message5
Long Message0 Optional Available Enter a long message.
  • Not displayed, if HULFT7 is selected in [HULFT Environment Settings].
  • Specify in characters up to 200 bytes in size, if HULFT7 is not selected in [HULFT Environment Settings].
  • If these fields are not set, the application does not send a message to the host on the receiving side.
Long Message1
Comment
Item name Required/Optional Use of Variables Description Remarks
Comment Optional Not available You can enter a simple description about the adapter.
You can reflect the description in the specification.		  

Schema

Input Schema

None.

Output Schema

None.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available component variables

Component variable name Description Remarks
exit_status Stores the termination status of the Send File command (utlsend) after the command runs.
  • The default value is null.
message_category Stores the category of the error message code when an error occurs.
  • The default value is null.
message_code Stores the error message code when an error occurs.
  • The default value is null.
message_level Stores the severity level of the error message code when an error occurs.
  • The default value is null.
error_type Stores the error type when an error occurs.
  • The default value is null.
  • The format of the error type is as follows.
    Example: java.io.FileNotFoundException
  • The stored content may vary depending on the version of HULFT.
error_message Stores the error message when an error occurs.
  • The default value is null.
  • The stored content may vary depending on the version of HULFT.
error_trace Stores the trace information when an error occurs.
  • The default value is null.
  • The stored content may vary depending on the version of HULFT.

Specification Limits

Main exceptions

Exception name Cause Solution
HulftResourceNotFoundException The [HULFT Environment Settings] is not specified. Specify the [HULFT Environment Settings].
java.io.IOException Process creation failed. The path to bin for HULFT may not be set properly due to incorrect resource settings.
HulftRuntimeExecutionException The Status Code is not 0 after a command runs. For details, check the message that is output in a log and also refer to manuals for HULFT.
InvalidPropertyConfigurationException The property configuration is incorrect. Check each property setting for the presence of any of the following states:
  • The number of characters exceeds the upper limit.
  • An invalid character is used.
  • A required field is not set.

Notes