Library /sys$common/syshlp/helplib.hlb  —  System Services, $DALLOC
    Deallocates a previously allocated device.

    Format

      SYS$DALLOC  [devnam] ,[acmode]

    C Prototype

      int sys$dalloc  (void *devnam, unsigned int acmode);

1  –  Arguments

 devnam

    OpenVMS usage:device_name
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Name of the device to be deallocated. The devnam argument is the
    address of a character string descriptor pointing to the device
    name string. The string might be either a physical device name or
    a logical name. If it is a logical name, it must translate to a
    physical device name.

    If you do not specify a device name, all devices allocated by the
    process from access modes equal to or less privileged than that
    specified are deallocated.

 acmode

    OpenVMS usage:access_mode
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Access mode from which the deallocation is to be performed. The
    acmode argument is a longword containing the access mode.

    The $PSLDEF macro defines the following symbols for the four
    access modes:

    Symbol         Access Mode

    PSL$C_KERNEL   Kernel
    PSL$C_EXEC     Executive
    PSL$C_SUPER    Supervisor
    PSL$C_USER     User

    The most privileged access mode used is the access mode of the
    caller.
Close Help