Parameter Values

The following table describes the values you can enter in the PARM field of the EXEC statement. In the absence of function action requests, the default action is print.

Value Meaning Default Explanation
-C Copy None Copies all the definitions from one configuration file to another file defined by CONFIG2. The file referenced by CONFIG2 is initialized before copying starts.
-Mddn Import None, IMPORT Reads the contents of the IMPORT file and apply to the CONFIG file. If you specify ddn, that DD name is used instead of IMPORT.
-Nddns Export None, EXPORT Writes out the entire contents of CONFIG in export format to the EXPORT file. If you specify ddn, that DD name is used instead of EXPORT.

The following table describes the parameter values of the Configuration File Utility:

Value Meaning Default Explanation
-Dn Debug 2 Specifies the level of message display. The value for n can be between 0 and 5, with 0 providing very few messages and 5 showing the hex displays of all the records processed.
-Ixxx Input DD name CONFIG Allows another DD name to be used in place of CONFIG.
-Oxxx Output DD name CONFIG2 Allows another DD name to be used in place of CONFIG2.
-P Print None Prints out each recipe and trigger with the associated Backend, ESB Endpoint, Group membership, and Conversion rules.
-R Read-only Update Opens the CONFIG file as read-only. If combined with Import, all the updates from the import operation are lost.
-T Initialize None Allows the program to initialize the CONFIG file if the file does not contain the Transformer_Anchor structure at the beginning of the file. The Initialize request does not apply if you also specify read-only.
-V Validate None Validates all the data structures for consistency and block identifiers (eyeball characters). If you specify -V -V, validation does not terminate after the first error occurs.
-X Hex dump None Displays all the active definitions in the file in hex and does not show the relationships among the definitions.
-Z Zero file None Resets the CONFIG file to empty before starting the requested processes. Note the warning as follows.
Note: Do not specify the Z option when importing data into a nonempty configuration file. Doing so destroys all the existing data in the configuration file.

For a summary of the usage of the parameter options, see Summary of Substation ES ESB Configuration File Utilities.