HP OpenVMS Systems

DBG$DYN_ADD

Notifies the HP DCPI daemon that a new code or DST range has been created.

Format

DBG$DYN_ADD type, number-of-bytes, base-address

Returns

OpenVMS usage:	cond value
type:	longword (unsigned)
access:	write only
mechanism:	by value

Arguments

type

OpenVMS usage:	longword_unsigned
type:	longword (unsigned)
access:	read only
mechanism:	by value

The type argument specifies the contents of the newly allocated section of virtual memory. The following types are defined:

Symbol	Region
DBG$C_DST	Section contains DST records.
DBG$C_CODE	Section contains code segments.

number-of-bytes

OpenVMS usage:	quadword_signed
type:	quadword (signed)
access:	read only
mechanism:	by value

The number-of-bytes argument specifies the size, in bytes, of the newly allocated section of virtual memory.

base-address

OpenVMS usage:	address
type:	quadword (unsigned)
access:	read only
mechanism:	by value

The base-address argument specifies the first contiguous block of bytes allocated for either code or DST records.

context

OpenVMS usage:	quadword
type:	quadword (unsigned)
access:	read write
mechanism:	by reference

The context argument specifies the unique identifier assigned by DBG$DYN_BEGIN to the caller.

Description

If a new section in virtual memory is allocated for either new code segments or DST records, then this routine must be called to let DCPI know about it. The type argument specifies the contents of the section. The base-address and number-of-bytes arguments are used to describe the location and length of the section, respectively.  The context argument should contain the value received from DBG$DYN_BEGIN.

Condition Values Returned

SS$_NORMAL	The routine successfully completed.
SS$_BADPARAM	Routine was provided an invalid parameter.
Other	If this routine does not complete successfully, it returns the status of the call it made that failed.

Example

See an example of the interaction between DCPI and an application that executes code dynamically.