HP 30292B User Manual

technology

3000 Business Servers Networking

3000

Bus ness

Servers

SNA NRJE Network Remote Job Entry

This paragraph describes System Network Architecture Network Remote Job Entry (SNA NRJE) for both the MPE V (SNA NRJE/V) and MPE/iX (SNA NRJE/iX) operating systems. The term SNA NRJE is used to refer to both SNA NRJE/V and SNA NRJE/iX. The terms SNA NRJE/V and SNA NRJE/iX are used when a distinction is necessary.

SNA NRJE/V on the HP 3000 Series 37-70 or SNA NRJE/iX on the HP 3000 Series 900 provides enhanced batch data communications between the HP 3000 and an IBM Systems/370-compatible mainframe in a System Network Architecture (SNA) environment. SNA NRJE emulates the major features of an IBM 8100 DPPX/RJE workstation using an SNA Physical Unit Type 2 (PU 2), Logical Unit Type 1 (LU 1) device.

HP SNA Services (30292B):

- SNA NRJE Network Remote Job Entry

- SNA IMF/iX Interactive Mainframe Facility

- LU 6.2 Application Programming Interface

- SNA Distributed Host Command Facility/iX

Features

• SNA NRJE is able is able to communicate with JES2, JES3, and VSE/POWER host job entry subsystems.

• Automatically route job output based on destinations selected by the user at the time of job submittal - “Job Management”

• Automatically route output based on user-selected IBM host forms - “Output Management”

• Process batch jobs originated by a user on an IBM Mainframe - “Reverse NRJE”

• Provide Native Languages Support - for data only. NLS 16-bit character mapping; interactive and programmatic access; and data integrity are not supported for languages such as Japanese, Korean, Simplified Chinese, and Traditional Chinese.

• Host output can be sent to any supported output device on an HP 3000 such as disk files, tape files, printers, or user-written programs.

• Multiple HP 3000 users can concurrently access the host for batch processing.

• Jobs are submitted into the transmission queue independent of the line status.

• Users can submit jobs and receive output without operator intervention.

• Other HP 3000 applications run concurrently with SNA NRJE.

• SNA NRJE can share an SNA link with other HP SNA service products.

• Customizable error and help message facilities are provided.

• Host console commands can be sent and host console data can be received.

• Data compression and character code translation are configurable.

• SNA NRJE and SNA Link support communications at up to 56 KB/s on MPE V and 16 MB/s on MPE/iX.

• SNA NRJE can take advantage of SNA/SDLC Link’s Auto-dial capability.

IBM Host Processor

Communications

Controller

MVS/SP JES2 or JES3 ACF/VTAM

VSE VSE/POWER ACF/VTAM

IBM 8100

DPPX/RJE

Printers

Magtapes

Disks

RJE Console

Card Readers

Printers

Card Readers

Terminals

Magtapes

Laser Printers

Disks

HP 3000

Printer

Up to 56 Kbps for MPE/V, and 64 Kbps for MPE/iX

Switched

or Leased

HP 3000 V or

SNA NRJE

and SNA Link

Modem

9600 bps

3000

Bus ness

Servers

SNA NRJE/iX requires the installation and use of SNA/SDLC Link/iX (30291A), SNA/Token Ring Link/iX (J2249A, requires MPE/iX Release 5.0 or later) or SNA/X.25 Link/iX (30298A), SNA NRJE/V requires SNA Link/V (30246A). SNA/SDLC Link/iX, SNA/Token Ring Link/iX, SNA X.25 Link/iX, and SNA Link/V (referred to jointly as SNA Link) manage the physical link to the host and implement protocols in the lower three layers of SNA. Each link product contains software, a hardware interface card, and a cable. SNA NRJE can run simultaneously with other HP SNA services 9for example, SNA IMF) on both the MPE V or MPE/iX systems. In addition, all SNA services can run simultaneously over the same SNA Link.

Functional Description

SNA NRJE must be used with an SNA Link product, which implements protocols in the lower three layers of SNA and provides physical connectivity to the IBM host via leased/dial-up lines or LAN. SNA Link supports line speeds up to 56 KB/s on MPE V and 16 MB/s on MPE/iX as well as simultaneous batch and interactive communications to an IBM host over a single line.

SNA NRJE supports up to eight workstations on an HP 3000. When these workstations are used to communicate with different hosts, each workstation must use a different SNA Link.

