MFDAS Syntax and Options

Use the MFDAS command line utility to perform a range of file-related interactions with the mainframe.
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.
  • /CAT=Y
  • /CATLOC=<filename>
  • /CATLOG=<filename>
  • /CATOVERRIDE=<catalogpath>
  • /CODEPAGE=<codepage> See Supported codepages for more information.
  • /DATACODEPAGE=<codepage> See Supported codepages for more information.
  • /ENDLOG=<endlogPath> - downloads the Endevor transaction log to the specified location on an END command failure
  • /FIXEDVSAM
  • /LOGLEVEL=ERROR|VERBOSE
  • /NONDYNAMIC
  • /NUMREC=<records to import>
  • /OVERWRITE=Y|N
  • /SHOWDETAILS

See User exit after a successful import and User exit after a successful export for more information.

Syntax:

MFDAS OPTION [/Parameter]

MFDAS supports the following options:

Parent topic: Using the command-line interface

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>

BUILD

MFDAS BUILD <filename> CHG <pkgname> MEMBER <mname> TYPE <memtype>

CANCEL | HOLD | RELEASE

MFDAS CANCEL|HOLD|RELEASE <jobid>

CAT

MFDAS CAT <catalogsearchfilter>

CATDCB

To list data sets based on a catalog search criteria: 

MFDAS CATDCB <catalogsearchfilter> [ALL]
MFDAS CATDCB * JESDD JOB#

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 END ENV <env> SYS <sys> SUB <sub> MEMBER <mname>|FILTER <filter> [STG <stage>] [TYPE <memtype>] [CCID <change-control-id>] 
[OVERRIDE SIGNOUT] [COMMENT <user-comment>]
MFDAS DELETE JES <jobid> [PURGE]
MFDAS DELETE USS <path>

DIR

MFDAS DIR END ENV <env> SYS <sys> SUB <sub> [PREFIX <prefix>|FILTER <filter>] [STG <stage>] [TYPE <memtype>] [ALL|FULL]
MFDAS DIR FOOT <dsname> [FILTER <mname>]
MFDAS DIR JESDD <jobid> [ALL] [INPUT]
MFDAS DIR LIB <dsname> [PREFIX <prefix>|FILTER <filter>] [TYPE <memtype>] [ALL]
MFDAS DIR PAN <dsname> [PREFIX <prefix>|FILTER <filter>] [TYPE <memtype>] [USERCODE <code>] [ALL]

To list the members of a partitioned data set: 

MFDAS DIR PDS <dsname> [PREFIX <prefix>|FILTER <filter>] [ALL|FULL] 
MFDAS DIR CHG <pkgname> [TYPE <memtype>] [PREFIX <prefix>] 
MFDAS DIR USS <path>

EXPORT | CHECKIN

MFDAS EXPORT|CHECKIN [BINARY|TEXT] <filename>|<filter> TO END ENV <env> SYS <sys>
SUB <sub> MEMBER <mname> TYPE <memtype> [VVLL <nnnn>] [CCID <change-control-id>] [COMMENT <user-comment>]
[OVERRIDE] [SIGNOUT] [BYPASS GEN] [PGRP <processor-group>] [LOCK=YES|NO]
MFDAS EXPORT|CHECKIN [BINARY|TEXT] <filename>|<filter> TO LIB <dsname> MEMBER <mname>
MFDAS EXPORT|CHECKIN [BINARY|TEXT] <filename>|<filter> TO PAN <dsname> MEMBER <mname>
[USERCODE <code>]

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>
MFDAS CHECKIN [BINARY|TEXT] <filename> TO CHG <pkgname> [TYPE <memtype>] [MEMBER <mname>] [OPTION <YYY>] [DESC <description>]
Y=Lock Y=Save Prior Y=Checkin Activate
MFDAS EXPORT <filename>|<filter> TO USS <path> [CREATE <YES|NO>] [APPEND <YES|NO>] [TRUNC <YES|NO>] [EXCL <YES|NO>] [PERM <permissions string>]

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

HISTORY | LISTCONC

MFDAS HISTORY|LISTCONC <filename> CHG <pkgname> MEMBER <mname> TYPE <memtype>
MFDAS HISTORY|LISTCONC <filename> END ENV <env> SYS <sys> SUB <sub> STG <stage> MEMBER <mname> TYPE <memtype> [VVLL <nnnn>]

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>
MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM END ENV <env> SYS <sys> SUB <sub> 
MEMBER <mname>|<filter> [STG <stage>] [TYPE <memtype>] [VVLL <nnnn>] [CCID <change-control-id>] [COMMENT <user-comment>] 
[OVERRIDE SIGNOUT] [LOCK=YES]

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]
MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM LIB <dsname> MEMBER <mname>|<filter>
MFDAS IMPORT|CHECKOUT [BINARY|TEXT] <filename> FROM PAN <dsname> MEMBER <mname>|<filter>

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 [BINARY|TEXT] <filename> FROM CHG <pkgname> [TYPE <memtype>] [MEMBER <mname>]
MFDAS CHECKOUT [BINARY|TEXT] <filename> FROM CHG <pkgname> [TYPE <memtype>] [MEMBER <mname>] [LEVEL <0|+|->]
[OPTION <YYYY>] Y=Lock Y=Overlay Prior Y=Save Prior Y=Suppress Notify
MFDAS IMPORT USS <path>

LIST

MFDAS LIST END ENV
MFDAS LIST END [SYS|SUB|STG|TYPE|PGRP] ENV <env> [SYS <sys>] [SUB <sub>] [STG <stage>] [TYPE <type>] [PGRP <pgrp>]

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.

MOVE

MFDAS MOVE END ENV <env> SYS <sys> SUB <sub> MEMBER <mname> [STG <stage>] [TYPE type] [TOUSER <userid>] [BYPASS GEN]
MFDAS MOVE [OVERRIDE SIGNOUT] [CCID <change-control-id>] [COMMENT <user-comment>]

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

TRANSFER

MFDAS TRANSFER END ENV <env> SYS <sys> SUB <sub> MEMBER <mname> [STAGE <stage>] [TYPE <type>] [VVLL <nnnn>]
[TOENV <env>] [TOSYS <sys>] [TOSUB <sub>] [TOMEMBER <mname>] [TOSTAGE <stage>] [TOTYPE <type>]
[CCID <change-control-id>] [COMMENT <user-comment>] [OVERRIDE SIGNOUT] [LOCK=YES]

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 CHG <pkgname> [MEMBER <mname>] | [TYPE <memtype>]
MFDAS UNLOCK QSAM <dsname>
Note: Use the GETENQI command to retrieve the current enqueue information.

VERSION

MFDAS VERSION