HP 3000 Manuals HP 3000 Manuals
ALTPROG
This command allows the user to manipulate those fields of a program file
which dictate the behavior of the program at run time. It is especially
useful in that programs may be adjusted without having to link them a
second time. Most of the options and keywords available can be
overridden by the :RUN command.
If a keyword is specified but no argument is given, then the
corresponding field in the file specified will be reset to its default
value.
Syntax
ALTPROG [PROG= file] [, file]...
[;XL= xl_file [, xl_file]...]
[;CAP= cap_list]
[;NMSTACK= max_stack_size]
[;NMHEAP= max_heap_size]
[;UNSAT= unsat_name]
[;ENTRY= entry_name]
[;PRI= priority_level]
[;MAXPRI= max_priority_level]
Parameters
file Specifies the name of a program file which is to be
altered. If no file is given, the file $OLDPASS is
assumed.
xl_file Specifies a default executable library to be searched
at run time.
If xl_file was not previously specified, or has more
characters than the previous xl_file specified, the
link editor will attempt to allocate enough space for
the new string. Since this xl_file name can be of
arbitrary length, it is possible to get an error
message from the link editor when not enough space is
available. In this case, you may specify the XL list
on the :RUN command, or else link the program again
using the longer xl_file name.
To specify the default xl_file, use XL="".
cap_list The capability attribute that the link editor assigns
to the executable program file. Enter one or more of
the following attributes separated by commas:
PH - Process Handling
DS - Extra Data Segments
MR - Multiple Resources
PS - Programmatic Creation of Session
PM - Privileged Mode
IA - Interactive Access
BA - Local Batch Access
Default: If no capabilities are specified, the
executable file's capability set will default to BA
and IA.
max_stack_size Sets the maximum stack size, in bytes, for the
resulting executable program. The program uses the
stack to store a procedure's local variables and for
control purposes. You can override this value using
the NMSTACK parameter of the :RUN command. Default:
the system-configured value.
max_heap_size Sets the maximum heap size, in bytes, for the
resulting executable program. The program uses the
heap for dynamic storage allocation. You can
override this value using the NMHEAP parameter of the
:RUN command. Default: the system-configured value.
unsat_name Names the procedure which the loader uses to satisfy
unresolved externals. Since unsat_name is a
procedure, it is case sensitive. You can override
the parameter by using the UNSAT parameter of the
:RUN command. When the loader cannot resolve
external references, it reports an error.
If unsat_name was not previously specified, or has
more characters than the previous unsat_name
specified, the link editor will attempt to allocate
enough space for the new string. Since this
unsat_name can be of arbitrary length, it is possible
to get an error message from the link editor when not
enough space is available. In this case you may
specify the unsat_name on the :RUN command, or else
link the program again using the longer unsat_name.
To specify the default unsat_name, use UNSAT="".
entry_name Names the point within a program where execution
begins. ENTRY= lets you override the primary program
entry point. If the symbol that matches entry_name
is not found, an error occurs. Entry_name is case
sensitive. You can override this parameter using the
ENTRYPOINT parameter of the :RUN command. Default:
starts execution from the primary program entry point
(corresponding to a program's main procedure or outer
block). Entry_names must be primary or secondary
entry types.
If entry_name was not previously specified, or has
more characters than the previous entry_name
specified, the link editor will attempt to allocate
enough space for the new string. Since this
entry_name can be of arbitrary length, it is possible
to get an error message from the link editor when not
enough space is available. In this case you may
specify the entry_name on the :RUN command, or else
link the program again using the longer entry_name.
priority_level Specifies the execution priority that the program
will have at run time. The priority_level has to be
either BS, CS, DS, ES, or a number between 100 and
255 inclusive. This value can be overridden by the
PRI= keyword on the :RUN command.
max_priority_level Specifies the maximum execution priority that the
program can have at run time. The max_priority_level
has to be either BS, CS, DS, ES, or a number between
100 and 255 inclusive. See the PRI= keyword of the
:RUN command for more information.