HP 3000 Manuals HP 3000 Manuals
NRJEStopWS
Stops or halts LU-LU session or workstation.
Syntax
_____________________________________________________________
| |
| BA I BA I IA |
| NRJEStopWS ( Wsid, NumLUs, LUNames, StopCode, 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.
NumLUs An input integer. The NumLUs parameter specifies the number of
entries in LUNames, from 0 through 16. The value of NumLUs for the
LUNames example below is 4.
If the value of NumLUs is 0, the action indicated by StopCode applies
to all active LUs.
LUNames An input byte array. The LUNames array is a list of eight-character
logical unit (LU) names. In MPE V, these are LU class names as
configured in the SNA Configuration: Classes screen. In MPE XL,
these are host names (not NAUs) of LUs that you wish to stop. See
Appendix D, "Glossary of Terms," for the definition of an LU.
Each entry is eight alphanumeric characters long, begins with a
letter, and is left-justified and blank-filled. The number of
entries is specified in NumLUs.
Following is an example of an LUNames array of four entries:
FIRSTLU
NEXTUNIT
NTHLU
LASTUNIT
StopCode An input integer. The StopCode indicates how the LU-LU sessions
indicated in LUNames are to stop. Value can be one of the following:
* 0 = Stop the sessions in an orderly manner.
* 1 = Halt the sessions immediately.
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.
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
This intrinsic provides an orderly or an immediate way to stop selected
LU-LU sessions or all active LU-LU sessions. Specify the number of LUs
to be stopped in NumLUs. Specify each LU name to be stopped as an entry
in LUNames. After NRJEStopWS returns control to your program, test the
first element of Result.
Text Reference
The NRJE manager commands STOPWS and HALT stop a workstation. See the
SNA NRJE Node Manager's Guide for more information on these commands.
The MPE commands to stop a workstation are NRJECONTROL HALT and
NRJECONTROL STOP. See the SNA NRJE Node Manager's Guide and the SNA Link
Services Reference Manual or the SNA Link/XL Node Manager's Guide.