HELPLIB.HLB  —  InfoServer  START

1  –  SERVER

    This command starts the LASTport/Disk server and sets various
    server and cache characteristics.

    Usually, this command is executed by SYS$STARTUP:ESS$LAD_
    STARTUP.COM using data from SYS$STARTUP:ESS$LAD_STARTUP.DAT.
    VSI strongly recommends that you make all modifications in the
    SYS$STARTUP:ESS$LAD_STARTUP.DAT file.

    You can use the START SERVER command interactively to use its
    qualifiers to change server settings so long as no services are
    currently defined.

                                   NOTE

       If you enter the START SERVER command directly, you must
       specify all four qualifiers, or the system will revert to
       using default values.

    Format

      START SERVER

1.1  –  Qualifiers

1.1.1    /BUFFER_SIZE

       /BUFFER_SIZE=n

    The InfoServer block cache is structured as an array of fixed-
    size buffers (also called buckets.) The /BUFFER_SIZE qualifier
    determines the size of each bucket. (The /CACHE qualifer
    determines the number of buckets.)

    The numeric value of this parameter is an integer between 3 and
    8 inclusive, representing the bucket size in 512-byte blocks as
    follows:

       3 -   8 blocks (default)
       4 -  16 blocks
       5 -  32 blocks
       6 -  64 blocks
       7 - 128 blocks
       8 - 256 blocks

    The default value is 3.

    Bucket sizes that are larger than 32 blocks are not appropriate
    for most users. The OpenVMS client segments I/O requests that
    are larger than 31 blocks into 31-block chunks, and the default
    bucket readahead behavior might result in unnecessary I/O
    activity to the disk.

1.1.2    /CACHE

       /CACHE = number-of-buckets (default = 512)

    The InfoServer block cache is structured as an array of
    fixed-size buffers (also called buckets. The /CACHE qualifier
    determines the number of buckets in the cache. The /BUFFER_SIZE
    qualifier determines the size of each bucket.

    Numbers larger than 16384 can adversely affect performance.
    Consider increasing the /BUFFER_SIZE qualifier to reach the
    desired cache size.

1.1.3    /MAXIMUM_SERVICES

       /MAXIMUM_SERVICES = maxservice (default = 256)

    Sets the maximum service count for the server. This is the
    maximum number of services that can be defined at one time.
    Each service descriptor consumes non-paged pool; however, unused
    service slots consume only 4 bytes each.

    The maximum value is 1024.

1.1.4    /WRITE_QUOTA

       /WRITE_QUOTA = n (default = 0)

    Number of simultaneous synchronous writes permitted within the
    server. The default of zero means that all write operations are
    performed synchronously.

1.2  –  Example

  $ InfoServer SHOW SERVER

        Node BILBO [HP rx2600  (900MHz/1.5MB)] running OpenVMS XAR8-D2Y
        LASTport/Disk Server Version 1.2

        Max Services:        64        Write Quota:          0
        Cache Buckets:     2048        Cache Bucket Size:   32 blocks
        Cache Size:    33554432 bytes
        Hits:                 0        Hit Percentage:       0%
        Misses:               0

        Current Sessions:     0        Peak Sessions:        0

                           Read             Write
        Requests:             0                 0
        Blocks:               0                 0
        Errors:               0                 0
        Aborted:              0                 0
        Conflicts:            0                 0

  $ InfoServer START SERVER/MAXIMUM_SERVICES=128
  /CACHE=2048/BUFF=5/WRITE=0

        %INFOSRVR-I-STARTED, LASTport/Disk server started.

  $ InfoServer SHOW SERVER

        Node BILBO [HP rx2600  (900MHz/1.5MB)] running OpenVMS XAR8-D2Y
        LASTport/Disk Server Version 1.2

        Max Services:    128        Write Quota:          0
        Cache Buckets:  2048        Cache Bucket Size:   32 blocks
        Cache Size: 33554432 bytes
        Hits:              0        Hit Percentage:       0%
        Misses:            0

        Current Sessions:  0        Peak Sessions:        0

                        Read             Write
        Requests:          0                 0
        Blocks:            0                 0
        Errors:            0                 0
        Aborted:           0                 0
        Conflicts:         0                 0

      The first command in this example displays the current
      information about the server. The second command starts the
      server and increases the maximum number of services for the
      server. The third command displays the new information about
      the server, showing the increases maximum number of services.
Close Help