Scroll to navigation

DCLEXEC(1) GFD Dennou Club Library DCLEXEC(1)

NAME

dclexec - execute a command with DCL options converted to environment variables

SYNOPSIS

dclexec command [ options ]

DESCRIPTION

dclexec is a wrapper utility included in the GFD Dennou Club Library (DCL). It executes the specified command while setting environment variables derived from DCL-style command-line arguments.

This is useful for programs that expect DCL runtime parameters (like window size or colormap settings) to be provided via environment variables rather than direct command-line arguments.

Transformation Rule

The program scans arguments starting from the second parameter (the first parameter is the target command). If an argument matches the DCL option format:

-xx:yy=value

It performs the following transformation:

1.
Removes the leading hyphen (-).
2.
Converts the parameter name part (before the equals sign) to uppercase.
3.
Prefixes it with the env command.

For example, the argument -sw:lwait=false is converted to the environment variable export SW:LWAIT=false.

OPTIONS

dclexec parses arguments that follow the format -xx:yy=value (specifically, arguments starting with a hyphen, having a colon at the 4th character, and containing an equals sign).

Note: Any arguments that do not match this specific DCL option format are ignored and are not passed to the target command.

EXAMPLES

To run a program named my_dcl_prog with specific DCL parameters converted to environment variables:

$ dclexec my_dcl_prog -sw:width=500 -sw:iclrmap=10

This effectively executes:

$ env SW:WIDTH=500 SW:ICLRMAP=10 my_dcl_prog

AUTHORS

Youhei SASAKI <uwabami@gfd-dennou.org>, GFD Dennou Club

SEE ALSO

env(1), dclconfig(1)

2026-01-23 DCL 7.5.2