| ETERNUS SF XL-DATA/MV V13 User's Guide |
|
Contents
Index
|
| Chapter 2 : Setting the Operating Environment | > 2.6 Environment Settings on the Server System | > 2.6.1 UNIX/IA Server Environment Settings |
XL-DATA/MV is equipped with a function that allows users to convert the return code of the filter command to a custom return code.
The definitions of the conversion function take effect when they are specified in the filter command return code conversion file.
[Syntax]
Use the following rules to create the filter command return code conversion file:
- Create the file using the following file name:
For UNIX servers: .filter_mftf (in the user home directory)
For IA servers : filter.ini (in the installation folder)
- Up to 1030 bytes of characters can be specified per line.
- Comments begin with # and continue to the end of the line.
- Use spaces or tabs to separate the information.
- A conversion definition starts with "CMD=" and continues to the next "CMD=" text or the end of the file.
- One definition is specified per line for a return code of the filter command.
- If the same filter command or return code is defined more than once, only the first one is used.
- For the following cases, the Client System is notified of failure with the exception of the success code (return code 0).
- If the filter command return code conversion file does not exist.
- If the filter command definition does not exist.
- If the return code definition does not exist.
- If for some reason the return code definition could not be recognized.
[Information]
command
Specifies the filter command within 1026 bytes.
The valid number of characters for the filter command vary according to the server type of the system server.
| Server | Valid Number of Characters |
|---|---|
| UNIX/IA Server | 1026 bytes |
If the command specified here is an exact match with the filter command (not including the options) specified when the client server requests a data transfer (i.e., when executing the batch utility or transfer command), the return code conversion is applied.
Also, if the file name or directory name of the filter command contains blanks, then double quotes (" ") or single quotes (' ') must be used when the client system sends data transfer request.
(Use double quotes (" ") only when specifying commands on the IA server.)
This specification must match the specification of the filter command (not including the options) specified during the data transfer request for this case as well (the value within the quotes).
n
Specify the return code of the filter command to convert.
The allotted range is as follows:
UNIX server: 0 - 255
IA server : 0 - 4,294,967,295
NORMAL
When the return code of the filter command is the value specified by "n", the following return codes of the client system are set to indicate normal completion.
UNIX : 0
Windows: 0
WARNING q
When the return code of the filter command is the value specified by "n," the value of "q" is set as the return codes of the client system to indicate completions with warnings.
The following are values that can be assigned to "q":
| UNIX | : | 0 - 255 If a value above 255 is specified, the value is set to 255. |
| Windows | : | 0 - 4,294,967,295 If a value above 4,294,967,295 is specified, the value is set to 4,294,967,295. |
ERROR
When the return code of the filter command is the value specified by "n", the following return codes of the client system are set to indicate an abnormal completion.
UNIX : 255
Windows: -1
The following is examples:
When using "C:$Windows$command$tfmdp32.exe"
Filter command return code "1" is assigned to NORMAL,
Filter command return code "2" is assigned to "33",
Filter command return code "3" is assigned to ERROR
Also,
When using "C:$Program Files$soft$command$fmdp32.bat"
Filter command return code "1" is assigned to NORMAL,
Filter command return code "2" is assigned to "33",
Filter command return code "3" is assigned to ERROR
The above are used for the following conversion examples.
|
# sample CMD=C:$Windows$command$tfmdp32.exe 1 NORMAL 2 WARNING 33 3 ERROR CMD="C:$Program Files$soft$command$fmdp32.bat" 1 NORMAL 2 WARNING 33 3 ERROR |
(Note: "$" means a backslash.)
As long as the data transfer is not in progress, the .filter_mftf file (filter.ini file for Windows) can be changed. Changes take effect when the modified file is saved. Currently running daemons or services do not have to be restarted.
|
Contents
Index
|