NAME

      prmrun - run application in assigned or specified PRM group


SYNOPSIS

      prmrun -V

      prmrun [-w]

      prmrun [-g PRMgroup |-i] application [arguments]


DESCRIPTION

      prmrun launches an application in its assigned PRM group, in a
      specified PRMgroup, or in the user's initial PRM group.

      If you specify only an application (and no -g or -i option), PRM
      launches the application in its assigned PRM group, as defined in the
      PRM configuration file.

      If you specify either of the two prmrun options (-g or -i), PRM
      examines user permissions to determine whether you are allowed to run
      the application as requested.


COMMAND AVAILABILITY

      Specifying only an application name:
	   Any user that can execute a given application can use prmrun
	   specifying only the application name.

      Specifying the -g PRMgroup option:
	   A user must be able to execute the specified application and have
	   permission to use PRMgroup (see prmconf(4)) to use this option.

      Specifying the -i option:
	   A user must be able to execute the specified application and have
	   an initial PRM group defined in the configuration file (see
	   prmconf(4)) to use the -i option.

      Superusers have no restrictions.


OPTIONS

      Running prmrun without options or application parameters prints a list
      of the PRM groups the invoking user can access.  The first group in
      the list is the invoking user's initial group.

      -V	      Display version information and exit.

      -w	      Print a list of the PRM groups the invoking user can
		      access in wide-column format, exceeding the 30-column
		      default if necessary to avoid clipping any names.	 The
		      first group in the list is the invoking user's initial
		      group.  (Although this option is still supported, you
		      do not need to specify it as its behavior is now the
		      default.)

      -g	      Launch the application in PRMgroup.

      PRMgroup	      Is the target PRM group. Specify a target PRM group by
		      the PRM group name or the PRM group ID (PRMID). A
		      parent group in a group hierarchy cannot be specified
		      as PRMgroup. For information on group hierarchies, see
		      the group records syntax in prmconf(4).

      -i	      Launch the application in the user's initial group, as
		      defined in the PRM configuration file. If the user's
		      initial group is not defined, the application is
		      launched in PRMID 1, the user default group.

      application     Launch the application, with or without its arguments,
		      in its assigned group, as defined in the PRM
		      configuration file.

		      If the application does not have an assigned group, it
		      is launched in the user's initial PRM group. If the
		      user does not have an initial group, the application
		      runs in PRMID 1, the user default group.

		      Applications configured with alternate names are not
		      supported for this feature.


RETURN VALUE

      Zero is returned if prmrun detects no errors, and the application, if
      specified, returns zero.

      Nonzero is returned if prmrun detects errors or the specified
      application returns nonzero.


EXAMPLES

      Run the application vi with argument memo in its assigned PRM group:

	   prmrun vi memo

      Run the application cc with arguments testprog.c -o testprog in the
      PRM group development, which is not cc's assigned group:

	   prmrun -g development cc testprog.c -o testprog

      Run the application testprog in the user's initial PRM group:

	   prmrun -i testprog

      Print a list of PRM groups you can access:


	   prmrun

	   Sample output:

	   User jdoe can access the following:
		test
		development
		OTHERS


WARNINGS

      When prmrun is used to start an application in a group other than its
      assigned PRM group, the application processes remain in the group
      started in until explicitly moved by prmmove or prmconfig. However, if
      the application starts before the application manager is started, the
      processes may be moved (depending on whether you use prmconfig -i or
      prmconfig -k) to their configured groups when the application manager
      is started and enabled.


AUTHOR

      prmrun was developed by HP.


FILES

      /etc/prmconf     default PRM configuration file


SEE ALSO

      prm(1), prmagt(1), prmanalyze(1), prmavail(1), prmconfig(1),
      prmlist(1), prmloadconf(1), prmmonitor(1), prmmove(1), prmrecover(1),
      xprm(1), xprm_keytool(1), prmconf(4).

      HP Process Resource Manager User's Guide (/opt/prm/doc/PRM.ug.pdf)

      HP Process Resource Manager homepage (http://www.hp.com/go/prm)