HP 3000 Manuals

NRJEActiveWS [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation


SNA NRJE User/Programmer Reference Manual

NRJEActiveWS 

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."



MPE/iX 5.0 Documentation