Import a Procedure Library Using Command Line Options

To import a procedure library using the command line options, use the following command:

swutil IMPORTLIB library target [options]

where:

• library is the name of the library you want to import.
• target is the full path to the library (as shown in Procedure Manager).

Note 

If your library names use spaces, you must quote them in the command line. See Import a Procedure Library.
• options can be one or more of the following to suppress or change a specific option:

swutil IMPORTLIB options

Option

Description

+c

Overwrite the existing procedure description when you import a procedure as a new version.

-c

Do not overwrite the existing procedure description when you import a procedure as a new version.

-d

Do not prompt for the procedure’s Owner (the current user is used).

+d owner

Do not prompt for the Owner but set the value of Owner to the value supplied in owner.

-e

Use existing use files if filenames are the same.

-g

Suppress confirmation when generating a new GUID for a renamed procedure.

-h

Displays the help (shows these options).

-ix

Import Incomplete procedures with status x, where x is one of the following:

• i for Incomplete
• w for Withdrawn

For example, -ii imports Incomplete procedures as Incomplete.

Note: If you choose -ii but an Incomplete or Unreleased version of a procedure already exists, the option is ignored and that procedure is imported as Withdrawn instead.

-l

Overwrite lists that already exist.

-mx

Import Model procedures with status x, where x is one of the following:

• m for Model
• r for Released
• w for Withdrawn

For example, -mr imports Model procedures as Released.

Note: If you choose -mm but a Model version of a procedure already exists, or -mr and a Released version already exists, the option is ignored and that procedure is imported as Withdrawn instead.

-n

Opt for new version at the "New version or New name" prompt.

+n name

Opt for new name at the "New version or New name" prompt and use the name supplied.

-q

Import procedures using the same procedure names (as new versions), owners and release status (except for Incomplete procedures) with which they were exported, without having to complete the associated prompts.

Note: This option is equivalent to using the -d, -n, -mm, -rr and -uu options.

-rx

Import Released procedures with status x, where x is one of the following:

• m for Model
• r for Released
• w for Withdrawn

For example, -rr imports Released procedures as Released.

Note: If you choose -rm but a Model version of a procedure already exists, or -rr and a Released version already exists, the option is ignored and that procedure is imported as Withdrawn instead.

-t

Do not import/overwrite iProcess table data.

+t

Import/overwrite iProcess table data.

-ux

Import Unreleased procedures with status x, where x is one of the following:

• u for Unreleased
• w for Withdrawn

For example, -uu imports Unreleased procedures as Unreleased.

Note: If you choose -uu but an Incomplete or Unreleased version of a procedure already exists, the option is ignored and that procedure is imported as Withdrawn instead.

-v

Displays messages showing if a procedure has been committed to the database or rolled back. See Display Commit/Rollback Messages When Importing Procedures or Procedure Libraries.

 

Note 

For any options that you do not set or suppress, you will be prompted in the same way as when you use swutil IMPORT interactively.

The procedure library is imported to the target library in Procedure Manager.

Example

To import a procedure library from the admin.xfr file into the Dept\Purchasing library where you want all released procedures to be imported as model procedures and you want to suppress all prompts, you would use the following command:

swutil IMPORTLIB admin /dept/purchasing -deglrm