You are here: LANSA for i User Guide > 1. LANSA Overview > 1.4 LANSA Command > 1.4.1 Parameters

1.4.1 Parameters

REQUEST

This is the action requested to be performed within LANSA. The action requested can be up to 10 characters in length. The actions that may be requested include:

      http://123.45.67.89/cgi-bin/lansaweb?procfun+lansaweb+about+dem

     In this case the information can be saved to a save file or, if your email is configured, emailed directly to your LANSA support desk.

PROCESS

This parameter is used to specify the name of the process to RUN, SUBMIT or X_RUN. It can be up to 10 characters in length.

FUNCTION

This parameter is used to specify the name of the function to RUN or X_RUN. It can be up to 7 characters in length.

PARM01

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the first user parameter defined for the process being run or submitted.

If the request is EXPORT or PCEXPORT, this must be the name of the previously defined list that specifies object(s) to be exported. It can be up to 7 characters in length.

If the request is IMPORT, this must be the device or device file name if importing from magnetic tape or on a disk, otherwise blank. It can be up to 10 characters in length.

If the request is EXPORTMSGS, this must be the name of the file to receive the export developer message header details. It can be up to 10 characters in length.

If the request is IMPORTMSGS, this must be the name of the file to that contains the developer message header details to be imported. It can be up to 10 characters in length.

If the request is STRLISTEN, this can optionally be the special value *UNLOCK. The special value *UNLOCK tells the Listener Job to leave LANSA resources unlocked. This option reduces the dependency of the Listener Job on the LANSA system from which it is started.

If the request is REORG, this acts as Change Work Spaces parameter and valid values are N, Y and blank. If the value is blank the default value is 'N"

PARM02

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the second user parameter defined for the process being run or submitted.

If the request is EXPORT, this must be the device or device file name if exporting on magnetic tape or disk, blank otherwise. It can be up to 10 characters in length.

If the request is PCEXPORT, this must be the CheckOutUsage of R (read only) or M (maintenance).

If the request is IMPORT, this must be save file name if importing from a save file, otherwise blank. Can be a qualified name. It can be up to 21 characters in length.

If the request is EXPORTMSGS, this must be the name of the file to receive the export developer message text details. It can be up to 10 characters in length.

If the request is IMPORTMSGS, this must be the name of the file to that contains the developer message text details to be imported. It can be up to 10 characters in length.

If the request is REORG, this acts as Total FFC parameter and valid values are 1 to 99 and blank. If the value is blank the default value is 99

PARM03

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the third user parameter defined for the process being run or submitted.

If the request is EXPORT, this must be the save file name if exporting to a save file, blank otherwise. Can be a qualified name. It can be up to 21 characters in length.

If the request is PCEXPORT, and the CheckOutUsage (PARM02) is M (maintenance), this must be the Task. It can be up to 8 characters in length.

If the request is IMPORT, this must be name of message queue to which messages and inquiries are to be sent. It can be up to 10 characters in length.

If the request is EXPORTMSGS, this must be the name of the library where the exported developer message files will be created. It can be up to 10 characters in length.

If the request is IMPORTMSGS, this must be the name of library that contains the developer message files to be imported. It can be up to 10 characters in length.

If the request is REORG, this acts as Total Compiles parameter and valid values are 1 to 99 and blank. If the value is blank the default value is 20

PARM04 

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the fourth user parameter defined for the process being run or submitted.

If the request is EXPORT, this must be the file sequence number if exporting to a device (see PARM02). The default is *END if not specified. It can be up to 7 characters in length (numerics).

If the request is PCEXPORT, and the CheckOutUsage (PARM02) is M (maintenance), this must be the PC Name. It can be up to 10 characters in length.

If the request is IMPORT, this must be the source system type (AS/400). It can be up to 6 characters in length.

If the request is EXPORTMSGS, this must be the export start date. This is in CCYYMMDD format. All developer messages created or changed on or after the export start date will be exported. This must be 8 characters in length.

If the request is REORG, this acts as Remove Multilingual support parameter and valid values are N, Y and blank. If the value is blank the default value is N

PARM05

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the fifth user parameter defined for the process being run or submitted.

If the request is EXPORT, this is whether or not to omit RDML source code from exported data. (YES or NO). The default is NO if not specified. It can be up to 3 characters in length.

If the request is IMPORT, this is the file sequence number if importing from a device (see PARM01). The file sequence number can be up to 7 numbers long. The default is *SEARCH. If the import is from an optical device (see PARM01), then this is the optical file name. The optical file name can be up to 80 characters long.

If the request is REORG, this acts as Purge Developer Message starting from date parameter and valid value is a date format in CCYYMMDD and blank. If the value is blank the default value is 00000000. The date must be a valid date, as it is not validated.

PARM06

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the sixth user parameter defined for the process being run or submitted.

It is applicable to multilingual partitions and is mandatory when exporting and importing weblets.

