MFDAS Syntax and Options

Use the MFDAS command line utility to perform a range of file-related interactions with the mainframe.
Attention: This topic applies to a feature that is in Early Adopter Program (EAP) release status. We intend to provide the finalized feature in a future release. Please contact OpenText Support for Micro Focus Products if you require further clarification.
Note: Slash parameters can appear anywhere, they are processed first and then removed:
  • /AMSLOG="<amslogPath>" - on AMS command if there was an IDCAMS command failure writes the SYSPRINT DD to the specified location. On TSO command writes SYSTSPRT DD to the specified location.
  • /CODEPAGE=<codepage> See Supported codepages for more information.
  • /DATACODEPAGE=<codepage> See Supported codepages for more information.
  • /FIXEDVSAM
  • /NUMREC=<records to import>

Syntax:

MFDAS OPTION [/Parameter]

MFDAS supports the following options:

ALLOCATE

MFDAS ALLOCATE PDS <dsname> CYL|TRK|BLK <number> LRECL <number>
BLKSIZE <number> RECFM FB|FBA|FBM|VB|VBA|VBM|F|FA|FM|FSA|FSM|U 
DIR <number> [VOL <volser>]
MFDAS ALLOCATE SEQ CYL|TRK|BLK <number> LRECL <number> 
BLKSIZE <number> RECFM FB|FBA|FBM|VB|VBA|VBM|F|FA|FM|FSA|FSM|U
[VOL <volser>]
MFDAS ALLOCATE PDS <dsname> EXT <extension>
MFDAS ALLOCATE USS <path> [PERM <permissions string>]
Note: The default value for PERM is 755. The umask applied to the process will be 000 and therefore any PERM specified will be the permissions applied to the process.

AMS

MFDAS AMS <cmd> /AMSLOG="<filename>"
MFDAS AMS FILE <filename> /AMSLOG="<filename>"

AWM

MFDAS AWM /AMSLOG="<filename>" "TAUZCIF <parms>"

BINDER

MFDAS BINDER <filename> PDS <dsname> MEMBER <mname> [XREF]

BROWSE

MFDAS BROWSE <filename> FROM PDS <dsname> MEMBER <mname>
MFDAS BROWSE <filename> FROM QSAM <dsname>

CANCEL | HOLD | RELEASE

MFDAS CANCEL|HOLD|RELEASE <jobid>

CATDCB

To list data sets based on a catalog search criteria:

MFDAS CATDCB <catalogsearchfilter> ALL

COMPRESS

MFDAS COMPRESS <dsname>

COPY

MFDAS COPY USS <path> TO <path> [CREATE <YES|NO>] [REPL <YES|NO>]

DELETE

MFDAS DELETE <dsname> [MEMBER <mname>]
MFDAS DELETE JES <jobid> [PURGE]
MFDAS DELETE USS <path>

DEPTH

MFDAS DEPTH USS <path>

DIR

MFDAS DIR FOOT <dsname> [FILTER <mname>]
MFDAS DIR JESDD <jobid> ALL [INPUT]

To list the members of a partitioned data set:

MFDAS DIR PDS <dsname> [PREFIX <prefix>|FILTER <filter>] FULL 
MFDAS DIR USS <path>

EXPORT | CHECKIN

To export a partitioned data set:

MFDAS EXPORT|CHECKIN [NOEMPTYCHECK] [LOCK] [RJSE [NOTRANSLATE]] [BINARY|TEXT] [NODFCONV] <filename>|<filter> TO PDS <dsname> MEMBER <mname> [OVERRIDESCLM]

To export to a QSAM data set:

MFDAS EXPORT|CHECKIN [LOCK] [BINARY|TEXT] <filename> TO QSAM <dsname>

GETENQI

Retrieve detailed enqueue information from a PDS or a QSAM data set:

MFDAS GETENQI PDS *|<dsname> [MEMBER <mname>]
MFDAS GETENQI QSAM *|<dsname>

HELP

Get basic information about the MFDAS syntax at the command line:

MFDAS HELP

IMPORT | CHECKOUT

To import from an unloaded DB/2 table with automatic data conversion and produce a workstation XDB format table.

MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM DB2 <dsname> <location> <authid> 
<tablename>

To import from a VSAM ESDS, KSDS, or an RRDS data set with automatic data conversion and produce a variable length workstation indexed file. If you wish to produce a fixed length indexed file, then use ESDS-FIXED, KSDS-FIXED, or RRDS-FIXED instead of ESDS, KSDS, or RRDS, respectively:

MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM ESDS|KSDS|RRDS[_FIXED] <dsname> 
[NODFCONV]

To import from an unloaded IMS database with automatic data conversion and produce a workstation PCIMS format database.

MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM IMS <dsname> <databasename> 
<segmentnamelocation> <segmentdatalocation>

To import from the mainframe JES2 or JES3 spool:

MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM JES <jobid> [EXECUTING] [INPUT]
MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM JESDD <jes_ddname> JES <jobid> [EXECUTING] [INPUT]

To import from a partitioned data set:

MFDAS IMPORT|CHECKOUT [LOCK] [BINARY|TEXT] <filename> FROM PDS <dsname> MEMBER <mname>|<filter>

To import from a QSAM data set with automatic data conversion:

MFDAS IMPORT|CHECKOUT [LOCK] [BINARY|TEXT] <filename> FROM QSAM <dsname>
MFDAS IMPORT USS <path>

LINK

MFDAS LINK USS <path> TO <path> [SYMBOLIC|PHYSICAL]

LOCATE

Check whether a data set exists on the mainframe.

MFDAS LOCATE <dsname>

A zero return code indicates that the data set exists, and a non-zero return code indicates that it does not exist.

MOUNTINFO

MFDAS MOUNTINFO USS <path>

PASSWORD

To change your mainframe password:

MFDAS PASSWORD <password>

RECALL

MFDAS RECALL <dsname>

RENAME

MFDAS RENAME <dsname> MEMBER <mname> NEWNAME <mname>
MFDAS RENAME <dsname> NEWNAME <dsname>
MFDAS RENAME USS <path> NEWNAME <path>

SETPERM

MFDAS SETPERM USS <path> PERM <permissions string>

SETUSER

MFDAS SETUSER <userid> <password>

STATUS

To get a job status:

MFDAS STATUS [LIST] <jobname>|<filter> [FILTER filter]

SUBMIT

To submit a JCL file for execution:

MFDAS SUBMIT <filename>|<filter>

TERMINATE

MFDAS TERMINATE

TSO

MFDAS TSO <TSO command>

UNLOCK

Unlocks a resource in a PDS or a QSAM data set as long as you are the owner of the lock. You should only perform this if you are sure that the resource is erroneously enqueued.
MFDAS UNLOCK PDS <dsname> MEMBER <mname>
MFDAS UNLOCK QSAM <dsname>
Note: Use the GETENQI command to retrieve the current enqueue information.

VERSION

MFDAS VERSION