HP 3000 Manuals HP 3000 Manuals
NRJEAlter
Revises the priority of a submitted job or jobs.
Syntax
________________________________________________________
| |
| |
| BA BA I I IA |
| NRJEAlter ( Wsid, Name, NameLen, NewPri, Result )|
| |
________________________________________________________
Parameters
Wsid An eight-character input byte array. The Wsid parameter identifies
your workstation. It must contain a left-justified alphanumeric name
beginning with a letter. If the workstation identifier is less than
eight characters long, it must be followed by blanks.
Name An input byte array. The Name parameter identifies the job or set of
jobs whose priority will be revised. The length of Name depends on
the way it is used (see the NameLen parameter).
Identify the job or job set one of these ways:
* By job name. Begin the Name string with a letter. Use up to
eight alphanumeric characters.
* All jobs in your logon account. Use one @ character in Name to
indicate that all jobs in your logon account will be revised.
* For a specific job stream file. Use a spool file identification
in the form nnnnn, where n is a digit.
* For all files of a user. Follow MPE standards. Use the form
UserName.AcctName with up to seventeen alphanumeric characters.
Separate UserName from AcctName with a period (.).
Note If you are referring to a job that is different from your logon, you
must have NM user capability.
See table 5-3, "Use of Name," in the NRJEJobInfo intrinsic
description.
NameLen An input integer variable. The NameLen parameter is the number of
characters entered in the Name parameter, described above.
NewPri An input integer variable. All jobs that are qualified by Name have
their transmission priority revised to NewPri, which is from 0
through 14. The highest priority is 14.
Result An eight-element integer output array (required). The Result array
contains error codes that occurred during execution of this
intrinsic.
The first element of the Result array is set to zero if no errors
took place. The structure of the Result array is described in
"Parameters Common to NRJE Intrinsics" in the introduction to this
chapter.
Always test the first element of Result immediately after you call
this intrinsic. If the first element of Result is not zero, test the
other elements of Result to determine the nature of the problem that
has occurred.
Description
Use NRJEAlter to revise the priority of jobs submitted from a Wsid but
not transmitted to the host. Specify the job set in Name and the desired
priority in NewPri. The NameLen parameter is the length of the string in
Name. The consequences of NRJEAlter execution are returned in Result.
Text Reference
See the ALTER command in Chapter 3, "User Commands."