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