 |
» |
|
|
|
This command executes a program file. It
permits the searching of libraries to satisfy external references.
Relocatable libraries (RL) are not searched.
Syntax | |
RUN progfile [;PARM=parameternum]
[;LIB= {G
P
S}] [;INFO="quotedstring"]
[;STDIN=[{*formaldesig
fileref
$NULL }]]
[;STDLIST=[{*formaldesig
fileref [,NEW]
$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 | |
|
