 |
» |
|
|
|
Cancels jobs already transmitted to the host, by marking the
Job Log to dispose of returning data sets. This intrinsic does not
apply if you are connected to a VSE/POWER host system. Syntax | |
BA BA I BA I
NRJEHJCancel (Wsid, UserName, UserNameLen, JobList, JobListLen,
I IA
NumCancelled, 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. - UserName
An input byte array (value
required if JobList and JobListLen are not supplied. If both UserName and JobList are supplied, only JobList is used to match host jobs). The UserName parameter specifies the kind of job information you
want. A name can be one of the following: An @ character. Use of this character cancels all your own
jobs. If you have NM capability, all jobs will be cancelled. A UserName.AcctName. (If you are referring to jobs submitted by another
user with this parameter, you must have NM capability).
- UserNameLen
An input integer variable (value
required if UserName is supplied). The UserNameLen parameter specifies the number of bytes in UserName, from 0 through 17. - JobList
An input byte array (value
required if UserName and UserNameLen are not supplied; if JobList is supplied, UserName and UserNameLen are not required, and will be ignored). The JobList array is a list of host job names and/or numbers. Names
are those on the host JCL JOB card. When cancelling jobs by job
names, only jobs submitted by the logon UserName.AcctName are cancelled. The 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: - 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. |
