HELPLIB.HLB  —  CREATE  /MAILBOX
    Valid for Alpha and Integrity server systems only.

    Creates a virtual mailbox named MBAn and assigns an I/O channel
    number to it. The /MAILBOX qualifier is required.

                                   NOTE

       The following privileges are required:

       o  TMPMBX (temporary mailbox) to create a temporary mailbox
          (which is the default)

       o  CMEXEC (change mode to executive) to create a temporary
          mailbox (which is the default). Note: This requirement is
          temporary and will be removed in a future release.

       o  PRMMBX (permanent mailbox) to create a permanent mailbox
          (using the /PERMANENT qualifier)

       o  SYSNAM (system logical name) to place a logical name for
          a mailbox in the system logical name table

       o  GRPNAM (group logical name) to place a logical name for a
          mailbox in the group logical name table

    To delete a mailbox, use the DELETE/MAILBOX command.

    Format

      CREATE/MAILBOX  logical-name

1  –  Parameter

 logical-name

    Specifies a logical name for the new mailbox. The system creates
    the mailbox and sets the logical name to point to it.

2  –  Description

    The CREATE/MAILBOX command creates a virtual mailbox.

3  –  Qualifiers

3.1    /BUFFER_SIZE

       /BUFFER_SIZE=n

    Specifies the number of bytes of system dynamic memory that can
    be used to buffer messages sent to the mailbox. If you do not
    specify /BUFFER_SIZE or specify it as 0, the operating system
    provides a default value from the DEFMBXBUFQUO system parameter.

3.2    /LOG

       /LOG
       /NOLOG (default)

    Displays the name of the new mailbox when it is created.

3.3    /MESSAGE_SIZE

       /MESSAGE_SIZE=n

    Specifies the maximum size (in bytes) of a message that can be
    sent to the mailbox. The maximum value is 65535. If you do not
    specify /MESSAGE_SIZE or specify the value as 0, the operating
    system provides a default value from the DEFMBXMXMSG system
    parameter.

3.4    /PERMANENT

    Specifies that the mailbox is to be permanent. By default,
    mailboxes are temporary.

3.5    /PROTECTION

       /PROTECTION=(ownership[:access][,...])

    Specifies protection for the mailbox.

    o  Specify the ownership parameter as system (S),  owner (O),
       group (G),  or world (W).

    o  Specify the access parameter as read (R),  write (W), logical
       I/O (L),  or physical I/O (P).

    If no protection is specified, the mailbox template is used.

    For more information about specifying protection codes, see the
    VSI OpenVMS Guide to System Security.

3.6    /TEMPORARY

       /TEMPORARY (default)

    Specifies that the mailbox is temporary. By default, mailboxes
    are temporary unless you specify /PERMANENT.

4  –  Example

  $CREATE/MAILBOX/PERMANENT/MESSAGE_SIZE=512/LOG MY_MAILBOX
  %CREATE-I-CREATED, MBA38: created
  $SHOW DEVICE MBA38/FULL
  Device MBA38:, device type local memory mailbox, is online,
      record-oriented device, shareable, mailbox device.

   Error count              0  Operations completed                0
   Owner process           ""  Owner UIC                    [SYSTEM]
   Owner process ID  00000000  Dev Prot  S:RWPL,O:RWPL,G:RWPL,W:RWPL
   Reference count          0  Default buffer size               512

      In this example, a permanent mailbox is created with the
      logical name MY_MAILBOX. The SHOW DEVICE command displays the
      full characteristics of the mailbox.
Close Help