Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 8 Procedures and Procedure Libraries : Import a Procedure Library

Import a Procedure Library
This section describes how to import a procedure library into Procedure Manager. Each procedure and sub-procedure contained in the library is also imported.
Note:
This option is not available from the swutil menu. You can only import procedure libraries using the command line option either interactively or by using the options to suppress the prompts.

 
swutil IMPORTLIB newlib ‘/dev/dept 1’

 
Import a Procedure Library Interactively
The interactive method displays prompts for each stage of the import. If you want to import a procedure library without displaying all of the prompts, use the command line method. See Import a Procedure Library Using Command Line Options.
The IMPORTLIB option is not available from the swutil menu.
1.
swutil IMPORTLIB library target
where:
library is the name of the library you want to import.
To import a procedure libary (for example, carpool.xpdl) from a directory outside of SWDIR/util (for example, /Dept/Purchasing), run the following command:
swutil IMPORTLIB /Dept/Purchasing/carpool.xpdl target
target is the full path to the library (as shown in Procedure Manager).
The library can be either an .xfr or .xpdl library. If there is only one type in the folder, then iProcess imports that library automatically. If however there are both types such as carpool.xfr and carpool.xpdl, you will be prompted to choose which you want to import, as follows:
'F'carpool.xfr,'P' carpool.xpdl,'Q'uit?
Enter F to import the .xfr or enter P to import the .xpdl.
2.
The library and all of its procedures are imported to Procedure Manager in the target you specified. If you want to move the library or procedures, use Procedure Manager to do so. See "Moving and Copying Procedures, Libraries and Shortcuts" in TIBCO iProcess Modeler Procedure Management.
When you import an .xpdl library, it already has a default destination library, which is the user input package name used when you exported the procedures as .xpdl from TIBCO Business Studio. However, you still can define the destination library, which will contain the default destination library.
Example
To import a procedure library from the admin.xfr file into the /Dept/Purchasing library following the interactive prompts, you would use the following command:

 
swutil IMPORTLIB admin /dept/purchasing

 
To import a procedure library from the admin.xfr file into the /Dept/Purchasing 2 library following the interactive prompts, you would use the following command (note the quoted pathname):

 
swutil IMPORTLIB admin ‘/dept/purchasing 2’

 
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).
options can be one or more of the following to suppress or change a specific option:
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.
Use existing use files if filenames are the same.
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.
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 name
Note: This option is equivalent to using the -d, -n, -mm, -rr and -uu options.
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.
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.
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

 
Display Commit/Rollback Messages When Importing Procedures or Procedure Libraries
swutil IMPORT -v and IMPORTLIB -v can be used so that messages showing whether procedures have been committed to the database or rolled back are displayed. For example, if you import a procedure called quota that already exists:

 
swutil IMPORT quota -vrwtden
Importing a Procedure
Checking Procedure ‘QUOTA’:
A ‘model’ procedure already exists; so importing as ‘withdrawn’.
**** COMMIT(&publish): Procedure:QUOTA
Unresolved issues from import of procedure quota, source file D:\swserver\swnod730\util\quota.imp

 
Use the following commands to display commit/rollback messages when importing a procedure or library of procedures:
swutil IMPORTLIB library target [-v]
swutil IMPORT procedure [-v]
where:
library is the name of the library to import.
target is the full path to the library (as shown in Procedure Manager).
procedure is the name of the .xfr or .xpdl file to import.
-v (optional) can be used to display messages about whether a procedure is rolled back or committed to the iProcess database.

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved