NetEx EFT213 Reference Manual Rel 5.4

Normally, without ON LOCAL_ERROR or ON REMOTE_ERROR specified, NetEx/eFT just ignores hosterrors and continues processing the next command.For further details about the ON command, see “Command Descriptions” on page 115.Checking Command StatusThe status() function allows the user to write scripts that check the status of the previous command and takeaction accordingly. A simple example appears below:** Print status of a single file transfer.*set input continue onsend -quiet src_filetext Transfer {eqs(status(), "S", "Successful.", "Failed.")}The example above demonstrates how status() can be used to print the results of the previous command (inthis case SEND). Status() returns either an “S” for Success, or an “E” for Error. Since it is a string function,the result is a string. Status() can be combined with any other string function or NetEx/eFT command to enhancescript processing. Above, it is used with the eqs() function to check the results which are then printedby the TEXT command.Refer to the section on string functions for more details and examples of the status() function.Creating NetEx/eFT AliasesAliasing is simply another form of NetEx/eFT scripting. Although the previous sections discussed scriptingin the context of INPUT files, everything described applies to NetEx/eFT aliases. Aliases can be thought ofas NetEx/eFT input files. In fact, a multicommand alias (discussed later) is treated in exactly the same way.The difference between a multicommand alias and an input script is the way in which they are defined. Asmentioned earlier, input scripts are defined using a standard text editor. Aliases are defined using the SETALIAS command.The alias capabilities of NetEx/eFT provide a means of creating a custom command set that can be used by allusers or a group of users. An alias is simply a new name for a NetEx/eFT command or set of commands.The following example shows how to create a simple alias (or new command) called FETCH that is equivalentto the RECEIVE command:eFT> set alias fetch receiveTo display the definition of the new alias, use the SHOW ALIAS command:eFT> show alias fetcheFT: FETCH ............. receiveThe alias name FETCH appears on the left and its translation or definition appears on the right. Now to transfera file from the remote host to the local host, either the RECEIVE command or the FETCH alias can beused. All qualifiers and parameters for the RECEIVE command are also valid for FETCH since NetEx/eFTjust maps FETCH to RECEIVE. The RECEIVE command is executed, but as far as the user is concerned, thecommand executing is FETCH. Therefore, the following are equivalent:eFT> fetch -quiet -mode character sourcefileand,eFT> receive -quiet -mode character sourcefilePage 96 Advanced Local User’s Guide REF-eFT213-R5.4-08