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

NRJEWriter

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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”

Feedback to webmaster