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

NRJEActiveWS

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Provides the number and identification of active NRJE workstations.

Syntax

                  I           BA          I       IA    
NRJEActiveWS ( InCount, WorkStations, OutCount, Result )

Parameters

InCount

An integer input variable by reference. The InCount parameter specifies the maximum number of entries that can be returned in the WorkStations array, from 1 through 8.

If InCount is less than the actual number of active WorkStations, an error code will be returned in Result.

WorkStations

An output byte array. The WorkStations array is a list of active NRJE workstations. Each entry is eight characters long, left-justified, and blank filled when necessary. A three-entry list will look like this:

STA1
RICHARD
RMT99

OutCount

An output integer variable by reference. The OutCount parameter is the number of active workstations and entries in WorkStations. Using the example for WorkStations above, OutCount=3.

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

The NRJEActiveWS intrinsic provides a list of active workstations. The maximum list length is entered in the InCount parameter. The list is in the Workstations array. The number of active workstations is returned in the OutCount parameter. The Result array contains any intrinsic execution error codes.

Text Reference

This intrinsic is used to provide information for the DISPLAY command. See Chapter 3 “User Commands”

Feedback to webmaster