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

NRJEQueue

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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 of 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”

Feedback to webmaster