02.04.2013 Views

Welcome to Adams/Solver Subroutines - Kxcad.net

Welcome to Adams/Solver Subroutines - Kxcad.net

Welcome to Adams/Solver Subroutines - Kxcad.net

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Extended Definition<br />

<strong>Welcome</strong> <strong>to</strong> <strong>Adams</strong>/<strong>Solver</strong> <strong>Subroutines</strong><br />

DATOUT outputs data from a simulation initiated by ANALYS. When you advance the simulation by a<br />

call <strong>to</strong> ANALYS, <strong>Adams</strong>/<strong>Solver</strong> does not au<strong>to</strong>matically output data. If you want <strong>to</strong> process output (for<br />

example, requests, graphics), call DATOUT from the CONSUB driver subroutine. In this way, you can<br />

choose the type and amount of output. For an example of a CONSUB driver subroutine that calls<br />

DATOUT, see CONSUB.<br />

ERRMES<br />

ERRMES provides the facility for outputting error messages from user-written subroutines.<br />

Use<br />

Called By<br />

Any user-written subroutine<br />

Prerequisite<br />

None<br />

Calling Sequence<br />

CALL ERRMES (errflg, mesage, id, endflg)<br />

Input Arguments<br />

errflg A logical (true or false) variable. When errflg is true, ERRMES writes the<br />

message passed in <strong>to</strong> its output files.<br />

mesage A character string or variable of as many as eighty characters that you want<br />

ERRMES <strong>to</strong> document when the subroutine has an error. This character string<br />

should be a descriptive message and should include the name of the<br />

subroutine with the error.<br />

id An integer variable that specifies the identifier of the statement that is<br />

currently invoking the user-written subroutine.<br />

endflg A character variable that s<strong>to</strong>ps execution when it equals STOP. If endflg has<br />

any other value, <strong>Adams</strong>/<strong>Solver</strong> continues execution.<br />

Extended Definition<br />

The ERRMES data access subroutine allows you <strong>to</strong> output messages <strong>to</strong> document errors that occur in<br />

user-written subroutines. The messages always go <strong>to</strong> the message file, and during interactive execution,<br />

<strong>Adams</strong>/<strong>Solver</strong> displays them on the screen.<br />

27

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!