VMS Help RTL Routines, PPL$, PPL$CREATE_APPLICATION  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Form or Join a PPL$ Application routine informs the PPL$
    facility that the calling process is forming or joining a
    parallel application.

    Format

      PPL$CREATE_APPLICATION  [size] [,application-name]

                              [,protection] [,flags]

1 - Arguments

 size

    OpenVMS usage longword_unsigned
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Number of (512 byte) pages that PPL$ allocates for its internal
    data structures. The optional size argument is the address of an
    unsigned longword containing this size value. See the Description
    section for information about the default value.

 application-name

    OpenVMS usage char_string
    type          character string
    access        read only
    mechanism     by descriptor
    The name of the application that the calling process will form or
    join. The optional application-name argument is the address of a
    descriptor pointing to a character string containing the name of
    the application. The application-name argument can contain up to
    11 characters.

 protection

    OpenVMS usage file_protection
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Numeric value representing the protection mask to be applied to
    the application. The optional protection argument is the address
    of an unsigned longword containing this numeric value. For more
    information, see the description of the $CRMPSC system service in
    the OpenVMS System Services Reference Manual.

 flags

    OpenVMS usage mask_longword
    type          longword (unsigned)
    access        read only
    mechanism     by reference
    Specifies options for forming or joining a PPL$ application. The
    flags argument is a longword bit mask containing the flags. Valid
    values for flags are as follows:

    PPL$M_         Form a new application only-do not join an
    FORMONLY       existing application. If this flag is not
                   specified, a process will join an application
                   if it already exists.
    PPL$M_         Join an existing application only-do not form a
    JOINONLY       new application. If this flag is not specified,
                   a process will form an application if it does not
                   already exist.
    PPL$M_PERM     Form a permanent application in which data is
                   maintained even though there are no active
                   processes. By default, application data is lost
                   when the last process in the application exits.
                   Use of this flag requires PRMGBL privilege.
    PPL$M_SYSTEM   Form or join a systemwide application. By default,
                   the application is available only to processes
                   running under the same group UIC. Use of this flag
                   requires SYSGBL and SYSLCK privileges.