HPlogo SNA NRJE User/Programmer Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 User Intrinsics

NRJECancel

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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”

Feedback to webmaster