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

NRJEWSInfo

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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

Output 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”

Feedback to webmaster