Files Used by the UTILX Utility

The UTILX utility uses the following files to interact with an external process:

  • STDIN is the Standard Input file to the external process.

  • STDOUT is the Standard Output file to the external process.

  • STDERR is the Standard Error file for the external process to report errors.

You can use file equation to change the attributes of STDIN, STDOUT, and STDERR files. These files default to REMOTE files when run from a CANDE or MARC session.

When initiated from the ODT, you can supply input to the external process using the AX (Accept) command. You can report all output using the DISPLAY command. Alternatively, you can file equate STDOUT or STDERR to media, such as a disk file, to report the output.

The UTILX utility supports several unique file options for STDIN, STDOUT, and STDERR files. You can specify these values using the IOHSTRING file attribute. These attributes are the same as the attributes supported by the RUNX utility. For more information, refer to topic, “RUNX Utility” found earlier in this manual.

Input Options

The input <text> to the UTILX utility identifies the external program to be run. The input text is specified as docker, which limits the external task to be run to a Docker command.

Examples

The following example returns the current Docker version:

RUN *SYSTEM/UTILX(̎version̎)