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

NRJEStopWS

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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 "Glossary" 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 “User Intrinsics”

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.

Feedback to webmaster