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

$$GATF^%ZISH(): Copy Global to Host File

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


This extrinsic function is used in the same way as the $$GTF^%ZISH API. The one difference is that if the file already exists, $$GATF^%ZISH appends global nodes to the existing file rather than truncating the existing file first.

NOTE: For more information, please refer to the $$GTF^%ZISH API API description.



Input Parameters


(required) Global to READ lines from, fully resolved in closed root form.


(required) Identifies the incrementing subscript level. For example, if you pass ^TMP(115,1,1,0) as the global_ref parameter, and pass 3 as the inc_subscr parameter, $$GATF will increment the third subscript (e.g., ^TMP[115,1,x]), but will READ nodes at the full global reference (e.g., ^TMP[115,1,x,0]).


(required) Full path, up to but not including the filename.


(required) Name of the file to open.




  • 1—Success.

  • 0—Failure.


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.