HP 3000 Manuals

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