MPE/iX Commands Reference Manual (32650-90864)

66 Chapter 2

Command Deﬁnitions A-B

ALTPROC

Changes characteristics of the speciﬁed processes. Currently, a process' priority, queue

attribute, and workgroup may be changed. (Native Mode)

Syntax

ALTPROC[ [ PIN=] { pinspec (pinspec [ ,pinspec ] ...) } [ ;JOB=] { jobspec (jobspec [ ,jobspec ]

...) } ]

[ [ ;PRI=] pri [ ;WG= ] { workgrp NATURAL_WG } ]

[ { ;TREE ;NOTREE }]

[{ ;USER ;ANYUSER } ]

[ ;SYSTEM]

Parameters

pinspec The process(es) you want to alter. This is a required parameter, unless you

specify jobspec. If you omit both, you will get an error.

The pinspec, expressed [#p ]pin, is a Process Identiﬁcation Number (PIN).

If pinspec is 0, then the caller's pin is used. To alter system processes, you

must have SM capability and specify the SYSTEM option.

NOTREE is the default for all pinspec target processes, and can be

overridden with the TREE option.

The USER and ANYUSER options do not apply to pinspec.

jobspec The name of the job or session whose processes are to be altered. A jobspec

can be any of the following, jobnumber, username, @S, @J, or @.

• The jobnumber must be in the form of either #Jnnn or #Snnn.

• The username must be in the form user[.account]. If there is more than

one job/session matching the same username, they will all be altered.

• Wildcards have the following meanings:

@S - all sessions,

@J - all jobs,

@ - all sessions and jobs

The USER and ANYUSER options apply only to jobspec and only if jobspec is

wildcarded. The USER option, which is the default, alters only processes

matching the user's name, while the ANYUSER option alters all processes

matching the wildcarded jobspec. For example, if the user's name is

STEVE.UI and you enter the command shown below, then only job

processes logged on as STEVE.UI are altered.

:ALTPROC job=@j;pri=cs