Cray Computers

Special Issue

USER DOCUMENTATION CATALOG

SCIENTIFIC COMPUTING DIVISION NATIONAL CENTER FOR ATMOSPHERIC RESEARCH About this issue

In response to user requests, we are pleased to bring you a special issue this month - the User Documentation Catalog. This catalog lists all the documentation available from SCD, as well as documentation that we recommend users purchase from outside vendors. The catalog contains a brief description of each document, an order form for SCD- distributed documentation, and ordering phone numbers and addresses for vendors.

To determine whether you need a particular document, we urge you to take a few minutes to read the description before ordering. As you might guess, we anticipate being inundated with orders, so please allow additional time for delivery.

The October issue of SCD Computing News will return to the usual format. In the meantime, please read the on-line Daily Bulletin to keep up with the latest news. Contents

Overview of This Catalog ...... 1 How to Order Documentation ...... 1

How to Obtain Computing Information ...... 1

Documentation Categories...... 1 Introductory...... 2

Cray Computers ...... 2 Documentation Distributed by SCD ...... 2 Documentation Distributed by Cray ...... 4

IBM Computers ...... 6 Documentation Distributed by SCD ...... 6 Documentation Distributed by IBM ...... 7

Input/Output ...... 7

Mass Storage System (MSS)...... 8

Applications Software ...... 9

Graphics ...... 12

Networking and Data Communications...... 14 Terminal Emulators for IBM-compatible PCs ...... 16 Terminal Emulators for Apple Macintosh Computers ..... 18

Additional Topics...... 19

Acronyms and Terms ...... 20

SCD Documentation Order Form ...... 21 NCAR GKS Graphics, Version 2.00 Manuals OrderForm ...... 25 Acknowledgments

Contributing Authors

Lynne Andrade Barbara Horner-Miller Ken Case Richard Valent

Technical Writer/Editor Diane Huntrods

Technical Information and Review

Britt Bassett Dave Kitts Linda Bath Bob Lackman Brian Bevirt Adrianne Link Phylecia Brandley Marla Meehl Mary Buck Peter Morreale Chris Burghart Don Morris Ginger Caldwell Bernie O'Lear Paul Ciesielski Tom Parker James Curry Mike Pernice Nancy Dawson Juli Rew Mary Downton Dick Sato Cassandra Fesen Gene Schumacher Frieda Garcia Vic Tisone Basil Irwin

Thanks to Elizabeth Heflick for data entry and design work and to Christine Guzy for revisions. Overview of This Catalog

This catalog describes the documentation that the Scientific Computing Division (SCD) distributes to National Center for Atmospheric Research (NCAR) computer users. The catalog also recommends the documentation that you may want to order directly from vendors.

How to Order Documentation To order documentation distributed by SCD (except NCAR Graphics, Version 2.00 manuals), use the order form on page 21 of this catalog. You can also order SCD documentation by contacting Mary Buck. Her e-mail addresses are [email protected] on the Internet and MARYB on the IBM 4381 (IO) front-end computer. You can also telephone her at (303) 497-1232. To order NCAR Graphics, Version 2.00 manuals, use the order form on page 25 of this catalog. To order vendor documentation, see the information provided in the catalog descriptions.

How to Obtain Computing Information Reference copies of the documentation described in this catalog are available in the SCD Consulting Office, Room 17 of the Mesa Lab. If you need more information about the documentation contents, please contact the SCD consultants. Their e-mail addresses are CONSULTI on the IBM 4381 (IO) computer and [email protected] on the Internet. You can also telephone the consultants at (303) 497-1278.

Documentation Categories

The documentation listed in this catalog is grouped into the following nine categories:

* Introductory * Cray Computers * IBM Computers * Input/Output * Mass Storage System (MSS) * Applications Software * Graphics * Networking and Data Communications * Additional Topics

Within each category, the catalog provides a brief description of each document. If the information is available, the catalog also provides the version or publication and revision number, publication date, number of pages, and price of vendor documentation. Acronyms and terms used in the descriptions are defined on page 20.

September 1988 User Documentation Catalog Introductory

Introductory

New User Orientation Contains the information provided in SCD's New User Student Guide, Version 1.1, Orientation Course. The guide is divided into five August 1988, 182 pages sections that contain introductory information about using the IBM 4381 (IO) front-end computer; running basic Cray jobs; accessing the Mass Storage System; processing graphics files; and using the Cray software libraries. The guide is designed to be used in conjunction with The Primerand contains much of the same information, but in an abbreviated form. It is cross- referenced with The Primer, so that users can easily find additional information. The guide contains many examples and hands-on practice sessions.

The Primer, Version 2.0, Introduces you to the computing equipment and July 1988, 175 pages peripheral resources available at NCAR and informs you how to access and use them. After reading this guide, you will know how to use the data communications system to access the IBM 4381 (IO) front-end computer, how to use the IBM 4381 (IO) computer to create a Cray job, and how to process a job on either Cray computer. Appendixes contain a handy command reference list of IBM commands and EXECs as well as Cray Job Control Language (JCL) and procedures.

Cray Computers

Documentation Distributed by SCD

Cray Job Control Language An introduction to Cray Operating System (COS) job with NCAR Site-specific control language (JCL). The document provides a list of Parameters, Version 1.0, Cray JCL with site-specific parameters and gives the July 1988, 18 pages possible values of those parameters. A list of JCL statements is included. For more information about Cray JCL, see the COS Version 1 Reference Manual, which is described on page 4.

EDITOR, Version 1.0, Explains how to invoke EDITOR, a portable editor that July 1988, 15 pages can be used on the Cray computers at NCAR, and describes various commands. In addition, the document also shows how to use string and token replace- ment, explains how to use multifile datasets, and describes the format of the listing dataset.

User Documentation Catalog September 1988 Cray Computers

A Guide to the Production Explains all aspects of scientific film production at of Computer-generated NCAR. Although the software and hardware described Films at NCAR, Version 2.0, are those available at NCAR, the film-making proce- July 1988, 15 pages. dures addressed in the guide may closely parallel those at sites with different configurations. This guide is intended for use with the "old" NCAR Graphics package, which is the pre-Graphical Kernel System version.

