Baanboard.com

Go Back   Baanboard.com

User login

Frontpage Sponsor

Main

Google search


Poll
How big is your Baan-DB (just Data AND Indexes)
0 - 200 GB
17%
200 - 500 GB
30%
500 - 800 GB
3%
800 - 1200 GB
7%
1200 - 1500 GB
10%
1500 - 2000 GB
13%
> 2000 GB
20%
Total votes: 30

Baanboard at LinkedIn


Reference Content

 
open.message()
By patvdv at 26 Feb 2008 - 21:57


open.message()

Syntax

long open.message( long project, string name$, long action [, long fast]
)

Description

Use this to create a new mailbox or to connect to an existing mailbox. You must call this function before you can read from or write to the mailbox.

Arguments

project

A number in the range 1 to 255 that indicates the project to which the mailbox belongs.

name$

This identifies a particular mailbox within the specified project. The argument must contain the name of a file that can be read by all processes that want to use the mailbox.

The function uses the specified project number and some attribute of the specified file to generate a mailbox key that uniquely identifies the mailbox. The contents of the file are not used or changed by the function.

Note that within a project, the specified file must be clearly associated with a particular mailbox.

action

This argument can have one of the following values:

  • 0 : If the mailbox does not already exist, a new one is created.
  • 1 : This is similar to 0, except that instead of using a file name specified in name$, the system creates a unique file name ("$BSE/TMP/PostB<pid>"). When specifying this option, specify name$ as an empty string ("").
  • 2 : If the mailbox does not already exist, a new one is not created.

fast

Set this optional argument to 1 if you are using the UNIX message queue ID instead of the mailbox key to identify the mailbox.

Return values

This returns a unique key for the opened mailbox. It returns -1 if an error occurs (the predefined variable e contains the error number).

Context

Bshell function.

Related topics

0
No votes yet


All times are GMT +2. The time now is 15:48.


©2001-2018 - Baanboard.com - Baanforums.com