USRCAL

USRCAL, Rnam1, Rnam2, Rnam3, Rnam4, Rnam5, Rnam6, Rnam7, Rnam8, Rnam9
Allows user-solution subroutines to be activated or deactivated.

SOLUTION: Load Step Options

Rnam1, Rnam2, Rnam3, . . . , Rnam9

User-defined solution subroutine names to be activated. Up to nine may be defined on one command or multiple commands may be used. If Rnam1 = ALL, activate all valid user subroutines. If Rnam1 = NONE, deactivate all valid user subroutines. All characters are required:

USREFL	—	Allows user defined scalar field (body force) loads.
USERCV	—	Allows user defined convection (surface) loads.
USERPR	—	Allows user defined pressure (surface) loads.
USERFX	—	Allows user-defined heat flux (surface) loads.
USERCH	—	Allows user-defined charge density (surface) loads.
USERFD	—	Computes the complex load vector for the frequency domain logic.
USEROU	—	Allows user supplied element output.
USOLBEG	—	Allows user access before each solution.
ULDBEG	—	Allows user access before each load step.
USSBEG	—	Allows user access before each substep.
UITBEG	—	Allows user access before each equilibrium iteration.
UITFIN	—	Allows user access after each equilibrium iteration.
USSFIN	—	Allows user access after each substep.
ULDFIN	—	Allows user access after each load step.
USOLFIN	—	Allows user access after each solution.
UANFIN	—	Allows user access at end of run.
UELMATX	—	Allows user access to element matrices and load vectors.
UTIMEINC	—	Allows a user-defined time step, overriding the program-determined time step.
UCNVRG	—	Allows user-defined convergence checking, overriding the program-determined convergence.

Command Default

No user-solution subroutines are active (even if linked into the program).

Notes

Allows certain user-solution subroutines to be activated or deactivated (system-dependent). This command only affects the subroutines named. Other user subroutines (such as user elements, user creep, etc.) have their own activation controls described with the feature.

The UAnBeg subroutine that allows user access at the start of a run does not require activation by this command; it is automatically activated when the program is started.

The routines are commented and should be listed after performing a custom installation from the distribution media for more details. See also the Advanced Analysis Guide for a general description of user-programmable features.

You must have system permission, system access, and knowledge to write, compile, and link the appropriate subroutines into the program at your site.

Most routines should be written in FORTRAN. The exceptions are USSBeg, UItBeg, UItFin, and USSFin. These can be called as Mechanical APDL macros which have access to a limited set of commands. For more details, see Access at the Beginning and End of Various Operations in the Programmer's Reference. (For more information about FORTRAN compilers, refer to either the Ansys, Inc. Windows Installation Guide or the Ansys, Inc. Linux Installation Guide for details specific to your platform or operating system.)

Issue USRCAL,STAT to list the status of these user subroutines.

Because a user-programmed subroutine is a nonstandard use of the program, the verification of any Mechanical APDL run incorporating these commands is entirely your responsibility. In any contact with customer support regarding the performance of a custom version of Mechanical APDL, explicitly state that a user-programmable feature has been used.

This command is also valid in PREP7.

Menu Paths

Main Menu>Preprocessor>Loads>Load Step Opts>Other>User Routines

Main Menu>Solution>Load Step Opts>Other>User Routines