HP 3000 Manuals HP 3000 Manuals
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, "Use of Name," 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. 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 NRJECancel to remove job stream spool files from the transmission
queue. Specify a spool file set one of these ways:
* Individually, by spool file identifier, or by job name, if it is
unique.
* Collectively, by job name (if it is generic), for all files of the
logon user, or for all files of another user (if you have NM
capability).
After NRJECancel has returned control to your program, test the first
element of Result.
Text Reference
See CANCEL in Chapter 3, "User Commands."