HP 3000 Manuals

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


SNA NRJE User/Programmer Reference Manual

NRJEWSInfo 

Obtains general information about a workstation.

Syntax 
____________________________________________________________________
|                                                                  |
|                                                                  |
|                   BA       I        BA    BA       BA      IA    |
|     NRJEWSInfo ( Wsid, ActiveFlag, JES, Remote, Reserved,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.

       ActiveFlag An output integer variable.  The ActiveFlag parameter is used to
                  learn whether your workstation is communicating with a host.
                  Possible values for this parameter are as follows:

                   *    1 = Your workstation is active.

                   *    2 = A stop is pending.

                   *    4 = A protocol shutdown is pending.

                   *  %10 = A monitor request is pending.

                   *  %20 = LU activation is pending.

                   *  %40 = Your workstation is inactive.

              JES An eight-character output byte array.  The JES parameter is used to
                  identify the job entry system configured at your host.  Information
                  is returned left-justified, with trailing blanks if needed.

           Remote An eight-character output byte array.  Use the Remote parameter to
                  learn how the host system identifies your workstation.

                  For example, RMT11 is returned as

                       RMT11

         Reserved This field is not in use at this time.
           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 

NRJEWSInfo is used to obtain general information about a workstation.

Input to NRJEWSInfo is the workstation identification (Wsid).

Ouput from this intrinsic is as follows:

 *  Whether the workstation is actively communicating with the host.

 *  The host job entry system in use.

 *  The remote identification used for the workstation at the host.

Once NRJEWSInfo has returned control to your routine, you should test
Result.

Text Reference 

Output from the NRJEWSInfo is supplied to the DISPLAY command.  See
Chapter 3, "User Commands."



MPE/iX 5.0 Documentation