6.6 ^$JOB

FreeM fully implements ^$JOB per ANSI X11.1-1995, as well as several extensions proposed in the M Millennium Draft Standard.

The first subscript of ^$JOB represents the $JOB of the process.

If you KILL a first-level subscript of ^$JOB, the SIGTERM signal will be sent to the corresponding UNIX process, causing pending transactions to be rolled back and the process to be terminated. If the targeted process is in direct mode, the user will be prompted with options of either rolling back or committing any pending transactions.

The following subscripts are supported:

CHARACTER +R -U -D

Returns the character set of the job.

CWD +R +U -D

Returns or sets the current working directory of the job.

EVENT +R +U +D

The subtree contained under ^$JOB($J,"EVENT") defines asynchronous event handlers for the current job. Please see Asynchronous Event Handling for more information.

GLOBAL +R -U -D

Returns the global environment of the job.

IOPATH +R +U -D

Returns or sets the I/O path to be used by the OPEN command.

PRIORITY +R +U -D

Returns or sets the nice value of the FreeM job.

REVSTR +R +U -D

When set to 1, allows $EXTRACT to accept negative values.

ROUTINE +R -U -D

Returns the name of the routine currently being executed by the job.

SYMTAB +R +U -D

Returns or sets the current local variable symbol table in use.

FreeM supports two unique and independent symbol tables, allowing FreeM programs to maintain two independent sets of identically- or differently-named local variables per process.

The default symbol table is 0, and the alternate symbol table is 1, corresponding to the valid values for ^$JOB($JOB,"SYMTAB").

Setting this subscript to values other than 0 or 1 will result in a ZINVEXPR error.

$PRINCIPAL +R -U -D

Returns the value of $PRINCIPAL for the job.

$TLEVEL +R -U -D

Returns the current transaction level (value of $TLEVEL for the job.

$IO +R -U -D

Returns the current value of $IO for the job.

USER +R -U -D

Returns the UID of the user owning the job.

GROUP +R -U -D

Returns the GID of the group owning the job.

NAMESPACE +R +U -D

Returns or sets the name of the job’s currently-active namespace.

MATH +R +U -D

Returns or sets the mode in which decimal comparisons and arithmetic calculations are conducted. Valid values are FIXED, for fixed-point decimals having up to 20,000 digits of precision, as determined by the $ZPRECISION intrinsic special variable, and IEEE754, to use IEEE 754 floating-point decimals. When in IEEE754 mode, floating-point numbers maintain 18 digits of numeric precision.

IEEE754 mode will make mathematical calculations significantly faster, especially when accelerated by a floating-point processor, at the expense of precision and accuracy.

FIXED mode is recommended for financial calculations, or where precision and accuracy are valued over performance. FIXED is the default mode of FreeM operation.

Attempting to SET this node to values other than FIXED or IEEE754 will set $ECODE to M29.

This document was generated on September 10, 2021 using texi2html 5.0.