The SNA NRJE user interface has commands for submitting jobs, directing the output to specific devices, directing the output to specific predefined file equations, displaying job status, and canceling jobs (see table of Selected User Commands on next page for other commands). These commands can be issued interactively through a terminal, or issued as part of an HP 3000 program

executing NRJE intrinsics. MPE commands can be executed in the middle of SNA NRJE operations. The HP 3000 will concurrently process user applications and data communications with an IBM mainframe.

In addition to SNA NRJE user commands, an operator with Node Manager (NM) capability has commands to start and stop the batch workstations, obtain the host remote console, start and stop tracing and other functions. These commands may be issued either interactively or through a batch job.

Operation of the user or operator interface is independent of the status of the data communications line. Submitted jobs are held in a transmission queue and automatically sent to the host when the line becomes available.

Similarly, job output is held at the host and sent to the HP 300 when the line connection is made.

The Job Management feature of SNA NRJE allows users, at time of submittal, to specify the particular device to which their job output is to be directed. If no device is specified, output is directed to a default destination, according to the configuration of SNA NRJE by the NodeManager. No further user intervention is required.

Note: Job Management is not available to anyone communicating with a host using the VSE/POWER job entry subsystem.

Output can be received on any standard output device on the HP 3000 such as tape units, disks, and printers. Similarly, jobs can be input device such as terminals, card readers, or disk.

3000

Bus ness

Servers

The Output Management feature of SNA NRJE allows users to have job output routed based on the form selected by the user’s host JCL and a Lookup Table which provides a mapping between host form names and HP 3000 file equations. Again default forms will be used if none are indicated.

Reverse NRJE allows a user connected to an IBM mainframe (or a user on a separate HP 3000 attached to the IBM) to start a job on an HP 3000 if SNA NRJE on the HP 3000 is active.

Note: The user must use the special form CMD that causes SNA NRJE to stream a received data set rather than route the data set using file equation attributes.

Using SNA NRJE and SNA Link, an HP 3000 with an HP 2680 Laser Printer can act as a remote or local (though still requiring a 37xx communications controller) print station for an IBM host. HP 3000 users can direct print output data sets to the laser printer. Users can specify an environment file that indicates predefined forms, character fonts and formats

- data set by data set. Native Language Support allows users to

select alternative Native Language Ids for translation of user data. Only data going to the host or coming from the host will be translated, commands and messages will still be in native 3000. Each reader, printer, and punch can be configured with a different language. NLS 16-bit character mapping; interactive and programmatic access; and data integrity are not supported for languages such as Japanese, Korean, Simplified Chinese, and Traditional Chinese.

Product Requirements

Both SNA NRJE/iX and SNA NRJE/V require an IBM System/370-compatible mainframe (Model 370, 30xx or 43xx) with an IBM 37xx communications controller. The following software must be running on the host and communications controller:

• Job Entry Subsystem: JES2 or JES3 running under – Operating System: MVS

• Job Entry Subsystem: VSE/POWER running under – Operating System: VSE – ACF/VTAM – ACF/NCP

Selected User Commands

Command Function

ALTER* Revises the priority of a submitted

job, or jobs.

CANCEL* Cancels previously submitted jobs

and causes data sets returning from

transmitted jobs to be deleted.

DISPLAY Provides information about a

workstation.

EXIT Causes the user to exit from the

NRJE command interpreter (CI), and returns control to the process from which the CI was run.

##FD “File Definition” used within a job to

include the contents of the file specified in the command.

HELP Provides you with information about

subsystem commands.

NRJE Invokes the subsystems command

interpreter. It is also an NRJE sub system command, so that you can switch to a different default workstation.

REDO Modifies and executes the previous

NRJE subsystem command.

RUN Executes a prepared program. SHOW* Provides information about jobs

you have submitted.

SUBMIT Prepares a batch input job stream for

transmission to a host system.

* This command has NRJE Manager extensions.

3000

Bus ness

Servers

HP will support certain versions, releases, modifications, and Product Temporary Fix (PTF) levels of the above software. The Network Implementations Support Plan (NISP) will help the customer engineer determine support requirements in advance of SNA NRJE in a particular network.

SNA NRJE/iX Product Requirements

• An HP 3000 Series 900 computer system running a supported release of MPE/iX.

• HP 30291A SNA/SDLC Link/iX, J2249A SNA/Token Ring Link/iX, or HP 30298A SNA/X.25 Link/iX

SNA NRJE/V Product Requirements

• An HP 3000 Series 37-70 and MPE V operating system

