 |
» |
|
|
|
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.
- 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. |
