cpebatch

Format

cpebatch

>>-cpebatch filename---+- -O-+---+---------------+-------------->
		       '- -I-'   '- -U: loginID--'

>-----+----------------+---+----------------+---+------+-------->
      '- -P: password--'	'- -L1: logfile--'	  '- -V--'

>-----+-----+--------------------------------------------------><
      +- -M-+
      '- -G-'

Purpose

Starts the command profile editor batch utility. For additional information about the command profile editor, see the chapter on using the command profile editor in the NetView Management Console User's Guide.

Parameters

cpebatch
The name of a command that invokes the executable command profile editor utility program.
filename
This is a required parameter. If the -O option is specified, this is the name of the output file that is created by the utility. If the -I option is specified, this is the name of the input file that is read by the utility.
-O
Generates a response file from the current commands database. The filename specifies the name of the file generated by the utility. If this is not a fully-qualified name, the file is generated in the current directory. If no name is specified, the default name of IHSECPED.RSP is used. The -O or -I parameter must be specified.
-I
Specifies a response file to be used to update the current commands database. Unless the filename is fully-qualified, it is assumed to reside in the current directory. The -O or -I parameter must be specified.
-U loginID
If the user ID is not present in the command line, you will be prompted by the batch utility to provide this information. The user ID must match your NetView(R) user ID.

The login user ID must have administrative authority.

-P password
The password for the login user ID specified by the -U parameter. There is no default value. If a password is not present in the command line, you will be prompted by the batch utility to provide this information. This password must match your NetView password. If a value is not specified, the command profile editor utility tries to sign on to the topology server with a null password. This is an optional parameter.
-L1 log file
The name of the error log file to which you want to log informational and error messages. The default is IHSECPED.LOG. If the file is not fully-qualified, it is put in the following directories:

The error log file is continually appended, so that multiple runs of the utility are logged in the same file.

This is an optional parameter.

-V
Forces the utility into verify mode. The response file is processed and compared with the data in the topology server, but no changes are made to the actual topology server database. This is an optional parameter.
-M
Overrides the default add mode of the utility and forces the utility into modify mode. This enables information to be replaced in or deleted from the existing database. This is an optional parameter.
-G
Overrides the default add mode of the utility and forces the utility into modify mode. This enables updates to be made to command sets and profiles by adding to them without replacing existing information. This is an optional parameter.

Return Codes

The command profile editor utility program generates the following return codes:

RC Explanation
0 Successful. The utility completed successfully. Unless -V was specified in the cpebatch command, the database was updated.
4 Warning. The database was updated (unless -V specified) and warning messages were logged.
8 Error. The database was not updated and error messages were logged.
12 Severe Error. The database was not updated and a severe error terminated the program immediately.