casrdtup

Imports CICS resources from a resource definition table (.rdt file).

Syntax:

casrdtup /ffile-name [/opresource-definition-path] [/rregion-name] [/uuserid] 
[/ppassword] [/xext] [/q] [/o] [/d]

Parameters:

/ffile-name The RDT file to import from. This parameter is mandatory, and can be a path on disk, or a database path, for example, sql://my-db/my-datastore?folder=/myrd. See The Datastore URL for details of the full SQL notation required.
/opresource-definition-path The directory containing the resource definition file, dfhdrdat, into which resources are imported.

This defaults to %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc\cas (Windows) or $COBDIR/etc/cas (UNIX), but could be another path on disk or a database path.

/rregion-name The name of the enterprise server region into which the resources will be imported.
/uuserid User ID
/ppassword Password
/xext Default FCT file extension
/q Quiet mode (no prompts)
/o Overwrite existing entries. If this is not specified, any duplicate entry results in an error message.
/d Discard MVS data set names

Dependencies:

To ensure that casrdtup is on your PATH, execute it from an Enterprise Developer command prompt.

Comments:

If the input file containing the CICS resource definitions has been generated on the mainframe, the file must be converted from EBCDIC to ASCI. To do the conversion you can:

  • Use the dfconv command. See DFCONV Batch File Conversion for more information.
  • Use the Data File Converter tool available from the Classic Data File Tools utility. See Data File Converter for more information.
  • Convert the input file during the transfer from the mainframe.

If a path or filename contains spaces, it should be enclosed in quotation marks. For example, "e:\dev mto\files".

This utility is designed to process mainframe generated resource definition records, which are not abbreviated. However, it will accept abbreviations for keywords and values, provided that the abbreviations are unique. For example, DSNA can be used in place of DSNAME and BR can be used in place of BROWSE.

This utility expects values to be uppercase like those generated by the mainframe utility, DFHCSDUP. For example, "NONE" and "YES" rather than "None" and "Yes".

This utility supports the DEFINE and DELETE commands only.
Note: The combination of DEFINE with the command line option /o can be used to overwrite existing definitions as an alternative to ALTER.

See Resource Definitions for more information on the resource definitions that you can use with Enterprise Server MSS.

Example:

For Windows environments:

casrdtup /fresfile.rdt /d /op"e:\devmto\files"

For UNIX environments:

casrdtup /fresfile.rdt /d /op/devmto/files

The above command imports the file resfile.rdt, discarding MVS data set names.