NRJEQueue [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation
SNA NRJE User/Programmer Reference Manual
NRJEQueue
Obtains information about a workstation transmission queue (the spooled
reader).
Syntax
___________________________________________________________________________
| |
| |
| BA I I BA I I |
| NRJEQueue (Wsid, Reserved, QueueLdev, Reserved, Reserved, ChainSize,|
| I I I I |
| CompFlag, TransIndicator, ReaderStatus, ReaderFence, |
| I IA |
| SystemFence, 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.
Reserved This field is not in use at this time.
QueueLdev An output integer variable. The QueueLdev variable contains the MPE
logical device number for the transmission queue. This is always a
spooled device.
Reserved This field is not in use at this time.
Reserved This field is not in use at this time.
ChainSize An output integer. Use the ChainSize value to find the default chain
size configured for transmission to the host.
The size of a chain is the number of request units (RUs) to be
transmitted to a host before NRJE requires a response.
CompFlag An output integer. Use the value of CompFlag to learn the state of
compression configured for a workstation transmission queue. The
values of CompFlag are as follows:
* Any odd number: Data is transmitted to the host in compressed
form.
* Any even number: Data transmitted to the host is not in
compressed form.
TransIndicator An output integer. The value f TransIndicator identifies the Native
Language ID used by the NRJE reader to obtain the ASCII-EBCDIC
translation table. Language IDs range from 0 through 255.
ReaderStatus An output integer. The ReaderStatus value shows the spooling status
of the reader identified by QueuedLdev. The values returned for
ReaderStatus are as follows:
* Any odd number: The reader is spooled at this time.
* Any even number: The reader configured in QueuedLdev is not
spooled. You are unable to submit jobs. The NRJE operator must
issue a reader up command (RDRUP) or the system operator must
issue the MPE command OPENQ.
ReaderFence An output integer. The ReaderFence parameter functions like an MPE
OUTFENCE for the QueuedLdev. When ReaderFence > 0, and communication
to the host is initiated, each spool file in the transmission queue
whose priority is less than or equal to the ReaderFence value is not
transmitted. When ReaderFence = 0, the MPE system output fence value
(outfence) is used.
Call NRJEAlter to reset the priority of job stream files in the
workstation transmission queue.
SystemFence An output integer. The SystemFence is the MPE outfence parameter.
When ReaderFence = 0, each output spool file whose priority is less
than or equal to SystemFence is not transmitted.
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
Use NRJEQueue to obtain information about the spooled reader for your
workstation. Identify your workstation in Wsid as an input parameter.
The NRJEQueue intrinsic provides you with the following information:
* The logical device number of the queued reader for your workstation.
* The following set of parameters associated with the queued logical
reader:
* The ChainSize, the number of RUs per job stream.
* A flag indicating whether data compression is performed.
* A data translation indicator.
* A spooling indicator showing the current status of the queued
reader.
* An output fence value for the queued reader.
* The system-wide output fence parameter.
After NRJEQueue has returned from your call, test the Result array.
Text Reference
The NRJEQueue intrinsic provides information for the DISPLAY command.
See Chapter 3, "User Commands."
MPE/iX 5.0 Documentation