Mapdl.assign(ident='', fname='', ext='', lgkey='', **kwargs)

Reassigns a file name to an ANSYS file identifier.



ANSYS file name identifier. Valid identifiers are: CMS, EMAT, EROT, ESAV, FULL, LN07, LN09, LN11, LN20, LN21, LN22, LN25, LN31, LN32, MODE, OSAV, RDSP, RFRQ, RMG, RST, RSTP, RTH, SELD, and SSCR. See File Management and Files for file descriptions. If blank, list currently reassigned files.


File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name.


Filename extension (eight-character maximum).


Key to specify local or global file name control for the specified file identifier in a distributed-memory parallel processing (Distributed ANSYS) run. For more information on local and global files, see File Handling Conventions in the Parallel Processing Guide.

BOTH - Reassign the file name for both the local and global files (default).

LOCAL - Reassign the file name for only the local files.

GLOBAL - Reassign the file name for only the global file.


The reassignment of file names is valid only if it is done before the file is used. All file reassignments are retained (not cleared) even if the database is cleared [/CLEAR] or the Jobname is changed [/FILNAME]. Assigned files may be overwritten. If file name arguments (Fname, Ext, –) are blank, the default ANSYS assignment is restored. Use SEOPT for SUB files and SEEXP for DSUB files.

This command is valid only at the Begin Level.

This command also checks to ensure that the path/file is valid and can be written by the user. If it is not valid, an error message will be returned. Ensure that the directory exists prior to using /ASSIGN command.