How to Recover and Describes how to insert restart logic in your code to Restart Your Cray Job, ensure that your Cray job begins at some point within Version 1.0, November 1987, your job, rather than at the beginning, if the system 10 pages crashes. The document also contains a detailed example of Fortran code that implements restart capability.

How to Use Tapes on the Describes the interface you use to stage 1/2-inch mag- CRAY-1A Computer, netic tapes to or from the CRAY,C1 disks and the tape Version 1.0, June 1988, drives connected to the CRAY,C1 computer. (The 13 pages CRAY,CX computer cannot access magnetic tapes.)

ICJOB: An Interactive Covers the basic capabilities of the ICJOB interface to Interface to the CRAY-1A the CRAY,C1 computer and provides techniques for Computer, Version 1.0, using ICJOB to perform regular tasks. ICJOB is a utility July 1985, 30 pages that provides IBM 4381 (IO) front-end computer users with interactive access to the CRAY,C1 computer. ICJOB provides a program development environment and aids in debugging large codes. (Interactive access to the CRAY,CX computer is provided by VMSTA. For more information about VMSTA, see page 4.)

Locally Developed Cray Lists all sixteen of the local utilities available at NCAR, Utilities, Version 1.0, provides a brief description of the function of these July 1988, 19 pages local utilities, and gives an in-depth explanation of eight of them. This document replaces all previous documentation for the eight utilities that are explained in detail. These eight utilities include: AQPLMS, AUDPRJ, DROPJQ, GETDOC, GETSRC, LOCATE, MAQR, and REMOVE.

September 1988 User Documentation Catalog Cray Computers

PERFMON: The Cray The Performance Monitor utility (PERFMON) monitors Performance Monitor certain hardware-related events during the execution of Utility, Version 1.0, a program. PERFMON helps you optimize your appli- February 1988, 16 pages cations code by providing information that can be used to analyze program performance. This document describes the PERFMON features, contains basic instructions for using PERFMON, and has several examples of input and output. PERFMON is available only on the CRAY,CX computer.

SEGLDR: The CRAY X-MP Serves as an introduction to running the segment loader Segment Loader, for two main audiences: users who want to take Version 1.1, November 1986, advantage of SEGLDR's segmentation capabilities and 4 pages users who want to use SEGLDR to duplicate the func- tionality of LDR (the older Cray loader product). SEGLDR is the loading mechanism for code generated by various language processors on the Cray computers and will completely replace LDR in the future.

SPY: A Timing Information Describes how to use the SPY utility on the Cray Utility, Version 1.0, computers. SPY provides detailed timing information April 1987, 7 pages about program execution within program modules.

Using the Cray Solid-state Explains how to use the CRAY X-MP Solid-state Stor- Storage Device at NCAR, age Device (SSD), an external storage device capable of Version 2.1, August 1988, extremely fast data transfer to main memory. Proper 6 pages use of the SSD can significantly reduce the cost and turnaround time of jobs that require large amounts of I/O. The document also explains how to access the SSD and introduces how Cray I/O is performed.

Discusses VMSTA (Virtual Machine Station), an EXEC VMSTA: Using the CRAY that links the IBM 4381 (IO) front-end computer to the X-MP Computer Interac- CRAY,CX computer. You can use VMSTA to submit tively, Version 1.0, batch jobs, obtain CRAY,CX job queue status reports, or November 1986, 11 pages gain interactive access to the CRAY,CX computer.

Documentation Distributed by Cray

Describes the external features of COS, the Cray COS Version 1 Reference Operating System. The manual is a reference document Manual, SR-0011, Revision O, for all users of COS. It includes information on job $38.00 processing, job control statements, and control statement structures.

User Documentation Catalog September 1988 Cray Computers

Describes all user log file, system log file, and program COS Message Manual, output listing messages issued by Cray Operating SR-0039, Revision E, System (COS) software. $23.90

Describes the CFT (Cray Fortran) compiler. The FORTRAN (CFT) Reference manual describes the standard language, CFT exten- Manual, SR-0009, Revision L, sions and differences, use of the compiler, and provi- $24.85 sions for enhancing performance on Cray computers.

Describes library routines available on CRAY X-MP and Programmer's Library CRAY-1 computer systems running under COS. These Reference Manual, SR-0113, subprograms can be called from user applications Revision B, written in Cray-supported high-level languages such as $34.15 Fortran, Pascal, and C.

Describes the operation of the Cray loader that loads Segment Loader (SEGLDR) program segments without explicit calls to an overlay Reference Manual, SR-0066, manager. SEGLDR loads code produced by language Revision C, processors such as CAL (Cray Assembly Language), $13.65 Fortran, Pascal, and C. SEGLDR runs under COS on the CRAY X-MP and CRAY-1 computer systems.

Describes UPDATE, a Cray utility that provides tools UPDATE Reference Manual, for modifying, editing, and updating source language SR-0013, Revision H, programs running under COS. It also describes $24.15 AUDPL, which provides information about program libraries written by UPDATE, and MODECKS, a utility that creates modification files (mods). UPDATE executes under COS on the CRAY X-MP and CRAY-1 computer systems.

To order Cray documentation or a copy of their complete User PublicationsCatalog, call (612) 681-5907 or write

Order Desk Cray Research, Inc. 2360 Pilot Knob Rd. Mendota Heights, MN 55120

If you order documentation by telephone, please state that you are affiliated with NCAR and provide a billing and a shipping address.

September 1988 User Documentation Catalog Cray Computers

Describes multitasking features and concepts, including CRAY X-MP Multitasking macrotasking and microtasking. The manual explains Programmer's Manual, how to partition an executable program among SN-0222, Revision D, multiple processors on CRAY X-MP computer systems $27.25 running COS.

Describes the CFT77 compiler, which translates CFT77 Reference Manual, FORTRAN 77 programs into machine-language SR-0018, Revision B, programs for all Cray computer systems running COS. $37.95 The manual describes the standard language, CFT77 extensions, use of the compiler, and provisions for enhancing performance on CRAY X-MP computer systems.

IBM Computers

Documentation Distributed by SCD

