Append

Append one path to another.

append appends one path to another formatting the paths according to the optional systemtype parameter. If the system type is not specified, then the system type is taken from the Endpoint currently on the stack. If no Endpoint is on the stack, an exception is thrown.

append is also a method that can be called on an Endpoint object. In this case, the system type is taken from the Endpoint itself.

Usage

append(path1, path2 [, systemtype])

or

Server.append(path1,path2)

Returns

String: The result of appending path2 to path1, formatted according to the specified systemtype or the system type of the Endpoint object.

Example:


set res = append('/tmp', 'file.txt', 'unix');

//

// res is /tmp/file.txt
 //

set res = append(@'C:\Temp', 'file.txt', 'windows');

//

// res is C:\Temp\file.txt
 //

set res = append('$2$DKA200:[FERDU01]', 'file.txt', 'vms');

//

//res is $2$DKA200:[FERDU01]file.txt

//

See Also:

appendstd()

Last modified June 15, 2020: Remove extra headers in DMScript (102cb1a)