9.151 PACKAGE_CREATE

Note: Built-In Function Rules     Usage Options

This Built-In Function creates a Package based on the supplied Deployment Tool Template. Objects can be added to the package.

Note: For WAMs and Weblets, the required Languages and Technology Services must be provided.

 

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Application Name

1

8

 

 

2

A

Req

Version or Patch

Version must be in the format <major version number>.<minor version number>.<build number>

Patch must be in the format <major version number>.<minor version number>.<build number>.<patch number>

1

23

 

 

3

List

Req

Objects to include in Package

List can be empty but must be supplied.

From - To   Description

  1     50     Object Type

Supported object types are listed in Package Objects.

 51     70     Object Name

 71     80    Object Qualifier

 81     81    Include Data (Files & Web Components only)

For files:
  Y - Include data
  N - Do not include data
For web components:
  I - Input
  O - Output
  N - Not applicable

 82     82    Data processing option (files only)

For files:
  I - Reload data ignoring any duplicates
  D - Drop existing data
  R - Reload data replacing duplicates (only available if file data included).

 83    99    Reserved for future use.

81

99

 

 

4

List

Req

Web Designs

If including WAMs or weblets in the package indicate the languages and technology services required.

List can be empty but must be supplied.

From - To   Description

  1     50     Object Type

WEBLANGUAGE
TECHNOLOGYSERVICE

 51     60     Language / Provider

WEBLANGUAGE : Language Code (e.g. ENG)
TECHNOLOGYSERVICE: Technology Service Provider (e.g. LANSA)

 61     70     Technology Service

WEBLANGUAGE: blank

TECHNOLOGYSERVICE: Technology Service (e.g. XHTML)

70

70

 

 

5

A

Req

Deployment Template

Must have associated .ptf template file in <System Directory>\X_Apps\X_Tmplt

1

10

 

 

6

A

Opt

Package Path

Indicate where the package should be created.

If blank package will be created at <System Directory>\X_Apps.

If you intend to edit the package using the Deployment Tool, the package must be created at <System Directory>\X_Apps

Default: blank

1

256

 

 

7

A

Opt

Package Create/Update Options Y, U or R

Default: Y

Y - Create/Recreate entire package based on template

U - Update object selection (add new, delete removed, do not modify other objects already in list)

R - Replace Object selection (remove all objects and replace with new object list)

 

1

1

 

 

8

A

Opt

Package Description

If the package already exists, the description will only be replaced if a non-blank description is supplied.

Default: blank

1

200

 

 

9

A

Opt

Application Description

If application already exists, the description will only be replaced if non-blank description is supplied.

Default: blank

1

200

 

 

 

Return Values

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

 A

Req

Return Code

OK = Package created without error

ER = An Error occurred during the package creation or build.  Check log files associated with package.

2

2

 

 

2

A

Req

Reason

Explanation accompanying error

1

100

 

 

 

 

Package Objects

When formatting entries for Argument 4, the Objects to include in Package, use the following table to determine appropriate data for each object type.

 

Object Type

Object Name
Required

Object Qualifier
Required

Include Data
Required

ACTIVEX

Y

N

N

BITMAP

Y

N

N

BUSINESS OBJECT

Y

N

N

CURSOR

Y

N

N

DOTNETCOMPONENT

Y

N

N

EXTERNALRESOURCE

Y

N

N

FIELD

Y

N

N

FILE

Y

Y - Library name

Y

FORM

Y

N

N

FUNCTION

Y

Y - Process

N

ICON

Y

N

N

LANGUAGE

Y – Package Language Code

Special value used to include Package Languages

N

N

MESSAGE

Y - Message ID (1-7), Language Code (8-11)

Language is optional. If not supplied, all languages are included.

Y - Message File

 

MESSAGEFILE

Y – Message File

Y - Language Code

N

MULTILINGUALVARIABLE

Y

N

N

PROCESS

Y

N

N

REUSABLEPART

Y

N

N

SERVERMODULE

Y

N

N

SYSTEMVARIABLE

Y

N

N

TECHNOLOGYSERVICE

Y – Provider

Y – Technology Service

N

THEME

Y

N

N

VISUALSTYLE

Y

N

N

WEBAPPLICATIONMODULE

Y

N

N

WEBCOMPONENT

Y

N

Y

WEBLET

Y

N

N

WEBPAGE

Y

N

N

WEBWIDGET

Y

N

N

 

What you cannot include with this BIF