Documentation
"CalComp 1051 Plotter," U01-0632, is available through PRTDOC.
The following manuals are located at the graphics lab in Remote 1 and in Room 105 Art and Architecture.
Preview Routines for CalComp Plotters
Example The command PROC PLOTWRTR is unique to UTCC and should be called after each plot is completed in a SAS job stream.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode,TIME=(0,30), // PASSWORD=? /*ROUTE PRINT BINS //stepname EXEC SAS //SYSIN DD * (SAS/GRAPH program) PROC PLOTWRTR;
Documentation
The following manuals have been placed at the locations listed in parentheses; "Reserve" means on reserve in Hodges Library.
SAS/GRAPH Software: Introduction
(Reserve)
SAS/GRAPH Software: Reference
, Volumes 1 and 2, (Reserve, Remote 1 Graphics Lab, Remotes
8 and 17)
In addition, "SAS/GRAPH Map Data Sets," U01-0540, is available through PRTDOC on CMS.
Proprietary notice Abaqus is a proprietary program and is made available for internal use at the University of Tennessee under the terms of the academic license agreement with Hibbitt, Karlsson and Sorensen, Inc., the developers of the program. All use must be under the direct supervision and control of UTCC User Services. Any non-academic use of the program requires payment of a monthly charge. Assistance and information may be obtained from UTCC User Services, 974-6831.
Documentation
"ABAQUS," U01-0611, available through PRTDOC on CMS or VAX/VMS, discusses system-specific questions, basic ABAQUS options, access to ABAQUS, access to example problems, and the most common user problems with ABAQUS.
The following manuals are on reserve in Hodges Library:
ABAQUS Users' Manual ABAQUS Example Problems Manual ABAQUS Theory Manual
Documentation
"Fluid Dynamics Analysis Package (FIDAP)," U01-0621, available through PRTDOC, details the JCL necessary for running on the IBM 3090, access to example problems, and the methods to accomplish pre- and post-processing.
The following FIDAP manuals are available at the engineering computer center at 318 Perkins Hall:
Volume 1: FIDAP, User Interface, FICONV, Theoretical
Volume 2: FIPREP, Error
Volume 3: FIMESH, FIPOST
Volume 4: Examples, Tutorial
Example The following JCL will access EISPACK subroutines when using VS FORTRAN.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC FORTVCLG,FIRSTLB=EISPACK //FORT.SYSIN DD * (your FORTRAN program calling EISPACK) //GO.SYSIN DD * (data)
Documentation
Online help files are available on CMS and VAX/VMS by entering HELP EISPACK.
"EISPACK Description," U01-0413, is available through PRTDOC.
Matrix Eigensystem Routines - EISPACK Guide , by B. T. Smith and others, Springer-Verlag, 175 Fifth Avenue, New York, NY 100010. This guide is located in Remote 2 (108 Estabrook Hall).
EISPACK - A Package for Solving Matrix Eigenvalue Problems , by J. J. Dongarra, Mathematics and Computer Science Division, Argonne National Laboratory, Argonne, Illinois 60430. This reference describes the use of EISPACK and changes made to the package for the current release, and is available for review at the User Services library, 200 SMC.
Vector/scalar library access under MVS/ESA
Under MVS/ESA, the ESSL routines are provided in both vector and scalar libraries. VS FORTRAN procedures default to the vector version. The scalar library is provided for development and testing of application programs. However, the vector library routines provide a high level of performance and should be used when running applications in production. The calling sequences and the numerical results of the vector and scalar routines are identical, but the scalar routines will execute more slowly because they have not been tuned for the high performance of the 3090's vector facility.
The following example illustrates choosing the scalar library when using FORTVLG.
//STEP1 EXEC FORTVLG,VERSION=SCALAR The library that you select at link-edit time determines whether the scalar or vector routine is accessed. Therefore, if you have been using the scalar library and you want to execute your program using the vector library, or vice versa, you do not have to recompile your program, but you must re-link edit.
Intercompilation Analysis (ICA) data set ESSL provides an ICA file to allow the compile-time diagnosis of inconsistencies or errors in call statements to ESSL routines. The ESSL ICA-file data set is UTCC.ESSL.ESVICA and is included in the UTCC VS FORTRAN cataloged procedures. The ddname ESSL must be part of the ICA option at compilation. For example,
//STEP EXEC FORTVC,FORTOPT='ICA(USE(ESSL))'
Documentation
SC23-0184,
Engineering and Scientific Subroutine Library Guide and Reference
, at Remotes 1, 2, 8 and 28 and on reserve in
Hodges Library
SC23-0410,
Engineering and Scientific Subroutine Library Reference Summary
,
a smaller manual that is convenient for personal use
such as checking the arguments of routines
Library capabilities The mathematical capabilities of the library include routines for the solution of linear and nonlinear systems of equations, eigensystem analysis, integration and differentiation, interpolation and approximation, differential equation solvers, optimization, and basic matrix/vector operations. The statistical capabilities of the library include routines for regression, correlation, analysis of variance, nonparametric statistics, tests of goodness of fit and randomness, time series analysis and forecasting, reliability, multidimensional scaling, probability distribution functions, and factor, discriminant, cluster and survival analysis. Special functions available are trigonometric, hyperbolic, exponential, gamma and Bessel functions, and exponential integrals. For a complete list and description of the subprograms available in the IMSL library, consult the manuals listed below under Documentation.
How to use IMSL subprograms on MVS Unlike previous editions of the IMSL library, the single and double precision versions of the IMSL subprograms in Edition 10.0 have distinct names. This eliminates any confusion over which precision version of a subroutine was linked and allows the use of different precision versions in the same program. Under MVS/ESA, the IMSL routines are provided in a vectorized version, UTCC.IMSL.VECTORLB, which is automatically searched in the linkage editor and loader steps of the UTCC VS FORTRAN cataloged procedures FORTVCL, FORTVCLD, FORTVCLG, FORTVL, FORTVLD, and FORTVLG.
IMSL access restrictions and permissions IMSL's lease contract forbids use of the IMSL subroutines at UTCC by outside organizations unless they have formalized a contractual arrangement with IMSL. Requests for such access (object code only) should be made to IMSL Inc., Customer Relations, P.O. Box 4605, Houston, Texas 77210-4605. When IMSL code must be reproduced in published materials, e.g., theses, dissertations, journals, reports or books, in order that the results can be duplicated by others, IMSL requests that the author make the following points in the document in a manner noticeable to someone interested in the listings:
1. The listed code is part of a proprietary product belonging to
IMSL Inc., Houston, Texas.
2. The listings are reproduced with the permission of IMSL.
3. The listings may not be extracted for other purposes or used
as the basis for any software development.
Documentation
The IMSL Interactive Documentation Facility (IDF) is an online help system on CMS and VAX/VMS designed by IMSL to help users identify the routines they need and to assist them in using those routines. It provides access to most of the information in the IMSL user's manuals. See "IMSL Interactive Documentation Facility," section 5.4.4.
Online help is available on CMS and VAX/VMS by entering HELP IMSL.
The following manuals are located in Remotes 1, 2 and 8 and on reserve in the Hodges Library.
MATH/LIBRARY User's Manual the general applied mathematics subprograms STAT/LIBRARY User's Manual Volumes 1-3, document the statistical subprograms SFUN/LIBRARY User's Manual documents the special functions
The manuals may be ordered from IMSL, Sales Division, P.O. Box 4605, Houston, Texas 77210-4605.
Example
The following JCL will access the LINPACK subroutines when using VS FORTRAN.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC FORTVCLG,FORTREG=3072K,FIRSTLB=LINPACK //FORT.SYSIN DD * (your FORTRAN program calling LINPACK) //GO.SYSIN DD * (data)
Documentation
Online help is available on CMS and VAX/VMS by entering HELP LINPACK.
LINPACK User's Guide by J. J. Dongarra and others, is available at Remotes 2 and 8 and on reserve at the Hodges Library.
U01-0531, "LINPACK," is available through PRTDOC.
Example
Two MINPACK libraries are available on the MVS system: UTCC.MINPACKS contains single precision subroutines; UTCC.MINPACKD contains double precision subroutines. The following JCL accesses the double precision MINPACK library when using VS FORTRAN.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC FORTVCLG,FORTREG=3072K,FIRSTLB=MINPACKD //FORT.SYSIN DD * (your FORTRAN program calling MINPACK) //GO.SYSIN DD * (data)
Documentation
U01-0605, "MINPACK," available through PRTDOC
The following manuals are available at Remotes 1, 2 and 8 and on reserve at Hodges Library.
User Guide for MINPACK-1
by Jorge J. Moore and others
Documentation for MINPACK-Single Precision Version
by Burton S. Garbow
and others
Example
The following JCL will execute an MPSX program.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn // EXEC MPSX //MPS1.SYSIN DD * (control program) //MPS2.SYSIN DD * (data)
Documentation
All of the following titles begin with IBM Mathematical Programming System Extended (MPSX/370) available at Remote 8.
SH19-6552,
User's Guide
SH19-6553,
Program Reference Manual
SH19-6554,
Messages and Codes
SH19-6555,
Operations Guide
SH19-6586,
Getting Started
Important note: The IBM implementation of the NAG Library is a double precision version; variables described as real in the NAG Library manuals must be declared as REAL*8 or DOUBLE PRECISION.
Using the NAG Library on MVS Routines from the NAG Library can be called from a VS FORTRAN program. The NAG Library is scanned automatically when the VS FORTRAN cataloged procedures are used. Under MVS/ESA, the vector version is accessed unless VERSION=SCALAR is specified on the EXEC statement. For example, execution of the following JCL calls the FORTRAN cataloged procedure FORTVCLD to compile, load, and go, using the vector version of NAG.
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC FORTVCLD //FORT.SYSIN DD * (FORTRAN program) //GO.SYSIN DD * (data)
Documentation An interactive online help program is available on CMS by typing NAGHELP. The most important parts of the specifications of all NAG FORTRAN routines are available in this online help facility. Copies of the NAG FORTRAN Introductory Guide , which contains basic information on the NAG routines, are located in Remotes 1, 2 and 8. The complete NAG FORTRAN Library Manual set is on reserve in Hodges Library. The IBM User's Note contains IBM-specific information and is, therefore, essential reading. The User's Note is available for reference online on CMS by typing HELP NAGVUN for the vector version or HELP NAGSUN for the scalar version. The User's Note can also be found at the beginning of the ;.us NAG FORTRAN Introductory Guide and in Volume 1 of the ;.us NAG FORTRAN Library Manual set.
How to use OSL subroutines on MVS The OSL subroutines are available on both CMS and MVS. On the MVS system, OSL users can access up to 256M of virtual memory. OSL is accessed automatically by the UTCC VS FORTRAN cataloged procedures on MVS. For programs written in C/370 or PL/I, or for VS FORTRAN programs that do not use any of the UTCC VS FORTRAN cataloged procedures, the following concatenation can be added to the SYSLIB DD statement:
// DD DSNAME=SYS1.OSL.EKKLIB,DISP=SHR
The dataset SYS1.OSL.EKKC.H contains the header file for use with C/370. Sample progams are in the datasets SYS1.OSL.EKKDRVF (VS FORTRAN), SYS1.OSL.EKKDRVC (C/370), and SYS1.OSL.EKKDRVP (PL/I). The dataset SYS1.OSL.EKKDATA contains sample data for these programs.
Documentation
Online help is available by entering the CMS command HELP OSL.
The following manual is on reserve at Hodges Library:
SC23-0519, Optimization Subroutine Library: Guide and Reference
Examples
To execute a GPSS program//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC GPSS //SYSIN DD * (GPSS program)
To execute a GPSS program in a larger region
//jobname JOB ,name,GROUP=Jprojcode,USER=Pusercode, // PASSWORD=? /*ROUTE PRINT RMTn //stepname EXEC GPSS,CORE=C,GOREG=256K //SYSIN DD * (GPSS program)
Documentation
The following manuals are located at Remote 8 and on reserve in Hodges Library.
SH20-0851,
GPSS V User's Manual
SH20-0866,
GPSS V Introductory User's Manual