*XPL
*XPL, Action,
Val1, Val2
Accesses content of a Mechanical APDL file.
ActionSpecifies the action for scanning file content (no default). Valid labels are:
OPEN
—
Open the specified file.
CLOSE
—
Close the specified file.
LIST
—
List the records at the current level in the hierarchy of records.
WHERE
—
Display the current location in the tree.
STEP
—
Step down in the tree of records.
UP
—
Go up in the tree of records.
READ
—
Read a record into an APDL Math object.
INFO
—
Display information from a record.
GOTO
—
Move directly to a given place in the tree of records (this avoids multiple calls to the STEP and UP options).
MARK
—
Mark a set of records of the current file; the asterisk (*) character can be used to specify multiple branches/records.
COPY
—
Copy the current file to a new one, ignoring the marked records.
SAVE
—
Save the current file, ignoring the marked records.
Val1,Val2Additional input. The meanings of
Val1andVal2vary depending on the specifiedAction, as described in the table below.
Action
Label | Val1 | Val2 | ||
|---|---|---|---|---|
| OPEN | Name of file[a] to open (no default) | (not used) | ||
| CLOSE | Name of file[a] to close (default is
last file opened by Action = OPEN) | (not used) | ||
| LIST | Number of levels in the tree of records (default = 1) | (not used) | ||
| UP | Number of levels in the tree of records (default = 1), or TOP to go directly to the top of the tree | (not used) | ||
| STEP | Name of the record of interest (no default) | (not used) | ||
| INFO | Name of the record of interest (no default), or * for all records | (not used) | ||
| READ | Name of the record of interest (no default) | Name of the APDL Math object to create (no default) | ||
| GOTO |
The complete PATH to the new location Example: *XPL,GOTO,RST::DSI::SET1 | (not used) | ||
| MARK | The complete path to the record(s); use (*) character to select multiple records (see example in next section) | (not used) | ||
| COPY | Name of the new file[a] | If blank (default), marked records are not copied to the new file. Valid inputs are:
|
[a] File name is case-sensitive with a 32-character maximum.
Notes
The *XPL command enables you to explore the contents of a Mechanical APDL file. Use this command to traverse up and down the tree structure of the specified file and review what is in the file. Files that can be scanned include .rst, .mode, .full, .cms, and .sub files. For more information and examples, see Using APDL to List File Structure and Content in the Ansys Parametric Design Language Guide.
The command *XPL,READ generates either a *VEC or a *DMAT object according to the record type. You do not have to create the APDL Math object before issuing this command.
This command is valid in any processor.