Explains how to use the IBM 4341 (IO) front-end The NCAR IBM 4341 computers as a gateway tool for accessing NCAR's Gateway Computers, Cray computers. Although the IBM 4341 (IO) February 1986, 256 pages computers have been replaced by the IBM 4381 (IO) front-end computer, the information in this manual is still valid for the IBM 4381. The manual also discusses editing and manipulating files, submitting jobs to the Cray computers and tracking their execution, basic IBM operating system concepts, and the utilities and libraries available on the IBM 4381 (IO) computer. An appendix describes how to use these IBM facilities and includes terminal keyboard templates for several com- monly used terminals.

A guide to writing, running, and debugging Fortran Writing and Debugging programs on the IBM 4381 (IO) front-end computer. Fortran Programs on the This document includes basic information about the IBM 4381 Computer, Version IBM FORTVS compiler, the loader, and the debugger. 1.0, March 1987, 19 pages It describes how to use input/output devices such as magnetic tapes.

User Documentation Catalog September 1988 IBM Computers

Documentation Distributed by IBM

IBM VM/SP: System Designed to give you a working knowledge of XEDIT, Product Editor User's Guide, the System Product editor. It discusses both full-screen SC24-5220, and line-mode editing and uses "before and after" $8.40 examples to illustrate the text.

IBM VM/SP: CMS User's Intended for the general CMS user. It describes the Guide, SC19-6210, interactive facilities of CMS and provides many $28.00 examples. The topics include using the CMS file system, using the help facility, reading tapes, and writing EXECs.

