COMPOSER Command Parameters

REQUEST

This parameter specifies the LANSA Composer function to be performed.  The functions that may be requested are:

• RUN: Specifies that a LANSA Composer Processing Sequence, Activity or Transformation Map is to be run.  The PSEQ parameter must be specified if REQUEST(RUN) is specified.  The PSEQ parameter specifies the identifier of the Processing Sequence, Activity or Transformation Map that is to be run.

• EXPORT: Exports LANSA Composer definitions such as Configurations, Trading Partners, Transformation Maps and Processing Sequences according to the Export List specified by the EXPORTLIST parameter.  The path to the resulting export file must be specified in the EXPORTTO parameter.  For more information refer to Unattended Export and Import Operations on the LANSA Composer Server.

• IMPORT: Imports LANSA Composer definitions such as Configurations, Trading Partners, Transformation Maps and Processing Sequences from an export file specified by the IMPORTFROM parameter.  For more information refer to Unattended Export and Import Operations on the LANSA Composer Server.

• REORG: Specifies that the LANSA Composer database housekeeping task is to be run.  The database housekeeping task will use the parameter specifications last used or last saved through the LANSA Composer client.  Refer to Database Housekeeping for more information.

• ABOUT: Echos messages containing certain LANSA Composer version and environment information back to the command processor.  This information includes LANSA listener, HTTP listener and JSM port numbers.

• LICENSE or LICENCE: Specifies that a server license for LANSA Composer is to be applied.
  Refer to Apply the Server License for LANSA Composer for more details.

• TUTORD: Starts the LANSA Composer tutorial orders application.

PSEQ

For REQUEST(RUN), this parameter must specify the identifier of the Processing Sequence, Activity or Transformation Map that is to be run.  You can specify the identifier in one of two ways:

• When running a Processing Sequence, you can specify the external identifier (ID or name) of the Processing Sequence.

• Otherwise you can specify the internal identifier of the Processing Sequence, Activity or Transformation Map.  The internal identifier is a unique internal key that is allocated for each item by LANSA Composer when it is created.  Its value can be displayed on the Audit tab in the LANSA Composer client application.

PARMS

For REQUEST(RUN), the PARMS parameter may be used to specify parameter values for the Processing Sequence, Activity or Transformation Map that is to be run.  Up to 100 parameter values may be specified.

Parameter values are always provided by parameter name, so you only need to supply values for required parameters or where you wish to use a value different from the default parameter value.  You can specify the parameter name and value pairs in any order.

For each parameter for which you wish to provide a value, you must provide:

• parameter name - the name of the parameter as defined in the Processing Sequence, Activity of Transformation Map definition.

• parameter value - the value for the parameter.

EXPORTLIST

For REQUEST(EXPORT), this parameter must specify the name of the Export List that specifies the set of LANSA Composer definitions to be exported.  You can specify the name of the export list, or, if you prefer, you can specify the internal identifier.

EXPORTTO

For REQUEST(EXPORT), this parameter must specify the full path to the LANSA Composer export file that will be created to contain the exported definitions.  Such a file usually has a file extension of .dxexport.  If the export file already exists, the export operation will replace it.  LANSA Composer will create the file with CCSID 1208.

IMPORTFROM

For REQUEST(IMPORT), this parameter must specify the full path to the LANSA Composer export file from which the LANSA Composer definitions are to be imported.  Such a file usually has a file extension of .dxexport.

 NOTE: The export file MUST have a CCSID of 1208 (for utf-8).  LANSA Composer will attempt to change the CCSID to 1208 to ensure the import operation is successful.  However, if LANSA Composer cannot effect the change (for example, due to lack of authority), you must ensure that the CCSID is set correctly.  The import operation will NOT proceed unless the CCSID is set to 1208.

PARTITION

This parameter specifies the identifier of the LANSA partition containing the LANSA Composer server installation to be used.  If not specified, the COMPOSER command will attempt to determine the partition identifier according to information recorded during the last LANSA Composer installation into this system.

In a standard LANSA Composer installation, the partition name is always LIC.  You should not normally need to specify this parameter.

LANGUAGE

This parameter specifies the national language to be used.  If not specified, the language defaults to the partition default language.