Previous Topic: hudp Command-User-Defined ProcessNext Topic: husrmgr Command-User Manager


hup Command-Update Package

The hup command lets you update the package the -p option specifies. You can specify other aspects of the process through command parameters read from the command line. The various options work with each other to let you create a form, and add or delete form associations.

This command has the following format:

hup {-b name -en name -p name} {-usr username -pw password} [-npn name] [‑at name] [-pr number] [-af name] [-apg names...] [-rpg names...] [-des text] [‑nt note] [‑rf name] [-ft formtype] [-afo formid] [-rfo formid] [-del] [-cf] [‑v] [‑prompt] 
[-i inputfile.txt | -di inputfile.txt] [-eh filename] [-o filename | -oa filename] [-arg] [-wts] [-h]
-b name

(Required) Specifies the CA Harvest SCM broker name.

-en name

(Required) Specifies the CA Harvest SCM project context. If the project name contains spaces, enclose the name in quotation marks.

-p name

(Required) Specifies the CA Harvest SCM package name, read from the command line or a signature file.

-usr username

(Required, unless -prompt is specified) Specifies the user name for login to the broker. If -usr is defined without -pw, the user is prompted for the password at runtime.

-pw password

(Required, unless -prompt is specified) Specifies the password for login to the broker. To hide the password from being exposed in plain text on the command line, use the ‑prompt option.

-npn name

(Optional) Specifies the new package name for an existing package.

-at name

(Optional) Specifies the user name to assign to the package.

-pr number

(Optional) Specifies the priority to assign to the package.

-af name

(Optional) Specifies the name of a form to associate to the package. A form is created if it does not exist and if -cf is specified. The -ft option must be used in conjunction with this option.

-apg names...

(Optional) Specifies package groups to add to the list of package groups associated with the current package.

-rpg names...

(Optional) Specifies the package groups to disassociate from the current package. This does not delete the specified package group; it simply removes the association.

-des text

(Optional) Specifies a package description.

-nt note

(Optional) Specifies a note.

-rf name

(Optional) Specifies the name of a form to disassociate from the package.

-ft formtype

(Optional) Specifies the form type.

-afo formid

(Optional) Specifies to add the form association specified by its object ID.

-rfo formid

(Optional) Specifies to remove the form association specified by its object ID.

-del

(Optional) When removing a form (-rfo or -rf), if -del is specified and the form is not associated with a package, the form is deleted from the database. -del receives either the form type and name or formid from the -ft and -rf or -rfo options.

-cf

(Optional) Specifies to create a form by name if the form name does not exist. When added to -af (associate form), it creates a new form by name if the form name does not exist.

-eh filename

(Optional) Specifies the encrypted CA Harvest SCM username-password file name. The file name used with this option contains encrypted username-password credentials and must be generated with the svrenc utility.

Note: -eh overrides -usr and -pw options. -prompt overrides -eh, -usr and -pw options.