HP 3000 Manuals HP 3000 Manuals
RUN
This command executes a program file. It permits the searching of
libraries to satisfy external references. Relocatable libraries (RL) are
not searched.
Syntax
[ {G}]
RUN progfile [;PARM=parameternum] [;LIB= {P}] [;INFO="quotedstring"]
[ {S}]
[ [{*formaldesig}]] [ [{*formaldesig }]]
[;STDIN=[{fileref }]] [;STDLIST=[{fileref [,NEW]}]]
[ [{$NULL }]] [ [{$NULL }]]
Parameters
progfile Specifies the name of the program file to be
executed. This is the only required parameter. If
you specify any other parameters, they override the
default parameters only for the current program
execution. The progfile name may be an HFS
filename.
PARM Specifies a value, parameternum, that you can pass
to the program as a general parameter for control
or other purposes. If you do not specify the
parameter, the default value is zero (0).
The ;PARM= value is limited to a signed 15-bit
decimal or unsigned 16-bit octal or hex value,
unless you use the implied form of the RUN command.
The implied form enables you to use any signed
31-bit number. Refer to "Operation Notes" for
information about the implied form.
LIB Specifies the executable libraries that you can use
to load the program. The available values are as
follows:
G Searches the program's group library first,
then its public account library, and
finally the system library in order to
resolve the program's external references.
P Searches the program's public account
library before the system library to
resolve the program's external references.
S Searches only the system library to resolve
the program's external references. This is
the default.
The group and account libraries referenced by this
parameter must be named SL.group.account for
compatibility mode programs and XL.group.account
for native mode programs. The group and account
are the group and account where the program
resides.
INFO Enables you to pass an ASCII string
("quotedstring") to the program to be run. You
must delimit the string with a matching pair of
quotation marks (either " or '). If you want a
quotation mark to appear within the string, you
must repeat it. For instance, you must type can't
as can''t, and "program" must appear as
""program"".
Including delimiters, the maximum length of the
string is 255 characters, unless you use the
implied form of the RUN command. The implied form
enables you to use up to 512 characters in a string
(less the number of characters in your other
parameters). Refer to "Operation Notes" for
information about the implied form.
STDIN Specifies the file used as $STDIN by the program
that you want to execute. If you omit this
parameter or if you do not specify anything after
the equal sign (;STDIN=Return, for instance), then
STDIN defaults to the standard list device for the
job or session.
The choices for this parameter are as follows:
*formaldesig Indicates the formal file
designator for a file
previously specified in a
file equation.
fileref Indicates the name of an
existing permanent or
temporary disk file.
$NULL Indicates the actual
file designator of a
system-defined file that is
always handled as an empty
file. When a program reads
from $STDIN, which is equated
to $NULL, it receives an
end-of-file condition.
STDLIST Specifies the file used as $STDLIST by the program
you want to execute. If you omit this parameter or
if you do not specify anything after the equal sign
(;STDLIST=Return, for instance), then STDLIST
defaults to the standard list device for your
session (terminal/screen) or job (job listing).
The choices for this parameter are as follows:
*formaldesig Indicates the formal file
designator for a file
previously specified in a
file equation.
fileref Indicates the name of an
existing permanent or
temporary disk file.
NEW Means that the file name
cannot already exist.
$NULL Indicates the actual
file designator of a
system-defined file that is
always handled as an empty
file. When referenced by a
program as $STDLIST, the
system accepts the associated
write request, but does not
produce physical output;
therefore, you can use $NULL
to discard unneeded output
from an executing program.
Operation Notes
* Usage
You can enter this command from a session or a job. You cannot
enter this command from a program unless you or the calling
program have process handling (PH) capability. Pressing Break
suspends execution of this command. Execution continues when you
enter the RESUME command. You can stop execution via the ABORT
command.
You cannot enter this command directly from break mode. If you
do, the system prompts you to abort the previously suspended
program. If you reply NO, the RUN command does not execute. If
you reply YES, the suspended program aborts and the RUN command
executes.
* Implied form of the command
You can use an implied form of the RUN command by omitting the
command name RUN and entering the name of the program along with
either the INFO or PARM parameters. (No other RUN command
parameters are supported.)
The native mode parser, rather than the compatibility mode parser,
is used when you enter the implied form of the command.
Consequently, you can use quotes (" or ') with the program file
name and/or the ;INFO= parameter. Quotes are not required if the
parameter does not contain delimiter characters, such as a blank,
a comma, a semicolon, quotemarks, or an equal sign.
Examples
* To run the program TESTPROG with STDIN set to an old disk file
named INPUT and $STDLIST set to the line printer, enter:
:FILE LPFILE;DEV=LP
:RUN TESTPROG;STDIN=INPUT;STDLIST=*LPFILE
* To set $STDLIST to a temporary disk file named RESULTS that the
RUN command automatically creates, enter:
:RUN TESTPROG;STDLIST=RESULTS,NEW
* To use the INFO= parameter to pass a string to the program, enter:
RUN MYPROG;INFO= "A TEST WITH ""AND"" CHARACTERS"
This examples shows "AND" with an extra pair of quotation marks,
resulting in the following string passed to the program:
A TEST WITH "AND" CHARACTERS
* To pass the same string to the program using the implied form of
the command, enter:
:MYPROG "A TEST WITH ""AND"" CHARACTERS"
or
:MYPROG `A TEST WITH "AND" CHARACTERS'
Related Commands
LINK
PREP
XEQ