HP 3000 Manuals HP 3000 Manuals
NRJELUList
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."