Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(5)$ZUTIL(5)Returns current namespace or switches to another namespace.$ZUTIL(5,current)$ZU(5,current)ParameterscurrentOptional — Namespace to be made current, enclosed in quotation marks.DescriptionThis function can be used to return a job's current namespace or to switch a job's currentnamespace to another namespace:• To return the job's current namespace, use $ZUTIL(5) with no argument.• To change the current namespace, use $ZUTIL(5) with the namespace name as the secondargument.After you issue $ZUTIL(5,current), Caché draws routines and globals from the Cachédatabase in this new namespace. Your effective working namespace also changes.ParameterscurrentThis field specifies the namespace that will be made current. Enclose the namespace namein double quotes. The namespace you use can be an explicit namespace or an impliednamespace. An implied namespace is a directory path or OpenVMS file specification precededby two caret characters: either "^^dir" (on the current system), or "^system^dir".Namespace names are case-insensitive. Caché always displays explicit namespace names inall uppercase letters, and implied namespace names in all lowercase letters.Notes$ZUTIL(5,current) retains the information Caché needs to return from routines in the newnamespace. When a routine in the new namespace quits, it returns correctly to the routinethat called it, which may return to its caller in the same or other namespaces, and so on.Subsequent routine calls, however, continue to refer to the namespace named in$ZUTIL(5,current).Caché ObjectScript Reference 567