• HP 30246A SNA Link/V

Functional Specifications

SNA NRJE provides the HP 3000 with the major functions of an IBM 8100 DPPX/RJE workstation operating as a remote node in an SNA network.

The maximum RU size supported by NRJE is 768 bytes.

SNA NRJE supports a record length up to 252 bytes (or characters) for JES2 and JES3 and 128 bytes (or characters) for VSE/POWER when sending data from the HP 3000 to an IBM host. Records up to 225 bytes in length may be received from the host.

NRJE supports up to eight workstations, each of which may support up to 16 LU-LU sessions, with a maximum of 64 total LU-LU sessions.

Installation and Configuration Policy

SNA NRJE is customer installable. However, Hewlett-Packard will perform minimum configuration of SNA NRJE in order to verify minimum product functionality. These tasks performed by HP are included in the product purchase price.

For product configuration tailored to the customer’s specific needs, or for a complete HP implementation, HP offers a comprehensive range of integrated and flexible support services. Please refer to the Network Support data sheets in this guide for more information on these services.

Customer Responsibility

Prior to having HP personnel onsite to perform minimum configuration of SNA NRJE, the customer is responsible for the following:

• Providing HP with the information necessary to complete the Network Implementation and Support Plan (NISP) including: – System configurations – Logical network map identifying relevant

traffic flow

– Physical network map identifying relevant

network hardware components.

• Verifying that the necessary host mainframe software is installed and configured to support SNA NRJE. The customer should contact their HP Sales Representative for typical host parameter values or consult the “HP SNA Products Remote System Configuration Guide (J2220-61025).

• Verifying that SNA Link/V, SNA/SDLC Link/iX, SNA/Token Ring Link/iX, or SNA/X.25 Link/iX is properly installed and configured prior to the installation of SNA NRJE unless an SNA Link will be installed at the same time.

3000

Bus ness

Servers

• Updating the HP 3000 system to the proper release level and installing the SNA NRJE software using AUTOINST. Refer to the HP 3000 MPE/iX Installation and Update Manual (36123-90001) for MPE/iX systems or the HP 3000 Software Update Manual (32033-90036) for MPE V systems.

• Verifying that all of the necessary software modules have been successfully installed by AUTOINST and are at the correct version levels using the NMMAINT.PUB.SYS utility.

• Performing full system backups as necessary and ensuring that the HP 3000 system and personnel with HP 3000 system management knowledge are available when HP is onsite to complete the INP card installation and minimum configuration of SNA NRJE.

The customer is also responsible for completing the configuration in order to fully integrate SNA NRJE into the existing customer network after HP has completed the minimum configuration of the SNA NRJE.

HP Responsibility

Following the installation of SNA NRJE, HP is responsible for the following:

• Confirming that all of the necessary software modules have been installed and are at the correct version level.

• Configuring the SNA NRJE product to a minimum configuration (1 LU) in order to verify software and hardware functionality.

• Verifying the SNA NRJE configuration by issuing the NRJECONTROL START command and ensuring that the LU-to-LU session becomes active.

These steps complete HP’s portion of the installation and minimum configuration of SNA NRJE.

HP effort spent on problems that are not caused by HP installation and configuration activities is considered HP Consulting Support and is billable to the customer at normal HP time-and-materials rates.

System Environment

SNA NRJE/iX, SNA SDLC Link/iX, and SNA/X.25 Link/iX are available on the HP 3000 Series 900 with currently supported releases of the MPE XL or MPE/iX operating system. SNA/Token Ring Link/iX requires MPE/iX release 5.0 or later. SNA NRJE/V and SNA Link/V are available on the HP 3000 Series 37-70 computers with the MPE V operating system.

Documentation

The following documentation is for both SNA NRJE/V and SNA NRJE/iX:

• 30292-61001 SNA NRJE User Programmer Reference Manual

• 30292-61000 SNA NRJE Node Manager’s Guide

• J2220-61025 HP SNA Products Remote System Configuration Guide

• 5958-8544 HP SNA Products: Job Entry Subsystem (JES) Guide

3000

Bus ness

Servers

SNA IMF/iX Interactive Mainframe Facility

The SNA Interactive Mainframe Facility/iX (SNA IMF/iX) product provides IBM 3270 device emulation for Hewlett-Packard terminals, printers, and HP 3000 Series 900 systems. (SNA IMF/V, P/N 30247A, provides similar functionality for MPE V systems.)

