NetEx EFT213 Reference Manual Rel 5.4

set input continue on** Loop until successful connection.*again:ask -prompt "Hostname? " hostconnect -quiet {host}{eqs(status(), "S", "text Connect worked.", "goto again")}This script also makes use of the eqs() function. Eqs() compares the result of status() with the string “S”(Success). If the strings compare (i.e., if the CONNECT was successful), the third argument of eqs() is usedto replace the function in the substitution. If the strings do not compare, the fourth argument is used.Notice that these last two arguments are simply NetEx/eFT commands enclosed in double quotes. The thirdargument “text Connect worked.” prints a message at the user’s terminal and continues processing. Thefourth argument “goto again”, causes processing to loop back to the ‘again:’ label where the user is promptedfor a new hostname. The GOTO command is discussed in a later section.The remainder of this section describes the NetEx/eFT string functions in more detail. The functions arelisted in alphabetical order except where functions are grouped by a logical association (for example, arithmeticoperations). Each function is indexed individually.The descriptions assume the user is familiar with NetEx/eFT strings and string variables as described in thesection entitled “String Variables” on page 63 is a list of the available string functions. Most of these functionsfollow the table in alphabetical order, however the arithmetic and logical functions are grouped together.Table 3. List of FunctionsFunction Description PageADD Adds two numeric string expressions and returns the result. 69CHRCMPReturns a single character represented by the specified number in the local hostmachine’s native character set (ASCII or EBCDIC).Compares two strings. Allows for partial string match by specifying the requiredcharacters in upper case.DATE Returns the system date of the local host. 72DEC Subtracts one from a numeric string expression and returns the result. 73DFN Tests if a variable is defined. 74DIVENCryptENVDivides the first numeric string expression specified by the second and returnsthe result.Used to encrypt user passwords which will be used by NetEx/eFT to establishconnections to remote hosts.Returns the value of the local host environment variable if the local host supportssuch variables. If local host environment variables are not supported orif the specified variable is not defined, a null string is returned.EQ Tests if the first number specified is equal to the second number specified. 81EQS Tests if the first string specified is equal to the second string specified. 77EXT Extracts and returns a bounded sequence of characters from a string. 787071697575REF-eFT213-R5.4-08 Advanced Local User’s Guide Page 67