Operating System Interface Facilities

To improve efficiency and reduce duplication and inconsistency, GT.M is closely integrated with the host operating system environment. With GT.M you can gain access to the operating system facilities to examine:

The following table summarizes the GT.M operating system interface facilities.

Operating System Interface Facilities

EXTENSION

EXPLANATION

ZSYstem

Provides access to the shell.

$ZMessage()

Translates an error condition code into text form.

$ZCMdline

Contains a string value specifying the "excess" portion of the command line that invoked the GT.M process.

$ZJob

Holds the pid of the process created by the last JOB command performed by the current process.

$ZPARSE()

Parses a UNIX filename.

$ZSEARCH()

Searches for one or more UNIX files.

$ZSYstem

Contains the status code of the last ZSYSTEM.

$ZTRNLNM()

Translates an environment variable.

$ZDIRectory

Contains current working directory.

[Note] NOTE:

The OS services accessed by GT.M commonly treat a <NUL> character as a terminator therefore any in cases where application information passes to the OS as arguments an embedded <NUL> may cause non-obvious behavior.