SNA NRJE User/Programmer Reference Manual (30292-90006)

136 Chapter5
User Intrinsics
NRJEAlter
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 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.