Specifying Animator Directives [ Micro Focus COBOL System Reference, Volume 1 ] MPE/iX 5.0 Documentation
Micro Focus COBOL System Reference, Volume 1
Specifying Animator Directives
You can use directives when Animator is invoked to modify its behavior.
You specify directives after the program name on the command line before
pressing Enter to begin animation or in the cobol.dir file.
The format for specifying directives is given here; descriptions of the
directives available are provided in the appendix Directives for
Animator.
On DOS, Windows and OS/2, use the following format for Animator
directives: (DOS, Windows and OS/2)
[ / ] [no] keyword "parameter"
where:
/ is an optional forward slash that immediately precedes the
directive.
no turns keyword off. no can either adjoin the keyword or be
separated from it by one or more spaces. no applies to
only certain directives as indicated in the directive's
description.
keyword is one or more of the Animator directives described in the
appendix Directives for Animator.
parameter is a qualifier to keyword and applies to only certain
directives as indicated in the directive's description.
parameter must appear in either of the following forms:
"parameter"
or
(parameter)
and can adjoin keyword or be separated from it by one or
more spaces. When quotation marks are used, parameter can
contain spaces. Where parentheses are used, no spaces are
permitted.
In this manual, parameters appear in quotation marks.
On UNIX, use the following format for Animator directives: (UNIX)
[no] keyword "parameter"
where:
no turns keyword off. no can either adjoin the keyword or be
separated from it by one or more spaces. no applies to
only certain directives as indicated in the directive's
description.
keyword is one or more of the Animator directives described in the
appendix Directives for Animator.
If you do specify more than one directive, they must all be
enclosed within quotation marks. This is necessary to
inform UNIX that all the directives within them are grouped
together. If you omit the quotation marks, second and
subsequent directives are ignored although no warning to
this effect is given.
parameter is a qualifier to keyword and applies to only certain
directives as indicated in the directive's description.
parameter must appear in one of the following formats:
parameter" \ \ or \ \ parameter
or
(parameter)
and must adjoin keyword. You must not include any spaces
within an Animator option because UNIX treats the space
character as an option delimiter, so if you include any
spaces within an Animator option, UNIX regards the option
as more than one option. If parameter is a file-name, then
it can be a fully specified file-name, including path,
unless otherwise stated.
If you specify an Animator directive in a $SET statement or in a
DIRECTIVES file, parameter cannot be preceded by an equals sign (=). It
must be enclosed either within double quotation marks (" ") or
parentheses ( ).
Cob maps the equals sign (which has no special meaning to UNIX) to the
format which uses parentheses (as these do have a special meaning to
UNIX). If you use quotation marks or parentheses you must escape them
with the backslash character (\) whenever they might be misinterpreted by
the UNIX shell. As the equals sign has no special meaning, it does not
need to be escaped.
In this manual, parameters appear in quotation marks.
MPE/iX 5.0 Documentation