Using the Caché ^%R Routine - InterSystems Documentation

More documents

Recommendations

Info

Note: Current users of Caché are strongly advised to use either 0 or 9 as appropriate. The remaining values should only be used for maintaining or updating legacy applications. Versioning There are entry points in %R that provide a limited form of version control when used with the "B" option to the ROUTINE entry point. They provide for keeping a specified number of previous “ancestor” versions of the specified routine available, and for being able to recover them as needed. For details, see VERMAX, VERMAXSET, VERSION1, and VERSION. Note: If you do not wish to use versioning at all, you may set the maximum to zero. Alternatively, you may kill the system globals ^rBACKUP, as well as ^rMACSAVE and ^rINCSAVE. Entry Points The publicly supported entry points in ^%R grouped functionally are: Name Interpretation Entry Point ParseRoutineName Purpose Separate a routine name into its component parts General Routine Manipulation Entry Point ROUTINE FMTERR CHECK DATE DEL EXISTS LANG LANGSET LENGTH SIZE LINE Purpose Compile, save, or load source code in database Display errors Check syntax of source code Get the saved routine date Remove a routine from the database Check to see if a routine exists Get the source language indicator for a routine Set the source language indicator for a routine Count the source lines in a routine Count the source characters in a routine Return a line from a saved routine 4 Using the Caché ^%R Routine
ParseRoutineName^%R Entry Point LINESET LOCK UNLOCK Purpose Insert/replace a new source line in a saved routine Attempt to gain exclusive use of a saved routine Gives up exclusive use of a saved routine Version Control Entry Point VERMAX VERMAXSET VERSION1 VERSION Purpose Returns the maximum number of versions to keep as backups Sets the maximum number of versions to keep as backups Returns the version number of the oldest backup Returns the version number corresponding to a relative version number For more information on Caché ObjectScript functions generally, see the section “Functions” in Using Caché ObjectScript. ParseRoutineName^%R ParseRoutineName^%R (rtn, .extent, .version, .namesp) Parameters rtn extent version namesp The name of the target routine. A string holding the parsed extension. A string giving the version number. A string giving the namespace, if any, contained in the routine name. Description This function provides access to the routine name parser used by the other entry points of ^%R. Using the Caché ^%R Routine 5
Page 1 and 2: Using the Caché ^%R Routine Versio
Page 3: Table of Contents Using the Caché
Page 6 and 7: • under certain circumstances, th
Page 10 and 11: ParseRoutineName^%R Parameters rtn
Page 12 and 13: ROUTINE^%R • Retrieve saved sourc
Page 14 and 15: ROUTINE^%R WARNING! This example cr
Page 16 and 17: CHECK^%R Remarks This routine refor
Page 18 and 19: DATE^%R DATE^%R DATE^%R (rtn, forma
Page 20 and 21: DEL^%R DEL^%R DEL^%R (rtn, namesp)
Page 22 and 23: LANG^%R LANG^%R LANG^%R (rtn, names
Page 24 and 25: LENGTH^%R Remarks This function cha
Page 26 and 27: SIZE^%R SIZE^%R SIZE^%R (rtn, names
Page 28 and 29: LINE^%R Parameters rtn The name of
Page 30 and 31: LINESET^%R Parameters rtn A string
Page 32 and 33: LINESET^%R ; Change the namespace w
Page 34 and 35: VERMAX^%R Description This function
Page 36 and 37: VERMAX^%R ; Change the namespace we
Page 38 and 39: VERSION1^%R Remarks This function s
Page 40: VERSION^%R Examples See the example

Using the Caché ^%R Routine - InterSystems Documentation

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?