SNA IMF/iX on an HP 3000 Series 900 allows interactive communications between the HP 3000 and an IBM System/ 370-compatible mainframe using SNA 3270 protocols. SNA IMF/iX emulates the base function set of an IBM 3270 control unit using SNA Physical Unit Type 2 (PU2 or 2.1), Logical Unit Types 1,2,3 (LU1, 2,3) protocols. HP terminals, printers, and applications on the HP 3000 running SNA IMF/iX emulate IBM terminal and printer functions.

SNA IMF/iX allows access to 3270 subsystems on the mainframe (such as TSO, CICS, and IMS) through a set of high-level intrinsics. There are two modes of operation. In programmatic mode, customer-written application programs on the HP 3000 emulate IBM 3270 terminals and printers, exchanging data with the host

Features

• SNA IMF/iX and an SNA Link product allow the HP 3000 to emulate the base function set of an IBM 3270 control unit using SNA (PU2 or 2.1, LU1, 2, 3) protocols.

• Other HP SNA service products can all be supported simultaneously over one SNA/SDLC Link/iX or SNA/X.25 Link/iX. The maximum datacomm line speed is 64 KB/s.

• SNA IMF/iX supports up to 127 devices (terminals, printers, and application programs) concurrently. With MPE/iX Release 4.0 or later, SNA IMF/iX supports up to 127 devices per SNA Link.

• The Pass Thru capability of SNA IMF/iX allows HP 3000-attached printers and terminals to emulate the base function set of IBM 3270 printers and terminals.

• SNA IMF/iX Pass Thru takes advantage of the Modified Data Tag feature of selected HP terminals (such as the HP 700/94) and supports a write optimization feature that limits screen updating to modified rows only. These features significantly reduce response time.

• SNA IMF/iX provides a “rolling softkeys” feature that allows the user to define and label multiple levels of terminal function keys to be their most frequently used IBM 3270 program function keys. Users can also define various “menus” of function keys that are clearly displayed in the terminal screen. The SNA IMF Programmer’s Reference Manual documents the terminals supporting this feature, some of which provide up to 16 softkeys on the screen at a time.

• Terminals/printers being used in the PassThru mode do not have to be dedicated. The user may access either the HP 3000 or the remote host from the same terminal.

IBM Mainframe

Processor

Communications

Controller

SNA Link(s)

SNA

IMF/iX

Other HP

SNA Services

HP 3000/iX

IBM 3274

Control Unit

Up to 127 SNA IMF/

iX Devices – HP Terminals – HP 3000 Programs – HP 3000 Printers

Up to 32 IBM Devices – IBM Terminals – IBM Printers

ACF/VTAM

ACF/NCP

3000

Bus ness

Servers

applications via intrinsics. The customer’s application program decides which intrinsics to call. In Pass Thru mode, an HP-written application program on the HP 3000 also emulates IBM 3270 terminals and printers, exchanging data with host applications via intrinsics. In Pass Thru mode, the selection of which intrinsics to call is fixed.

SNA IMF/iX requires the installation and use of SNA/SDLC Link/iX (30291B), SNA/Token Ring Link/iX (J2167B)* or SNA/X.25 Link/iX (36939B). The SNA Link products manage the physical link to the host and implement protocols in the lower three layers of SNA.

* SNA/Token Ring Link/iX (J2167B) requires MPE/iX release 5.5 Express 7 or later, or MPE/iX release 6.0 Express 1 or later.

Asian options also supported include:

• HP Asian Vectra PCs

• HP Asian Terminals

• HP Asian Printers

• Asian IBM environments

Functional Description

SNA IMF/iX is a software product that allows an HP 3000 and attached devices to emulate the base function set of an IBM 3274 control unit and attached devices, which does not include graphics, programmed symbols, color, or extended highlighting.

SNA IMF/iX requires SNA/SDLC Link/iX, SNA/Token Ring Link/iX or SNA/X.25 Link/iX. These links manage the communications link and implement lower-level SNA (PU2 or 2.1) protocols. SNA IMF/iX provides interactive and programmatic 3270 communications with a mainframe and can run simultaneously along with other SNA services such as SNA NRJE/iX and LU6.2 API/iX on MPE/iX systems.

In the programmatic mode, user-written programs on the HP 3000 can communicate with programs on the host. HP 3000 programs may be written in C, FORTRAN, COBOL, COBOL II, BASIC, Pascal, or SPL.

Features (continued)

