Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

User Commands (p - r) run(1)
-jobid=jobid_number
Specifies the new job ID for the new process. If this flag is not specified, the job ID for
the new process is 0.
-lib={/G/volume/subvolume/swapfile | unset}
Specifies a user library file in the /G directory that is to be searched for external refer-
ences required by the program being run. The user library file is searched before the
OSS library file. The name of the library file in /G is linked to the program file being
run and remains in use until the program is run with the -lib=unset option.
-mem=num_pages
Specifies the maximum number of virtual data pages to be allocated for the new pro-
cess. num_pages is an integer in the range 1 through 64. If this flag is not specified, the
default value for the maximum number of virtual data pages allocated for the new pro-
cess is 64. If the value specified for num_pages is less than the compilation-time
value, the compilation-time value is used. If the actual compilation-time value is less
than the value specified for num_pages (or its default value), the compilation-time
value is used.
The -mem flag does not apply to native processes, which use the kernel-managed swap
facility.
-maxheap=maxheapsize
Overrides the default maximum heap size for a process. The maxheapsize value is a
positive integer, optionally suffixed with either MB or GB. The default unit of the max-
heapsize value is MB (MegaBytes).
This flag is supported on systems running J06.13 or later J-series RVUs or H06.24 or
later H-series RVUs only.
-name=/G/process_name
Specifies the Guardian process name to be assigned to the new process. process_name
is an alphanumeric string whose first character must be alphabetic. If this flag is not
specified, the new process is not named.
-swap=/G/volume [/subvolume [/swapfile]]
Specifies either the name of a file in directory /G that holds the virtual data of a TNS
process or the name of a volume to contain temporary files.
When a TNS process is running, by default the operating system allocates swap space
from the kernel-managed swap facility for the purpose of swapping the data stack.
However, if the -swap flag specifies a valid unstructured permanent file, that file is
used as the swap file and is not purged when the process terminates. The volume that is
specified with the -swap flag must exist in the /G directory on the local node. If not,
the run command displays the usage message and exits in error.
For a TNS process, if the file specified with the -swap flag does not exist, it will be
created. If you specify a swap volume (omitting the subvolume and swapfile names)
for a TNS process, the operating system creates a temporary swap file for the TNS data
segment and deletes it when the process completes.
For a native process, any volume specified in a -swap flag can be used for temporary
file creation by appropriately coded processes. The process can inquire (through
PROCESS_GETINFOLIST_ or PROCESS_GETINFO_) about its swap file and get
back the name of a nonexistent temporary file, for example, $VOL.#0. (The volume
name is as specified in the command; the #0 is syntactically valid but does not
correspond to a real file [a temporary file would have seven digits after the #].) Some
utilities use this feature to determine the volume on which to place temporary files of
527188-021 Hewlett-Packard Company 7−61