/UCMD

/UCMD, Cmd, SRNUM
Assigns a user-defined command name.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Argument Descriptions

Cmd

User-defined command name. Only the first four characters are significant. Must not conflict with any Mechanical APDL command name or any user unknown-command macro name.

SRNUM

User subroutine number (1 to 10) programmed for this command. For example, the command /UCMD,MYCMD,3 will execute subroutine USER03 whenever the command MYCMD is entered. Use a blank command name to disassociate SRNUM from its command. For example, /UCMD,,3 removes MYCMD as a command.

Notes

Assigns a user-defined command name to a user-programmable (system-dependent) subroutine. This feature allows user-defined commands to be programmed into Mechanical APDL. Once programmed, this command can be input to the program like other commands, and can also be included in the Mechanical APDL start-up file.

Up to 10 subroutines are available for user-defined commands (USER01 to USER10). You must have system permission, system access, and knowledge to write, compile, and link the appropriate subprocessors into Mechanical APDL at your site.

All routines should be written in FORTRAN. 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.

The USER01 routine is commented and should be listed from the distribution media (system dependent) for more details.

Issue /UCMD,STAT to list all user-defined command names.

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

See User-Programmable Features (UPFs) in the Advanced Analysis Guide for a general description of user-programmable features and the Guide to User-Programmable Features in the Programmer's Reference for a detailed description of these features.

See *ULIB for another way of defining user commands.

This command is valid only at the Begin Level.

Menu Paths

This command cannot be accessed from a menu.