Appendix B. Using APDL to List File Structure and Content

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,Val2
Action

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, Val2

Additional input. The meanings of Val1 and Val2 vary depending on the specified Action, as described in the table below.

Action LabelVal1Val2
OPENName of file to open (no default)File type (no default); valid labels are RST, MODE, FULL, CMS, and SUB
CLOSEName of file to close (default is last file opened by Action = OPEN)(not used)
LISTNumber of levels in the tree of records (default = 1)(not used)
UPNumber of levels in the tree of records (default = 1), or TOP to go directly to the top of the tree(not used)
STEP or INFOName of the record of interest (no default)(not used)
READName 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.


Release 18.2 - © ANSYS, Inc. All rights reserved.