casesxml

Imports and exports enterprise server definitions.
Restriction: This topic applies only when the Enterprise Server feature is enabled.

casesxml can perform one of two operations:

  • generate .xml files, in casesxml export format, that contain structured definitions of a region, a CICS resource definition file, and the catalog
  • import a casesxml export format .xml file to update the definitions of a region, a CICS resource definition file, and the catalog

casesxml is useful in any situation where you want to make a copy of the key resource definitions used in your Enterprise Server setup. This could be for backup purposes, for instance, or to enable you to share common resource definitions across multiple users.

casesxml consolidates functionality from the mfds command, the casrdtex CICS command, and the mfcatxml catalog import/export utility. Whether you use casesxml or an individual command or utility depends on the type of information that you want to import or export.

Note: The casesxml command-line utility can only import files that have been exported using casesxml. Repository files exported from MFDS or ESCWA can be imported using the mfds command.

Syntax:

casesxml command [switch ...] [parameter ...]

Parameters:

command
export Definitions are to be exported from Enterprise Server to an .xml file.
import Definitions are to be imported from an .xml file into Enterprise Server.
switch
Import and export:
-s Include security definitions.
-v Display verbose output.
Export only:
-a Include all RDT entries.
Import only:
-o Overwrite existing definitions.
parameter
Import and export:
-dresource-definition-file-location The location of the CICS resource definition file.

If this is not supplied, it will be determined from the Micro Focus Directory Server (MFDS) region definition.

This override may be required if the resource definition file's location is defined using an environment variable which is not set when the export is executed or, in an import scenario, a different resource definition file should be targeted.

This override may be required when exporting if the resource definition file's location is defined using an environment variable which is not set when the export is executed, or when importing if a different resource definition file is to be targeted.

-pmfds-password The password to use when retrieving information from MFDS.
-umfds-user-name The user name to use when retrieving information from MFDS.
-c All output is combined into one file. The name of the combined file is region-name_combined.xml.

If you do not specify -c a number of .xml files are produced depending on the information that is returned.

Output files that already exist are overwritten.
Note: If the enterprise server definition has been exported using this option then you must import using the -c parameter.
Export only:
-rregion-name The region whose definition is to be exported.

This is required when exporting but optional when importing.

-tmfds-timeout The timeout period, in seconds, to use when retrieving information from MFDS. The default is 5.
-wwork-location The location where the output files are to be written. The default is %TMP%. To use the current directory specify -w%CD%. Output files that already exist are overwritten.
-z In addition to producing one or more .xml files, produce a .zip file containing the .xml files.

The name of the .zip file is region-name_export.zip. The file is overwritten if it already exists.

Import only:
-ffile-to-import The name of the file to import, which can be an .xml file in casesxml export format or a .zip file containing casesxml export format files.