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

138 Chapter5
User Intrinsics
NRJECancel
NRJECancel
Cancels previously submitted jobs not yet transmitted.
Syntax
BA BA I IA
NRJECancel ( Wsid , Name , NameLen , 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 array identifies the
job stream file to be cancelled.
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. If you have NM capability,
all jobs will be affected.
• 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 instrinsic
description.
NameLen An input integer variable. The NameLen parameter
contains the number of characters in
Name .
Result An eight-element integer output array (required).
The
Result array contains error codes that occurred
during execution of this intrinsic.