If the request is EXPORT, this is the languages to be exported. Up to 64 language codes can be specified or *ALL to export all languages. It can be up to 256 characters in length.

If the request is IMPORT, this is whether or not to import all languages in the exported data. (Y or N). This is 1 character in length.

If the request is REORG, this acts as Delete Deleted Partition Language Extensions and valid values N, Y and blank. If the value is blank the default value is N

PARM07

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the seventh user parameter defined for the process being run or submitted.

If the request is EXPORT, this is do not save to media - leave in QTEMP. (YES or NO) Default is NO if not specified. It can be up to 3 characters in length.

If the request is IMPORT, this is the languages to be imported. Up to 64 language codes or *ALL to import all languages in exported data. Only applicable to multilingual partitions. It can be up to 256 characters in length.

If the request is REORG, this acts as Reorganize Shared LANSA system files and valid values N, Y and blank. If the value is blank the default value is N

PARM08

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the eighth user parameter defined for the process being run or submitted.

If the request is EXPORT, this is whether or not to include LANSA/Document details in the export. (YES or NO). Default is NO if not specified. It can be up to 3 characters in length.

If the request is IMPORT, this is the default language. Defaults to current language if not specified. Only applicable to multilingual partitions. It can be up to 4 characters in length.

If the request is REORG, this acts as Purge Task History starting from date parameter and valid value is a date format in CCYYMMDD and blank. If the value is blank the default value is 00000000. The date must be a valid date, as it is not validated.

PARM09

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the ninth user parameter defined for the process being run or submitted.

If the request is EXPORT, specify in characters 1 – 3 whether or not to omit frameworks and groups. (YES or NO). Defaults to NO if not specified.

If the request is IMPORT, specify, in characters 1-3, whether or not to assign new internal names. (YES or NO). Defaults to YES if not specified.

Use characters 4-6 to control the use of $$ files. Pass YES or NO or OPT. Default is NO if not specified.

If NO, any existing $$ file will not be automatically deleted.

If YES, any $$ file of the files being imported will be automatically deleted. The file name to be deleted is composed of $$ plus the first 8 characters of the file name. Where 9 and 10 character file names are not unique in the first 8 characters, this may result in additional $$ files being deleted. (For the processing to complete, these files must be deleted.)

If OPT, all $$ file processing is ignored. This means that you must have a viable back-up of all files being imported, and any existing $$ files for files being imported will remain. CHGPF will be used on files being imported that are DDS-based, while the SQL DDL CREATE OR REPLACE will be used on files being imported that are SQL-created.

PARM10

This parameter can be up to 256 characters in length.

If the request is RUN or SUBMIT, this must exactly match the tenth user parameter defined for the process being run or submitted.

If the request is IMPORT, specify in characters 1-10  the name of the library containing export objects. Only applicable for IBM i to S/38 transfer. It can be up to 10 characters in length.

Use characters 11-13 to specify Allow Name Changes. Pass as YES or NO. Defaults to NO if not specified.

Use characters 14-16 to specify Allow Type Changes. Pass as YES or NO. Defaults to NO if not specified.

Use characters 17 –19 to specify whether or not to omit frameworks and groups. (YES or NO). Defaults to NO if not specified.

PARTITION

This parameter is used to specify the name of the partition to be used. It can be up to 3 characters in length.

If not specified, the partition defaults to the SYS partition.

LANGUAGE

This parameter is used to specify the language to be used. It can be up to 4 characters in length.

Only applicable to multilingual partitions.

If not specified, the language defaults to the partition default language.

TASK_ID

This parameter is used to specify the task identifier to be used for development work. It can be up to 8 characters in length.

PC_TYPE

This parameter is used to specify the type of PC used with the GUI. This is 1 character in length.This is used internally by LANSA and is not usable in a normal LANSA invocation.

DEVELOPER

This parameter is used to specify whether LANSA presents a command line and work with interface. It is up to 9 characters in length.

ALLOW_MSGS

This parameter is used to specify whether or not access is given to developer services. It is up to 4 characters in length.

DATE_SRCE

This parameter is used to specify where to retrieve the date and date format from. It is up to 7 characters in length.

BDEBUG

This parameter is used to specify that batch debug of LANSA RDML functions is required.  This is used internally by LANSA and is not useable in a normal LANSA invocation.

BDEBUG_DEV

This parameter is used to specify the name of the display device to be used for debugging batch RDML functions. This is used internally by LANSA and is not useable in a normal LANSA invocation.

BDEBUG_MSG

This parameter is used to specify the name of the message queue to be used to issue messages when using batch debugging. This is used internally by LANSA and is not useable in a normal LANSA invocation.

X_RUNADPRM

This parameter is used to specify additional parameters for an X_RUN request. These additional parameters must be specified in the X_RUN format, e.g. PRTR=*PATH. Refer to Standard X_RUN Parameters in the Technical Reference Guide for details of X_RUN parameters.

For examples, refer to 1.4.2 Execute RDMLX function.