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.