Chapter 10. Utility Routines

Revision History
Revision V7.1-00323 November 2023
Revision V7.1-00219 September 2023
Revision V7.0-00223 March 2022
Revision V7.0-00124 November 2021
Revision V7.0-00012 February 2021
Revision V6.3-01208 April 2020
Revision V6.3-01120 December 2019
Revision V6.3-00927 June 2019
Revision V6.3-00824 April 2019
Revision V6.3-00704 February 2019
Revision V6.3-00626 October 2018
Revision V6.3-00423 March 2018
  • In “%PEEKBYNAME()”, Added note about RO database implications

  • In “ %GCE”, change strexpr to expr; add more information about $DEVICE.

  • In “ %GSE”, Updated %GSE entry to contain QUIET Utility Label

  • In “ %RCE”, Updated %RCE entry to include QUIET and QCALL utility labels.

  • In “ %RSE”, Updated %RSE entry to include QUIET and QCALL utility labels.

Revision V6.3-00222 August 2017
  • In “%PEEKBYNAME()”, add an entry for jnlpool_ctl_struct.instfreeze_environ_inited replication parameter.

Revision V6.3-00120 March 2017
Revision V6.0-00121 March 2013

Added the following sections:

In “ %XCMD”, added the description of the LOOP^%XCMD utility label.

GT.M provides library utilities to perform frequently used tasks, and to access frequently used information. Most of the utilities are for GT.M programmers, but some provide tools for system administration and operation.

The GT.M utilities fall into the following general categories:

  • Date and time utilities

  • Conversion utilities

  • Mathematic utilities

  • Global utilities

  • Routine utilities

  • Internationalization utilities

  • System Management utilities

  • UTF-8 mode Utility Routines

The GT.M distribution includes the source files for these utilities. The default installation compiles them to produce object modules in the $gtm_dist distribution library.

You may wish to examine the utilities and include some of them in your programs if the programs access the function frequently or you may want to modify the utilities to better fit your particular needs. If you modify a utility, store your copy in a directory that precedes gtm_dist in the search list $ZROUTINES to prevent a new release of GT.M from overwriting your copy.

loading table of contents...