File: tut_errors.rst

package info (click to toggle)
openmolcas 25.02-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 170,204 kB
  • sloc: f90: 498,088; fortran: 139,779; python: 13,587; ansic: 5,745; sh: 745; javascript: 660; pascal: 460; perl: 325; makefile: 17
file content (198 lines) | stat: -rw-r--r-- 8,244 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
.. index::
   single: Error messages
   single: Error

Most frequent error messages found in |molcas|
==============================================

Due to the large number of systems where the |molcas| package is
executed and the large number of options included in each of
the programs it is not possible to compile here all the possible
sources of errors and error messages occurring in the calculations.
The |molcas| codes contain specific error message data basis where
the source of the error and the possible solution is suggested.
Unfortunately it is almost impossible to cover all the possibilities.
Here the user will find a compendium of the more usual errors
showing up in |molcas| and the corresponding error messages.

Many of the error messages the user is going to obtain are specific
for the operative system or architecture being used.
The most serious ones are in most of cases
related with compiler problems, operative system incompatibilities,
etc. Therefore the meaning of this errors must be checked in the proper
manuals or with the computer experts, and if they are characteristic
only of |molcas|, with |molcas| authors. The most common, however,
are simple mistakes related to lack of execution or reading
permission of the shell scripts, |molcas| executable modules, etc.

In the following the most usual errors found in |molcas| are listed.

.. index::
   single: Error; molcas not found

* The shell is unable to find the command :command:`molcas`.
  The message in this case is, for instance: ::

    molcas:  not found

  The solution is to add into the :variable:`PATH` the location of molcas driver script.

  .. index::
     single: Error; MOLCAS undefined

* If the |molcas| environment is not properly installed the
  first message showing up in the default error file is: ::

    ***
    *** Error: Could not find molcas driver shell
    *** Currently MOLCAS=

  Typing a command :command:`molcas`, you can check which molcas
  installation will be used. Check the value of the variable :variable:`MOLCAS`,
  and define it in order to point to the proper location of molcas installation.

  .. index::
     single: Error; ENV undefined

* Environment is not defined

  An attempt to run an executable without molcas driver scripts gives
  an error: ::

   Usage: molcas module_name input

* A call for a program can find problems like the three following ones: ::

    Program NNNN is not defined

  An error means that requested module is missing or the package is not installed.

  .. index::
     single: Error; Input file not found

* When the input file required for a |molcas| program is not
  available, the program will not start at all and no output
  will be printed, except in the default error file where the
  following error message will appear: ::

    Input file specified for run subcommand not found : seward

  .. index::
     single: Error; RUNFILE

* All the codes communicate via file :file:`RUNFILE`, if for a some reason
  the file is missing or corrupted, you will get an error ::

    ***    Record not found in runfile

  The simple solution --- restart seward to generate proper :file:`RUNFILE`.

  .. index::
     single: Error; ONEINT
     single: Error; ORDINT

* All the codes need integral files generated by :program:`SEWARD` in
  files :file:`ONEINT` and :file:`ORDINT`.
  Even the direct codes need the one-electron integrals stored
  in :file:`ONEINT`. The most common problem is then that a program
  fails to read one of this files because :program:`SEWARD` has not
  been executed or because the files are read in the wrong address.
  Some of the error messages found in those cases are listed here.

  In the :program:`SCF` module, the first message will appear when
  the one-electron integral file is missing and the second when
  the two-electron integral file is missing: ::

    Two-electron integral file was not found!
     Try keyword DIRECT in SEWARD.

  .. index::
     single: Error; Insufficient memory

* |molcas| use dynamical allocation of memory for temporary arrays.
  An error message "Insufficient memory" means that requested value
  is too small --- you have to specify :variable:`MOLCAS_MEM` variable and restart your
  calculation.

  .. index::
     single: Error; memory allocation

* if user ask to allocate (via :variable:`MOLCAS_MEM`) an amount of memory,
  which is large than possible on this computer, the following error message
  will be printed. ::

    MA error: MA_init: could not allocate 2097152152 bytes
    The initialization of the memory manager failed ( iRc=  1 ).

  .. index::
     single: Error; input error

* An improper input (e.g. the code expects to read more numbers, than
  user specified in input file) will terminate the code with errorcode 112.

  .. index::
     single: Error; Disk address problems
     single: Error; I/O problems

* Input/Output (I/O) problems are common, normally due to insufficient
  disk space to store the two-electron integral files or some of the
  intermediate files used by the programs. The error message would depend
  on the operative system used. An example for the :program:`SCF` is
  shown below: ::

    *******************************************************************************
    *******************************************************************************
    ***                                                                         ***
    ***                                                                         ***
    ***    Location: AixRd                                                      ***
    ***    File: ORDINT                                                         ***
    ***                                                                         ***
    ***                                                                         ***
    ***    Premature abort while reading buffer from disk:                      ***
    ***    Condition: rc != LenBuf                                              ***
    ***    Actual   :                0!=          262144                        ***
    ***                                                                         ***
    ***                                                                         ***
    *******************************************************************************
    *******************************************************************************

  The error indicates that the file is corrupted, or there is a bug in the
  code.

* Sometimes you might experience the following problem with :program:`GEO`/:program:`HYPER`
  run: ::

    Quaternion tested
    mat. size =     4x    1
     -0.500000000
      0.500000000
     -0.500000000
      0.000000000
    ###############################################################################
    ###############################################################################
    ###                                                                         ###
    ###                                                                         ###
    ###    Location: CheckQuater                                                ###
    ###                                                                         ###
    ###                                                                         ###
    ###                                                                         ###
    ###    Quaternion does not represent a rotation                             ###
    ###                                                                         ###
    ###                                                                         ###
    ###############################################################################
    ###############################################################################

  The error indicates that you need to rearrange the Cartesian coordinates
  (atoms) of one or another fragment.

.. .. _TUT\:sec\:flow_all:

   |molcas| Flowchart
   ------------------

   .. figure:: flow-all.*
      :name: fig:flow_all
      :width: 75%
      :align: center

      Program module dependencies flowchart for |molcas|. Shadow boxes represent optative modules to be installed independently.