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

NRJELUList

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Provides a list of all LUs and related characteristics for a workstation.

Syntax

                      BA      I             I          BA        IA
NRJELUList          (Wsid, MaxEntries, ReturnEntries, LUList, ChainSizeList,
                          DA             DA                IA
                    MinJobSizeList, MaxJobSizeList, ActiveLuNameList
                          IA          IA
                    AutoStartList, 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.

MaxEntries

An input integer. The MaxEntries parameter contains the maximum number of entries expected in all output array parameters except Result. The MaxEntries parameter value should be the number of LUs configured for the workstation, from 1 through 16.

Make sure that the available length of each of the output array parameters (LUList, ChainSizeList, MinJobSizeList, MaxJobSizeList, ActiveLUNumList, and AutoStartList) is sufficient for the expected number of entries.

ReturnEntries

An output integer. The ReturnEntries parameter normally contains the actual number of entries in all output array parameters except Result.

After calling NRJELUList, ReturnEntries can contain the required number of entries for LUList, ChainSizeList, MinJobSizeList, MaxJobSizeList, ActiveLUNumList, and AutoStartList. This occurs only when the first word of Result is 137, which means that MaxEntries was too small.

LUList

An output byte array. The LUList array contains a list of entries of all LU names for the workstation. Each entry is eight characters, left-justified, with trailing blanks. Following is an example of a three-entry LUList:

ERST
NEXTONE
LAST
ChainSizeList

An output integer array. The ChainSizeList array contains a list of chain sizes for each LU in a workstation.

A chain size is the number of RUs sent from the workstation to the host before requesting a positive response.

MinJobSizeList

An output double-word integer array. This parameter is hardcoded to return 0.

MaxJobSizeList

An output double-word integer array. This parameter is hardcoded to return a maximum sector size of 2147483647.

ActiveLUNumList

An output integer array. The ActiveLUNumList array contains a list of active LU numbers. A zero entry indicates an LU is inactive. An active entry is a positive integer, which is the LU number.

Following is a three-entry ActiveLUNumList corresponding to LUList, above:

0 ERST is inactive.

34 NEXTONE is active, and its LU number is 34.

22 LAST is active, and its LU number is 22.

AutoStartList

An output integer array. The AutoStartList array contains a list of flags of LUs that are automatically initiated.

Automatic starting is a configurable item.

A zero element is returned if an LU is not initially started when a workstation is started.

A -1 element is returned if an LU is initially started.

following is a three-entry AutoStartList corresponding to LUList, above:

0 ERST is not initially started.

-1 NEXTONE is initially started.

-1 LAST is initially started.

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

Call NRJELUList to obtain a list of all LUs, and lists of LU characteristics, for a workstation. A positional correspondence exists among the entries in LUList and the characteristics listed in ChainSizeList, MinJobSizeList, MaxJobSizeList, ActiveLUNumList, and AutoStartList. The length of all lists must be large enough so that all configured LUs can be entered; otherwise, an error will occur. After NRJELUList has returned control to your program, test the first element of Result.

Text Reference

DISPLAY shows LUs and related characteristics. This is the same information that displays when you enter the DISPLAY command with the LUT parameter. See DISPLAY in Chapter 3 “User Commands”

Feedback to webmaster