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

Chapter 5 143
User Intrinsics
NRJEHJCancel
exception to this is a logon with NM capability. When
cancelling by job number, you must have NM capability
to cancel jobs submitted by another user. Numbers are
those assigned by the host system. Each entry is eight
characters long, left-justified, and blank-filled. An
example of
JobList with four entries is:
DS1
1099
2122
FIRSTONE
JobListLen An input integer variable (value required if
JobList is supplied). The JobListLen parameter
specifies the number of entries in the
JobList .
NumCancelled An output integer (required). NumCancelled is
returned to reflect the number of host jobs that were
successfully cancelled.
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 NRJEHJCancel to cancel jobs already transmitted to the host. This
intrinsic functions by marking the Job Log to purge returning output
data sets for the cancelled jobs. Specify a job set one of these ways:
• All files of the logon user, or all files of another user if you have NM
capability.
• Individually, by host job number, or host job name. Note that if more
than one job matches the job name, only those matching the logon
UserName.AcctName are cancelled. If you have NM capability, all
jobs that match the job name are cancelled.
After NRJEHJCancel has returned control to your program, test the first
element of
Result . 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.