On Alpha and Integrity server systems, sets a simple value
associated with a process.
Format
SYS$SET_PROCESS_PROPERTIESW mbz1 ,pidadr ,prcnam ,property
,value ,prev_value [,bufsiz
,bufcnt ,flags]
C Prototype
int sys$set_process_propertiesw (mbz1, unsigned int *pidadr,
unsigned int *prcnam, unsigned
int property, unsigned __int64
value, unsigned __int64
*prev_value,...);
1 – Arguments
mbz1
type:
access:
mechanism: 0
Reserved for future use by VSI. Must be specified as 0.
pidadr
OpenVMS usage:process_id
type: longword (unsigned)
access: modify
mechanism: by reference
Process identification (PID) of the process whose system service
logging characteristics are to be modified. The pidadr argument
is the address of the PID.
Supported only for use with PPROP$C_SS_LOG_ENABLE, PPROP$C_
SS_LOG_DISABLE, and PPROP$C_SS_LOG_UNLOAD. Otherwise, must be
specified as 0.
prcnam
OpenVMS usage:process_name
type: character-coded text string
access: read only
mechanism: by descriptor-fixed-length string descriptor
Process name of the process whose priority is to be changed. The
prcnam argument is the address of a character string descriptor
pointing to the process name. The process name can be 1 - 15
characters long.
You can use the prcnam argument only on behalf of processes
in the same UIC group as the calling process. To affect system
service logging for processes in other groups, you must specify
the pidadr argument.
Supported only for use with PPROP$C_SS_LOG_ENABLE, PPROP$C_
SS_LOG_DISABLE, and PPROP$C_SS_LOG_UNLOAD. Otherwise, must be
specified as 0.
property
OpenVMS usage:integer
type: longword (unsigned)
access: read only
mechanism: by value
A constant that selects which property to set.
Valid values for property are defined by the $PPROPDEF macro as
follows:
Property Code Description
PPROP$C_CASE_ The type of case lookup to use. This value
LOOKUP_TEMP is set for the life of the currently
active image. This value reverts to the
permanent case setting on image rundown.
In the absence of an explicit case lookup
specification in a user-provided NAML,
RMS uses this value to determine the case
setting for the current file operation.
Valid values are PPROP$K_CASE_BLIND and
PPROP$K_CASE_SENSITIVE.
For additional information, see the Guide
to OpenVMS File Applications.
PPROP$C_CASE_ The type of case lookup to use. This value
LOOKUP_PERM is set for the life of the process or
until the case is set agairundown. Setting
this value affects only future activated
images for this process. To change the case
setting for the current active image, you
must modify the PPROP$C_CASE_LOOKUP_TEMP
setting.
Valid values are PPROP$K_CASE_BLIND and
PPROP$K_CASE_SENSITIVE.
For additional information, see the Guide
to OpenVMS File Applications.
PPROP$C_SEARCH_ Processes the active search mode. The value
SYMLINK_TEMP reverts to the permanent setting on image
rundown. Valid values are PPROP$K_SEARCH_
SYMLINK_NONE, PPROP$K_SEARCH_SYMLINK_ALL,
and PROP$K_SEARCH_SYMLINK_NOELLIPS.
PPROP$C_SEARCH_ Processes the permanent search mode. This
SYMLINK_PERM value is set for the life of the process.
Changing this setting only changes the
behavior of subsequently activated images.
Valid values are PPROP$K_SEARCH_SYMLINK_
NONE, PPROP$K_SEARCH_SYMLINK_ALL, and
PROP$K_SEARCH_SYMLINK_NOELLIPS.
PPROP$C_DEADLOCK_ The per-process deadlock wait time (in
WAIT 100-ns units). A value of zero resets and
disables the per-process deadlock wait time
and fallback to the systemwide deadlock
wait time that comes from the system
parameter DEADLOCK_WAIT. Valid values are
in the range of 100000 (=10ms) and 10000000
(=1 s). If the value is too small, the per-
process deadlock wait is set to 10 ms; if
the value is too large, it is set to 1 s.
PPROP$C_HOME_RAD The Resource Affinity Domain (RAD) to which
the process is assigned. Newly mapped
memory in the process will come from the
home RAD of the process. Currently mapped
memory will not move into the new home RAD
unless $PURGWS is issued.
Valid values are integers between 0 and the
maximum RAD on the system. Valid home RADs
must also contain either memory or CPUs.
PPROP$C_KERNEL_ Sets the process specific limit of the
THREAD_LIMIT number of kernel threads that can be
created. By default, this is controlled
systemwide through the SYSGEN parameter
MULTITHREAD. A value between 0 (use
default) and the current setting of the
MULTITHREAD parameter can be used.
PPROP$C_MEDDLE Reserved for use by VSI.
PPROP$C_MEDDLE_ Reserved for use by VSI.
ENABLE
PPROP$C_PARSE_ The type of command parsing to use. This
STYLE_TEMP value is set only for the life of the
image. The value reverts to the permanent
style on image rundown. Valid values
are PARSE_STYLE$C_TRADITIONAL and PARSE_
STYLE$C_EXTENDED.
PPROP$C_PARSE_ The type of command parsing to use. This
STYLE_PERM value is set for the life of the process
unless the style is set again. Valid values
are PARSE_STYLE$C_TRADITIONAL and PARSE_
STYLE$C_EXTENDED.
PPROP$C_SS_LOG_ Stop logging system service requests
DISABLE for the current or specified process. If
logging was previously disabled, the value
returned in prev_value is 0. If logging was
previously enabled, the value returned is
1.
For more information, see the VSI OpenVMS
System Analysis Tools Manual.
PPROP$C_SS_LOG_ Allocate log buffers and enable logging of
ENABLE system service requests for the current
or specified process. If logging was
previously disabled, the value returned in
prev_value is 0. If logging was previously
enabled, the value returned is 1.
For more information, see the VSI OpenVMS
System Analysis Tools Manual.
PPROP$C_SS_LOG_ Stop logging system service requests for
UNLOAD the current or specified process and close
the log file so that it can be analyzed. If
logging was previously disabled, the value
returned in prev_value is 0. If logging was
previously enabled, the value returned is
1.
For more information, see the VSI OpenVMS
System Analysis Tools Manual.
PPROP$C_TOKEN Controls the token size used by DCL. When
the bit is clear (the default), traditional
tokens are used, and each command token can
hold up to 255 characters. When the bit is
set, extended tokens are used; each command
token can be up to 4000 characters.
PPROP$C_UNITS Controls the process units. When the bit
is clear (the default), all size-related
numbers are displayed in blocks. When
the bit is set, size-related numbers are
converted to bytes.
value
OpenVMS usage:integer
type: quadword (unsigned)
access: read
mechanism: by value
A quadword value to which to set the property.
prev_value
OpenVMS usage:access_mode
type: quadword (unsigned) address of a quadword value
access: write
mechanism: by reference
The address of a quadword that will receive the previous value of
the property.
bufsize
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by value
The requested system service log buffer size in bytes. Supported
only for use with PPROP$C_SS_LOG_ENABLE. If omitted, it defaults
to 65,024 bytes. The maximum value is 65,024 bytes. The minimum
value is 4096 bytes.
bufcnt
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by value
The requested number of system service log buffers. Supported
only for use with PPROP$C_SS_LOG_ENABLE. If omitted, it defaults
to 2. The maximum number of buffers is 6.
flags
OpenVMS usage:mask_longword
type: longword (unsigned)
access: read only
mechanism: by value
Flag mask specifying the enable logging request. The flags
argument is a longword bit vector in which each bit corresponds
to a flag. The $LOGTYPDEF macro and the LOGTYPDEF.H file define a
symbolic name for each flag.
The $LOGTYPDEF macro defines the following symbolic names for the
fault characteristic codes:
Symbol Description
LOGTYP$M_ Log system service arguments.
ARGS
LOGTYP$M_ Write log information to a file.
FILE
If you specify the flags argument as 0, the service defaults to
logging to a file and logging arguments.
If you specify LOGTYP$M_ARGS but lack privilege, service
arguments are not logged.