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

NRJEConsole
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Obtains the host remote console of a workstation.

Syntax

                 BA       D        IA     
 NRJEConsole ( Wsid, ConsoleId, 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.

ConsoleId

An output double-word integer variable. The ConsoleId parameter contains the console identification used with the NRJEConsCheck, NRJERcvMsg, NRJERelease, and NRJESendCmd intrinsics.

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 Chapter 5 “User Intrinsics”

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

Call NRJEConsole before NRJESendCmd, NRJERcvMsg, and NRJERelease. NRJEConsole obtains access to the host remote console for a workstation and returns ConsoleId.

ConsoleId is used to identify the host remote console in these intrinsics:

  • NRJEConsCheck: to determine if any host remote console messages are waiting to be received.

  • NRJESendCmd: to transmit a host remote console command.

  • NRJERcvMsg: to receive a host remote console message.

  • NRJERelease: to relinquish control of the host remote console.

After NRJEConsole has returned control to your program, test the first element of Result.

Text Reference

CONSOLE also obtains access to the host remote console. See the SNA NRJE Node Manager's Guide for more information.



NRJEConsCheck
  		 


NRJELUStatus  
Feedback to webmaster