Launching Data File Editor from a Command Line Prompt

Data File Editor can be launched from a Visual COBOL command line prompt to open local files or catalogued files from an enterprise server region.

Local files: For local files use the following syntax:

mfdatatools2 [file-type][path][filename][option...]

file-type

This parameter is optional. If omitted, Data File Editor opens without a file loaded. If specified, file-type must be one of:

/data: Specifies that the file to be opened is a data file, and will be opened in the Data File Editor.

path

This parameter is optional. If specified, Data File Editor attempts to open the named file located in the path specified. If omitted, Data File Editor attempts to open the named file located in the current working directory.

filename

This parameter is optional. If specified, Data File Editor uses the path (if specified) and filename to open the file in the appropriate editor. If omitted, Data File Editor opens with no file loaded.

option

These parameters are optional, and will only take effect if the /data file type is also specified. If omitted, Data File Editor opens at the Open File dialog box, where you can set the required options. You can specify one or more of:

/org org-type

The organization of the file. org-type can be one of:

seq: Sequential files.
lseq: Line sequential files.
rel: Relative files.
idx: Indexed files.

/reclen

The maximum record length.

Catalogued data set: Use the following syntax to open a catalogued data set from an enterprise server region:

mfdatatools2 /dsn [data set name] [options...]

Parameter	Usage	Description
/dsn [data set name]	Required	Specifies the catalogued data set to be opened.
/host [host name]	Optional	Host name of the machine running Enterprise Server. The default value is localhost.
/port [port]	Optional	Port of the target region's Web Services and J2EE listener. The default value is 9003.
/user [user ID]	Optional	User ID for enterprise server region authentication.
/pwd [password]	Conditional	Password for enterprise server region authentication. Required if the /user parameter was specified. Can either contain the password in clear text or an identifier to obtain the password from the mfsecrets vault. To obtain the password from the vault use: mfsecret:vault_name:/secret_path To use the default vault, use: mfsecret:/secret_path The password must be stored in the vault beforehand, for example by using the mfsecretsadmin utility. For more information, see Restricting Access to the Vault Facility.
/group [user group]	Optional	User group for enterprise server region authentication.
/fs [Fileshare name]	Optional	Name of the Fileshare server to use.
/tls	Optional	Enable TLS protocols to open the data set.

Example

mfdatatools2 /dsn MFI01V.MFIDEMO.BNKACC /host rhel-es01 /port 9006 /fs FS01 /user psmith /pwd mfsecret:/mySecrets/esPassword /tls

This opens the data set MFI01V.MFIDEMO.BNKACC from the enterprise sercver region with port 9006 (TLS-enabled) on host rhel-es01 using the Fileshare server FS01 and user ID psmith. The user password is obtained from the Micro Focus Secrets Vault under the path /mySecrets/esPassword.