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.
The command format is:
*XPL,Action,Val1,Val2Action
Specifies 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. |
Val1, Val2Additional input. The meanings of Val1 and
Val2 vary depending on the specified
Action, as described in the table below.
Action
Label | Val1 | Val2 |
|---|---|---|
| OPEN | Name of file to open (no default) | File type (no default); valid labels are RST, MODE, FULL, CMS, and SUB |
| CLOSE | Name of
file 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 or INFO | Name of the record of interest (no default) | (not used) |
| READ | Name of the record of interest (no default) | Name of the APDL Math object to create (no default) |
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.