MSC Nastran 2012 Installation and Operations Guide
MSC Nastran 2012 Installation and Operations Guide
MSC Nastran 2012 Installation and Operations Guide
Technical Support
Internet Resources
Main Index
MSC Nastran 2012 Installation and Operations Guide
xiv
List of MSC Nastran Books
Below is a list of some of the MSC Nastran documents. You may find any of these documents from
MSC.Software at http://simcompanion.mscsoftware.com.
Installation and Release Guides
Installation and Operations Guide
Release Guide
Guides
Reference Books
Quick Reference Guide
DMAP Programmers Guide
Reference Manual
Users Guides
Getting Started
Linear Static Analysis
Dynamic Analysis
MSC Nastran Demonstration Problems
Thermal Analysis
Superelements
Design Sensitivity and Optimization
Implicit Nonlinear (SOL 600)
Explicit Nonlinear (SOL 700)
Aeroelastic Analysis
User Defined Services
EFEA Users Guide
EFEA Tutorial
EBEA Users Guide
Main Index
xv
MSC Nastran 2012 Installation and Operations Guide
Preface
Technical Support
For technical support phone numbers and contact information, please visit:
http://www.mscsoftware.com/Contents/Services/Technical-Support/Contact-Technical-Support.aspx
Support Center (http://simcompanion.mscsoftware.com)
Support Online. The Support Center provides technical articles, frequently asked questions and
documentation from a single location.
Main Index
MSC Nastran 2012 Installation and Operations Guide
xvi
Internet Resources
MSC.Software (www.mscsoftware.com)
MSC.Software corporate site with information on the latest events, products and services for the
CAD/CAE/CAM marketplace.
Main Index
Ch. 1: Introduction MSC Nastran 2012 Installation and Operations Guide
1
Introduction
Document Scope
Document Structure
Overview 14
Console Installation 18
Silent Installation 19
Overview
System-Specific Tuning
Pentium
Overview
Using Databases
n memory
vi rt ual
bpw 8 = bpw 4 =
Note: In order to use the physical and virtual specifications, the computers physical memory
and swap file size must be known to the nastran command. The nastran command always
knows both these sizes on Windows systems. On UNIX systems, the physical memory is
known on Linux, and Solaris. The computers physical and virtual memory sizes can also
be set via the s.pmem and s.vmem keywords respectively.
Main Index
83
CHAPTER 4
Using the Basic Functions of MSC Nastran
Examples are
Set the memory request to one gigabyte, 1024 megabytes, 1048576 kilobytes, 1073741824 bytes,
134217728 words for i8/ILP64 or 268435436 words on all other systems.
Set the memory request to 50% of the computers physical memory.
Maximum Memory Size
Table 4-2 lists the maximum memory size for MSC Nastran platforms. A memory request larger
than this value results in an error as the job starts.
Table 4-2 Maximum Memory Size
prod_ver nastran memory=1gb
prod_ver nastran memory=0.5xPhys
Note: The actual maximum value you can specify depends on several factors, including the
physical memory systems and the swap file size on UNIX systems, the paging file size on
Windows systems, and your virtual memory limit on most UNIX systems. You must also
deduct from the maximum value the size of the executable, listed in System Descriptions
in Appendix D, and space required for the various operating system and Fortran runtime
libraries. Jobs submitted with mode=i8 on platforms that support it, have unlimited
memory.
Platform Memory
AIX 8 GB
HPUXIPF 8 GB
HPUX 8 GB
Linux32 2 GB
Linux64 8 GB
Linuxipf 8 GB
Solaris 8 GB
Main Index
MSC Nastran 2012 Installation and Operations Guide
84
Solaris8664 8 GB
Win32 1.5 GB
Win64 8 GB
Platform Memory
Note: When running with mode = i8 or ILP64 on platforms that support it, the maximum memory
is limited by system limits and virtual address space.
Main Index
85
CHAPTER 4
Using the Basic Functions of MSC Nastran
Determining Resource Requirements
For most models of moderate size (up to 10000 grid points for static analysis), you need not be concerned
with resource requirements since the default MSC Nastran parameters allocate sufficient resources. The
analysis of larger models may require you to check the resource requirements and the various options
that are available to manage memory and disk resources.
There are several tools available to assist you in determining the resource requirements of your job.
Table 4-3 and Table 4-4 are the simplest tools, they present gross estimates of the memory and total disk
space requirements of static analyses using default parameters with normal output requests. Other
solution sequences will generally have greater requirements.
Table 4-3 Estimated Memory Requirements of Static Analyses
Table 4-4 Estimated Total Disk Requirements of Static Analyses
More detailed resource estimates can be obtained from the ESTIMATE program, described in
ESTIMATE on page 191. ESTIMATE reads the input data file and calculates the job's memory and disk
requirements. The ESTIMATE program is most accurate in predicting the requirements of static analyses
that don't have excessive output requests. The memory requirements for normal modes analyses using
the Lanczos Method are reasonably accurate; however, the disk requirements are dependent upon the
number of modes. This is a value that ESTIMATE does not know. Memory and disk requirements for
other solutions are less accurate.
Degrees of Freedom
Memory
Requirements
Others
3 MW
5 MW
10 MW
22 MW
44 MW
Degrees of Freedom Total Disk Space Requirements
90 MB
500 MB
1000 MB
2000 MB
4000 MB
DOF 10000 <
10000 DOF < 50000 s
50000 DOF < 100000 s
100000 DOF < 200000 s
200000 DOF < 400000 s
DOF 10000 <
10000 DOF < 50000 s
50000 DOF < 100000 s
100000 DOF < 200000 s
200000 DOF < 400000 s
Main Index
MSC Nastran 2012 Installation and Operations Guide
86
The best estimates of the memory requirements for a job are available in User Information Message 4157,
described in User Information Messages 4157 and 6439 on page 129, but this requires an MSC Nastran
run.
Estimating BUFFSIZE
Table 4-5 presents recommendations for BUFFSIZE based on model size. These values have been
chosen to represent the best compromise between database access speed and storage requirements for
typical problems. An excessively large BUFFSIZE can result in more I/O data transferred and wasted
space in the database for smaller problems; an excessively small BUFFSIZE can result in increases I/O
counts for larger problems. You may be able to achieve higher performance or smaller databases using
other values.
Table 4-5 Suggested BUFFSIZE Values
Degrees of Freedom BUFFSIZE
8193
16385
32769
DOF 100000 s
100000 DOF < 200000 s
DOF 400000 >
Note:
The actual I/O transfer size is where bpw is 8 on i8/ILP64 and
bpw is 4 on all other systems.
BUFFSIZE 1 ( ) bpw
Main Index
87
CHAPTER 4
Using the Basic Functions of MSC Nastran
Using the Test Problem Libraries
Three libraries of test problems are delivered with MSC Nastran.
These files are accessible via the DEMODIR symbol, or via the path
install_dir/prod_ver/nast/demo on UNIX and install_dir\prod_ver\nast\demo on Windows.
The test problem library (TPL) contains a general selection of MSC Nastran input files showing
examples of most of the MSC Nastran capabilities. In general, these files are not documented.
The files are accessible via the TPLDIR symbol, or via the path install_dir/prod_ver/nast/tpl on
UNIX, and install_dir\prod_ver\nast\tpl on Windows.
The DEMO and TPL libraries contain demoidx.dat and tplidx.dat respectively. These files contain
one-line descriptions of the library members. Also included are files named tplexec and demoexec,
which are scripts used to run the problems on UNIX, or tplexec.bat and demoexec.bat, which are
batch files used to run the problems on Windows.
If you only want to run a job from the DEMO or TPL libraries, the easiest method is to use either the
DEMODIR or TPLDIR symbols, running the command from any convenient directory. For
example,
If you want to experiment with the file, copy the file to your own directory and then execute the problem.
Note that several of the library files have INCLUDE files that should also be copied if they too will be
modified, or they can be referenced as-is via the standard INCLUDE file processing; see Using the
INCLUDE Statement on page 97.
Some example problems contain references to files that are qualified with the following logical symbols:
TPLDIR
DEMODIR
DBSDIR
OUTDIR
Unless they already exist in your environment as environment variables, the logical symbols DEMODIR
and TPLDIR automatically point to the DEMO and TPL libraries respectively. DBSDIR and OUTDIR
are always based on the dbs and out keywords respectively.
prod_ver nastran DEMODIR:d10101d
Main Index
MSC Nastran 2012 Installation and Operations Guide
88
Making File Assignments
Using the ASSIGN statement in your input file, you can assign physical files used by MSC Nastran to
FORTRAN units or DBset files or you can modify the properties of existing or default file assignments.
The ASSIGN statement is documented in the File Management Statements in Chapter 2 of the MSC
Nastran Quick Reference GuideMSC Nastran Quick Reference Guide.
ASSIGN Statement for FORTRAN Files
For FORTRAN files, the format of the ASSIGN statement is
Currently, there are no values of the SYS field defined for FORTRAN files on any system. For a list of
the FORTRAN files and their default attributes, please refer to Table 2-1 in the File Management
Statements in Chapter 2 of the MSC Nastran Quick Reference GuideMSC Nastran Quick Reference
Guide. For more information about byte-ordering within binary files (the "endian" of a file), please refer
to Binary File Byte Ordering (Endian) in Appendix D.
ASSIGN Statement for DBsets
ASSIGN logical-name[=filename|*}] [TEMP] [DELETE] [SYS='sys-spec']
See Using the SYS Field on page 118 for details on the SYS field for DBsets.
Scratch DB Set Names
The default base name for scratch DB Sets uses the base name of the input data file as a prefix; this will
permit you to more easily identify the job that created specific files in the scratch directory.
The SCRATCH DBset names will be named /tmp/example.T<unique>.* on the UNIX systems and
c:\temp\example.T<unique>.* on Windows systems where <unique> is a string created from the
process ID of the nastran command and the current time.
ASSIGN logical-key[={filename|*}] [UNIT=u] [[STATUS=]{NEW|OLD|UNKNOWN}]
[[FORM=]{FORMATTED|UNFORMATTED|BIGENDIAN|LITTLEENDIAN|LTLEND|<ostype>}] [DEFER]
[{TEMP|DELZERO}] [DELETE] [SYS='sys-spec']
UNIX: prod_ver nastran example sdir=/tmp
Windows: prod_ver nastran example sdir=c:\temp
Main Index
89
CHAPTER 4
Using the Basic Functions of MSC Nastran
The following tables give information about the DBALL and SCRATCH DBset default allocations.
where:
DBset Memory BUFFSIZE Physical File Attribute
Type Size Units Assignable Size
Logical
Name
Physical
Name Size
MASTER RAM 200000 Words YES 8193 MASTER dbs.MASTER 5000
DBALL N/A - YES 8193 DBALL dbs.DBALL See Table 4-6
OBJSCR N/A - NO 8193 OBJSCR sdir.OBJSCR 5000
SCRATCH SMEM See note GINO
Blocks
YES 8193 SCRATCH sdir.SCRATCH See Table 4-6
SCRATCH N/A - YES 8193 SCR300 sdir.SCR300 See Table 4-6
User DBset N/A - YES 8193 DBset dbs.DBset 25000
Note: The default SMEM value is 100 for all platforms.
DBset The DBset name.
Memory The size of open core memory (in words) used by the RAM of the MASTER
DBset. The size may be modified using the FMS statement, INIT MASTER
(RAM = value).
BUFFSIZE The buffer size (words) used for I/O transfer for each DBset. This size may be
changed if YES is in the Assignable column.
Logical Name The logical name of the DBset. This name may be set with the ASSIGN or
INIT statement.
Physical Name The name of the file as known to your operating system. This name may be
changed by using the ASSIGN statement.
Size The default maximum file size (in GINO blocks) allowed for each DBset.
This size may be changed by using the INIT statement.
Main Index
MSC Nastran 2012 Installation and Operations Guide
90
Table 4-6
Default Maximum DBALL and SCRATCH DBset Sizes in GINO Blocks
Memory (MEM) BUFFSIZE
BUFFSIZE <
32769
32769 < BUFFSIZE
< 65537 BUFFSIZE = 65537
MEM < 32 MW 250,000 250,000 250,000
32 MW < MEM < 64 MW 500,000 1,000,000 1,000,000
MEM > 64 MW 1,000,000 2,000,000 2,000,000
Note: These values will be reduced, if necessary and without any information messages, to the
maximum file size supported by the filesystem on which the file was allocated. For
example:
For Windows XP using a FAT filesystem, the maximum file size is 2 GB.
For Windows XP using a FAT32 filesystem, the maximum file size is 4 GB.
For AIX using a non-largefile enabled JFS filesystem, the maximum file size is
2 GB.
For AIX using a largefile enabled JFS filesystem, the maximum file size is
63.88 GB.
Default Maximum DBALL and SCRATCH DBset Sizes in GB for Specific BUFFSIZE
Values
Memory (MEM) BUFFSIZE
8193 32769 65537
MEM < 32 MW 7.63 GB 30.52 GB 61.04 GB
32 MW < MEM < 64 MW 15.26 GB 122.07 GB 244.14 GB
MEM > 64 MW 30.52 GB 244.14 GB 488.28 GB
Main Index
91
CHAPTER 4
Using the Basic Functions of MSC Nastran
Using Databases
MSC Nastran uses a database for the storage and subsequent retrieval of matrices and tables. This facility
consists of several database sets (DBsets) that conform to the following specifications:
The MSC Nastran limit on the maximum number of DBsets for an analysis is 200. Your
computer may have a lower limit on the maximum number of open files that a process can open.
This limit is displayed as the Number of open files by the limits special function. See Using
the Help Facility and Other Special Functions on page 79.
Each DBset may consist of 1 to 20 physical files. Again, this is subject to the maximum number
of open files that your system permits.
The maximum size of each DBset is machine dependent. There are several factors affecting the
maximum size a given file can reach. Among these are: the jobs file resource limit; the
available space of the file system containing the file; the maximum file size supported by the
operating system, and the BUFFSIZE. On UNIX systems, the if command lists the maximum
space and available space in a file system. Your resource limit is displayed by as the Maximum
file size by the limits special function.
Notes:
1. Large files are available if the file system containing the file supports large files. See your system
administrator to determine which file systems, if any, support large files.
2. Large files can only be created on file systems supporting large files (the flags value from df -
g must show the 0x10 bit set).
3. Large files are available on Solaris 2.6 or later if the file system containing the file supports large
files. See your system administrator to determine which file systems, if any, support large files.
Table 4-7 Database I/O Capabilities
Computer Large File File Mapping
Buffered
I/O Async I/O
AIX
Yes
1
No Yes No
HPUX
Yes
2
No Yes No
HPUXIPF
Yes
2
No Yes No
Intel Linux32
Yes
No Yes Yes
Intel Linuxipf Yes No Yes
Yes
4
Intel Linux64 Yes No Yes
Yes
5
Intel Windows Yes
Yes
Yes Yes
Solaris
Yes
3
Yes Yes Yes
Solaris8664 Yes No Yes
No
Main Index
MSC Nastran 2012 Installation and Operations Guide
92
4. Supported on SGI Altix IA64 only.
5. MIO is available with an MIO license from IBM.
The default database provides for five DBsets that are subdivided into two categories (scratch and
permanent DBsets) as follows:
Three DBsets are scratch DBsets that are typically deleted automatically at the end of a run. The
logical names for these DBsets are SCRATCH, SCR300, and OBJSCR.
The remaining two DBsets have the default names of dbs.MASTER and dbs.DBALL, where dbs
is set by the dbs keyword.
The database may be defined in two different ways:
1. Using the dbs keyword on the command line; see Using the dbs Keyword on page 92.
2. Using ASSIGN statements in the FMS Section of the input data file. See ASSIGN Statement for
DBsets on page 88 and Using the ASSIGN Statement on page 94.
Using the dbs Keyword
To illustrate the use of the dbs keyword, see the TPL file am762d.dat
To run this job, enter
The default value for dbs in this example is ./am762d on UNIX and .\am762d on Windows. The
DBALL and MASTER DBsets are created in your directory as am762d.DBALL and
ID MSC, AM762D $ JFC 30SEP88
$ DBS=AM762D SPECIFIED WHEN JOB SUBMITTED
TIME 2
SOL 101 $ SUPERELEMENT STATICS
CEND
TITLE = EXAMPLE: SPECIFY DBS=AM762D WHEN JOB SUBMITTED AM762D
SUBTITLE = COLD START
LOAD = 11
DISPLACEMENT = ALL
ELFORCE = ALL
BEGIN BULK
CBEAM,1,1,10,20,0.,1.,0.
FORCE,11,20,,100.,1.,.8,1.
GRID,10,,0.,0.,0.,,123456
GRID,20,,10.,0.,0.
MAT1,100,1.+7,,.3
PBEAM,1,100,1.,.08,.064,,.1
ENDDATA $ AM762D
prod_ver nastran TPLDIR/am76:am762d
Main Index
93
CHAPTER 4
Using the Basic Functions of MSC Nastran
am762d.MASTER respectively; and the output files are am762d.f04, am762d.f06, and
am762d.log.
To restart from the previously created DBsets, use the following command:
The input data for the restart is TPL file am762r.dat. The dbs keyword is set to am762d. The
following is sample input for the am762r.dat file:
The existing DBALL and MASTER DBsets created in your directory by the am762d job are used. The
output files from this job are am762r.f04, am762r.f06, and am762r.log.
prod_ver nastran TPLDIR/am76:am762r dbs=am762d
RESTART VERSION = 1 $ RESTART FROM AM762D
$ DBS=AM762D SPECIFIED WHEN JOB SUBMITTED
ID MSC, AM762R $ JFC 30S3088
TIME 2
SOL 101
CEND
TITLE = EXAMPLE: RESTART, ATTACH DATABASE VIA DBS=AM762D AM762R
SUBTITLE = RESTART WITH LARGER LOAD
SELG = ALL $ GENERATE NEW LOAD
SELR = ALL $ REDUCE NEW LOAD
LOAD = 11
DISPLACEMENT = ALL
ELFORCE = ALL
BEGIN BULK
FORCE,11,20,,100.,1.,.8,1.
ENDATA $ AM762R
Main Index
MSC Nastran 2012 Installation and Operations Guide
94
Using the ASSIGN Statement
This section contains two examples using the ASSIGN statement. The first example, TPL file
am763d.dat shows how to use the ASSIGN statement to create the database files. The second example
shows how to use the ASSIGN statement to assign database files in a restart job.
Before you submit this job, create a dbs directory in your current working directory and set the
DBSDIR environment variable to dbs as follows:
in the Korn shell,
in the C-shell, or
on Windows.
Once the DBSDIR environment variable is set, the job is submitted with the command:
ASSIGN MASTER=DBSDIR:am763d.MYMASTER
ASSIGN DBALL=DBSDIR:am763d.MYDBALL
$
$ DBSETS CREATED WITH DIRECTORIES AND NAMES AS ASSIGNED ABOVE.
$ THIS IS ALTERNATE METHOD TO BE USED INSTEAD OF SPECIFYING DBS = AM763D
$ WHEN JOB IS SUBMITTED.
$
ID MSC, AM763D $ FILENAME CHANGED 16SEP88 -- JFC
TIME 2
SOL 101 $ STRUCTURED SUPERELEMENT STATICS WITH AUTO RESTART
CEND
TITLE = EXAMPLE: DATABASE CREATED VIA ASSIGN CARDS AM763D
SUBTITLE = COLD START.
LOAD = 11
DISPLACEMENT = ALL
ELFORCE = ALL
BEGIN BULK
CBEAM,1,1,10,20,0.,1.,0.
FORCE,11,20,,100.,1.,.8,1.
GRID,10,,0.,0.,0.,,123456
GRID,20,,10.,0.,0.
MAT1,100,1.,.08,.064,,.1
ENDDATA
export DBSDIR=dbs
setenv DBSDIR dbs
set DBSDIR=dbs
Main Index
95
CHAPTER 4
Using the Basic Functions of MSC Nastran
The DBsets mydball and mymaster are created in the dbs directory with the names
am763d.MYMASTER and am763d.MYDBALL respectively. The output files am763d.f04,
am763d.f06, and am763d.log are created in the current working directory.
The second example (TPL file am763r.dat) illustrates a restart that uses the ASSIGN statement:
To submit the above file, issue the command:
The DBsets am763d.MYMASTER and am763d.MYDBALL created by the previous job in the
dbs directory are used. The output files am763r.f04, am763r.f06, and am763r.log are created in
the current working directory.
Using the INIT Statement
DBsets are created using the INIT statement, which is documented in the The File Management Section
(FMS) on page 35 of the MSC Nastran Quick Reference Guide. For example,
prod_ver nastran TPLDIR/am76:am763d
RESTART $ RESTART FROM AM763D, SAVE VERSION 1 ON DATABASE
$ ATTACH AM763D DATABASE WITH ASSIGN COMMANDS BELOW
ASSIGN MASTER=DBSDIR:am763d.MYMASTER
ID MSC,AM763R $ FILENAME CHANGED 16SEP88 -- JFC
TIME 2
SOL 101
CEND
TITLE = EXAMPLE: RESTART, DATABASE ATTACHED VIA ASSIGN CARDS AM763R
SUBTITLE = RESTART -- ADD STRESS RECOVERY COEFFICIENTS TO PBEAM
LOAD = 11
DISPLACEMENT = ALL
ELFORCE = ALL
STRESS = ALL
BEGIN BULK
$ WITH STRUCTURED SOLUTION SEQUENCES (SOL 101+), ALL BULK DATA IS STORED
$ ON DATABASE.
$ ON RESTART, ONLY INCLUDE ADDITIONAL CARDS OR CHANGED CARDS.
/,6 $ DELETE OLD PBEAM CARD ON DATABASE, ADD STRESS RECOVERY COEFFICIENTS
$ AND REPLACE AS FOLLOWS.
PBEAM,1,100,1.,.08,.064,,.1,,+PBEAM1
+PBEAM1,0.0,0.5,0.0,-0.5,0.3,0.0,-0.3,0.0,+PBEAM2
+PBEAM2,YES,0.5,1.0,.08,.064,,.1,,+PBEAM3
+PBEAM3,0.0,0.5,0.0,-0.5,0.3,0.0,-0.3,0.0
ENDDATA $ AM763R
prod_ver nastran TPLDIR/am76:am763r
Main Index
MSC Nastran 2012 Installation and Operations Guide
96
creates and allocates two members DBALL1 and DBALL2 to the DBALL DBset with a maximum size
of 2000 GINO blocks for DBALL1 and a maximum size of 300 kilobytes for DBALL2. The maximum
size can be specified either as the number of GINO blocks or as a number followed by one of the
following modifiers:
where bpw is 8 when mode = i8; 4 on all others. The modifier may be specified using any case
combination.
INIT DBALL LOGICAL=(DBALL1(2000),DBALL2(300KB))
M or Mw
Multiply the size by , round up to a BUFFSIZE multiple.
Mb
Multiply the size by , round up to a BUFFSIZE multiple.
K or Kw Multiply the size by 1024, round up to a BUFFSIZE multiple.
Kb
Multiply the size by , round up to a BUFFSIZE multiple.
w Round the size up to a BUFFSIZE multiple.
b Divide the size by bpw, round up to a BUFFSIZE multiple.
1024
2
1024
2
bpw ( )
1024 bpw ( )
Note: This syntax is similar to, but not the same as, the syntax described in Specifying Memory
Sizes on page 82.
Main Index
97
CHAPTER 4
Using the Basic Functions of MSC Nastran
Using the INCLUDE Statement
The INCLUDE statement is used to insert a specified file into the input file. This statement is especially
useful when you want to partition your input into separate files. The format is:
INCLUDE filename
or
INCLUDE logical-symbol:filename
The file name must be quoted in single quotes if the name contains spaces, commas, special characters
or dollar signs or, on UNIX; lowercase characters. for example,
INCLUDE 'filename'
The file name may include a directory specification, where directory levels are indicated using a using a
directory level separator character ("/" on Unix and "/" or "\" on Windows).
Specifying the INCLUDE Filename
The filename can be continued, if necessary, on multiple lines of the input file. The filename is obtained
from an INCLUDE, RFALTER, or RFINCLUDE statement as follows:
1. The filename is built up by concatenating tokens. A token is either a blank- or comma-delimited
unquoted word or a quoted string (which can be continued across lines).
2. Token are separated by blanks or commas. The blanks or commas separating the tokens are
ignored.
3. Statements may be continued by following the last token on a line by a comma, or specifying an
incomplete quoted string (i.e., the closing quote is missing from the line). All trailing blanks on
the incomplete quoted strings initial line, all leading and trailing blanks on the incomplete quoted
strings intermediate lines, and all leading blanks on the incomplete quoted strings final line are
ignored.
4. Comments may be specified after the last filename token of a line that is not within an incomplete
quoted string. The comment is started with an unquoted dollar sign $, and continues to the end
of the current line.
5. Only the first 72 columns of a line are scanned, i.e., any characters from column 73 and onward
are ignored.
These rules are best explained via some examples.
Note: The RFINCLUDE and RFALTER statements may be used instead of the INCLUDE
statement to insert a specified file into the input file. Except for the directory searching
order specified below, these statements are processed in the same manner that the
INCLUDE statement is processed.
Main Index
MSC Nastran 2012 Installation and Operations Guide
98
include datafile.dat
The filename is DATAFILE.DAT.
include 'c:\abc\def\ghi.include'
The filename is c:\abc\def\ghi.include.
include '/mydir' /level1 /level2/ 'myfile.x'
The filename is /mydir/LEVEL1/LEVLEL2/myfile.x.
RFAlter '/mydir
/level1
/level2
/level3/mydata'
The filename is /mydir/level1/level2/level3/mydata.
include '/proj
/dept123
/sect 456
/joe/flange.bdf'
The filename is /proj/dept123/sect 456/joe/flange.bdf.
rfinclude c:\project,
$ A comment line
'\Data Files' \subdir\thisfile
The filename is C:\PROJECT\Data Files\SUBDIR\THISFILE.
include 'MYTESTDIR:*/mytestfile.dat'
If the logical symbol MYTESTDIR has the value "/myfiles/test", the expanded filename is
"/myfiles/test/*/mytestfile.dat". Note that this filename includes a subdirectory search request, explained
below.
The following examples illustrate what happens when comments or quotes are incorrectly placed.
Note: The following examples contain a mixture of UNIX and Windows pathnames. The
concepts demonstrated by each example are valid on both systems.
Main Index
99
CHAPTER 4
Using the Basic Functions of MSC Nastran
include 'TPLDIR:alter.file $ comment
stmt 2 $ word ' $ comment 3 ' info
The filename is TPLDIR:alter.file $commentstmt 2 $ word .
include '/proj, $ Proj Name
'/dept123, $ Dept Name
'/sect456, $ Sect Name
'/myfile.dat $ File Name
The filename is /proj, $ Proj Name/DEPTNAME/sect 456, $ Sect Name/MYFILE.DAT.
Requesting Subdirectory Searching
MSC Nastran has the ability to search subdirectories when attempting to locate an INCLUDE file. This
can be requested in two ways:
1. Specify "*" as the last directory component within the filename specification. For example,
include '/testdir/dir1/dir2/*/myfile.dat'
says that the directory "/testdir/dir1/dir2" and all of its subdirectories, including nested
subdirectories, are to be searched for the file to be included. Note that the "*" specification must
be followed by a directory level separator character as described above and, if it is not the first
character in the file name, must be preceded by a directory level separator character.
2. Omit any directory specifications on the filename specification and specify "*" as the last
directory component of a directory in the directory list specified by the "jidpath" keyword. See
the description of the jidpath keyword in the Keywords and Environment Variables in
Appendix C.
Locating INCLUDE Files
Once the filename has been obtained from the include statement and any logical symbols have been
expanded, up to four filenames on UNIX systems and two filename on Windows systems will be
searched for. The filenames are:
1. The filename as specified by the include statement. If filename does not end in the file type
specified by the jidtype keyword, it is appended.
2. UNIX: The filename constructed immediately above, converted to lower-case, unless filename is
already all lower-case (i.e., it was specified as a quoted string).
3. The filename as specified by the include statement, without the file type specified by jidtype.
Main Index
MSC Nastran 2012 Installation and Operations Guide
100
4. UNIX: The filename specified above, converted to lower-case, unless filename is already all
lower-case (i.e., it was specified as a quoted string).
For example, consider the statement
include File1
and assume jidtype=dat was specified or defaulted. MSC Nastran will consider the following filenames
on UNIX in the order specified:
FILE1.dat
file1.dat
FILE1
file1
and the following filenames on Windows in the order specified:
file1.dat
file1
For another example, consider the statement
include 'File1.bdf'
and assume jidtype=dat was specified or defaulted. MSC Nastran will consider the following filenames
on UNIX in the order specified:
File1.bdf.dat
file1.bdf.dat
File1.bdf
file1.bdf
and the following filenames on Windows in the order specified:
File1.bdf.dat
File1.bdf
Here is an example with a directory specification. Consider the statement
Note: Recall that character-case is insignificant to Windows file names.
Main Index
101
CHAPTER 4
Using the Basic Functions of MSC Nastran
include 'mydir/File1.dat'
and assume jidtype=dat was specified or defaulted. MSC Nastran will consider the following
filenames on UNIX in the order specified:
mydir/File1.dat
mydir/file1.dat
and the following filename on Windows:
mydir/file1.dat
If filename contains a directory component, MSC Nastran will attempt to locate one of the four UNIX
or two Windows filenames in the specified directory as follows.
If there is no subdirectory search request specified, MSC Nastran will look in the specified
directory for the file.
If there is a subdirectory search request specified, MSC Nastran will look for the file first in the
specified directory then in all of its subdirectories
If none of the names exist or are not readable, a UFM will be issued and the job will exit.
If filename does not contain a directory component, MSC Nastran will attempt to locate one of the four
UNIX or two Windows filenames by searching the following directories or search paths:
the current working directory (the "." directory, i.e., the directory where the nastran command
was run).
If an RFALTER or RFINCLUDE statement is being processed
the directory specified by the RFADIR environment variable, if that variable is defined.
the directory specified by the SSSAALTERDIR environment variable, if that variable was
defined.
the directory containing the file that specified the INCLUDE, RFALTER or RFINCLUDE
statement.
If file that specified the INCLUDE, RFALTER or RFINCLUDE statement itself was included,
the directory containing the parent file will be searched. This nesting will continue until the
directory containing the input data file has been searched.
the list of directories specified by the jidpath keyword will be searched in order, noting that
one or more of the directories in this list may specify subdirectory searching.
If an INCLUDE statement is being processed:
the directory specified by the RFADIR environment variable, if that variable is defined.
the directory specified by the SSSALTERDIR environment variable, if that variable was
defined.
Main Index
MSC Nastran 2012 Installation and Operations Guide
102
If no readable file can be found in any of these directories, a UFM will be issued and the job will exit.
Main Index
103
CHAPTER 4
Using the Basic Functions of MSC Nastran
Using the SSS Alter Library
The SSS Alter directory, install_dir/prod_ver/nast/sssalter on UNIX and
install_dir\prod_ver\nast\sssalter on Windows, contains alters (modifications to MSC Nastran solution
sequences) and associated support files that represent client-requested or prototype features that are not
yet implemented in MSC Nastran's standard solution sequences. These alters can be inserted using the
INCLUDE statement and the SSSALTERDIR symbol. For example,
INCLUDE 'SSSALTERDIR:zfreqa.dat'
Note: The SSSALTERDIR specification is not required since the directory specified by the
SSSALTERDIR is one of the directories automatically searched as part of INCLUDE file
processing. However, using the SSSALTERDIR specification is suggested to ensure that
the file in the SSS Alter directory is the one actually used instead of a file with the same
name located in one of the other directories in the INCLUDE file search paths.
Main Index
MSC Nastran 2012 Installation and Operations Guide
104
Resolving Abnormal Terminations
MSC Nastran generates a substantial amount of information concerning the problem being executed. The
.f04 file provides information on the sequence of modules being executed and the time required by each
of the modules; the .log file contains system messages. A list of known outstanding errors for
MSC Nastran is delivered in the file install_dir/prod_ver/doc/error.lis on UNIX and
install_dir\prod_ver\doc\error.lis on Windows. Please consult this file for limitations and restrictions.
MSC Nastran may terminate as a result of errors detected by the operating system or by the program. If
DIAG 44 is set (see the keyword diag on page 54 and the MSC Nastran Quick Reference Guide), MSC
Nastran will produce a dump of several key internal tables when most of these errors occur. Before the
dump occurs, there may be a fatal message written to the .f06 file. The general format of this message is
This message is issued whenever an interrupt occurs that MSC Nastran is unable to satisfactorily process.
The specific reasons for the interrupt are usually printed in the .f06 and/or .log file; n is an error code
that is explained in Chapter 16 of the MSC Nastran Reference Manual.
Whenever the System Fatal Error 4275 or 4276 is associated with a database error, further specific
information is written to the .f06 file as follows:
The FILE and/or BLKNBR lines may not be present, depending upon the bio-function issuing the
message.
Interpreting System Error Codes
If an operating system error occurs, an attempt is made to catch the error and place the error number in
the .log file. A description of these error numbers may be obtained with the following command:
***SYSTEM FATAL ERROR 4276, subroutine-name ERROR CODE n
bio-function ERROR - STATUS = errno, FILX = i, LOGNAME = logical, NSBUF3 = j
FILE = filename
BLKNBR = k
ERROR MESSAGE IS --
error-message-text
IBM cat /usr/include/sys/errno.h
Sun man -s2 intro
Other UNIX man 2 intro
Main Index
105
CHAPTER 4
Using the Basic Functions of MSC Nastran
Terminating a Job
There may be instances when a running job must be prematurely terminated; this is accomplished using
one of the following procedures:
Job Running in the Foreground (batch=no on UNIX; all jobs on Windows)
Use the interrupt sequence (on Silicon Graphics systems this sequence is usually Ctrl-\; on other
systems Ctrl-C).
Job Running in the Background (batch=yes or after=time on UNIX)
Use the ps command to find the process ID (PID) of the MSC Nastran job (i.e., the
install_dir/prod_ver/arch/analysis executable) and issue the command
where pid is the process ID.
Job Running Under NQS or NQE (queue=queue_name on UNIX)
1. Use qstat -a to find the request-id of your job.
2. Use qdel request-id to delete a job that has not yet started; or use qdel -k request-id to kill a
job that has already started where request-id is the request ID.
Flushing .f04 and .f06 Output to Disk (UNIX)
As MSC Nastran writes to the .f04 and .f06 files, the FORTRAN runtime libraries will buffer this I/O in
memory to reduce the amount of time consumed by disk I/O. When the buffers are filled (i.e.,
MSC Nastran has written a sufficient amount of information to the .f04 or .f06 file), the buffers will be
flushed to the files by the FORTRAN runtime libraries. In a large job, some modules may do
substantially more computation than I/O. As a result, the I/O may remain in the FORTRAN buffers
(possibly for several hours) before they are written to disk.
AIX, HP-UX, and Linux computers support asynchronous flushing of the .f04 and .f06 files. To do this,
enter the command
where pid is the process ID of the running MSC Nastran job (i.e., the install_dir/prod_ver/arch/analysis
executable). There may be a time delay between the time you issue the kill command and the time the
files are actually updated.
kill pid
kill -USR1 pid
Main Index
MSC Nastran 2012 Installation and Operations Guide
106
Common System Errors
The most common system errors encountered during an MSC Nastran job are described below.
UNIX Disk I/O Errors
ERRNO 1 (EPERM) - no permission to file (all systems).
Please check the ownership and mode of the file or directory with the ls -l command. Change
either the ownership or permissions of the file or the directories along the path. The chgrp(1)
command is used to change the group of a file, chmod(1) is used to change permissions of the
file, and chown(1) is used to change ownership of the file.
ERRNO 27 (EFBIG) - file is too large (all systems)
This error occurs if a file's size exceeds a resource limit. The resource limits in effect during the
job's execution are printed in the .log file under the heading Current Resource Limits. Increase
the -If and -IF parameters on your qsub command if you are running NQS or NQE; ask your
system administrator to increase your File Size limit (all platforms).
ERRNO 28 (ENOSPC) - disk space is completely filled (all systems).
MSC Nastran deletes its scratch files at termination even if the disk space fills up. Therefore, the
df(1) command may show a large amount of free space even though the job failed due to lack of
disk space. Both the current working directory and the scratch directory need to be checked.
Move your files to a disk with more space (see the out, dbs, and sdirectory keywords), or
delete unnecessary files from the disk.
Inability to Allocate the Requested Amount of Memory (OPEN CORE Allocation Failed)
Temporary lack of swap space (all systems).
This error may be caused by too many processes running at the same time. Decrease the number
of processes or increase the available swap space.
The data segment of the process has exceeded the UNIX resource limit (UNIX).
The resource limits in effect during the job's execution are printed in the .log file under the
heading Current Resource Limits. Ask your system administrator to increase your Data
Segment Size (all), Maximum break size (HP-UX), or Virtual Address Space (all others).
memory allocation error: unable to allocate n words (HP-UX).
The resource limits in effect during the job's execution are printed in the .log file under the
heading Current Resource Limits. Check your Maximum break size; if this is smaller than
the requested memory, ask your system administrator to increase your limit.
If your limit is large enough, the system wide shmmax and maxdsize kernel parameters may
be too small. These parameters must be large enough to accommodate all simultaneously
executing MSC Nastran jobs plus all others users of shared memory. These values are modified
using sam(1M), see Kernel Parameters under Configurable Parameters.
It may also be possible to correct these errors with the following:
Reduce the amount of memory requested by the memory keyword.
Main Index
107
CHAPTER 4
Using the Basic Functions of MSC Nastran
Increase the -lm and -lM parameters if you directly submitted your job to NQS or NQE
using a qsub command.
Increase the prmdelta or ppmdelta keyword values if you submitted your job to NQS or
NQE using the nastran commands queue keyword.
EAG FFIO Errors (Altix)
The following error message may appear on LINUXIPF systems when FFIO is being used:
This message is a consequence of not having enough memory for the eie cache pages. System memory
requirements are as follows:
If the job was directly submitted with the qsub command, then the error can be avoided by increasing
the NQS lm and lM parameters. The value should be at least 6.5 MW plus the value specified by the
memory keyword plus the amount needed for eie. To determine the amount needed for FFIO, consider
the following ff_io_opts request:
This request requires an additional:
If the job was submitted with the nastran commands queue keyword, the nastran command
automatically adjusts the memory request based on the ff_io_cachesize keyword. The eie open
failure message should only appear if the user modified the ff_io_defaults or ff_io_opts keywords
without modifying the ff_io_cachesize keyword. This error can be avoided by increasing the value set
by the ppmdelta keyword (see ppmdelta (UNIX) on page 80) to 6.5 MW plus the amount of memory
for FFIO.
See the URL
eie open failure : Not enough space for cache pages
Description Size Where Documented
executable 6.5 MW System Descriptions on page 115
opencore memory keyword Keywords and Environment Variables on page 45
and Managing Memory on page 116
EIE buffers/ Cache Keywords and Environment Variables on page 45
(eie:128:16:1:1:1:0,set:0:0)
file://install_dir/prod_ver/arch/ffio.html
128 blocks page ( ) 16 pages ( ) 512 words block ( ) 1048576W 1MW = =
Main Index
MSC Nastran 2012 Installation and Operations Guide
108
where arch is linuxipf, for a complete description of EAG FFIO.
Main Index
Ch. 5: Using the Advanced Functions of MSC Nastran MSC Nastran 2012 Installation and Operations
Guide
5
Using the Advanced Functions
of MSC Nastran
Overview
Managing Memory
Managing DBsets
Overview
ESTIMATE
F04REPRT
HEATCONV
MSCACT
MSGCMP
MultiOpt
NEUTRL
OP4UTIL
OPTCONV
PLOTPS
RCOUT2
RECEIVE
TRANS
XMONAST (UNIX)
XNASTRAN (UNIX)
Overview
Specifying Parameters
User-Defined Keywords
Symbolic Substitution
Main Index
MSC Nastran 2012 Installation and Operations Guide
2
Specifying Parameters
Nastran execution is controlled by a variety of parameters, either keywords or special Nastran statements,
both required and optional. The purpose of this section is to describe how and where these parameters
may be specified, not to describe these parameters in detail. This is done in subsequent sections. The
Nastran parameters may be specified on the command line, in a command initialization (INI) file, in
runtime configuration (RC) files and, for some parameters, from environment variables. The information
from these sources is consolidated at execution time into a single set of values. Much of this information
is passed to analysis processing in a "control file", built using the templates (Customizing the
Templates on page 66). (The records in this control file are echoed to the .log file.) Examples of INI
and RC files are given in the User-Defined Keywords on page 8 and Customizing Command
Initialization and Runtime Configuration Files on page 16.
Command Initialization and Runtime Configuration Files
Although the purposes of the INI and RC files are somewhat different, the format of each file is the same.
All INI and RC files are processed twice, once (the "first" pass) to extract parameters (keywords and
other information) that are to be used for all Nastran jobs, and once (the "second" pass) to extract
parameters specific to a particular job. This is accomplished by separating the INI and RC files into a
series of "sections" identified by a "section header" and "subsections" within sections, identified by a
subsection "header." There are two types of sections: "unconditional" and "conditional." Subsections are
always "conditional."
An unconditional section is one that starts with the name of the section enclosed in square
brackets ("[","]"). Section names may not contain any embedded blanks but may be
separated from the square brackets by any number of blanks. As currently implemented, there
are three valid unconditional names: "General", "Solver" and "Nastran". (These section
names are case-insensitive.) In addition, there is an implicit "unnamed" section that consists of
all parameters in the INI or RC file that appear before the first named section or subsection.
There is no special meaning assigned to any of the unconditional sections. Their use is optional;
the section names are intended to be used for descriptive purposes.
A conditional section or subsection is one that starts with an expression in the form:
enclosed in section header identification characters. For a conditional section, the section header
identification characters are square brackets ("[","]"), just as for unconditional sections. For a
subsection, the section header identification characters are "less than" and "greater than" ("<",
">") characters. Keywords and values may not contain any embedded blanks but may be
separated from each other and from the enclosing section header identification characters (the
square brackets or "less than"-"greater than" characters) by any number of blanks. In the
expression:
<keyword><operator><value>
Main Index
3
APPENDIX A
Configuring the Runtime Environment
Parameters in unconditional sections, but not in subsections (which are always conditional) within
unconditional sections, are processed on the first pass through an INI or RC file. On the second pass,
these parameters are ignored (they are not reprocessed). Parameters in conditional sections and
subsections are ignored on the first pass. Parameters in conditional sections and subsections whose
expressions evaluate to "true" are processed on the second pass through an INI or RC file, thus allowing
conditional expressions to reference all of the valid keywords. Note that for subsections within
conditional sections, both the conditional expression for the section and the conditional expression for
the subsection must evaluate to "true" before parameters in the subsection are processed.
Parameter specifications in, either unconditional or conditional sections, may be continued, if necessary,
by specifying a backslash (\) character as the last non-blank character of the line. Note for Windows
users, if the parameter value itself ends with a backslash, the statement must have additional characters,
such as a comment, after the value specification. For example, a specification such as:
sdir=e:\
will not work properly. Instead, write the statement as:
sdir=e:\ $ Specify the scratch directory
In addition to parameters, INI and RC files may contain comment records. There are two types of
comment records: ignored and printed.
Ignored comments are records that start with a semi-colon (";") or pound sign ("#"). These
records are completely ignored. When running in Windows, there is a special form of ignored
comments that may be specified in an INI file (but not in RC files). These are records that start
with "REM", short for "REMARK". The test for "REM" is case-insensitive.
Printed comments are records that start with the currency symbol ("$"). These records are
passed on as part of the analysis information but are otherwise ignored.
<keyword> represents any valid internal keyword (see Keywords on page 46) or
user-defined keyword (see User-Defined Keywords on page 8).
<operator> specifies the comparison to be performed between <keyword> and
<value> as follows:
= equal (either string or numeric)
! not equal (either string or numeric)
!= not equal (either string or numeric)
< numerically less than
<= numerically less than or equal
> numerically greater than
>= numerically greater than or equal
<value> specifies the appropriate keyword value to be used in the comparison.
Keywords and values may be specified in any case.
Main Index
MSC Nastran 2012 Installation and Operations Guide
4
The list below specifies the INI and RC files that MSC Nastran uses. Any or all of these files may be
ommitted. Table A-1 lists the keywords that are generally set in the unconditional sections of the
command initialization file. Table A-2 lists the keywords that are generally set in RC files.
Note: Although sectioning within INI and RC files was first introduced in MSC Nastran 2004,
valid INI and RC files from prior versions of Nastran are fully compatible with this new
format. Since sections were not supported in previous versions (except for INI files on
Windows, which allowed unconditional sections), all parameters will be in the "unnamed"
implicit section (or, on Windows, in named unconditional sections) and will be processed
on the first pass through the file. No information will be extracted from these files on the
second pass.
Command Initialization (INI) File
This file is used to define keywords that are to be set whenever the nastran command is
executed. Typical keywords in the unconditional sections include the installation base
directory and the version of MSC Nastran. Conditional sections and subsections might
include keywords such as "rcmd" and "rsdirectory" in sections that are conditional upon the
value of the "node" keyword.
UNIX: install_dir/prod_ver/arch/nastran.ini
At installation time, this name is linked to install_dir/bin/nast2012.ini
Windows: install_dir\prod_ver\i386\nastran.ini or install_dir\bin\nastran.ini
Starting with MSC Nastran 2011, there are two possible RC files that may be defined in each of the
locations that are searched for RC files. The first name is a version independent name and the second
name is a version dependent name, where the version number is indicated by <vernum> in the file name
and the version number for MSC Nastran 2012 is 2012.
System RC Files
These files are used to define parameters that are applied to all MSC Nastran jobs using this
installation structure. Many of the parameters that might be specified in the INI file could,
alternatively, be specified in this file.
UNIX: install_dir/conf/nastran.rcf and
install_dir/conf/nast<vernum>rc
Windows: install_dir\conf\nastran.rcf and
install_dir\conf\nast<vernum>.rcf
Main Index
5
APPENDIX A
Configuring the Runtime Environment
Please note that the UNIX shorthand "~", to refer to your or another user's home directory, cannot be used
in an RC file. In addition, environment variables are only recognized within the context of a logical
symbol definition.
Architecture RC Files
This files are used to define parameters that are applied to MSC Nastran jobs using this
architecture.
UNIX: install_dir/conf/arch/nastran.ini and
install_dir/conf/arch/nast<vernum>rc
Windows: install_dir\conf\arch\nastran.rcf and
install_dir\conf\arch\nast<vernum>.rcf
Node RC Files
These files are used to define parameters that are applied to MSC Nastran jobs running on
this node. Alternatively, the parameters in this file could be specified in a conditional
section in one of the previous files, using nodename as the value of the "s.hostname"
keyword in the conditional expression.
UNIX: install_dir/conf/net/nodename/nastranrc and
install_dir/conf/net/nodename/nast<vernum>rc
Windows: install_dir\conf\net\nodename\nast2012.rcf and
install_dir\conf\net\nodename\nast<vernum>.rcf
User RC Files
These files are used to define parameters that are applied to MSC Nastran jobs run by an
individual user.
UNIX: $HOME/.nastranrc and
$HOME/.nast<vernum>rc
Windows: %HOMEDRIVE%%HOMEPATH%\nastran.rcf and
%HOMEDRIVE%%HOMEPATH%\nast<vernum>.rcf
Local RC Files
These files should be used to define parameters that are applied to Nastran jobs that reside
in the input data file's directory. This RC file is in the same directory as the input data file.
If the "rcf" keyword (page 84) is used, this local file is ignored.
UNIX: .nastranrc and
.nast<vernum>rc
Windows: nastran.rcf and
nast<vernum>.rcf
Main Index
MSC Nastran 2012 Installation and Operations Guide
6
Also, note that, on UNIX systems, the leading period (.) on the User RC Files and Local RC Files file
names cannot be deleted even if alternate names are specified using the a.urc and a.urcb keywords
as described below.
The file names listed above may be changed by the user using the a.rc, a.rcb, a.urc and a.urcb
keywords, noting that the directories in which the files are located may not be changed.
The a.rc keyword can be used to change the names of the version dependent RC file names for
the System RC Files, the Architecture RC Files and the Note RC File. The default for this
keyword is nast<vernum>rc for UNIX and nast<vernum>.rcf for Windows.
The a.rcb keyword can be used to change the names of the version-independent RC file names
for the System RC Files, the Architecture RC Files and the Node RC Files. The default for this
keyword is nastranrc for UNIX and nastran.rcf for Windows.
The a.urc keyword can be used to change the names of the version dependent RC file names
for the User RC Files and the Local RC Files. For UNIX, the default for this keyword is the
value of the a.rc keyword with a leading period (.) added. For Windows, the default for this
keyword is the value of the a.rc keyword.
The a.urcb keyword can be used to change the names of the version-independent RC file
names for the User RC Files and the Local RC Files. For UNIX, the default for this keyword is
the value of the a.rcb keyword with the leading period (.) added. For Windows, the default
for this keyword is the value of the a.rcb keyword.
In addition to keyword specifications, the following MSC Nastran statements (from the NASTRAN and
FMS Sections) may appear in RC files and conditional sections in an INI file: NASTRAN, ACQUIRE,
ASSIGN, CONNECT, DBCLEAN, DBDICT, DBDIR, DBFIX, DBLOAD, DBLOCATE, DBSETDEL,
DBUNLOAD, DBUPDATE, DEFINE, ECHOOFF, ECHOON, ENDJOB, EXPAND, INCLUDE, INIT,
PROJ, RESTART and RFINCLUDE. Except for minimal checking of the NASTRAN and PARAM
statements, the syntax of these statements is not validated These records are simply passed on for use in
Nastran analysis processing.
INI files and RC files also may contain PARAM statements that specify values that affect Nastran
analysis processing. The values associated with PARAM names may be specified using PARAM
statements in INI files and RC files or by using PARAM keywords, defined using the PARAM keywords
feature as described in User-Defined Keywords on page 8. PARAM statements must be specified in
"free-field format", i.e., in the Case Control PARAM format (PARAM,name,value), not in Bulk Data
fixed-field format. Please see Parameters in Chapter 5 of the MSC Nastran Quick Reference Guide
for more information on PARAM names and statements and their usage.
Environment Variables
Several keywords may have their values set from associated environment variables. When this is the
case, the environment variable takes precedence over any INI or RC file keyword specification. A
command-line specification will over-ride the environment variable specified value. This same
precedence rule applies to user-defined keywords that may have their initial values taken from
environment variables, as described in the next section. A list of the keywords and their associated
Main Index
7
APPENDIX A
Configuring the Runtime Environment
environment variables, along with a description of each keyword, may be obtained by using the
following command:
prod_ver nastran help env
Main Index
MSC Nastran 2012 Installation and Operations Guide
8
User-Defined Keywords
In addition to the internally defined keywords (see Keywords on page 46), Nastran allows users to
define their own keywords. There are two classes of user-defined keywords:
General keywords. These are intended for use in INI file or RC file conditional section clauses,
in user modifications to the run template files (nastran.dmp, nastran.lcl, nastran.rmt or
nastran.srv) and, for UNIX, in customized queue commands (submit keyword)..
PARAM keywords. These are keywords associated with a PARAM name. Using descriptive
keywords to set a PARAM value may be more convenient than specifying the PARAM statement
in an RC file. Also, keywords are not limited to a maximum of eight characters, as PARAM
names are, and may be more descriptive of the action being affected or requested.
User-defined keywords are supported by the "help" and "whence" functions.
General Keywords
These keywords are defined in the file specified by the "0.kwds" keyword. The default file names are:
The records in this file consist of:
Comment records. These are records that start with a comment character (hash, '#', semi-colon,
';', or currency symbol, '$') and are completely ignored.
Blank or null records. These records are ignored.
Keyword records. These records consist of the keyword name along with an optional value
descriptor and comment in the form:
where:
UNIX: install_dir/prod_ver/arch/nastran.kwds
At installation time, this name is linked to install_dir/bin/nast2012.kwds
Windows: install_dir\prod_ver\i386\nastran.kwds or
install_dir\bin\nast2012.kwds
The file used is the first one found.
keyword_name[,attributes] : value_descriptor comment
keyword_name is the name to be assigned to the user keyword. This name may not
contain any embedded blanks and may not be the same as any internal
keyword or previously specified user-defined keyword. It is also case-
insensitive except in the case when its initial value may be set from an
environment variable with the same name.
Main Index
9
APPENDIX A
Configuring the Runtime Environment
There may be any number of leading blanks in the record and before and after the separating
colon.
General keywords and the values assigned to them only affect Nastran processing if:
there are customized INI and RC files that have conditional sections, using these keywords in
expressions, that specify other keywords and statements (e.g., NASTRAN and PARAM
statements) that modify Nastran processing to meet the requirements of a user's site and
installation.
they are used in customized templates (Customizing the Templates on page 66).
for UNIX systems, they are used in customized queue commands defined using the "submit"
keyword (Customizing Queue Commands (UNIX) on page 62).
PARAM Keywords
These keywords are defined in the file specified by the "0.params" keyword The default file names are:
attributes specifies optional attributes to be assigned to the keyword defined by
keyword-name. Currently, the only defined attribute is:
argv keyword and its value is to be added to the r.argv keyword
value
Any number of blanks may separate keyword_name, the separating
command and the attributes specification.
value_descriptor is optional. If specified, it should be as described in Value Descriptors
on page 10 and may not contain any embedded blanks. If this field is
not present, the separating colon may be omitted.. The default value
descriptor is "string". This field may also specify that the initial
value of this keyword be taken from an environment variable with the
same name.
comment is an optional comment field. If present, it must be separated from
value_descriptor or keyword_name by blanks or must
begin with a comment character.
UNIX: install_dir/prod_ver/arch/nastran.params
At installation time, this name is linked to install_dir/bin/nast2012.params
Windows: install_dir\prod_ver\i386\nastran.params or install_dir\bin\nast2012.params
The file used is the first one found.
Main Index
MSC Nastran 2012 Installation and Operations Guide
10
The records in this file consist of:
Comment records. These are records that start with a comment character (hash, '#', semi-colon,
';', or currency symbol, '$') and are completely ignored.
Blank or null records. These records are ignored.
Keyword-name records. These records consist of the keyword name, the associated PARAM
name, along with an optional value descriptor and comment in the form:
where:
There may be any number of leading blanks in the record and before and after the separating
colons.
Keyword names that are the same as PARAM names are allowed, as long as the keyword name is not an
internal or general user-defined keyword name.
Values associated with PARAM names, whether set using PARAM keywords or set using PARAM
statements (statements having the form PARAM,name,value), directly affect Nastran analysis
processing.
Value Descriptors
Value descriptors enable limited syntax checking for values assigned to general and PARAM user-
defined keywords. For general keywords, they may also specify that the initial value of the keyword be
set from the value associated with the environment variable having the same name as the keyword. There
keyword_name : param_name : value_descriptor comment
keyword_name is the name to be assigned to the PARAM keyword. This name is
case-insensitive, may not contain any embedded blanks and may not
be the same as any internal keyword, general user-defined keyword
or previously specified PARAM keyword.
param_name is the PARAM name to be associated with keyword_name. This
name is case-insensitive, may be a maximum of eight characters,
must begin with an alphabetic character and may not contain any
embedded blanks. Also, it may not be the same as any previously
specified PARAM name.
value_descriptor is optional. If specified, it should be as described in Value
Descriptors and may not contain any embedded blanks. If this field
is not present, the separating colon may be omitted. The default
value descriptor is "string".
comment is an optional comment field. If present, it must be separated from
value_descriptor or param_name by blanks or must begin
with a comment character.
Main Index
11
APPENDIX A
Configuring the Runtime Environment
are two types of syntax checking available: value must be one of a list of entries or value must be
numeric. Also, the two forms can be combined. These are specified as follows:
List: {"val1","val2",...,"valn"}
That is, the acceptable values are enclosed in double quotes (") and separated from each other by
commas. The specification, including the various acceptable values, may not contain any embedded
blanks. Values are case-insensitive and any partial specification is acceptable and will be replaced by
the full value. For example, if a keyword may only have the values "preliminary", "check" and "final",
the value descriptor would be:
and a value specification of "Ch" would be accepted and replaced by "check".
Numeric: number
Values will be checked to see if they are valid numbers, either integer or floating point. For example,
valid keyword value specifications could be: "1", "-3.247", "4.e-5". "3.75.4", "4.24x" and "-
4-5" are invalid specifications.
Complex value: number,number
This format is only supported for PARAM keyword value descriptors. Values will be checked to see if
they consist of two valid numeric values, separated by a comma.
Combined: {"val1","val2",...,"valn",number}
In addition, for general keywords, if the value descriptor starts or ends with the string "env", specified
in any case and separated from the rest of the value descriptor with a comma (unless the value descriptor
is only "env"), the keyword value will be set using the value associated with the environment variable
having the same name as the keyword. The environment value will be subjected to the same syntax-
checking rules that an INI file, RC file or command line specification would be, with a warning message
generated if syntax checking fails. This occurs even if the keyword is specified on the command line.
Note that, for UNIX systems, since environment variable names are case-sensitive, the keyword name
must be specified exactly the same as the environment variable name. This is the only time that the
keyword name is case-sensitive. For Windows systems, since environment variable names are not case-
{"Preliminary","Check","final"}
Note: This checking does not support the NASTRAN "nnnseee" numeric format, where the 'e'
between the number and the signed exponent ("seee") is missing.
Note: This "combined" format does not support complex numbers.
Main Index
MSC Nastran 2012 Installation and Operations Guide
12
sensitive, this restriction does not apply. Keyword values set from environment variables over-ride
keyword values set in INI or RC files but do not over-ride keyword values set on the command line.
If a value descriptor is omitted or is not one of these formats, no syntax checking will be performed.
Examples:
1. The following value descriptor would accept a value of "test", "final" or a number:
Acceptable values would be: te (replaced by test), FIN (replaced by final), 7, 14.5, 3.e-
4, -5
2. The following value descriptor would accept only the strings "abc", "def", "ghi" and "glm":
Acceptable values would be: g (replaced by ghi), aB (replaced by abc), gl (replaced by glm),
D (replaced by def)
3. The following value descriptor, only valid for a PARAM keyword, would only accept a complex
number specification:
Acceptable values would be: 1,2, 7.54,3.14
4. The following value descriptors, only valid for a general keyword, would accept only the strings
"qrs", "test", and "xyz". In addition, the value descriptor requests that the keyword value be set
from the environment.
or
Acceptable values would be: q (replaced by qrs), xY (replaced by xyz), T (replaced by test)
{"Test","Final",Number}
{"abc","def","ghi","glm"}
number,number
enV,{"qrs","test","xyz"}
{"qrs","test","xyz"},Env
Main Index
13
APPENDIX A
Configuring the Runtime Environment
Resolving Duplicate Parameter Specifications
Nastran processing information is obtained by scanning the various INI and RC files, the system
environment, and the Nastran command line in the following order:
1. Nastran command line, first pass. Only "program options", i.e., "-x" options, are processed
during this command line scan. For example, this is when the "-i ini_file_name" program option
is processed.
2. Environment variables, first pass. During this pass, the only keywords whose values are set are
those that may only be specified as environment variables. This includes keywords such as
HOME (for UNIX), HOMEDRIVE and HOMEPATH (for WINDOWS) and PWD.
3. INI file, first pass, if this file exists. During this pass, only unconditional sections are processed.
Generally, the only keywords processed in this pass are: 0.kwds, 0.params, accmd, acvalid, rcmd,
rsdirectory, sysmsg and version (although rcmd and rsdirectory probably should be in conditional
sections scanned during the second pass).
4. Environment variables, second pass. During this pass, only those keywords that may only be set
in global sections of the INI file or as environment variables are processed. This includes
keywords such as MSC_ARCH, MSC_BASE and MSC_VERSD.
5. Nastran command line, second pass. The only general use keywords processed during this
command line scan are: dmparallel, jid, jidpath, jidtype, node, pause, rcf, username, version and
whence. The processing of other command line keywords is deferred until later command line
scans.
This is the time that the user-defined keyword definition files (for both general use and PARAM
keywords), if any, are processed and the keyword specifications defined by these files are added to the
keywords tables. The keywords defined in these files may be used just as internal keywords are used.
(See User-Defined Keywords on page 8.)
6. System RC files, first pass, if these files exist. During this pass, only unconditional sections are
processed.
7. Architecture RC files, first pass, if these files exist. During this pass, only unconditional sections
are processed.
8. Node RC files, first pass, if these files exist. During this pass, only unconditional sections are
processed.
9. User RC files, first pass, if these files exist. During this pass, only unconditional sections are
processed.
10. Local RC files, first pass, if these files exist. During this pass, only unconditional sections are
processed.
11. Environment variables, third pass. During this pass, only "general" user-defined keywords that
have been flagged to be set from environment variables are processed. (This pass will be skipped
if there are no "general" user-defined keywords.)
Main Index
MSC Nastran 2012 Installation and Operations Guide
14
12. Nastran command line, third pass. Only "general" user-defined keywords are processed during
this command line scan. (This pass will be skipped if there are no "general" user-defined
keywords.)
At this point, all keyword values that can be used in conditional section expressions are known.
13. INI file, second pass, if this file exists and has conditional sections. During this pass, only the
conditional sections are processed.
14. System RC files, second pass, if these files exist and have conditional sections. During this pass,
only the conditional sections are processed.
15. Architecture RC files, second pass, if these files exist and have conditional sections. During this
pass, only the conditional sections are processed.
16. Node RC files, second pass, if these files exist and have conditional sections. During this pass,
only the conditional sections are processed.
17. User RC files, second pass, if these files exists and have conditional sections. During this pass,
only the conditional sections are processed.
18. Local RC files, second pass, if these files exist and have conditional sections and if they are not
ignored. During this pass, only the conditional sections are processed.
19. Environment variables, fourth pass. During this pass, all keywords that may be set from
environment variables and that have not been processed previously are now processed.
20. Nastran command line, fourth pass. All keywords not processed during the previous passes are
now processed. For example, this is when user-defined PARAM keyword specifications are
processed.
At this point, all information necessary to generate the "control file" has been collected. This file is
generated when the "script templates" (see Customizing the Templates on page 66) are processed.
21. NASTRAN, FMS and PARAM statements in the input file.
If duplicate keywords are encountered, the last specification found is the one used. That is, the above list
specifies the precedence order, from lowest precedence (number 1) to highest (number 21). The only
case in which the last keyword specification is not used is when keywords are "locked", i.e., when a
specification of the form
is processed. After this "lock" request is processed, any requests to set keyword, whether from INI
files, RC files, environment variables or command line arguments, are quietly ignored. That is,
processing proceeds as if any keyword specifications specified after the "lock=keyword" request do
not exist. Once a keyword has been "locked, there is no way to "unlock" it. (Note that it is valid to
"lock" the lock keyword itself.)
If duplicate NASTRAN and FMS statements are encountered, they are simply passed on for use in
Nastran analysis processing in the order in which they were encountered.
lock=keyword
Main Index
15
APPENDIX A
Configuring the Runtime Environment
Thus, the general rule for resolution is:
Information specified in NASTRAN input data files always takes precedence over any other
values.
Command line parameters have the next highest precedence.
Environment variables associated with keywords and that have non-null values are next.
RC file parameter specifications are next.
INI file parameter specifications are last.
Generally, the only exceptions to this precedence ordering are "general" user-defined keyword
specifications. The command line values take precedence over values specified in unconditional INI file
and RC file sections but have lower precedence than values specified in conditional INI file and RC file
sections. Because the primary purpose for general user-defined keywords is for conditional section
selection, changing a general user-defined keyword in a conditional section may lead to unexpected
results. Such specifications should be used with care. Also, because user-defined PARAM keywords on
the command line are not processed until the last command line scan, PARAM keywords should not be
used in INI file and RC file conditional section expressions since command line specified values will not
be in effect when these expressions are evaluated.
Because PARAM values may be specified either using PARAM statements or using PARAM keywords,
they require further explanation. PARAM statements and PARAM keywords referring to the same
PARAM name are considered equivalent definitions for the PARAM name. As such, the last
specification, regardless of whether it was a PARAM statement or a PARAM keyword, is the one that is
used to establish the value associated with the PARAM name.
Main Index
MSC Nastran 2012 Installation and Operations Guide
16
Customizing Command Initialization and Runtime
Configuration Files
Table A-1 lists the keywords that are generally set in the unconditional sections of the command
initialization file.
Most of the command line keywords can be set in any of the RC files. Table A-2 lists keywords that are
generally set in the system, architecture, or node RC files:
Table A-1 Command Initialization File Keywords
Keyword Purpose
0.kwds Alternate name for user-defined keywords definition file.
0.params Alternate name for PARAM keywords definition file
acct Enables job accounting, see Enabling Account ID and Accounting Data on
page 41.
acvalid Activates account ID validation, see Enabling Account ID Validation on
page 41.
MSC_BASE Defines the installation base directory. Normally this is defined as an
environment variable by the prod_ver command.
version Specifies the default version of Nastran to be run.
Table A-2 RC File Keywords
Keyword Preferred RC File Purpose
accmd System Command line to invoke accounting logger
program.
acct System Enables job accounting.
acvalid System Enables account ID (acid) validation.
authorize System Specifies the licensing method.
lock Any Prevent further changes to a keyword's value.
memory Node Specifies a default memory allocation
memorymaximum Node Specifies a maximum "memory" request.
ncmd Architecture Specifies the notify command when
"notify=yes" is set.
news System Controls the display of the news file at the
beginning of the .f06 file.
post Architecture UNIX: Specifies commands to be run after
each job is completed.
Main Index
17
APPENDIX A
Configuring the Runtime Environment
ppcdelta Architecture UNIX: Specifies the value that is subtracted
from the "CPU" keyword value to determine
the NQS per-process CPU time limit.
ppmdelta Architecture UNIX: Specifies the value that is added to the
"memory" keyword value to determine the
NQS per-process memory limit.
pre Architecture UNIX: Specifies commands to be run before
each job begins.
prmdelta Architecture UNIX: Specifies the value that is added to the
"ppm" value to determine the NQS per-
request (per-job) memory limit.
qoption Architecture UNIX: Specifies a string of additional
queuing options to be set in the queue
submittal command.
rcmd Any Specifies the remote Nastran command to be
used when "node" is specified. Should be in a
conditional section using "node" in the
conditional expression.
real Node Specifies the "REAL" parameter to limit
virtual memory usage.
rsdirectory Any Specifies the scratch directory to be used
when "node" is specified. Should be in a
conditional section using "node" in the
conditional expression.
scratch Any Specifies the default job status as scratch or
permanent.
sdirectory Node Specifies a default scratch directory.
submit Architecture UNIX: Defines queues and their associated
submittal commands.
sysn Any Specifies system cells. Can also be specified
using the synonym keywords, e.g., buffsize is
equivalent to sys1.
Table A-2 RC File Keywords (continued)
Keyword Preferred RC File Purpose
Main Index
MSC Nastran 2012 Installation and Operations Guide
18
Examples
The following (relatively simplistic) examples illustrate how unconditional and conditional sections
could be used.
Example 1:
Assumptions: There are three computer nodes, sysnode1, sysnode2 and sysnode3, that may be accessed.
On sysnode1:
MSC Nastran 2008 and MSC Nastran 2011 are installed:
MSC Nastran 2008 is accessed using "/local/msc/bin/nast2008"
MSC Nastran 2011 is accessed using "/local/msc/bin/nast2011"
The scratch directory is /local/temp
On sysnode2:
Only MSC Nastran 2008 is installed and is accessed using "/local1/msc/bin/nast2008"
The scratch directory is /local1/temp
On sysnode3:
MSC Nastran 2008 and MSC Nastran 2011 are installed:
MSC Nastran 2008 is accessed using "/local2/msc/bin/nast2008"
MSC Nastran 2011 is accessed using "/local2/msc/bin/nast2011"
The scratch directory is /local2/temp
All of this information could be specified in an INI file, identical on all three nodes, as follows:
;
; This is the MSC Nastran Command Initialization File
; The default version is to be set to 2011.
;
version=2011.0
; Define conditional sections giving the appropriate sdir
; values when MSC Nastran is run locally.
[ s.hostname = sysnode1 ]
sdir=/local/temp
[ s.hostname = sysnode2 ]
sdir=/local1/temp
[ s.hostname = sysnode3 ]
sdir=/local2/temp
; Define conditional sections giving the appropriate
; remote access keywords when a "node" value,
; requesting remote execution, is specified.
;
Main Index
19
APPENDIX A
Configuring the Runtime Environment
[ node = sysnode1 ]
rsdir=/local/temp
< version = 2008.0 >
rcmd=/local/msc/bin/nast2008
< version = 2011.0 >
rcmd=/local/msc/bin/nast2011
[ node = sysnode2 ]
rsdir=/local1/temp
< version = 2011.0 >
rcmd=/local1/msc/bin/nast2011
[ node = sysnode3 ]
rsdir=/local2/temp
< version = 2008.0 >
rcmd = /local2/msc/bin/nast2008
< version = 2011.0 >
rcmd=/local2/msc/bin/nast2011
;
; This is the end of the Command Initialization file
;
Alternatively, the information could be split between an INI file and a system RC file, identical on all
three nodes, as follows:
In the INI file:
;
; This is the MSC Nastran Command Initialization File
; The default version is to be set to 2011.
;
version=2011.0
; Define conditional sections giving the appropriate
; remote access keywords when a "node" value,
; requesting remote execution, is specified.
;
[ node = sysnode1 ]
rsdir=/local/temp
< version = 2008.0 >
rcmd=/local/msc/bin/nast2008
< version = 2011.0 >
rcmd=/local/msc/bin/nast2011
[ node = sysnode2 ]
rsdir=/local1/temp
< version = 2011.0 >
rcmd=/local1/msc/bin/nast2011
[ node = sysnode3 ]
rsdir=/local2/temp
< version = 2008.0 >
rcmd = /local2/msc/bin/nast2008
Main Index
MSC Nastran 2012 Installation and Operations Guide
20
< version = 2011.0 >
rcmd=/local2/msc/bin/nast2011
;
; This is the end of the Command Initialization file;
In the system RC file, identical on all three nodes:
;
; This is the MSC Nastran system RC file.
;
; Define conditional sections giving the appropriate sdir
; values when MSC Nastran is run locally.
[ s.hostname = sysnode1 ]
sdir=/local/temp
[ s.hostname = sysnode2 ]
sdir=/local1/temp
[ s.hostname = sysnode3 ]
sdir=/local2/temp
;
; This is the end of the system RC file
;
Example 2:
Assumptions: User keywords defining "run type" and "data complexity" are needed and AUTOSPC,
AUTOSPCR, BAILOUT and ERROR PARAM values are to be set based on these keywords.
The nastran.kwds file could be:
; User Keywords
Runtype:{"prelim","development","final"};Analysis stage
Level : number # Data complexity level
;
The nastran.params file could be:
; PARAM keywords
Set_AutoSPC : AutoSPC : {"Yes","No"}
Set_AutoSP_CR : AUTOSPCR : {"yes","no"}
Bailout_Value : bailout : number
Set_Error : Error : number
;
Then, the system RC file could contain:
; RC file
[ runtype = prelim ]
set_autospc = yes
bailout_value = -1
set_error = 0
set_autosp_cr = yes
Main Index
21
APPENDIX A
Configuring the Runtime Environment
[ runtype = development ]
set_autospc=yes
bailout_value=0
set_error=-1
[runtype=final]
set_autospc=no
param,bailout,0
param,error,-1
param,autospcr,no
[level < 3]
; basic data complexity parameters
[level >= 3]
<level>8>
; advanced data complexity parameters
<level<=8>
; intermediate data complexity parameters
; End of RC file
Main Index
MSC Nastran 2012 Installation and Operations Guide
22
Symbolic Substitution
Introduction
Symbolic Substitution is a capability added to Nastran that allows a user to effectively modify a Nastran
data file using command line and RC file keyword specifications without actually editing the file. This
capability is very similar to environment variable expansion that happens in various command prompt
shells such as the Linux/UNIX Bourne, Korn and C shells and the Windows Command Prompt shell
when scripts are processed. It is also analogous in some ways to the capabilities provided by
programming language preprocessors, for example, the CPP preprocessor used by the various C/C++
compilers. The key feature of symbolic substitution is that these modifications do not affect the actual
data file but present the data read from the data file to the processing program as if it was the modified
data that was being processed.
Generally, symbolic substitution means that a data record is scanned to see if it contains special data
strings (that identify the symbolic variables) that specify symbolic substitution requests. If such
strings are found, the record is modified to replace the special data strings with user-defined substitution
(replacement) strings (the values currently associated with the symbolic variables, i.e., the variable
values) and it is this modified record that is actually processed. This symbolic substitution happens
before any other processing of the record occurs, thus making it transparent to the rest of the program
processing the data record. In the case of Nastran, this symbolic substitution processing will happen
immediately after a record is read from the Nastran data file and before any other processing (with the
possible exception of special processing required to satisfy licensing requirements) is performed.
Simple Examples
Two very simple examples illustrate how this capability could be used in Nastran data files. Note that
the details of the syntax are completely described in the following sections and may be ignored for now.
Also note that the examples do not deal with things such as managing the output from multiple Nastran
runs. These issues, involving, among other techniques, using command line or RC file keywords such
as "out=", "append=" and "old=yes", are beyond the scope of this document.
Example 1:
Suppose you want to make several tests where the thickness of a PSHELL element is to be varied. You
could do this by defining the thickness of the PSHELL element as a "symbolic variable" (identified using
the string "%thickness%"), setting a default value (using the "%defrepsym" statement) and
specifying the desired thickness on the command line (using the "REPSYM=" keyword). A very simple
data file (sym.dat) could be (where most of the BULK entries are in an include file named
"model.bdf", not shown here):
%defrepsym thickness=5.0
SOL 103
CEND
TITLE = 1st perturbation, t = %thickness%
ECHO = NONE
Main Index
23
APPENDIX A
Configuring the Runtime Environment
SUBCASE 1
METHOD = 100
SPC = 1
DISP = ALL
BEGIN BULK
EIGRL,100,,,6
PARAM,POST,0
PARAM,GRDPNT,0
$PBEAML Properties
PBEAML 2 1 I
70.0 60.0 60.0 3.3 5. 5.
$
$PSHELL Properties
$
pshell,1,1,%thickness%,1,,1
$
include 'model.bdf'
enddata
If the test is run using the following command line:
nast2008 sym repsym=thickness=1.0 ...
the test will run as if the "TITLE" and "pshell" records are:
TITLE = 1st perturbation, t = 1.0
and
pshell,1,1,1.0,1,,1
If the test is run using the following command line:
nast2008 sym repsym=thickness=3.5 ...
the test will run as if the "TITLE" and "pshell" records are:
TITLE = 1st perturbation, t = 3.5
and
pshell,1,1,3.5,1,,1
If the test is run without specifying any REPSYM setting for "thickness", e.g., using the following
command line:
nast2008 sym ...
the test will run as if the "TITLE" and "pshell" records are:
TITLE = 1st perturbation, t = 5.0
and
pshell,1,1,5.0,1,,1
Main Index
MSC Nastran 2012 Installation and Operations Guide
24
Example 2:
Suppose you have a test that contains two superelements, where the only difference between the data for
each superelement is the area of a PBAR element. Instead of having two different definitions, you could
have a single definition of the data in an include file, where the area of the PBAR is specified as a
symbolic variable. The include file (called "bar.bdf") could be:
%defrepsym area=1.
grid,2,,1.0,0.0,0.0
grid,3,,2.0,0.0,0.0
grid,4,,3.0,0.0,0.0,,123456
cbar,2,2,2,3,0.,1.,0.
cbar,3,2,3,4,0.,1.,0.
pbar,2,2,%area%,1.,1.,1.
mat1,2,1.e7,,.3
and the actual input file could be:
sol 101
cend
title=simple part se
echo=both
subcase 1
load=1
disp=all
elforce=all
begin bulk
grid,1,,0.0,0.0,0.0
grid,2,,1.0,0.0,0.0
cbar,1,1,1,2,0.,1.,0.
pbar,1,1,1.,1.,1.,1.
mat1,1,1.e7,,.3
force,1,1,,1.,1.,1.,1.
$
begin super=1
%setrepsym area=1.
include 'bar.bdf'
$
begin super=2
%setrepsym area=2.
include 'bar.bdf'
enddata
The first "include 'bar.bdf'" statement will be processed as if the pbar record is
pbar,2,2,1.,1.,1.,1.
and the second "include 'bar.bdf'" statement will be processed as if the pbar record is
pbar,2,2,2.,1.,1.,1.
Main Index
25
APPENDIX A
Configuring the Runtime Environment
Detailed Specifications
The use of the Symbolic Substitution capability is defined by a number of rules. These rules are
given in the following sections and provide the complete specification. Following the rules, there is
information about requesting report information and about error handling. Finally, there are some (again
simple) examples showing usage.
Symbolic Substitution Rules
The following rules define the symbolic substitution user interface. The descriptions start with the rules
for variable naming, followed by the rules for defining the replacement width information, followed by
the various keywords and statements used to control symbolic substitution.
Variable Naming
The rules for naming symbolic substitution variables are:
Symbolic variable names are not case-sensitive, are a maximum of 32 characters long and may
not contain leading, trailing or embedded blanks or special characters including (_). Variable
names must start with an alphabetic character followed by zero or more alphabetic or numeric
characters. For example:
The variable name "VaRiaBLe1" is the same as "VARIABLE1" and "variable1"
The following variable names are valid:
The following variable names are not valid:
Unless symbolic variable values are quoted, they are not case-sensitive and may not contain
leading, trailing or embedded blanks or percent (''%') characters. The quoting rules are given
below.
abcdef
abc123
Name1
123abc Does not start with an alphabetic character
a bcd Contains an embedded blank
abc& Contains an invalid character ('&')
/def Does not start with an alphabetic character
_abc123 Uses an underscore in the name.
Main Index
MSC Nastran 2012 Installation and Operations Guide
26
Substitution Field Width Specification
The ability to control the appearance of any symbolic substitution is an important requirement when
generating data for a program such as Nastran. The result of a symbolic substitution request is identified
as a field. Substitution field width information can be taken by default, specified in the data file or
specified using command line and/or RC file keywords. These methods are explained below.
The rules for defining substitution field width information are:
Symbolic variable substitution is, by default, exact. That is, the number of characters occupied
by the symbolic symbol replacement is exactly the same as the replacement value. However,
this default replacement processing can be controlled by specifying the substituted field width,
the field precision and the justification within the field. This information is specified using the
syntax
-w.p
where the -, w and p are all optional and have the following meanings.
The field width specification (w) defines the minimum number of characters the field is to have
as a decimal integer value. If the replacement value has fewer characters than the field width,
it will be padded with spaces on the left (by default) or on the right (if the left justification flag
is specified). If the replacement value has more characters than the field width and if no
precision value was specified, the entire replacement string will be used. A field width value
of 0 (zero) is equivalent to omitting the width specification. Note that a negative width value
will be processed as if the left-justification flag was specified (see below) since a negative
field width is meaningless.
The field precision specification (p) defines the maximum number of characters the field is to
have. The format is a period (.) followed by a decimal integer value. If the replacement value
length exceeds the precision value, only the last p (by default) or the first p (if the left
justification flag is set) characters of the replacement value will be used. A field precision
value of 0 (zero) (or a negative value) is equivalent to omitting the precision specification.
If both field width and field precision are specified and are positive, the precision value cannot
be less than the width value. If it is, it will be reset to the field width.
The - character is the left-justification flag and specifies that the replacement value is to
be left-justified within the field. If this character is omitted, the replacement value will be
right-justified within the field.
For example, the width, precision and justification of a typical field in the Bulk Data portion of a
Nastran data file is:
-8.8
meaning that the field is exactly eight characters wide and that data is to be left-justified within
the field. For a wide-format Bulk Data record, this specification would be:
-16.16
The specification for an exact replacement, i.e., where the replaced field is exactly the size of the
replacement value, is:
0.0
Main Index
27
APPENDIX A
Configuring the Runtime Environment
To simplify width specification for Nastran widths, the following (case-insensitive) synonyms
for common widths are available and may be used wherever a width specification can be used:
It is very important to note that there are two distinct portions to a Nastran data file, that part that is before
the first BEGIN statement and that has free format, and that part that is after the first BEGIN statement
(the Bulk Data Section) and often has fixed format fields. Because of this, two different sets of field
width information are maintained for use when field width information is not explicitly specified as part
of a symbolic substitution request, one for use before the first BEGIN statement and one for use after the
first BEGIN statement.
Defining Variable Values and Width Information
Symbol names and associated values and symbol width specifications may be set using keywords on the
command line or in RC files and may be set using special statements in the Nastran data file itself. Each
keyword and statement is explained in detail.
Using Command Line or RC File Keywords
Setting Variable Value Using REPSYM
Symbolic variables and associated values may be set on the Nastran command line or in RC files using
the keyword
repsym=<varname>=<varvalue>
where <varname> specifies the name of the symbolic variable and <varvalue> specifies the value
to be associated with the variable name. For example,
repsym=abc=1.23e-5
Setting Variable Width Information Using REPWIDTH
Symbolic variable substitution default width information may be set on the Nastran command line or in
RC files using the keyword
repwidth=<widthinfo1>,<widthinfo2>
where <widthinfo1> specifies the default width information for the portion of the Nastran data file
before the BEGIN statement and <widthinfo2> specifies the default width information for the
portion of the Nastran data file after the BEGIN statement. Each is specified using a -w.p specification
or as one of the synonyms, as described previously. If either width specification is omitted, the current
default for that section is not changed. Note that the separating comma is required if the Bulk Data
Section width value is to be set, i.e., if <witdhinfo2> is specified. For example,
repwidth=12,bulk
exact is equivalent to 0.0
bulk is equivalent to -8.8
wide is equivalent to -16.16
Main Index
MSC Nastran 2012 Installation and Operations Guide
28
specifies that symbolic substitution default width is to be 12.0 before the BEGIN statement is
encountered and -8.8 after the BEGIN statement is encountered and
repwidth=,bulk
specifies that symbolic substitution default width is to be EXACT (or 0.0, the default) before the BEGIN
statement is encountered and -8.8 after the BEGIN statement is encountered.
Just as with other Nastran command line or RC file keywords, the REPSYM and REPWIDTH keywords
are not case-sensitive.
Using Special Statements in a Nastran Data File
Setting Values Using setrepsym
Symbolic variables and associated values may be set in a Nastran data file using the following statement:
%setrepsym <varname>=<varvalue>
where the '%' character must be in column 1 and nothing else may appear in the record except for
optional comments following <varvalue>, where the start of the comment is indicated by a ' $'
(blank, currency symbol). The setrepsym string is not case-sensitive and at least one blank must
separate this string from the <varname> specification. For example,
%setrepsym abc=1.23e-5
Clearing ("Unsetting") Values Using unsetrepsym
A symbolic variable value set using the %setrepsym statement may cleared ("unset") in a Nastran data
file using the following statement:
%unsetrepsym <varname>
where the '%' character must be in column 1 and nothing else may appear in the record except for optional
comments following <varname>, where the start of the comment is indicated by a ' $'. The
unsetrepsym string is not case-sensitive and at least one blank must separate this string from the
<varname> specification. For example, to clear the variable abc, use
%unsetrepsym abc
Setting Default Values Using defrepsym
Default variable values can be set in a Nastran data file using the following statement:
%defrepsym <varname>=<varvalue>
where the '%' character must be in column 1 and nothing else may appear in the record except for optional
comments following <varvalue>, where the start of the comment is indicated by a ' $'. The
defrepsym string is not case-sensitive and at least one blank must separate this string from the
<varname> specification. The specified value will be used only if a value for <varname> was not
previously set, i.e., by a repsym keyword on the command line or in an RC file or by a %setrepsym
statement previously specified in the data file that has not been unset by a %unsetrepsym statement.
For example,
Main Index
29
APPENDIX A
Configuring the Runtime Environment
%defrepsym abc=2.46e+2
Clearing ("Unsetting") Default Values Using undefrepsym
The default value for a symbolic variable may cleared ("unset") in a Nastran data file using the following
statement:
%undefrepsym <varname>
where the '%' character must be in column 1 and nothing else may appear in the record except for
optional comments following <varname>, where the start of the comment is indicated by a ' $'. The
undefrepsym string is not case-sensitive and at least one blank must separate this string from the
<varname> specification. For example, to clear the default value associated with variable abc, use
%undefrepsym abc
Setting Width Information Using setrepwidth
Symbolic variable substitution default width information may be set in a Nastran data file using the
following statement:
%setrepwidth <widthinfo1>,<widthinfo2>
where the '%' character must be in column 1 and nothing else may appear in the record except for
optional comments following <widthinfo2>, where the start of the comment is indicated by a ' $'.
The setrepwidth string is not case-sensitive and at least one blank must separate this string from the
width specifications. There may not be any blanks within the width specifications. <widthinfo1>
specifies the width information for the portion of the Nastran data file before the BEGIN statement and
<widthinfo2> specifies the width information for the portion of the Nastran data file after the BEGIN
statement. Each is specified using a -w.p specification or as one of the synonyms, as described above.
If either width specification is omitted, the current width information for that section is not changed.
Note that the separating comma is required if the Bulk Data Section width value is to be set, i.e., if
<widthinfo2> is specified. For example,
%setrepwidth 0.0,wide
specifies that the symbolic substitution width specification is to be 0.0 before the BEGIN statement and
is to be -16.16 after the BEGIN statement.
Clearing ("Unsetting") Width Information Using unsetrepwidth
Symbolic variable substitution width information set using the %setrepwidth statement may be
cleared in a Nastran data file using the following statement:
%unsetrepwidth
where the '%' character must be in column 1 and nothing else may appear in the record except for
optional comments following the unsetrepwidth string, where the start of the comment is indicated
by a $'. The unsetrepwidth string is not case-sensitive and must be followed by at least one blank.
This statement does not have any arguments and clears both width specifications.
Main Index
MSC Nastran 2012 Installation and Operations Guide
30
Setting Default Width Information Using defrepwidth
Default symbolic variable substitution width information may be set in a Nastran data file using the
following statement:
%defrepwidth <widthinfo1>,<widthinfo2>
where the '%' character must be in column 1 and nothing else may appear in the record (except for
optional comments following <widthinfo2>, where the start of the comment is indicated by a ' $'.
The defrepwidth string is not case-sensitive and at least one blank must separate this string from the
width specifications. There may not be any blanks within the width specifications. <widthinfo1>
specifies the default width information for the portion of the Nastran data file before the BEGIN
statement and <widthinfo2> specifies the default width information for the portion of the Nastran
data file after the BEGIN statement. Each is specified using a -w.p specification or as one of the
synonyms, as described above. If either width specification is omitted, the current width information for
that section is not changed. Note that the separating comma is required if the Bulk Data Section width
value is to be set, i.e., if <widthinfo2> is specified. For example,
%defrepwidth 0.0,wide
specifies that default symbolic substitution is to be 0.0 before the BEGIN statement and is to be -
16.16 after the BEGIN statement.
Clearing ("Unsetting") Default Width Information Using undefrepwidth
Default symbolic variable substitution width information may be cleared in a Nastran data file using the
following statement:
%undefrepwidth
where the '%' character must be in column 1 and nothing else may appear in the record except for optional
comments following the undefrepwidth string, where the start of the comment is indicated by a $'.
The undefrepwidth string is not case-sensitive and must be followed by at least one blank. This
statement does not have any arguments and clears both default width specifications.
General Information For Special Statements
The %setrepsym, %unsetrepsym, %defrepsym, %undefrepsym, %setrepwidth,
%unsetrepwidth, %defrepwidth and %undefrepwidth statements are deleted, logically, from
the data file and will never be processed by the rest of Nastran unless an error is encountered while they
are being processed. This is discussed in the Error Handling on page 34.
Requesting Symbolic Substitution
Symbolic variable substitution will occur when a string having the form
%<varname>,<widthinfo>:<varvalue>%
is found anywhere within a Nastran data file, except that this string may not span records, i.e., the
substitution request must be on a single record (line). The leading and trailing '%' characters are required
as is the <varname> field. The <widthinfo> field is optional. If it is omitted, the comma (,)
separating it from the <varname> field may be omitted and the rules for determining what width
Main Index
31
APPENDIX A
Configuring the Runtime Environment
specification will be used are discussed below. The <varvalue> field is optional and provides a way
of specifying a default value, i.e., the local default value, as described below. If it is omitted, the colon
(:) separating it from the <varname> (or <widthinfo>) field may be omitted. The rules for
determining what symbolic value will be used as the substitution value are discussed below. For
example, if the symbolic variable abc is to be replaced by its current value with no special processing
(or if default width processing is to be used), the substitution request would be:
%abc%
If the symbolic variable is to be replaced by its current value, with the minimum field width to be 12
characters and with the value always to be left-justified, the substitution request would be:
%abc,-12%
Quoting Rules For Symbolic Variable Values
If a symbolic variable value is case-sensitive, if it contains leading, trailing or embedded blanks
or if it contains percent characters, tab characters or other special characters, it must be quoted.
(Note that "escape" sequences such as '\t' or '\n' are not given any special treatment; that is,
they are left as is.)
If the value is part of a repsym keyword command-line specification, the quoting rules of
the command shell being used apply.
If the value is part of a repsym keyword specified in an RC file, it must be enclosed in single
quotes (').
If the value is part of a %setrepsym or %defrepsym record or if it specified as the local
default value in a symbolic substitution request, quoting a symbolic variable value means
enclosing the value in one of the following pairs of characters:
If the first non-blank character encountered in a variable value specification is one of the
starting quote characters, the variable value must be ended by the associated ending quote
character. The actual variable value will be the (possibly null) string between (but not
including) the starting and ending quote characters. If the variable value starts with one of the
starting quote characters, it must be quoted using an alternate quote character.
Starting Quote Character Ending Quote Character
" "
' '
/ /
\ \
[ ]
{ }
( )
Main Index
MSC Nastran 2012 Installation and Operations Guide
32
General Rules For Symbolic Variable Substitution
Nested symbolic substitution is not supported. Even if the value associated with a symbolic
variable name is, itself, in the format of a symbolic variable substitution request, that request will
be ignored. That is, after symbolic variable substitution has occurred, the substituted string is
not re-scanned.
Determining what symbolic variable value will be used when a variable substitution request is
encountered depends on where the variable value associated with the specified variable name
was set. The first value encountered in the following hierarchy is the value that will be used:
A value specified in the Nastran data file using the %setrepsym statement, if there is one
active, i.e., if it has not been deactivated by a %unsetrepsym statement.
A value specified on the Nastran command line or in RC files using the repsym keyword.
As part of the variable symbol substitution request, using the local default value, if there is
one.
A value specified in the Nastran data file using the %defrepsym statement, if there is one
active, i.e., if it has not been deactivated by a %undefrepsym statement.
This precedence follows normal Nastran ordering, i.e., "the data file wins," while still providing
great flexibility. Also, the ordering of the last two items in this hierarchy allows a user to set all
defaults except for special cases and follows the idea that the specification "closest" to the use is
the one used. If no replacement value is found, the substitution request will be ignored and the
record will be unchanged.
Determining what symbolic width specification will be used when a variable substitution request
is encountered depends on where the width information has been specified and on the part of the
Nastran data file that is being processed, i.e., is the variable substitution request before or after
the first BEGIN statement. The first width specification value encountered in the following
hierarchy is the specification that will be used:
A value specified in the symbolic substitution request itself, i.e., if a <widthinfo> entry
was specified as part of the symbolic substitution request.
A value specified on a %setrepwidth statement corresponding to the current section in the
Nastran data file, if there is one active, i.e., if it has not been deactivated by an
%unsetrepwidth statement.
A value specified on the Nastran command line or in RC files using the repwidth keyword
corresponding to the current section in the Nastran data file.
A value specified in the Nastran data file using the %defrepwidth statement corresponding
to the current section in the Nastran data file, if there is one active, i.e., if it has not been
deactivated by a %undefrepwidth statement.
The program default value of exact (0.0).
This precedence also follows normal Nastran ordering, i.e., "the record wins followed by the
data file wins," while still providing great flexibility.
When running in licensing "Interlock" mode, i.e., in CRC validation mode, the following
restrictions will be in effect. If a restriction is violated, Nastran processing will be terminated.
Main Index
33
APPENDIX A
Configuring the Runtime Environment
The %setrepsym, %unsetrepsym, %defrepsym and %undefrepsym statements are
not allowed. Also, specifying a default value within the symbolic substitution request is not
allowed. That is, symbolic variable values may only be set using the repsym keyword on
the command line or in an RC file. Note that the %setrepwidth, %unsetrepwidth,
%defrepwidth and %undefrepwidth statements are allowed.
A maximum of two symbolic substitution specifications are allowed per record and a
maximum of ten symbolic substitution requests are allowed in the entire input data file.
Interlock CRC calculations will be made on the input record before symbolic substitution
occurs. Note that any alterations to the record made as part of the CRC calculation processing
will not affect symbolic substitution processing.
Requesting Symbolic Substitution Replacement Information Using REPINFO
A report of what symbolic substitutions were made is generated at the end of Nastran
processing, with the level of detail in the report controlled by an "information level" flag set
using the
repinfo=n
keyword, where n is an integer number that specifies the level of detail desired. The
meanings the various values for n are as follows:
The report is written to the .f06 file. If there is not enough dynamic memory available to save the
report information, the repinfo level may be reduced. When running in Nastran, the default
is repinfo=1. Otherwise, repinfo=0 will be forced.
Just as with other Nastran command line or RC file keywords, the REPINFO keyword is not
case-sensitive.
0 suppress the report altogether
1 report the various values assigned using the repsym keyword
2 same as 1 except add the various values assigned using the setrepsym statement
3 same as 2 except add the various values assigned using the defprepsym statement
4 same as 3 except add the various values assigned as local default values
5 same as 1 except add all locations where the specified repsym value was used
6 same as 2 and 5 except add all locations where the specified setrepsym value was
used
7 same as 3 and 6 except add all locations where the specified defrepsym value was
used
8 same as 4 and 7 except add all locations where local default values were used.
Main Index
MSC Nastran 2012 Installation and Operations Guide
34
Error Handling
If an error is encountered processing a setrepsym, unsetrepsym, defrepsym, undefrepsym,
setrepwidth, unsetrewidth, defrepwidth or undefrepwidth statement, a comment
string will be added to the record giving the error information and the record will be passed to Nastran
(or the application reading the data file) as if the record was a normal Nastran data record. If an error is
encountered in a record containing a symbolic substitution request, the symbolic substitution request will
not be processed and, if repinfo=1 or greater is in effect, a message giving information about the error
will be written to the .log file. It is expected that the statements in error will not be valid Nastran
statements and so will be flagged as an error.
Examples
1. The value on an OPTION statement is to be settable using the command line, taking a default
value of OPT1val (case-sensitive) if no command line value is set. The OPTION statement
could be
OPTION=%Option:OPT1val%
and the command line parameter that would be used to set OPTION to a different value, OP2VAL
(not case-sensitive), would be
RepSym=Option=op2val
2. An INCLUDE file contains records that are to be used four times in the Bulk Data Section of a
Nastran data file, with the only difference being the value in Field 3 of one record. The first time
the file is used, this field must contain the value 1.234, the second time this field must contain the
value 4.567 and the last two times this field must contain the value -12.578. In all cases, the
replacement field must be eight characters wide and the data must be left-justified in the field.
Assuming that the symbolic variable is DATFL3 and that the include file name is incl.data, this
could be done as follows:
In the include file, specify the following statements before the record to be modified:
%DefRepSym datfl3=-12.578
then the record to be modified could be specified as follows:
FL1 FL2 %datfl3%FL4 FL5 FL6
and, for completeness, specify the following record after the record to be modified:
%Undefrepsym datfl3
Then the data file would contain:
. . .
%setrepsym DATFL3=1.234
%DefRepWidth ,bulk
include incl.data
. . .
%setrepsym DATFL3=4.567
include incl.data
%Unsetrepsym datfl3
. . .
include incl.data
Main Index
35
APPENDIX A
Configuring the Runtime Environment
. . .
include incl.data
Main Index
MSC Nastran 2012 Installation and Operations Guide
36
Main Index
App. B: Glossary of Terms MSC Nastran 2012 Installation and Operations Guide
B
Glossary of Terms
Main Index
MSC Nastran 2012 Installation and Operations Guide
38
3060 A User Fatal Message indicating that authorization to run MSC Nastran
has been denied (see Managing MSC Nastran Licensing on page 31).
6080 A User Warning Message indicating that timing blocks must be generated
for your computer (see Generating a Timing Block for a New Computer
on page 59).
acct MSC accounting file directory, install_dir/acct on UNIX and
install_dir/acct on Windows. Also, the program
(install_dir/prod_ver/arch/acct on UNIX and
install_dir\prod_ver\arch\acct.exe on Windows) that updates the current
months accounting data file. See MSCACT for the program source.
architecture RC
files
The RC files residing in the install_dir/conf/arch directory on UNIX
and in the install_dir\conf\arch directory on Windows. See Command
Initialization and Runtime Configuration Files on page 2 in Appendix A for
information about the names of these files and Table 3-1 for a listing of
architecture names.
archive A test problem library (install_dir/prod_ver/misc/archive on UNIX and
install_dir\prod_ver\misc\archive on Windows) that contains test decks
that are no longer part of either the DEMO or TPL libraries. These files
may be incompatible with MSC.Nastran V70.5 or may use features that
are no longer supported.
ASSIGN A File Management Section (FMS) statement that is used to assign
physical files to DBsets or FORTRAN files.
authorize Command line and RC file keyword that is used to set the authorization
code required to run MSC Nastran.
basename The part of a pathname exclusive of the directory and file type (e.g., the
basename of /temp/myfile.dat. is myfile).
buffer pool A disk cache of GINO blocks.
BUFFPOOL The NASTRAN statement keyword that sets the size of the buffer pool
(see The NASTRAN Statement on page 12).
BUFFSIZE One plus the number of words in a GINO physical record. Also, the
NASTRAN statement keyword that sets the default buffer size (see The
NASTRAN Statement on page 12).
conf The MSC configuration file directory (install_dir/conf on UNIX and
install_dir\conf on Windows) contains the system, architecture, and node
RC files and other site-specific files.
counted license A counted license is a FLEXlm license that limits the number of
concurrent executions of MSC Nastran. Counted licenses always require
a FLEXlm license server.
Main Index
39
Appendix B
Glossary of Terms
daemon A UNIX program that runs in the background and provides services to the
operating system and to users. Daemons are generally started when the
system is bootstrapped and terminate when the system shuts down.
dat Default input data file type.
DBALL Default DBALL DBset file type. The DBALL DBset contains your model
and results.
DBL700 Specifies that SOL 700 will use double precision. This keyword is only
used if PATH=3 is specified on the SOL 700 entry and no sol700.pth file
exists. The default is dbl700=no. Note that significant performance
degradation will occur if dbl700=yes is specified.
DBset Database file set.
DDLPRT Utility program that prints the contents of the results database (XDB) data
definition language database (install_dir/prod_ver/arch/dbc.xdb on UNIX
and install_dir\prod_ver\arch\dbc.xdb on Windows) and illustrates the
batch recovery of the data definition language.
DDLQRY Utility program that prints the contents of the results database (XDB) data
definition language database (install_dir/prod_ver/arch/dbc.xdb on UNIX
and install_dir\prod_ver\arch\dbc.xdb on Windows) and illustrates the
interactive recovery of the data definition language.
del Delivery database library,
DEMO The demonstration problem library (install_dir/prod_ver/nast/demo on
UNIX and install_dir\prod_ver\nast\demo on Windows) contains a
selection of MSC Nastran input files that are documented in the MSC
Nastran Demonstration Problem Manual.
DEMO1 Sample program that prints information from a graphics database file.
DEMO2 Sample program that prints information from a graphics database file.
DMAP Direct Matrix Abstraction Program, which is the programming language
of the MSC Nastran solution sequences.
DMP Distributed Memory Parallel. In MSC Nastran, DMP execution is enabled
by the dmparallel keyword.
DMP700 Specifies the number of hosts for an SOL 700 run. This keyword is only
used if PATH=3 is specified on the SOL 700 entry and no sol700.pth file
exists. The default hosts are the same for MSC Nastran.
doc Documentation file directory.
EAG FFIO Engineering Applications Group Flexible File I/O, an asynchronous
database I/O library on linuxipf systems. See the ff_io keyword, (p. 59)
ESTIMATE Utility that estimates memory and disk requirement of a data file and make
suggestions on improving the performance of MSC Nastran.
Main Index
MSC Nastran 2012 Installation and Operations Guide
40
F04 The F04 file is created by MSC Nastran and contains a module execution
summary as well as a database information summary. The F04 file has the
file type.f04".
F06 The F06 file is created by MSC Nastran and contains the numerical results
of the analysis. The F06 file has the file type .f06".
file locking A mechanism to prevent multiple MSC Nastran jobs from interfering with
one another. For example, two jobs attempting to write to the same DBset
interfere with one another, whereas two jobs reading the delivery database
do not interfere with one another.
file mapping A mechanism to use the systems virtual paging system to access a file.
MSC Nastran can use file mapping to access GINO files. See Table 4-7
for a listing of systems that support file mapping.
FMS File Management Section of the input file, which is used to attach and
initialize DBsets and FORTRAN files.
gentim2 MSC Nastran job that determines the timing constants for your computer.
GINO The MSC Nastran database subsystem.
GINO block A block of data transferred by GINO.
HEATCONV Utility program that converts pre-MSC.Nastran V68 heat-transfer data
files to the MSC.Nastran Version 68 format.
HIPPI High Performance Parallel Interface. An ANSI standard (ANSI X3T9.3
document number X3T9.3/90-043, 1990) interface used in high-
performance environments.
IEEE Institute of Electrical and Electronics Engineers, Inc. A professional
society. The floating point formats and, to a lesser extent, algorithms used
on most MSC Nastran computers are defined by IEEE Standard 754.
IFPBUFF Specifies the physical record size, in words, of MSC Nastran IFPStar
database. The physical I/O size is IFPBUFF-1 words. The maximum value
of IFPBUFF is 65537 words.
INCLUDE A general MSC Nastran input file statement that inserts an external file
into the input file. INCLUDE statements may be nested.
INIT The INIT statement is part of the File Management Section (FMS) and is
used to create a temporary or permanent DBset.
large file A file on a 32-bit system that can be 2 gigabytes or larger. All files on a
64-bit system can be large files. See Table 4-7 for a listing of systems that
support large files.
local RC files The RC files residing in the directory containing the input data file. See
Command Initialization and Runtime Configuration Files on page 2 in
Appendix A for information about the names of these files.
Main Index
41
Appendix B
Glossary of Terms
LOG The LOG file is created by MSC Nastran and contains system information
as well as system error messages. The LOG file has the file type .log.
MASTER Default MASTER DBset file type. The MASTER DBset contains the
names of other database members and indices.
MATTST Sample program that reads the OUTPUT4 matrix files.
mem700 The default memory (in MegaWords) used the dynamic portion of
SOL 700 runs. This keyword is only used if PATH=3 is specified on the
SOL 700 entry and no sol700.pth file exists.
memory Command line keyword that is used to define the amount of memory
allocated for open core.
MPI Message Passing Library. An industry-standard library for message
passing programs.
MPL The module properties list is a table that defines the properties of DMAP
modules.
MSC.ACCESS FORTRAN-callable subroutine library that reads and writes results
database (XDB) files.
MSCACT Utility program that generates accounting reports. The source for this
utility and the accounting file update program are maintained in the same
file (install_dir/prod_ver/util/mscact.c on UNIX and
install_dir\prod_ver\util\mscact.c on Windows).
MSGCMP Utility program that compiles a text file to create a message catalog.
NAO The Network Authorization Option of MSC Nastran. The implementation
in MSC.Nastran Version 70.5 is not compatible with earlier versions of
NAO.
ndb Default neutral-format results database file type.
neu Default neutral-format plot file type. Only created by NEUTRL.
NEUTRL Utility program that converts binary plot (.plt) files to neutral plot (.neu)
files.
node RC files The RC files residing in the install_dir/conf/net/nodename directory on
Unix and install_dir\conf\net\nodename directory on Windows. See
Command Initialization and Runtime Configuration Files on page 2 in
Appendix A for information about the names of these files.
NUSR The node-locked license enforcement of the maximum number of users
concurrently running MSC Nastran. See Enabling Account ID Validation
on page 41 for additional information.
on2 Default neutral-format OUTPUT2 file type.
op2 Default binary-format OUTPUT2 file type.
open core Amount of working memory in words.
Main Index
MSC Nastran 2012 Installation and Operations Guide
42
OPTCONV Utility program that converts pre-MSC.Nastran V68 optimization and
design-sensitivity data files to the MSC.Nastran Version 68 format.
pch Default punch file type.
PLOTPS Utility program that converts binary (.plt) or neutral (.neu) plot files to
PostScript (.ps) files.
plt Default binary-format plot file type.
ps Default PostScript plot file type.
RC file Runtime configuration file that is used by MSC Nastran to control
execution parameters.
RCOUT2 Utility program that converts a neutral OUTPUT2 (.on2) file to a binary
OUTPUT2 (.op2) file.
RECEIVE Utility program that converts neutral results database (.neu) files to binary
results database (XDB) files.
RFA Rigid-format alter library, install_dir/prod_ver/nast/rfa on UNIX and
install_dir\prod_ver\nast\rfa on Windows. (This directory is now
empty.)
SCR300 Default SCR300 DBset file type.
SCRATCH Default SCRATCH DBset file type.
sdir Keyword that is used to set the directory for temporary scratch files
produced by MSC Nastran.
SMEM Scratch memory area for memory-resident database files.
smemory Command line keyword to set SMEM.
SMP Shared Memory Parallel. In MSC Nastran, SMP execution is enabled by
the parallel keyword.
SMPLR Sample program that reads graphics database files.
SSS Structured Solution Sequences. The delivery database files
(SSS.MASTERA, SSS.MSCSOU, and SSS.MSCOBJ) are found in
install_dir/prod_ver/arch on UNIX and install_dir\prod_ver\arch on
Windows; the source files are found in install_dir/prod_ver/nast/del on
UNIX and install_dir\prod_ver\nast/del on Windows.
SSSALTER Additional alter and error corrections library,
install_dir/prod_ver/misc/sssalter on UNIX and
install_dir\prod_ver\misc\sssalter on Windows.
SUN_IO An asynchronous database read library on Solaris systems. See the
sun_io keyword, (p. 93).
SYS An ASSIGN statement parameter that is used to specify special
machine-dependent information. File locking and file mapping of
database files are controlled through the SYS parameter.
Main Index
43
Appendix B
Glossary of Terms
sysfield The global SYS parameter that can be specified on the command line or in
an RC file.
system RC files The RC files residing in the install_dir/conf directory on UNIX and in
the install_dir\conf directory on Windows. See Command Initialization
and Runtime Configuration Files on page 2 in Appendix A for information
about the names of these files.
SYSTEM(x) System cells that are used by MSC Nastran to control analysis parameters.
TABTST Sample program that reads binary-format OUTPUT2 files.
TPL The test problem library (TPL, install_dir/prod_ver/nast/tpl on UNIX and
install_dir\prod_ver\nast\tpl on Windows) contains a general selection of
MSC Nastran input files showing examples of most of the MSC Nastran
capabilities, in general, these files are not documented.
TRANS Utility program that converts binary results database (XDB) files to neutral
results database (.neu) files.
type The part of the pathname exclusive of the directory and basename (e.g., the
file type of myfile.dat is .dat).
UFM A User Fatal Message that describes an error severe enough to terminate
the program.
UFM 3060 A User Fatal Message indicating that authorization to run MSC Nastran
has been denied (see Using the mscinfo Command (UNIX) on page 30).
UIM A User Information Message that provides general information.
uncounted license An uncounted license is a FLEXlm license that allows any number of
concurrent executions of MSC Nastran on a given node. An uncounted
license does not require a FLEXlm license server.
user RC files The RC files residing in the $HOME directory on UNIX and in the
%HOMEDRIVE%%HOMEPATH% directory on Windows. See
Command Initialization and Runtime Configuration Files on page 2 in
Appendix A for information about the names of these files.
util Utility program library, install_dir/prod_ver/util on UNIX and
install_dir\/prod_ver\util on Windows.
UWM A User Warning Message that warns of atypical situations. You must
determine whether a problem exists in the analysis.
Main Index
MSC Nastran 2012 Installation and Operations Guide
44
UWM 6080 A User Warning Message indicating that timing blocks must be generated
for your computer (see Generating a Timing Block for a New Computer
on page 59).
version A file is versioned by appending a dot followed by a version number to
the files name. The latest version of a file does not have a version number,
all earlier versions do, with the oldest having the smallest version number
and the latest having the highest version number.
XDB The XDB file is created by MSC Nastran and contains results information
for use by various post-processing programs. See the POST parameter
in Parameters on page 691 of the MSC Nastran Quick Reference Guide
for further information on generating XDB files. XDB files are not
versioned. The XDB file has the file type .xdb.
Main Index
App. C: Keywords and Environment Variables MSC Nastran 2012 Installation and Operations Guide
C
Keywords and Environment
Variables
Keywords
Environment Variables
Other Keywords
n
f i l es
Main Index
95
Appendix C
Keywords and Environment Variables
Symbolic names must be 16 characters or less, the value assigned to the
symbolic name must be 256 characters or less. If the symbolic name used in
an ASSIGN or INCLUDE statement or in command line arguments is not
defined, it is left in the filename specification as is.
For example, many of the TPL and DEMO input data files have ASSIGN
statements such as the following:
ASSIGN 'MASTER=DBSDIR:abc.master'
The string "DBSDIR:" specifies a symbolic name that is to be replaced by
another string. The replaced string is defined by the "symbol=" keyword (or
"lsymbol=" keyword if "node" was not specified) in an initialization or RC file,
on the command line, or as environment variable. For example,
(UNIX) symbol=DBSDIR=/dbs
(Windows) symbol=DBSDIR=d:\dbs
When the previous ASSIGN statement is processed, the filename assigned to
the logical name MASTER is /dbs/abc.master on UNIX and
d:\dbs\abc.master on Windows. An alternate way of defining
symbolic names is through the use of environment variables. For example,
typing the following command
export DBSDIR=/dbs
at a Korn shell prompt, or
setenv DBSDIR /dbs
at a C-shell prompt, or
set DBSDIR=d:\dbs
at a Windows shell prompt, is equivalent to the "symbol" keyword definition.
Note: If a symbolic name is defined by both a symbol statement in an RC file and by
an environment variable, the symbol statement value will be used.
Main Index
MSC Nastran 2012 Installation and Operations Guide
96
The section titled Environment Variables on page 105 contains a list of
environment variables that are automatically created by the nastran command.
Of particular interest to the logical symbol feature are the OUTDIR and
DBSDIR variables. These variables refer to the directory that will contain the
output files (set using the "out" keyword) and the directory that will contain
the permanent database files (set using the "dbs" keyword), respectively.
sysfield sysfield=option,option,... Default: None
Defines a global SYS value that is applied to Dbsets. Each option must have
one of the following formats:
keyword=value
or
LNAMEXP(keyword=value,keyword=value,...)
where:
LNAMEXP = specifies a logical name expression using the UNIX/Windows file
name specification format
Characters may be specified in any case. Internally, they are converted to upper-case before
they are used.
Most characters in a substitution pattern match themselves but you can also use some special
pattern-matching characters in the pattern.
These special characters are:
* = Matches any string, including the null string.
? = Matches any one character.
[...] = Matches any one of the characters enclosed in the square brackets.
Main Index
97
Appendix C
Keywords and Environment Variables
[!...] = Matches any one of the characters enclosed in the square brackets.
Matches any one character other than one of the characters that
follow the exclamation mark within square brackets.
Inside square brackets, a pair of characters separated by a - (minus)
specifies a set of all characters that collate within the range of that
pair, as defined by the ASCII collating sequence, so that [a-dy] is
equivalent to [abcdy].
keyword=value = Specifies a keyword and value to be used for the Dbset file. If the
entry is part of an option qualified by an LNAMEXP expression, the
keyword and value will only be used for a Dbset file whose logical
name is selected by the expression specified by LNAMEXP.
Otherwise, the keyword and value will be used for all Dbset files.
Note that a null LNAMEXP expression will match any logical name.
The "sysfield" keyword may be specified more than once. The options are
processed in the order specified on the various specifications. If multiple
"keyword=value" options specify the same keyword, the last one encountered
is the one that is used. You may use the "whence" keyword to see the
"sysfield" keyword values. Also, the "sysfield" keywords are listed in the
LOG file.
See the sections titled Using the SYS Field on page 118 or SYS Parameter
Keywords on page 102 for details on the valid keyword options.
Example: prod_ver nastran example
sysfield=lock=no
This example disables file locking for all Dbsets.
Example: prod_ver nastran example
sysfield=lock=no
sysfield=scr*(mapio=yes,lock=yes)
This example disables file locking for all files and then enables filemapping
("mapio=yes") and turns file locking back on for Dbsets whose logical
names start with "SCR". The end result is that file locking is disabled for all
Dbsets except those whose logical names start with "SCR" and file mapping
and file locking are enabled for Dbsets whose logical names start with "SCR".
Main Index
MSC Nastran 2012 Installation and Operations Guide
98
sysn sysn=value Default: None
Sets the SYSTEM(n) cell to value. This keyword may be repeated any number
of times. All non-repeated cells are used, but only the last repeated cell is used.
If there is a "name" associated with the SYSTEM(n) value, that keyword will
also be set to value. The System Cell number to System Cell name equivalence
is listed in the nastran Command and NASTRAN Statement on page 1 of the
MSC Nastran Quick Reference Guide. The form "system(n)=value" may be
used, but the entire keyword-value string must be quoted when used on a
UNIX command line.
Example: prod_ver nastran example
sys114=200
or prod_ver nastran example
"system(114)=200"
These examples set SYSTEM(114) to 200. The second example shows how to
quote the parenthetic form. Also, in this example, since SYSTEM(114) has the
name "BUFFPOOL", the value of the "buffpool" keyword is also set to 200.
t3skew t3skew=number Default: 30.0
Controls minimum vertex angle for TRIA3 elements at which User Warning
Message 5491 is issued. See the MSC Nastran Quick Reference Guide, Section
1, The NASTRAN Statement, for more information on this keyword.
tetraar tetraar=number Default: 100.0
Specifies maximum allowable aspect ratio of longest to shortest edge for the
CTETRA element. See the nastran Command and NASTRAN Statement on
page 1 of the MSC Nastran Quick Reference Guide for more information on
this keyword.
trans trans=yes,no,auto Default: no (local)
auto (remote)
If the node keyword is not specified, this keyword indicates the XDB file is
to be translated to a neutral-format file using the TRANS utility. The output
file will have the file type .ndb.
UNIX only: If the node keyword is specified, this keyword indicates how an
XDB file is to be copied back to the local node. If trans=auto is specified,
the XDB file will be copied using TRANS/RECEIVE if the two computers use
different floating point formats or by a binary copy if the floating point formats
are the same. If trans=yes is specified, the XDB is always copied using
TRANS on the remote node and RECEIVE on the local node (this may be
needed if the floating point formats are identical but the file formats are not).
If trans=no is specified, the XDB file will not be copied back
Example: prod_ver nastran example
trans=yes
Main Index
99
Appendix C
Keywords and Environment Variables
This example will run MSC Nastran and then convert the XDB file, if written,
to neutral format using TRANS.
UNIX example: prod_ver nastran example
node=othernode
trans=yes
This example will run MSC Nastran on node othernode and copy the XDB file
back using TRANS/RECEIVE.
use_aio use_io=yes,no Default: No
(HP-UX 11) Enables HPs enhanced library for database I/O. Setting use_aio=yes will
enable the library for all *.SCRATCH and *.SCR300 files, using
threads to control the asynchronous read-aheads.
This keyword may also be set by the USE_AIO environment variable. The
environment variable overrides the RC files, and the command line overrides
the environment variable. Setting the environment variable to any non-null
value is equivalent to use_aio=yes; unset the environment variable to set
use_aio=no.
Example: prod_ver nastran example
use_aio=yes
This example will run MSC Nastran on with HPs AIO library enabled.
The library is controlled by a number of environment variables. They include:
AIO_FLIST Comma-separated list of filenames. The
default is *.SCRATCH,*.SCR300.
AIO_THREADS Maximum number of concurrent I/O
threads per file.The default is .
AIO_BUFFERS Maximum number of I/O buffers per
file. The default is .
AIO_PATDEPTH Number of I/Os to detect sequential
access. The default is 3.
username username=name Default: Current user name
(UNIX) Specifies an alternate username on the remote host when the node keyword
is specified. This keyword may only be specified on the command line.
Example: prod_ver nastran example
node=othernode
user=fred
This example will run MSC Nastran on node othernode as user fred.
usparse usparse=number Default: See the description below.
n
cpu
1
n
cpu
1
n
cpu
1
Main Index
MSC Nastran 2012 Installation and Operations Guide
100
Unsymmetrix sparse matrix method selection. This keyword may also be set
with the sys209" command line keyword. See the MSC Nastran Quick
Reference Guide for information on the default value and legal values for this
keyword.
version version=version_number Default: Latest installed version.
Specifies the version number. The keyword may only be specified on the
command line or in the command initialization file.
Example: prod_ver nastran example
version=68.2
This example will run MSC.Nastran V68.2 assuming it has been installed in
the same installation base directory as this version of MSC Nastran.
whence whence=keyword_list Default: None
Displays value and source for listed keywords. This keyword may be used to
determine a keyword's value and where it was set. An input datafile (JID) is
optional; the job will not be run. If the "node" keyword is specified, the request
will be passed to the remote node for processing. Otherwise, information will
be displayed for the local node. If multiple "whence" keywords are specified,
the keywords in the various keyword lists will be concatenated, except that if
a null list is specified, all existing keywords in the accumulated list will be
deleted. Any keywords in the "keyword_list" that have the format "sysn" will
attempt to return the value associated with the System Cell name associated
with system cell n, if possible. The entries in the "keyword_list" may also
request information about a PARAM name. These entries have the format
"p:name", where "name" is the PARAM name (not the name of the
associated PARAM keyword, if any).
Normally, the output is two lines for each keyword. The first line specifies the
"source", i.e., from where the keyword value is obtained; the second line
specifies the keyword and its value. The only exception is when the keyword
is "symbol", "system" or "j.params". In these cases, there will be multiple lines
of keyword value information. If an unknown keyword is specified, a "User
Warning Message" will be generated and the keyword will be ignored.
Example: prod_ver nastran iter=yes
whence=sys1,bpool
whence=sscr,iter
Assuming that none of these values is modified in configuration files, the
output from this request is:
MSC Nastran V2007.0 (...) ...
$ internal default
sys1=8193
$ internal default
bpool=37
Main Index
101
Appendix C
Keywords and Environment Variables
$ internal default
sscr=250000
$ command line[1]
iter=yes
xhost xhost=yes,no Default: No
(UNIX) Indicates if the xhost(1) command is to be run. The xhost(1) command may be
required if the node keyword and either xmon=yes or xmon=kill are
specified. The argument to xhost(1) will be the node specified by the node
keyword. This keyword is ignored if the node keyword is not specified.
xmonast xmonast=yes,no,kill Default: No
(UNIX) Indicates if XMONAST is to be run to monitor the MSC Nastran job. If
xmonast=yes is specified, XMONAST will be automatically started; you
must manually exit XMONAST when the MSC Nastran job has completed. If
xmonast=kill is specified, XMONAST will start and will automatically exit
when the MSC Nastran job has completed.
Example: prod_ver nastran example
xmon=kill
This example runs the XMONITOR utility while the MSC Nastran job is
running. Once the job completes, the XMONITOR program is automatically
terminated.
Main Index
MSC Nastran 2012 Installation and Operations Guide
102
SYS Parameter Keywords
The following keywords may be used for DBset files and for DBC Fortran files.
async async=yes,no,must Default: No
(See Table 4-7) This keyword specifies the file is to be read using asynchronous I/O. If
async=yes is specified and a memory allocation operation fails, then
unbuffered disk I/O will be used. If async=must is specified and a memory
allocation operation fails, then a fatal error will be issued and the job
terminated. See Using Asynchronous I/O on page 123 for further
information.
buffio buffio=yes,no,must Default: No
(See Table 4-7) This keyword specifies the file is to be buffered. If buffio=yes is specified
and a memory allocation operation fails, then unbuffered disk I/O will be
used. If buffio=must is specified and a memory allocation operation fails,
then a fatal error will be issued and the job terminated. See Using Buffered
I/O on page 121 for further information.
lock lock=yes,no Default: No for Delivery DBsets
Yes for all others.
(UNIX) Specifies the file is to be locked when it is opened. Locking a file prevents
two or more MSC Nastran jobs from interfering with one another; however,
this does not prevent any other program or operating system command from
modifying the file.
SYSTEM(207) can also be used to globally control DBset locking. Setting
SYSTEM(207)=1 will disable locking unless overridden for a specific file
by SYS=LOCK=YES on an ASSIGN FMS statement. Setting
SYSTEM(207)=0 will enable locking of read-write DBsets unless
overridden for a specific file by SYS=LOCK=NO on an ASSIGN FMS
statement.
mapio mapio=yes,no,must Default: No
(See Table 4-7) This keyword specifies the file is to be mapped. If mapio=yes is specified
and a mapping operation fails, then normal disk I/O will be used. If
mapio=must is specified and a mapping operation fails, then a fatal error
will be issued and the job terminated. See Using File Mapping on page 120
for further information.
Main Index
103
Appendix C
Keywords and Environment Variables
report report=yes,no Default: No
Requests that a summary report about the number of file operations and
other information about the I/O processing done for a particular file be
written to the file defined by stderr when the file is closed. In addition, if
TIMING=YES is specified, this report will contiain timing information
about the various steps involved in the I/O processing. If ASYNC=YES,
BUFFIO=YES or MAPIO=YES, the report will contain additional
information about the processing specific to these methods.
timing timing=yes,no Default: No
Requests that operation timing be enabled for the file. This timing
information will be included in the .f04 file and, if REPORT=YES is also in
effect, in the report written to stderr.
wnum wnum=number Default: 4 (ASYNC=NO)
8 (ASYNC=YES)
(See Table 4-7) Specifies the number of windows or buffers that will be maintained for each
mapped, buffered or asynchronous I/O file. The use of multiple windows or
buffers permits multiple I/O streams to target a file (e.g., simultaneously
reading one matrix and writing another) without forcing an excessive
number of window remap operations or buffered read/writes. The number
must be between 1 through 32 inclusive, values outside of this range are
ignored without acknowledgement.
wsize wsize=size Default: See text.
(See Table 4-7) File Mapping. Specifies the size of the window mapping the file into
memory. The window is that portion of the file that is visible through the
map. If the window is the same size as the file, then the entire file is visible.
If the window is smaller than the file, then any portion of the file within the
window or windows can be directly accessed; the rest of the file cannot be
accessed until a window is remapped to include the desired file location. The
default is 128KB or 4*BUFFSIZE, whichever is larger.
Main Index
MSC Nastran 2012 Installation and Operations Guide
104
(See Table 4-7) Buffered I/O. Specifies the size of the buffer read from or written to disk. If
the buffer is the same size as the file, then the entire file is memory resident.
If the buffer is smaller than the file, then any portion of the file within the
buffer or buffers can be directly accessed; the rest of the file cannot be
accessed until a buffer is read to include the desired file location. The default
is 4*BUFFSIZE or 64K, whichever is larger.
(See Table 4-7) Asynchronous I/O. Specifies the size of the buffer used to hold data read
from disk. If the buffer is the same size as the file, then the entire file is
memory resident. If the buffer is smaller than the file, then any portion of the
file within the buffer or buffers can be directly accessed; the rest of the file
cannot be accessed until a buffer is read to include the desired file location.
The default is 8*BUFFSIZE or 64KB, whichever is larger.
The total window or buffer size (WNUM value * WSIZE value) is limited
to 25% of the available address space or, for Windows, to 25% of the
physical memory. The address space limit is displayed by the limits
special function, see Using the Help Facility and Other Special Functions
on page 79, as the Virtual Address Space limit. If the address space limit
or physical memory cannot be determined for a particular platform, a value
of 64MB for 32-bit pointer systems and 8GB for 64-bit pointer systems is
used as the 25% limit value. If wsize=0" is specified for a read-only file, the
entire file will be mapped or buffered into memory, subject to the 25%
address space limit. (The 25% limit can be overridden if the numeric value
is specified as a negative number. The 25% test will be suppressed and the
actual window size value will be the absolute value of the specified numeric
value. It is the users responsibility to ensure that the specified value is valid
and does not cause performance problems.)
The size is specified as a memory size, see Specifying Memory Sizes on
page 82.
If size is less than the files BUFFSIZE, then size is multiplied by
BUFFSIZE.
Main Index
105
Appendix C
Keywords and Environment Variables
Environment Variables
The following environment variables affect the execution of the nastran command.
Table C-1 Environment Variables Affecting the nastran Command
Name Purpose
DISPLAY UNIX: The default display for xmonast.
FF_IO_DEFAULTS Linuxipf: Alternate means to set the ff_io_default
keyword.
FF_IO_OPTS Linuxipf: Alternate means to set the ff_io_opts keyword.
HOME UNIX: The users home directory.
HOMEDRIVE Windows: The users home drive.
HOMEPATH Windows: The users home directory.
LM_LICENSE_FILE Alternate means to set the authorize keyword.
LOGNAME UNIX: The user ID.
MP_ADAPTER_USE AIX: Alternate means to set the adapter_use keyword.
MP_CPU_USE AIX: Alternate means to set the cpu_use keyword.
MP_EUIDEVICE AIX: Alternate means to set the euidevice keyword.
MP_EUILIB AIX: Alternate means to set the euilib keyword.
MP_HOSTFILE AIX: Alternate means to set the hosts keyword.
MP_PROCS AIX: Alternate means to set the dmparallel keyword.
MP_RESD AIX: Alternate means to set the resd keyword.
MSC_ARCH Specifies the MSC Nastran architecture.
MSC_BASE If set, the script will use this directory as the install_dir.
MSC_ISHELLEXT Alternate means to set the ishellext keyword.
MSC_ISHELLPATH Alternate means to set the ishellpath keyword.
MSC_JIDPATH Alternate means to set the jidpath keyword.
MSC_LICENSE_FILE Alternate means to set the authorize keyword.
MSC_NOEXE If set, the nastran command will build the execution script
but will not actually execute it. This may be useful for
debugging purposes.
MSC_OLDTYPES Alternate means to set the oldtypes keyword.
MSC_SUN_IO Solaris: Alternate means to set sun_io keyword.
MSC_VERSD MSC use only.
MSCDBG Specify debugging flags.
Main Index
MSC Nastran 2012 Installation and Operations Guide
106
The following environmental variables are available for use by the pre and post keywords.
TEMP Windows: If set, this is the default value for the sdirectory
keyword. If not set, use the system default temporary file
directory as the default value.
TMPDIR UNIX: If set, this is the default value for the sdirectory
keyword. If not set, use the system default temporary file
directory as the default value.
USE_AIO HP-UX: Alternate means to set use_aio keyword.
USER UNIX: The users home directory (if LOGNAME is not set
or is a null string).
Table C-2 Pre and Post Keyword Environment Variables
Name Purpose
DBSDIR The directory part of MSC_DBS, i.e., the directory that will
contain the permanent database files.
DELDIR Directory containing the solution sequence source files
(install_dir/prod_ver/nast/del on UNIX and
install_dir\prod_ver\nast/del on Windows).
DEMODIR Directory containing DEMO library
(install_dir/prod_ver/nast/demo on UNIX and
install_dir\prod_ver\nast\demo on Windows).
JIDDIR Directory containing the input file.
MSC_APP yes,no
MSC_ASG MSC use only.
MSC_ARCH The actual architecture used by the nastran command.
MSC_LICENSE_FILE Licensing value.
MSC_BASE The actual install_dir used by the nastran command.
MSC_DBS Default prefix of permanent databases.
MSC_EXE Executable path.
MSC_JID Input data file path.
MSC_MEM Open core memory size in words.
MSC_OLD yes,no
MSC_OUT Prefix of F06, F04, and LOG files.
MSC_SCR yes,no
Table C-1 Environment Variables Affecting the nastran Command (continued)
Name Purpose
Main Index
107
Appendix C
Keywords and Environment Variables
MSC_SDIR Default prefix of scratch databases.
MSC_VERSD MSC use only.
OUTDIR Output file directory.
SSSALTERDIR Directory containing SSS alters
(install_dir/prod_ver/nast/sssalter on UNIX and
install_dir\prod_ver\nast\misc\sssalter on Windows).
TEMP Windows: Temporary directory.
TMPDIR UNIX: Temporary directory.
TPLDIR Directory containing TPL library
(install_dir/prod_ver/nast/tpl on UNIX and
install_dir\prod_ver\nast\tpl on Windows).
Table C-2 Pre and Post Keyword Environment Variables (continued)
Name Purpose
Main Index
MSC Nastran 2012 Installation and Operations Guide
108
Other Keywords
The following keywords are available for use by the nastran command and script templates. You will
generally not need to set or use these values.
Table C-3 Other Keywords
Keyword Purpose
0 Pathname of the nastran command.
0.acceptdeny Pathname of accept/deny utility used in this job.
0.dmp DMP job template pathname.
0.dmpaccept Pathname of dmpaccept utility.
0.dmpdeny Pathname of dmpdeny utility.
0.ini Command initialization file pathname.
0.kwds=filename Pathname of User-defined general keywords file
0.lcl Local job template pathname.
0.params=filename Pathname of User-defined PARAM keywords file
0.rmt Remote job template pathname.
0.rmtaccept Pathname of rmtaccept utility.
0.rmtdeny Pathname of rmtdeny utility.
0.srv Server job template pathname.
0.tmplt Alternate template pathname, overrides local/remote template selection
logic.
a.addall=list Comma separated list of extensions to be added to the j.all list
a.addapp=list Comma separated list of extensions to be added to the j.app list.
a.addofp=list Comma separated list of extensions to be added to the j.ofp list.
a.addold=list Comma separated list of extensions to be added to the j.old list.
a.appdir Application specific base pathname relative to MSC_BASE.
a.altmode The INTEGER mode associated with the alternate architecture.
a.altmodedir The directory name associated witht he alternate architecture.
a.archdir Architecture specific base pathname relative to MSC_BASE.
a.estimate ESTIMATE executable filename relative to a.archdir.
a.exedir Directory part of any file name specified by executable.
a.flex Pathname of default FLEXlm license file.
a.fms Comma-separated list of FMS keywords recognized in RC files.
a.k Multiplier for K factor.
a.msgcat Pathname of default message catalog.
Main Index
109
Appendix C
Keywords and Environment Variables
a.news News filename relative to a.appdir.
a.port Default FLEXlm port number.
a.rc Versioon dependent RC files base filename. For UNIX, default is
nast<vernum>rc and for Windows, default is nast<vernum>.rcf.
a.rcb Version independent RC base filename. Default is the a.rc keyword
value.
a.receive RECEIVE executable filename relative to a.archdir.
a.release Release number, same as MSC Nastran version number.
a.sbcm Pathname of default node-locked authorization code file.
a.solver Solver executable filename relative to a.archdir.
a.sss Delivery database filename relative to a.archdir.
a.tier MSC internal variable.
a.touch News file touch pathname.
a.trans TRANS executable filename relative to a.archdir.
a.urc Version dependent User and Local RC files base filename. For UNIX, will
always be prefixed by .. For UNIX, default is nastranrc and for
Windows default is nastran.rcf.
a.urcb Version independent User and Local RC files base file name. Default is the
a.rcb keyword value. For UNIX, will always be prefixed by ..
a.xmonitor XMONAST executable filename relative to a.archdir.
d.dbsds Blank separated list of per-task dbs directory values of DMP jobs.
d.hosts Blank separated list of per-task hostnames
d.jidvis Blank separated list of per-task JID visibility flags.
d.outvis Blank separated list of per-task output directory visibility flags.
d.rcmds Blank separated list of per-task rcmd values.
d.sdirs Blank separated list of per-task sdirectory values.
d.tid DMP task ID.
datecmd Date command. Only used on Windows.
dcmd Debugger.
debug Run solver under debugger.
j.all Blank separated list of file types to be deleted at job completion if
delete=all is specified.
Table C-3 Other Keywords (continued)
Keyword Purpose
Main Index
MSC Nastran 2012 Installation and Operations Guide
110
j.app Blank separated list of file types to be appended at job completion if
append=yes is specified.
j.argv Comma separated list of keywords and values to be added to the r.argv
argument list.
j.base Job basename.
j.command Job submittal command string.
j.dir Job directory.
j.env Job environment variable list.
j.exetype Specifies type of executable, either win32 or win64. Only used on
Windows.
j.expbase Generated <expjid> base name.
j.expdir Generated <expjid> directory.
j.expjid Generated <expjid> file name.
j.ext_xdb File type associated with logical name DBC files. Built from "dbc(xdb)"
as modified using "extdefault".
j.extall Blank separated list of output file types (extensions) to be deleted at job
completion if "delete-all" is specified. Built from "j.all" and "a.addall" as
modified using "extdefault".
j.extapp Blank-separated list of output file types (extensions) to be appended at job
completion if "append=yes" is specified. Built from "j.app" and
"a.addapp" as modified using "extdefault".
j.extofp Blank-separated list of output file types that will be deleted at job
completion if and only if they are empty. Built from "j.ofp" and "a.addofp"
as modified using "extdefault".
j.extofp_old Blank-separated list of output file types that will be used in "dmparallel"
mode to define the files to be merged or deleted. (See "mergeresults".)
Built from "j.ofp", "a.addofp" and "oldtypes" as modified using
"extdefault".
j.extold Blank-separated list of output file types that will be versioned ("old=yes")
or deleted ("old=no") at job start. Built from "j.old", "a.addold" and
"oldtypes" as modified using "extdefault".
j.mode Generated effective mode value in effect. Will be one of , i4 or i8.
j.modedir The directory associated with the j.mode value. NULL unless j.mode
is one of i4 or i8.
j.msg Job completion message.
j.nascar List of NASTRAN entries.
Table C-3 Other Keywords (continued)
Keyword Purpose
Main Index
111
Appendix C
Keywords and Environment Variables
j.news News file pathname.
j.nice Nice command to be used for commands, set based on "nice" keyword.
(UNIX Only).
j.ofp Blank separated list of file types to be deleted at job completion if and only
if they are empty.
j.old Blank separated list of file types to be versioned or deleted under the old
keyword.
j.out Appended output file type.
j.params Generated list of PARAM statements. Contains the result of INI file, RC
file and command line PARAM processing
j.rcfiles Comma-separated list of RC files.
j.server MSC Nastran server flag
j.shell Shell debugging flag.
j.startdate Job start date-time string.
j.title Title of XMONAST icon.
j.tty TTY name.
j.type Space separated list of file types to be versioned.
j.unique Job unique name.
job Job script filename, created in out directory.
log Pathname of LOG file.
msgdest System message destination.
nprocessors Number of processors.
ppc Per-process CPU time limit.
ppm Per-process memory limit.
prm Per-request memory limit.
PWD Current working directory.
r.altmode The INTEGER mode associated with the remote mode alternate
architecture.
r.altmodedir The directory name associated with the remote node alternate architecture.
r.argv List of arguments to be processed on rmt/dmp host.
r.expvis "expjid" visibility flag for remote job. Value is "yes" or "no".
r.jidvis JID visibility flag.
r.oscode Remote system operating system code, 1 = Windows, 2 = UNIX.
Table C-3 Other Keywords (continued)
Keyword Purpose
Main Index
MSC Nastran 2012 Installation and Operations Guide
112
r.outvis Output directory visbility flag.
r.rmtcode Remote communications protocol, 1 = MSCRmtCmd, 2 = rsh/rcp.
r.rshell Remote node Shell pathname. Only used when "r.rmtcode" is 1.
s.arch System architecture name.
s.block Words per disk block.
s.bpw Bytes per word.
s.clock CPU clock frequency.
s.config CONFIG number.
s.cpu CPU name.
s.hostname Simple hostname.
s.hyper Identifies whether or not HyperThreading is available. Only used on
Windows.
s.hyper_use Specifies how HyperThreading is used for job. Only used on Windows.
s.model System model name.
s.modeldata Pathname of site specific model data.
s.nohyper_aff System CPU affinity mask for use when hyperthreads=no specified. Only
used on Windows.
s.nproc Number of processors.
s.numeric Encoded numerical format.
s.os OS name.
s.osv OS version.
s.pmem Physical memory, in MB. Only known on UNIX, Solaris, and Windows.
s.proc Default processor subtype.
s.rawid Raw configuration number.
s.rcp Remote file copy command.
s.rsh Remote shell command.
s.type System description.
s.vmem Virtual memory, in MB. Only known on Windows.
tcmd Timing command.
Table C-3 Other Keywords (continued)
Keyword Purpose
Main Index
113
Appendix C
Keywords and Environment Variables
System Cell Keyword Mapping
The following table lists the System Cell Name - System Cell Number equivalence used by MSC Nastran
when processing the sysn and whence keywords:
Table C-4 System Cell Name -- System Cell Number
System Cell Name System Cell Number
attdel 124
autoasgn 133
bfgs 145
buffpool 114
buffsize 1
ifpbuff 624
chexaint 212
config 28
cordm 204
cpyinput 305
dblamkd 155
dbverchk 148
diaga 25
diagb 61
disksave 193
distort 213
f04 86
f06 2
fastio 194
fbsmem 146
fbsopt 70
frqseq 195
hicore 57
iter 216
ldqrkd 170
locbulk 143
massbuf 199
Main Index
MSC Nastran 2012 Installation and Operations Guide
114
maxset 263
metime 20
mindef 303
minfront 198
mperturb 304
mpyad 66
newhess 108
nlines 9
nsegadd 200
numseg 197
parallel 107
punch 64
q4skew 190
q4taper 189
quadint 141
radlst 88
radmtx 87
real 81
scr300 142
scr300del 150
scrsave 196
solve 69
sparse 126
t3skew 218
tetraar 191
usparse 209
Table C-4 System Cell Name -- System Cell Number
System Cell Name System Cell Number
Main Index
App. D: System Descriptions MSC Nastran Installation and Operations Guide
D
System Descriptions
Overview
System Descriptions
Numerical Data