HP 3000 Manuals HP 3000 Manuals
NRJEWriter
Obtains information about the logical writers configured for a
workstation.
Syntax
__________________________________________________________________________
| |
| |
| BA I I BA BA IA |
| NRJEWriter ( Wsid, InCount, OutCount, WriterList, LdevList, PrList,|
| IA BA BA IA IA |
| TransList, Reserved, Reserved, Forced, 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.
InCount An integer input variable. The InCount parameter specifies the
maximum number of elements to be returned in all of this intrinsic's
output arrays except Result.
The maximum value you can specify for InCount is 14. This is because
no more than seven printer writers and seven punch writers can be
configured for a workstation. This is a host restriction.
OutCount An integer output variable. The OutCount parameter identifies the
actual number of elements returned in all of this intrinsic's output
arrays except Result.
WriterList An output byte array. The WriterList array is a list of logical
writer names configured for your workstation, such as PRn and PUn,
where n is from 1 through 7.
Each entry is eight characters long, left-justified, and filled with
trailing blanks. Following is a typical set of three WriterList
entries:
PR1
PR2
PU1
LdevList An output byte array. The LdevList array is a list of output
designators that correspond to the names of logical writers in
WriterList. These may be an ldev, a logical device class, or a
'formid.' Each entry is eight characters long, left-justified, and
filled with trailing blanks.
PriList An output integer array. The PriList array is a list of output
priorities that correspond to logical device numbers in LdevList.
Each entry is an output priority, where PriList[i] is from 0 through
14; 14 is the highest priority. When PriList[i]=0, the
system-configured default value is used.
TransList An output integer array. The TransList array is a list of Native
Language identifiers used to designate an EBCDIC-ASCII translation
table.
Each entry indicates the kind of translation done for a corresponding
logical writer in WriterList. Each entry in TransList contains one
of these values:
* 0-255 = A language ID.
* -1 = No translation will be done.
Reserved This field is not in use at this time.
Reserved This field is not in use at this time.
Forced An output integer array. The Forced array is a list of flags for
each writer of a workstation. Each entry indicates whether the
configured formids are "forced" specifications.
Values for Forced[i] are as follows:
* 0 = The configured 'formid' is "forced". This supersedes
JCL-specified form references.
* -1 = User-specified special form names are used.
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
NRJEWriter is used to obtain information about the logical writers
configured for your workstation. Enter your workstation identification
(Wsid) and the maximum number of writers you expect (InCount). You
receive the following output from NRJEWriter:
* The number of writers (the OutCount parameter value). OutCount is
also the length of the lists shown below.
* Writer characteristics are output in separate lists:
* Name
* Logical device number
* Output priority value
* Native Language ID
* A flag indicating whether the formids are "forced"
When NRJEWriter returns control to your routine, you should test Result.
Text Reference
The NRJEWriter intrinsic provides information for the DISPLAY command.
See Chapter 3, "User Commands."