Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$MV^%ZISH(): Rename Host File

Reference Type: Supported, Category: Host Files, Integration Agreement: 2320

Description

This extrinsic function renames a Host file. The function performs the renaming, regardless of the underlying operating system, by first copying the file to the new name/location and then deleting the original file at the old name/location.

Format

  $$MV^%ZISH([path1,]filename1[,path2],filename2)

Input Parameters

path1:

(optional) Full path of the original file, up to but not including the filename. If null, it will default to $$DEFDIR^%ZOSV.

filename1:

(required) Name of the original file.

path2:

(optional) Full path of renamed file, up to but not including the filename. If null, it will default to $$DEFDIR^%ZOSV.

filename2:

(required) Name of the renamed file.

Output

returns:

Returns:

  • 1—Success.

  • 0—Failure.

Example

>S Y=$$MV^%ZISH("","TMP.DAT","","ZXG"_I_".DAT")

 


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.