View Source

RUNNBR

This parameter specifies the run number for which Processing Sequence run information is to be retrieved. If your CL program "knows" the run number, it may specify the value directly through this parameter. Alternatively, your program may specify the following special value:

*PRV: Specifies that the command should retrieve run information for the last Processing Sequence run completed in the same job and that was initiated using the COMPOSER command.

(When a Processing Sequence is run using the COMPOSER command, it leaves the data area DXP1CPP in library QTEMP, identifying details of the run. The *PRV special value in this command uses the values in that data area to determine the run number. It will not be effective if the run was not executed using the COMPOSER command or if it was executed in another job, or if the data area in QTEMP is no longer extant or if its contents have been changed by some other means since the last COMPOSER command that ran a Processing Sequence.)

When RUNNBR(*PRV) is specified, the value specified for the PARTITION parameter, if any, is ignored. (In a standard LANSA Composer installation, it should not be necessary to specify a value for the PARTITION parameter.)

OUPNAM

This parameter may specify the name of an output parameter from the specified Processing Sequence run whose value is to be retrieved and placed in the Control Language (CL) variable specified by the RTNOUPVAL parameter. You can specify the name of the output parameter, or you can use one of the following special values:

*NONE: No output parameter value is to be retrieved.

*ONLY: If your Processing Sequence only has one output parameter, then you can use the special value *ONLY to receive its value.

*ONLY does not enforce that there is only one output parameter. It simply receives just one output parameter value, on the assumption that it is the only one. If the Processing Sequence in fact has more than one output parameter, which parameter's value is received by using *ONLY is undefined. You should not use *ONLY in this circumstance.

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.

RTNRUNNBR

This parameter may specify a Control Language (CL) variable that is to receive the run number for the specified Processing Sequence run. If used, the CL variable should be declared as *DEC (15 0).

RTNRESULT

This parameter may specify a Control Language (CL) variable that is to receive the two-character result code for the specified Processing Sequence run. If used, the CL variable should be declared as *CHAR (2).

RTNOUPVAL

This parameter may specify a Control Language (CL) variable that is to receive the output parameter value for the specified output parameter from the specified Processing Sequence run. If used, the CL variable should be declared as *CHAR (256).