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

142 Chapter5
User Intrinsics
NRJEHJCancel
NRJEHJCancel
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