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
Non-LANSA objects – unless they are first recorded as External Resources.
Editor List or Task related objects.
Application Template objects.