DELMBX

Mark a permanent mailbox for deletion

VSupported on OpenVMS

xcall DELMBX(channel)

Arguments

channel

The Synergy DBL channel on which the mailbox was opened, using either CREMBX or an OPEN statement. (n)

Discussion

The DELMBX subroutine enables the process running the program to mark a permanent mailbox for deletion. The actual deletion occurs when no more channels are assigned to the mailbox.

The DELMBX subroutine marks the mailbox to be deleted when it is no longer used by any process. (You can also specify a temporary mailbox to be deleted, but temporary mailboxes are automatically deleted when they are no longer in use.) The mailbox continues to exist as long as at least one process has a channel assigned to it.

If you specify a channel that is not currently opened, a “Channel has not been opened” error ($ERR_NOOPEN) is generated.

See also

• CREMBX routine
• OPEN statement

Examples

subroutine cleanup
proc
    xcall close_chns
    xcall delmbx(MBXCHN)
    return
stop