importupd command

Use the importupd command to import update information and installable files into the update library on the management server.

Synopsis

smcli [-c] [-prompt] [-user user_name] [-pw password] importupd options

smcli importupd [-h | -? | --help]

smcli importupd [-v] [-c] [-s] [-o] [-r] [-W seconds] {path}

smcli importupd [-v] [-c] [-o] [-W seconds] [-u update] {path_list}

Description

This command adds information and files for one or more updates to the update library on the management system. The update information comes from descriptor files identified by path (either specified directly or in the directory). Any update documentation or installable files in the specified path that are associated with the update are also copied to the update library.

Operands

This command uses one or more paths, separated by a comma, as an operand.

If you do not specify an update, the path must be the full path and name of one or more update descriptor files (*.sdd) or the directory that contains one or more update descriptor files. By default, this command first attempts to create update descriptor files from existing update information at the given path. Specify the -s | --skipgenerate option to prevent generation of any update descriptor files (*.sdd). If you specify the -r | --recurse option, this command searches all subdirectories for update descriptor files and update information.

Tip: If the directory or file name in the path contains spaces, enclose the path in quotation marks.

Note: The specified path must be to a local directory. Network mounted directories cannot be used.

Options

-c | --clean

Cleans (deletes) the original files after the import completes successfully.

Tip: If errors occur during the import, the files are not deleted.

-h | -?

Displays the syntax and a brief description of the command.

Tip: If you specify additional options other than -h | -? | --help, the options are ignored.

--help

Displays detailed information about the command, including the syntax, a description of the command, a description of the options and operands, error codes, and examples.

Tips:

If you specify additional options other than -h | -? | --help, the options are ignored.
You can also display detailed help in the form of man pages using the man command_name command.

-o | --overwrite

Overwrites the update if it already exists in the update library.

Tip: If you do not specify this option and the update already exists, the update is not imported again.

-r | --recurse

Searches all subdirectories in the specified path for updates to import.

Tip: You can specify this option only if the operand is a directory. This option is not valid if the operand is a directory and file name.

-s | --skipgenerate

Prevents the generation of any update descriptor files (*.sdd).

Tip: Update descriptor files are generated by default if this option is not specified.

-u | --updates {update_oid | update_fix_id}

Imports one or more files for an existing update, specified by ID or fix ID (update ID), into an existing update.

update_oid: Specifies the unique ID of an update, specified as a hexadecimal value prefixed with 0x (for example, 0x37).
Tip: Use the lsupd -o command to list all update IDs.
update_fix_id: Specifies the unique fix ID of an update (for example, SF99001G-47).
Tip: Use lsupd -A DisplayName,UpdateId to list the current fix IDs.

Tip: To import a new update that is not currently being managed, do not specify this option.

-v | --verbose

Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

-W | --wait seconds

Displays the results of the command after waiting the specified number of seconds, regardless of whether or not the task has been completed.

Possible values for seconds are:

-1: Waits indefinitely for the task to finish before exiting and displaying the results. This value is the default if this option is not specified.
0: Exits immediately, and the task continues to run in the background. Use the lsjob or lsjobhistory command to check the status.
1 or greater: Exits after the specified number of seconds. If the task is completed before the specified wait period, this command displays the results. If the task is not completed before the specified wait period, the command exits and the task continues to run in the background. Use the lsjob or lsjobhistory command to check the status.

Exit status

The following codes are returned by this command.

0: The operation completed.
1: A usage error occurred.
2: The command or bundle was not found.
3: The command was not performed because either authentication failed or you are not authorized to perform the action.
29: The specified locale is not valid or not supported.
50: The specified update is not valid.
53: The specified update already exists in the update library on the management server.
86: A server representing the local machine could not be found.
93: An error occurred while parsing the update descriptor file.
94: An error occurred while generating a descriptor file for this update.
126: The task did not complete before the specified wait time. The command is still running in the background.

Examples

Import an update
This example illustrates how to copy the d:\myupdates directory (because it is read-only media) to a temporary writable location on the management server. It searches that directory and all subdirectories for update descriptor files (*.sdd) and, if no files are found, automatically generates update descriptor files for platforms that are known to IBM® Flex System Manager. Then, it imports installable files and the update information described in the update-package descriptor files into the update library. Finally, the files in the temporary location are deleted.
Tip: If the d:\myupdates directory is on a read/write file system, the initial copy to a temporary location will not occur.
```
smcli importupd -c -r d:\myupdates
```
Import an update for IBM i
This example illustrates how to import the SI01234.SAVF save file, which is an IBM i PTF binary, into the update library for the specified update.
```
smcli importupd -o -u SI01234 c:\SI01234.SAVF
```