MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions (ABORTSESS - FCLOSE)

ALTDSEG

	MPE documents
	Complete PDF
	Table of Contents
	Index

	Edition 7 E0701
	Edition 7 E0300 ♥
	Edition 6 E0195

NM and CM callable.

Reduces the storage required by the extra data segment when moved into main memory and expands storage as required, allowing for a more efficient use of memory. Data segment management (DS) capability is required.

NOTE: Data segment management (DS) intrinsics are not recommended for use in the operating system native mode programming environment; use of DS intrinsics degrade program performance.

Syntax


           U16V   I16V       I16
  ALTDSEG (index, increment, size);

Parameters

index

16-bit unsigned integer by value (required)

Indicates the index of the extra data segment, obtained from the GETDSEG call.

increment

16-bit signed integer by value (required)

Specifies the value, in half words, the extra data segment is to be changed. A positive value requests an increase; a negative value requests a decrease.

size

16-bit signed integer by reference (required)

Returns the new size of the extra data segment after incrementing or decrementing has occurred.

Operation Notes

Incrementation and decrementation is accomplished in even multiples of four half words, which are rounded up. For example (in half words):

Present Segment Size	Change Value	New Segment Size
128	-3	128
128	-4	124
128	+1	132
128	+3	132
128	+4	132

When a data segment is created through GETDSEG, the required virtual space is allocated by the system to accommodate the original length of the data segment. This virtual space is allocated in increments of 512 half words. For example, creation of an extra data segment with a length of 600 half words results in the allocation of 1024 half words of virtual space.

NOTE: ALTDSEG cannot increase the size of a data segment to exceed the virtual space originally allocated through GETDSEG.

When GETDSEG is called in privileged mode, the ALTDSEG intrinsic must also be called in privileged mode.

Condition Codes

CCE (2): Request granted.
CCG (0): Request granted. An illegal decrement was requested to a total segment size of <=0; the current size remains in affect. An illegal increment was requested for a total segment size greater than the virtual space originally assigned; the size of the virtual space is granted and returned to the size parameter.
CCL (1): Request denied. An illegal index parameter was specified.

Additional Discussion

Intrinsics: FREEDSEG, GETDSEG
Manuals: Introduction to MPE XL for MPE V Programmers

ALMANAC

ARITRAP