[ To order IBM documentation, call 1-800-426-2468 and ask for the Education and Software Department.

Input/Output

Sending Graphics Intended for users who want to print graphical output Metacode Files to the Xerox on the Xerox 4050 laser printers. This document 4050 Laser Printers, describes how to send graphics metacode files to be Version 1.1, July 1988, processed and printed on the Xerox laser printers from 11 pages the Cray computers, the IBM 4381 (IO) front-end computer, and SCD UNIX front-end computers. It includes descriptions of the available options and provides examples.

Using the Xerox 4050 Laser Intended for users who want to print text output on the Printers from the Cray and Xerox 4050 laser printers. The document summarizes IBM 4381 Computers, the keywords used to control print parameters from Version 1.0, September 1986, the Cray computers and the IBM 4381 (IO) front-end 11 pages computer. It includes job submission examples.

September 1988 User Documentation Catalog Mass Storage System (MSS)

Mass Storage System (MSS)

IBM Utilities for Accessing Discusses four utilities that perform MSS file mainte- the Mass Storage System, nance via the IBM 4381 (IO) front-end computer. The Version 1.0, April 1986, four utilities are MSCHANGE, MSDELETE, MSINFO, 12 pages and MSUPDATE. The document provides examples for each utility.

Mass Storage File Describes four Cray utilities that perform MSS Maintenance from the Cray file maintenance on the Cray computers. After Computers, Version 2.0, summarizing MSCHANG, MSDELET, MSINFO, and December 1986, 17 pages MSUPDAT, the document provides examples of how to use them.

The Mass Storage System, This overview of MSS enables you to use it from the Version 2.0, August 1986, Cray computers and from the IBM 4381 (IO) front-end 16 pages computer. File-naming conventions, file-purging policies, and dataset-moving commands are discussed.

PSTRANS: A Utility for Describes how to use PSTRANS, a utility on the Cray Transferring Files from computers that allows up to 50 specified files from a PSTORE Datasets, PSTORE dataset on MSS to be transferred to specified Version 1.0, September 1986, directories on MSS. PSTORE datasets were created on 5 pages TBM (the previous mass storage system).

TBM Utilities: EOFILT, Documents the use of EOFILT, PSTRANS, and PSTRANS, and TBMCONV, TBMCONV, three locally written utilities that are used Version 1.0, September 1988, with the Ampex Terabit Memory System (TBM), 10 pages NCAR's previous mass storage system. EOFILT filters end-of-file marks into and out of PSTORE datasets. PSTRANS transfers up to 50 files from a PSTORE dataset on the Mass Storage System (MSS) to specified directories on the MSS. TBMCONV allows the Cray computers to read TBM volumes originally written by the CDC 7600.

User Documentation Catalog September 1988 Applications Software

Applications Software

In this section, SCD and non-SCD documents are grouped together, so you can easily see when both SCD and non-SCD documents are available for an applications software package. The documents are listed alphabetically, according to the name of the package. Reference copies are available for use in the Consulting Office, Room 17 of the Mesa Lab. On-line information about the applications software described on the following pages can be accessed on the Cray computers with the GETDOC utility. For more information about the GETDOC utility, see the SCD document, "Locally Developed Cray Utilities," described on page 3 of this catalog.

NCAR Software Catalog, Assists SCD computer users in locating specific Cray March 1986, 345 pages software routines. The catalog provides short descriptions of the applications that are contained in each software library available on the Cray computers. For detailed information about the routines, use the GETDOC utility to view the on-line documentation.

Collected Algorithms of Provides an overview of the Association for the ACM 1975-1979 and Computing Machinery (ACM) software collection that 1980-1984, Version 1.2, is available at NCAR. The document briefly describes April 1987, 29 pages over 130 mathematical software algorithms. The description of each algorithm includes the NCAR classification category for the algorithm (as used in the NCAR Software Catalog), as well as references to full descriptions and where to look for more information.

ECMFFT: Multiple Fast Describes how to use the real and complex transform Fourier Transform Routines, routines in NCAR's ECMFFT library and how to obtain Version 1.2, August 1987, the source code for the nonproprietary versions of these 12 pages routines. The document includes examples of simple working programs. ECMFFT is a binary library of real and complex Fast Fourier Transforms (FFTs) optimized for the Cray computers.

September 1988 User Documentation Catalog Applications Software

EISPACK A library that is primarily dedicated to finding Matrix Eigensystem eigenvalues and eigenvectors of matrices and matrix Routines-EISPACK Guide, systems. EISPACK usage is explained in Volumes 6 and ISBN 0-387-07546-1, 51 of the Lecture Notes in Computer Science, which are $30 published by Springer-Verlag. To order either of the EISPACK documents listed here, call Springer-Verlag at Matrix Eigensystem 1-800-526-7254 or write Routines-EISPACK Guide Extension, Springer-Verlag New York, Inc. ISBN 0-387-08254-9 Order Department $27.50 44 Hartz Way Secaucus, NJ 07094

FISHPAK: A Package of A software library intended for users who are solving Fortran Subprograms for the separable elliptic partial differential equations. Solution of Separable FISHPAK contains information about accessing the Elliptic Partial Differential FISHPAK binary library on NCAR's Cray computers, Equations, Version 1.1, the source code for the Fortran subroutines, test May 1988, 7 pages programs, and documentation files. Several of the Fortran subroutines treat the Helmholtz equation in Cartesian, polar, cylindrical, and spherical coordinate systems.

FITPACK: A Software Contains a preface that briefly describes the software Package for Curve and features and provides instructions for accessing and Surface Fitting Employing using the FITPACK source code and binary library on Splines Under Tension, NCAR's Cray computers. The rest of the document Version 1.0, September 1987, describes the routines for curve and surface fitting that 22 pages use splines under tension. This document does not include argument descriptions; if you want to use FITPACK, you need to obtain the FITPACK manual that is described below.

FITPACK, 1983, A library of software for curve and surface fitting em- 351 pages, ploying splines under tension. The software fits data $30 that represent any of the following kinds of mappings: a real function of one variable, a curve in the plane, a curve in three-dimensional space, a real function of two variables, and a surface. In the case of surface fitting, the data are required to be defined on a rectangular grid. You can order a copy of the manual from the author by calling (512) 471-4353 or writing

Alan Cline Pleasant Valley Software 8603 Altus Cove Austin, TX 78759

10 User Documentation Catalog September 1988 Applications Software

IFTRAN Preprocessor, A guide to using the IFTRAN preprocessor at NCAR. Version 1.0, April 1986, IFTRAN is Fortran-based, highly portable, and easier to 29 pages write and read than basic Fortran. The document includes IFTRAN commands, statement and input formats, and information about using IFTRAN on several mainframe computers.

The IMSL Complete This edition of the International Mathematical and Libraries Group, Edition 10, Statistical Library (IMSL) contains about 800 user April 1987 entries in three major groups: applied mathematics, softcover set, $37 statistics, and special functions. To order the IMSL (CGLD-USM-PERFCT) manuals, call (713) 782-6060 or write 3-ring binder set, $105 (CGLD-USM-3 ring) IMSL, Inc. Customer Relations 2500 ParkWest Tower One 2500 CityWest Boulevard Houston, TX 77042-3020

The IMSL Libraries Edition Assists users with the transition from the International 10.0 Update Guide, Mathematical and Statistical Library (IMSL) Edition 9.2 November 1987, 71 pages to Edition 10.0. Tables in the appendix show which Edition 10.0 routine replaces each Edition 9.2 routine and indicate how the new routines differ from the old ones. The guide does not contain usage instructions, such as argument lists; for this reason, you should purchase the IMSL manuals if you use IMSL software frequently.

LINPACK Users' Guide, A library that analyzes and solves various systems of 1979, simultaneous linear algebraic systems. To order the $30 guide, call the Society for Industrial and Applied Mathematics (SIAM) at 1-800-447-7426 or write

SIAM Customer Services 1400 Architects Building 117 South 17th Street Philadelphia, PA 19103-5052

MUDPAK: Multigrid Soft- Explains how to use MUDPAK, a collection of Fortran ware for Linear Elliptic subprograms that solve linear elliptic partial differential Partial Differential equations (PDEs) using multigrid iteration. This pow- Equations, Version 1.0, erful technique solves two- and three-dimensional August 1988, 10 pages problems more efficiently than traditional methods.

11 September 1988 User Documentation Catalog Applications Software

NAG Fortran Library The Numerical Algorithms Group (NAG) library Manual, Mark 12, contains over 1,000 subroutines and functions. To order March 1987, a microfiche or hardcopy of the manual, call (312) 971- $40 (microfiche) 2337 or write $195 (hardcopy) NAG, Inc. Technical Sales 1101 31st Street, Suite 100 Downers Grove, IL 60515

POLISH Explains how to use POLISH, which is designed to Using POLISH on the NCAR enhance the readability of existing programs written in Cray Computers, Version 1.0, FORTRAN 77, on NCAR's Cray computers. The docu- September 1986, 39 pages ment covers formatting features and error diagnostics.

SAS Describes how to use the Statistical Analysis System An Introduction to Using (SAS), a statistical analysis and data reporting package, SAS on NCAR's IBM 4381 on the IBM 4381 (IO) front-end computer under the Computer, Version 2.0, Conversational Monitor System (CMS) Operating September 1987, 30 pages System. The document also contains reviews of selected SAS manuals, ordering information for manuals, and a sample SAS program.

SSDLIN: A Collection of Contains information about using SSDLIN, a Out-of-core Linear Algebra collection of out-of-core linear algebra routines, on Software, Version 2.0, NCAR's CRAY, CX computer. The routines are de- May 1988, 22 pages signed to take advantage of the extremely fast data transfer capabilities of the Solid-state Storage Device (SSD). The document includes both matrix subroutines and auxiliary I/O routines that facilitate the storage and retrieval of matrices.

Graphics

NCAR Graphics User's Describes how to use the Graphical Kernel System Guide, Version 2.00, (GKS) version of NCAR Graphics, which conforms to August 1987, 650 pages GKS Level OA. The manual includes steps for converting code from the NCAR System Plot Package to NCAR Graphics, instructions on using the NCAR System Plot Package Simulator (SPPS), details of using the 28 graphics utilities, and 230 pages of examples. A copy of this manual is shipped with the software package. University users can order additional manuals by using the NCAR GKS Graphics, Version 2.00 Manuals

12 User Documentation Catalog September 1988 Graphics

Order Form, on page 25 of this catalog. Local users at NCAR can obtain the manual in Room 6 of the Mesa Lab and charge it to their program number. For more information about ordering the NCAR GKS Graphics software package, call (303) 497-1201 or write

NCAR SCD/Graphics Distribution P.O. Box 3000 Boulder, CO 80307-3000

AUTOGRAPH: A Graphing Describes in full detail how to use AUTOGRAPH, a Utility, Version 2.00, utility that produces graphs. (A shortened version of August 1987, 213 pages the AUTOGRAPH documentation is included in the NCAR Graphics User's Guide.) A copy of this manual is shipped with the software package. Additional copies are included with orders for the NCAR Graphics User's Guide.

The NCAR Graphics Describes the SCD Graphics System. The set of six System (pre-GKS), May 1983, documents consists of An Introduction to the SCD 650 pages Graphics System, an overview of the system; The System Plot Package, a complete description of basic plotting routines and their associated calls and parameters; The Graphics System Implementor's Guide, which provides the information that an installer needs to implement the NCAR graphics system; The SCD Graphics Utilities, a description of all the SCD graphics utilities; Selected User Reference Papers, a collection of users' papers that describes different uses of the NCAR graphics system; and AUTOGRAPH, which describes the utility that enables users to draw graphs with a labeled back- ground and one or more curves. This graphics system is a pre-Graphical Kernel System (GKS) version.

CONBND: A Routine to Discusses CONBND, a pre-Graphical Kernel System Shade Contour Plots, (GKS) routine used to shade contour plots. This Version 1.0, September 1983, document describes the routine, its usage, arguments, 10 pages history, and algorithm and gives examples of how to use CONBND, which is used in conjunction with FILL.

Discount GKS Software Describes four Graphical Kernel System (GKS) software Price List for NCAR/UCAR products that are available to NCAR and University Members, Version 1.1, Corporation for Atmospheric Research (UCAR) May 1987, 12 pages members at a substantial discount. The document

September 1988 User Documentation Catalog 13 Graphics

provides the cost, licensing agreement, and general information about the GKS products developed by the University of Lowell, ISSCO, NOVA, and TEMPLATE. SCD has not evaluated these products.

FILL: A Set of Routines to Summarizes FILL, a set of graphics subroutines used to Fill Polygonal Areas, Version fill polygonal portions of a plotter frame with parallel 1.0, May 1982, 11 pages lines. The document discusses the use, required access method, and steps involved in resetting various parameters to determine how the filling is done. A set of example programs is included. This document can be used with both the Graphical Kernel System (GKS) and the pre-Graphical Kernel System.

Networking and Data Communications

KNET TCP/VM User's KNET TCP/VM allows an IBM VM/SP operating Guide, January 1988, system to communicate with IBM and non-IBM 160 pages computers. The user's guide explains how to use the Transmission Control Protocol/Internet Protocol (TCP/IP) services of KNET. These services include logging onto a remote computer (TELNET), transferring files between computers (FTP and TFTP), and sending or receiving mail (SMTP). The document provides instructions for IBM VM/CMS users to communicate with non-IBM systems, explains how non-IBM system users can communicate with VM/CMS, and describes how users can communicate between IBM VM/CMS systems using KNET. (This manual was written by Spartacus, Inc. and distributed by SCD.)

MIGS: MASnet/Internet MIGS is a combination of hardware and software that Gateway Server User's allows access to the NCAR Mainframe and Server Guide, Version 1.1, Network (MASnet) by computers attached to the August 1988, 63 pages Internet. MIGS provides an easy way to access the Cray computers, the DICOMED, and the Mass Storage System, as well as other components of the NCAR computing environment. MIGS can also be customized at each local site. This document describes how to use MIGS from both your local system and from MASnet systems. The documentation details use of all parameters and provides usage examples.

14 User Documentation Catalog September 1988 Networking and Data Communications

MIGS: MASnet/Internet Describes how to install MIGS at your local site. This Gateway Server Remote document contains information on how to establish System Administrator's security and how to modify the MIGS defaults to meet Guide, Version 1.1, your local site needs. Special sections cover UNIX and August 1988, 25 pages VMS implementation. This document is for use by local MIGS systems administrators, not users. It is a supple- ment to "MIGS MASnet/Internet Gateway Server User's Guide."

RSCS: The Remote Describes RSCS, a single-purpose operating system for Spooling Communications a virtual machine on the IBM 4381 (IO)front-end Subsystem, Version 1.0, computer. RSCS is used for remote batch job entry to May 1988, 31 pages the Cray computers at NCAR and file routing to remote printers.

Telenet Logon Procedure, Describes how the Telenet system provides access to the Version 1.0, March 1988, IBM 4381 (IO)front-end computer or other divisional 4 pages computers via the Private Automatic Computer Exchange (PACX). Three types of access to the IBM 4381 (IO)computer are available via Telenet. These types of access are full-screen full-duplex access, line-mode half-duplex access, and full-screen access via Simware emulation software.

Includes information on saving and replying to UNIX Mail Hints, Version messages, forwarding mail, using aliases, editing and 1.0, May 1988, 7 pages sending files, and using set commands to alter your mail environment. The document also contains a quick reference guide of mail commands.

Explains how to send and receive mail on the IBM 4381 Using the EMAIL Feature on (IO)front-end computer using the Simple Mail Transfer the IBM 4381, Version 1.0, Protocol (SMTP) EMAIL feature of the Spartacus/ May 1987, 3 pages KNET package.

Using the NCAR Internet Explains how to use the NCAR Internet Remote Job Remote Job Entry System, Entry (IRJE) system. IRJE allows remote users to sub- Version 1.0, February 1988, mit jobs directly from their local hosts to NCAR's Cray 5 pages computers and have the results delivered directly back to their local hosts. The document lists the require- ments for using IRJE, explains how to obtain and fill out a registration template, describes how to prepare and submit jobs to the Cray computers, tells how to obtain the status of submitted jobs, and discusses how to change registration information.

September 1988 User Documentation Catalog 15 Networking and Data Communications

Terminal Emulators for IBM-compatible PCs

EM4010/Kermit V3.41-2.46: Explains how to set the correct parameters for direct Direct Connection with the connection access to the IBM 3725 computer using IBM 3725 Computer, EM4010. Describes how to log on to the IBM 3725 November 1987, 14 pages computer. Provides information on how to use the Kermit file transfer protocol and the graphics mode when using EM4010.

EM4010/Kermit V3.41-2.46: Describes the parameters that need to be set for direct Direct Connection with the connection access to the IBM 4381 (IO)front-end IBM 4381 Computer, computer using EM4010. Explains how to log on to the November 1987, 14 pages IBM 4381 (IO)computer to initiate an interactive session. The document also contains a description of how to use the Kermit file transfer protocol with EM4010 and provides information on the graphics mode of EM4010.

EM4010/Kermit V3.41-2.46: Explains the parameters that need to be set for direct Direct Connection with an connection access to an NCAR UNIX computer using NCAR UNIX Computer, EM4010. The document also explains how to log on to November 1987, 12 pages an NCAR UNIX computer and how to use the file transfer protocol Kermit when using EM4010.

EM4010/Kermit V3.41-2.46: Describes the parameters that need to be set for Telenet Remote Access to the IBM access to the IBM 4381 (IO)front-end computer using 4381 Computer, November EM4010. Describes how to use the file transfer protocol 1987, 13 pages Kermit with EM4010. This document also provides information on the graphics mode of EM4010. To log on from a remote site, you need to read the document, "Telenet Logon Procedure" in conjunction with this document.

MS-DOS Kermit V2.29: Describes the parameters you need for direct connection Direct Connection with the access to the IBM 3725 computer using MS-DOS Kermit IBM 3725 Computer, V2.29. Explains the use of the Kermit file transfer proto- November 1987, 4 pages col between MS-DOS Kermit V2.29 and CMS Kermit.

MS-DOS Kermit V2.29: Describes the parameters you need for direct connection Direct Connection with the access to the IBM 4381 (IO)front-end computer using IBM 4381 Computer, MS-DOS Kermit V2.29. Also describes how to use the November 1987, 4 pages Kermit file transfer protocol between MS-DOS Kermit V2.29 and CMS Kermit.

16 User Documentation Catalog September 1988 Networking and Data Communications

MS-DOS Kermit V2.29: Explains the parameters that need to be set for Telenet Remote Access to the IBM access to the IBM 4381 (IO)front-end computer when 4381 Computer, using MS-DOS Kermit V2.29. Describes how to use the November 1987, 3 pages Kermit file transfer protocol between MS-DOS Kermit V2.29 and CMS Kermit. In order to log on from a remote site, you also need to read the document, "Telenet Logon Procedure" in conjunction with this document.

Procomm V2.3: Direct Describes the parameters that need to be set for direct Connection with the IBM connection access to the IBM 3725 using Procomm V2.3. 3725 Computer, Explains how to log on to the IBM 3725 computer and November 1987, 7 pages how to use the Kermit file transfer protocol when using Procomm V2.3.

Procomm V2.3: Direct Explains parameter settings for direct connection access Connection with the IBM to the IBM 4381 (IO)front-end computer using Pro- 4381 Computer, comm V2.3. This document also describes how to use November 1987, 8 pages the Kermit file transfer protocol using Procomm V2.3.

Procomm V2.3: Direct Describes the parameters that need to be set for direct Connection with an NCAR connection access to an NCAR UNIX computer using UNIX Computer, Procomm V2.3. This document also explains how to log November 1987, 7 pages on to an NCAR UNIX computer and how to use the Kermit file transfer protocol when using Procomm V2.3.

Procomm V2.3: Remote Explains parameter settings for Telenet access to the Access to the IBM 4381 IBM 4381 (IO)front-end computer using Procomm V2.3. Computer, November 1987, Describes how to use the Kermit file transfer protocol 7 pages using Procomm V2.3. The document, "Telenet Logon Procedure," should be used in conjunction with this document to log on from a remote site.

YTERM: Direct Connection Describes the parameters that need to be set for direct with the IBM 4381 connection access to the IBM 4381 (IO)front-end Computer, November 1987, computer using YTERM. This document also explains 3 pages how to log on to the IBM 4381 (IO)computer, how to use the PCTRANS file transfer protocol, and how to use the TPRINT printing functions.

September .1988 User Documentation Catalog 17 Networking and Data Communications

YTERM: Remote Access to the IBM 4381 Computer, Explains how to set the parameters for Telenet access to November 1987, 3 pages the IBM 4381 (IO)front-end computer using YTERM. Provides information on how to log on to the IBM 4381 (IO)computer, how to use the PCTRANS file transfer protocol, and how to use the TPRINT printing functions. This document should be used in conjunction with the document, "Telenet Logon Procedures," to log on from a remote site.

YTERM 1.3 User's Guide, Version 1.3, 1985, 31 pages Provides information on YTERM, a package of system services and terminal emulation software for the IBM Personal Computer family. The guide describes the general use of YTERM as well as the hardware and software needed to use the package. In addition, it discusses keyboard tables, file transfers, session logging, and monitoring of terminal traffic. (This document was written by Yale Computer Center.)

Terminal Emulators for Apple Macintosh Computers

Versaterm/Kermit V3.1: Describes the parameters that need to be set for direct Direct Connection with the connection access with the IBM 3725 computer using IBM 3725 Computer, Versaterm V3.1. This document also describes how to December 1987, 3 pages use the Kermit file transfer protocol and explains how to display graphics using Versaterm.

Versaterm/Kermit V3.1: Describes the parameters that need to be set for direct Direct Connection with the connection access to the IBM 4381 (IO)front-end com- IBM 4381 Computer, puter using Versaterm V3.1. Explains how to use the November 1986, 4 pages Kermit file transfer protocol and describes how to display graphics using Versaterm V3.1.

Versaterm/Kermit V3.1: Explains the correct parameters that need to be set for Direct Connection with an direct connection access to the NCAR UNIX computers NCAR UNIX Computer, using Versaterm V3.1. This document also describes March 1987, 3 pages how to use the Kermit file transfer protocol and how to display graphics using Versaterm V3.1.

18 User Documentation Catalog September 1988 Additional Topics

Versaterm/Kermit V3.1: Explains the parameters that need to be set for Telenet Remote Access to the IBM access to the IBM 4381 (IO) front-end computer using 4381 Computer, November Versaterm. Describes how to use the Kermit file 1986, 3 pages transfer protocol using Versaterm V3.1. Provides information about how to display graphics using Versaterm.

Additional Topics

Charges for SCD Computing Provides the charging algorithms that are used to Resources, Version 3.1, compute General Accounting Unit charges for utilizing August 1988, 8 pages SCD's computing resources. The document contains the charging algorithm for CRAY,CX and CRAY,C1 jobs, Mass Storage System and DICOMED system use, and Xerox 4050 laser printer output. It also describes the Job Queue Manager, the Cray job class structure, and how job classes affect charges.

Data Availability at NCAR, Summarizes the datasets that are available from the Version 1.0, March 1987, Data Support Section of NCAR. The list of datasets is 23 pages brief and updated yearly. Additional references are cited.

Contains information about various datasets that are Data Sets for Meteorological available for meteorological and oceanographic Research, July 1975, research and gives basic information about the data or 194 pages types of data. A list of addresses and a bibliography in the back of the manual provide sources of additional information.

19 September 1988 User Documentation Catalog Acronyms and Terms

Computing ASCII American Standard Code for Information Interchange COS Cray Operating System CRAY,C1 CRAY-1A computer at NCAR CRAY,CX CRAY X-MP/48 computer at NCAR DICOMED Graphics processing system for microfiche and film FFT Fast Fourier Transform GKS Graphical Kernel System EXEC Executable program on the IBM 4381 (IO) front-end computer IMSL International Mathematical and Statistical Library IRJE Internet Remote Job Entry JCL Job Control Language MASnet Mainframe And Server Network MIGS MASnet/Internet Gateway Server MSS Mass Storage System at NCAR NAG Numerical Algorithms Group PACX Private Automatic Computer Exchange PERFMON Performance Monitor utility RSCS Remote Spooling Communications Subsystem SAS Statistical Analysis System SLATEC Software library developed by Sandia National Laboratory, Los Alamos National Laboratory, and the Air Force Weapons Laboratory Technical Exchange Committee SMTP Simple Mail Transfer Protocol SPPS System Plot Package Simulator, part of NCAR Graphics SSD CRAY Solid-state Storage Device on the CRAY X-MP computer TBM TeraBit Memory, the previous mass storage system UNICOS UNIX Cray Operating System VM/CMS Virtual Machine/Conversational Monitor System VM/SP Virtual Machine/System Product

Organizations ACM Association for Computing Machinery ECMWF European Centre for Medium-range Weather Forecasts NCAR National Center for Atmospheric Research SCD NCAR Scientific Computing Division SIAM Society for Industrial and Applied Mathematics UCAR University Corporation for Atmospheric Research

20 User Documentation Catalog September 1988 SCD Documentation Order Form

The Scientific Computing Division (SCD) provides the following documents for NCAR/SCD computer users free of charge. To order a copy of a document, check the appropriate box and provide your name and shipping address in the space at the end of this form. If you have questions about the content of a document, please call the SCD Consulting Office at (303) 497-1278.

Introductory QJ The Primer, Version 2.0, July 1988 I New User Orientation Student Guide, Version 1.1, August 1988 I User Documentation Catalog, September 1988

Cray Computers I Cray Job Control Language with NCAR Site-specific Parameters, Version 1.0, July 1988 I EDITOR, Version 1.0, July 1988 I Q A Guide to the Production of Computer-generated Films at NCAR, Version 2.0, July 1988 I [ How to Recover and Restart Your Cray Job, Version 1.0, November 1987 I How to Use Tapes on the CRAY-1A Computer, Version 1.0, June 1988 I Q ICJOB: An Interactive Interface to the CRAY-1A Computer, Version 1.0, July 1985 I [ Locally Developed Cray Utilities, Version 1.0, July 1988 I J PERFMON: The Cray Performance Monitor Utility, Version 1.0, February 1988 I Q SEGLDR: The CRAY X-MP Segment Loader, Version 1.1, November 1986 I SPY: A Timing Information Utility, Version 1.0, April 1987 I Using the Cray Solid-state Storage Device at NCAR, Version 2.1, August 1988 QJ VMSTA: Using the CRAY X-MP Computer Interactively, Version 1.0, November 1986

IBM Computers [Q The NCAR IBM 4341 Gateway Computers, February 1986 Writing and Debugging Fortran Programs on the IBM 4381 Computer, Version 1.0, March 1987

Input/Output Q Sending Graphics Metacode Files to the Xerox 4050 Laser Printers, Version 1.1, July 1988 QJ Using the Xerox 4050 Laser Printers from the Cray and IBM 4381 Computers, Version 1.0, September 1986

Mass Storage System IC IBM Utilities for Accessing the Mass Storage System, Version 1.0, April 1986 I J Mass Storage File Maintenance from the Cray Computers, Version 2.0, December 1986 I l The Mass Storage System, Version 2.0, August 1986 I J PSTRANS: A Utility for Transferring Files from PSTORE Datasets, Version 1.0, September 1986 I J TBM Utilities: EOFILT, PSTRANS, and TBMCONV, Version 1.0, September 1988, 10 pages Applications Software EJ NCAR Software Catalog, March 1986 [ Collected Algorithms of the ACM 1975-1979 and 1980-1984, Version 1.2, April 1987 [ ECMFFT: Multiple Fast Fourier Transform Routines, Version 1.2, August 1987

I September 1988 User Documentation Catalog 21 Applications Software (continued) J FISHPAK: A Package of Fortran Subprograms for the Solution of Separable Elliptic Partial Differential Equations, Version 1.1, May 1988 J FITPACK: A Software Package for Curve and Surface Fitting Employing Splines Under Tension, Version 1.0, September 1987 J IFTRAN Preprocessor, Version 1.0, April 1986 Q The IMSL Libraries Edition 10.0 Update Guide, November 1987 Q MUDPAK: Multigrid Software for Linear Elliptic Partial Differential Equations, Version 1.0, August 1988 Q Using POLISH on the NCAR Cray Computers, Version 1.0, September 1986 Q An Introduction to Using SAS on NCAR's IBM 4381 Computer, Version 2.0, September 1987 [ SSDLIN: A Collection of Out-of-core Linear Algebra Software, Version 2.0, May 1988

Graphics O The NCAR Graphics System (pre-GKS), May 1983 Q CONBND: A Routine to Shade Contour Plots, Version 1.0, September 1983 Q Discount GKS Software Price List for NCAR/UCAR Members, Version 1.1, May 1987 Q FILL: A Set of Routines to Fill Polygonal Areas, Version 1.0, May 1982

Networking and Data Communications [ KNET TCP/VM User's Guide, January 1988 [ MIGS: MASnet/Internet Gateway Server User's Guide, Version 1.1, August 1988 Q MIGS: MASnet/Internet Gateway Server Remote System Administrator's Guide, Version 1.1, August 1988 Q RSCS: The Remote Spooling Communications Subsystem, Version 1.0, May 1988 Q Telenet Logon Procedure, Version 1.0, March 1988 [ UNIX Mail Hints, Version 1.0, May 1988 [ Using the EMAIL Feature on the IBM 4381, Version 1.0, May 1987 Q Using the NCAR Internet Remote Job Entry System, Version 1.0, February 1988

Terminal Emulators for IBM-compatible PCs O EM4010/Kermit V3.41-2.46: Direct Connection with the IBM 3725 Computer, November 1987 Q EM4010/Kermit V3.41-2.46: Direct Connection with the IBM 4381 Computer, November 1987 Q EM4010/Kermit V3.41-2.46: Direct Connection with an NCAR UNIX Computer, November 1987 Q EM4010/Kermit V3.41-2.46: Remote Access to the IBM 4381 Computer, November 1987 U MS-DOS Kermit V2.29: Direct Connection with the IBM 3725 Computer, November 1987 [ MS-DOS Kermit V2.29: Direct Connection with the IBM 4381 Computer, November 1987 U MS-DOS Kermit V2.29: Remote Access to the IBM 4381 Computer, November 1987 1 Procomm V2.3: Direct Connection with the IBM 3725 Computer, November 1987 O Procomm V2.3: Direct Connection with the IBM 4381 Computer, November 1987

22 User Documentation Catalog September 1988 Networking and Data Communications (continued) I Q Procomm V2.3: Direct Connection with an NCAR UNIX Computer, November 1987 iJ Procomm V2.3: Remote Access to the IBM 4381 Computer, November 1987 I Qj YTERM: Direct Connection with the IBM 4381 Computer, November 1987 I Q YTERM: Remote Access to the IBM 4381 Computer, November 1987 I YTERM 1.3 User's Guide, Version 1.3, 1985

Terminal Emulators for Apple Macintosh Computers I [Q Versaterm/Kermit V3.1: Direct Connection with the IBM 3725 Computer, I December 1987 I IJ Versaterm/Kermit V3.1: Direct Connection with the IBM 4381 Computer, I November 1986 I QI Versaterm/Kermit V3.1: Direct Connection with an NCAR UNIX Computer, I March 1987 I O Versaterm/Kermit V3.1: Remote Access to the IBM 4381 Computer, November 1986

I Additional Topics I [J Charges for SCD Computing Resources, Version 3.1, August 1988 I [J Data Availability at NCAR, Version 1.0, March 1987 I Data Sets for Meteorological Research, July 1975

Mail to:

NCAR Small documents are sent first class, SCD/Documentation Distribution and larger documents are shipped UPS. P.O. Box 3000 (UPS will not deliver to a P.O. Box.) I Boulder, CO 80307-3000

Shipping Address (please print or type): User Number

I Name

1 Department

University / Institution I Street

City State

Zip Phone ( ) I area code L Check here if this is a new address.

rev 8/25/88 September 1988 IcUser Documentation Catalog I .. r .. __..,._ s, V. ... .LV...... i {...... i i . 23 i SCIENTIFIC COMPUTING DIVISION t- NATIONAL CENTER FOR ATMOSPHERIC RESEARCH i i i i i i NCAR GKS Graphics, Version 2.00 Manuals Order Form i i i Person's Name: i Institution Name: i Shipping Address: -- i i i i (Please give street address; UPS will not deliver to a P.O. Box) i Phone Number (include area code)

NCAR Graphics User's Guide Quantity Unit Price Total and AUTOGRAPH: A Graphing Utility

Destinations within the U.S., Canada, and Mexico $50.00

All Other Destinations (shipping costs included) $85.00

Total Order

These manuals are written for Version 2.00 (August 1987).

Prepayment is required - no Purchase Orders or orders by phone are accepted. Make check payable to "National Center for Atmospheric Research," in U.S. dollars.

Mail completed form, with check attached, to: National Center for Atmospheric Research Finance Office P.O. Box 3000 Boulder, CO 80307-3000 USA

Orders shipped within four weeks of date received.

Rec'd Sent Check # Amount $

September 1988 User Documentation Catalog 25

L CHANGE OF ADDRESS FORM [I Add to mailing list " Delete from mailing list O Change existing entry Name: New address:

User number Phone number

Trademarks: IBM® is a registered trademark of International Business Machines Corporation. SEGLDRTM and CRAY X-MP TM are trademarks, and SSD® and CRAY-1® are registered trademarks of Cray Research, Inc. UNIXTM is a trademark of AT&T Bell Laboratories. SAS® is a registered trademark of SAS Institute, Inc. Reference to a company or product name does not imply approval or recommendation of that company or product to the exclusion of others. SERVICES DIRECTORY CONTACT PHONE(3030 E-MAIL General Information SCD Consulting Office Consultant on Duty 497-1278 CONSIJLT1 Visitor/User Information Fieda Garcia 497-1254 FRIEDA Project & User Number Assignment Rosemary Mitchell 497-1235 ROSEMARY Computing Resource Applications John Adams 497-1213 JOHNAD NCAR Switchboard 497-1000 Remote Access Information Data Communications (RSCS-RJE) Bill Ragin 497-1258 B3ILLR US Telecom (T'elenet) Marla Meehl 497-1301 MARIA Internet Access (TCP/IP) Don Morris 497-1282 MORRIS Operational Information Computer Operations Bob Niffenegger 497-1240 Machine Room Oper. Supervisor 497-1200 Graphics Operations Andy Robertson 497-1241/42 Tape Librarian - 1/2" and MSS Sue Long 497-1245 SUELONG Graphics Software Distribution General Information 497-1201 Documentation Orders/Output Mailing Mary Buck 49741232 MARYB

SENDING ELECTRONIC MAIL: The electronic mail (e-mail) addresses above are for the IBM 4381 (10) front-end computer. The following examples show the addresses for sending e-mail to the SCD consultants.

From the IBM 4381 (10) computer, enter: TO CONSU1LTi OR From a host computer connected to the Internet, use a local mailing program with the Internet address: [email protected]

If the Internet address does not work, note that the explicit Internet address is 128.117.8.7 and consult your local system administrator.

SCD COMPUTING NEWS Scientific Computing Division IU.S. POSTAGE PAID National Center for Atmospheric Research Boulder / Colorado P.O0. Box 3000, Boulder, CO 80307-3000 PeriNo 55

NCAR Library DIR Mesa Lab NCAR MAIL ROOM