HP System Dictionary/XL SDMAIN Reference Manual (32256-90001)

4-102
Example
The first of the following examples asks for help with the HELP command. The syntax of the HELP is
displayed. The second of the following examples asks for the definition of the user-defined macro OPEN.
>HELP HELP.
HELP - Returns a list of valid subcommands for a command or a detailed
description of a specific command
SYNTAX: HELP<H> [command [subcommand]] [.]
>
>HELP OPEN
MACRO Definition:
open mode = shared-update.
define scope = da; open-mode = !mode; status = test.
>
INCLUDE
Causes SDMAIN to temporarily stop reading its input from the current input device or file and start
reading input from the specified file.
Syntax
IN[CLUDE] include-file-name .
Parameters
include-file-name Name of the file from which to read input.
Description
When the end of file is reached, SDMAIN goes back to the previous input device or file for input. Within an
include file, you can have other INCLUDE commands and macro calls. After a macro call is expanded,
SDMAIN executes the expanded macro as if it is an include file. The maximum number of nested levels of
input at any one time using INCLUDE commands or macro calls is 20. When executing a file specified by
the INCLUDE command, the EDIT command and the REDO command are not allowed. Also, attribute
prompting is not performed at this time. Commands are echoed to $STDLIST as they are executed from
within the include file. The INCLUDE command itself is not written to the log file, but each command read
from the include file for processing is written to the log file as if it were being entered interactively. If you
enter INCLUDE $STDIN or INCLUDE $STDINX, you can return to the previous level by issuing the MPE
command :EOD.
Open Mode: Any
Scope: Any
Example
The following example specifies the file file1 to be the input file. The next command processed by the
system is read from file1.
>INCLUDE file1.