• SNA IMF/iX allows programs on an HP 3000 to communicate with programs o the host system, through a set of high-level intrinsics. Programs may be written in C, FORTRAN, COBOL, COBOL II, BASIC, Pascal, or SPL.

• Most host application programs designed to work with IBM 3270 terminals can usually be used with minimal change.

• SNA IMF/iX runs concurrently with other HP 3000 applications and can be accessed from other systems via HP’s Network Services.

• SNA IMF/iX supports HP’s Native Languages Support (NLS 8-bit character mapping), which allows application programmers to create local language applications for end users. NLS 16-bit character mapping; interactive and programmatic access; and data integrity are not supported for languages such as Japanese, Korean, Simplified Chinese, and Traditional Chinese.

• SNA IMF/iX supports IBM applications with 480, 1920, or 3440 character screen sizes.

• For Asian options only:

– SNA IMF/iX (ASIAN) supports

IBM’s DBCS protocol to ensure 16bit data integrity communication between the HP 3000 and the Asian host.

– SNA IMF/iX (ASIAN) allows both

16-bit interactive as well as programmable access to the Asian IBM host.

– SNA IMF/iX (ASIAN) provides 16-

bit character mapping between the HP (HP-15) and the IBM (DBCS) data.

– SNA IMF/iX (ASIAN) supports

languages such as Japanese, Korean, and Traditional Chinese.

3000

Bus ness

Servers

Program access is accomplished through use of a set of intrinsics that are powerful procedures, which perform the low-level task of decoding the data streams.

(Table 1 provides a list of available intrinsics.) The intrinsics can be used with the intrinsics of other HP 3000 facilities such as IMAGE/3000, VPLUS/3000, KSAM/3000, or NS/3000. The high-level, easy-to-use nature of these intrinsics results in improved programmer productivity.

Because programmatic mode works by exchanging information through screen images, most host applications that have been

written for use with IBM 3270 controllers will work with SNA IMF/iX with little or no modification. For customers who are in the process of changing from centralized to distributed processing, this feature helps provide a smooth transition.

The Pass Thru mode of SNA IMF/iX provides users the capability of using HP 3000 attached printers and DTC attached terminals for interactive access to a host computer.

In this mode, SNA IMF/iX users can directly access host software such as CICS or IMS, or they can use TSO for program development.

Table 1. SNA IMF/iX Intrinsics Summary

Intrinsic Function

ABORT3270 Aborts an outstanding no-wait REC3270 or TRAN3270 request. ACQUIRE3270 Provides the SNA IMF/iX users the capability to start PASS Thru on an HP 3000 terminal

or printer programmatically. ATTRLIST Returns the locations of attribute characters with all or a subsection of a screen. CLOSE3270 Equivalent to turning off the specified device. ERR3270 Returns the error message associated with a given intrinsic error number. EXTFIELDATTR Returns information about the attribute information of the Double Byte FIELDATTAR Returns information about the attributes of the specified field. IOWAIT3270 Informs the user program that a previous I/O operation has completed. IODONTWAIT3270 Waits for a previous no-wait I/O request to complete. OPEN3270 Equivalent to turning on the power of a 3270 Display Station or Printer. It allocates the

internal screen buffer used by SNA IMF/iX. PRINT3270 Prints a copy of the internal screen image to a spool file. READFIELD Reads a field of data from the internal screen buffer and returns the data to an

HP application program.

READSCREEN Reads all or part of the internal screen buffer and returns this data to the

HP application program. RECV3270 Allows the user program to receive the screen after modification by the host. RESET3270 Equivalent to pressing the RESET key on an IBM 3270 Display Station keyboard. SCREENATTR Returns information about the attributes of the screen image currently in the internal buffer. STREAM3270 Equivalent to typing a Series of keystrokes in a 3270 Display Station keyboard. Provides

a mechanism for performing “special function key” operations from the HP application

program. Also allows more than one field of data to be updated in one Intrinsic call. TRAN3270 Equivalent to pressing a transmit key in the 3277 or 3278 Display Station keyboard.

It causes modified data to be transmitted to the host the next time the host polls the device. VERS3270 Returns the number if the version of SNA IMF/iX that is being executed in the HP 3000. WRITEFIELD Writes data from the HP application program into an unprotected field if the internal

screen buffer. READSTREAM Reads all or part of the untranslated host data stream. WRITESTREAM Creates the data stream that an HP application program sends to the IBM host.

+ 16 hidden pages