SMC/ELB Comparison utility

The SMC/ELB Comparison utility (smc_elb.exe) reads methods and their associated ELBs (or shared images) in the SMC, and then verifies that there is an ELB containing those methods. This utility can be useful at deployment time to help ensure that you have all the necessary files. Smc_elb.exe is installed in the dbl\bin directory.

Note

The SMC/ELB Comparison utility checks only for the ELBs that are referenced in the SMC. It does not check for any dependent ELBs that may be linked to the ELBs in the SMC.

If you’re using Workbench, the SMC/ELB Comparison utility runs automatically when you generate Java class wrappers or C# classes. You can also run it independently in Workbench or from the command line on any platform. Running a comparison from the command line enables you to specify which SMC, interface, and method ID you want to check and how you want to receive the output. Running a comparison from Workbench enables you to verify the interfaces selected in a particular project (see Running an SMC/ELB comparison from Workbench).

Note

If you used logicals in the SMC to point to the directories that your ELBs or shared images reside in, those logicals must be defined in the environment in order for smc_elb to be able to resolve them. Smc_elb does not read xfpl.ini, SYNRC.COM, or DBLDIR:SERVER_INIT.COM.

Windows and UNIX syntax

smc_elb [‑s smc_path] [‑i interface_name] [‑m method_id] [‑o filename] 
[‑e] [‑b] [‑l line_length] [‑v] [‑h]

Arguments

<none>

Run without any arguments, smc_elb will verify all methods in the SMC (in the location specified by DBLDIR) and display the output to the screen.

‑s smc_path

(optional) The path where the SMC files are located. If not specified, smc_elb looks for the SMC files in the location specified by DBLDIR. If DBLDIR is not set, smc_elb looks in the current working directory.

‑i interface_name

(optional) Verify only the methods in the specified interface name. If you do not specify an interface name (or a method ID; see below), all methods in the SMC are verified.

‑ m method_id

(optional) A specific method ID you want to verify. If you specify both an interface name and a method ID, the interface name overrides the method ID and all methods in the interface are verified. If you do not specify a method ID (or an interface name; see above), all methods in the SMC are verified.

‑o filename

(optional) File that you want the output written to. If the file does not exist, it is created. If it exists, it is overwritten. If ‑o is not specified, output is directed to the screen.

‑e

(optional) Display all output to the screen while also writing it to a file. Use with ‑o.

‑b

(optional) Display only errors to the screen or, if ‑o is specified, write only errors to a file. Success and informational messages are not displayed.

‑l line_length

(optional) Number of characters per line for output. You can use this option when writing to a file (‑o option) or the screen. The default line length is 255 characters, the maximum is 256, and the minimum is 20.

‑v

(optional) Display the version number.

‑h

(optional) Display a list of options.

OpenVMS syntax

smc_elb [/smc_path=smc_path] [/interface=interface_name] [/method=method_id] 
[/output=filename] [/verbose] [/brief] [/line_length=value] [/version]

Arguments

<none>

Run without any arguments, smc_elb.exe will verify all methods in the SMC (in the location specified by DBLDIR) and display the output to the screen.

/smc_path=smc_path

(optional) The path where the SMC files are located. If not specified, smc_elb.exe looks for the SMC files in the location specified by DBLDIR. If DBLDIR is not set, smc_elb.exe looks in the current working directory.

/interface=interface_name

(optional) Verify only the methods in the specified interface name. If you do not specify an interface name (or a method ID; see below), all methods in the SMC are verified.

/method=method_id

(optional) A specific method ID you want to verify. If you specify both an interface name and a method ID, the interface name overrides the method ID and all methods in the interface are verified. If you do not specify a method ID (or an interface name; see above), all methods in the SMC are verified.

/output=filename

(optional) File that you want output written to. If the file does not exist, it is created. If it exists, a new file is created. If /output is not specified, output is directed to the screen.

/verbose

(optional) Display all output to the screen while also writing it to a file. Use with /output.

/brief

(optional) Display only errors to the screen or, if /output is specified, write only errors to a file. Success and informational messages are not displayed.

/line_length=value

(optional) Number of characters per line for output. You can use this option when writing to a file (/output option) or the screen. The default line length is 255 characters, the maximum is 256, and the minimum is 20.

/version

(optional) Display the version number.

Running an SMC/ELB comparison from Workbench

When you run the SMC/ELB Comparison utility from Workbench, it uses the SMC specified in the SMC directory field in the Component Information dialog box, and checks all methods in the interfaces that are selected in that dialog box.

1. Open a Java or .NET component project in Workbench.
2. Select Synergy/DE > Utilities > SMC/ELB Comparison. The utility runs and displays output in the Build tab of the Output toolbar.