LINC Programming Reference Manual - Public Support Login - Unisys

RUN
Value Description
ACTIV The terminal already has a Report attached.
BUSY The maximum number of Reports are already running, or the Report has
already been initiated by the same user.
INVAL The Report name is invalid or unlocatable.
spaces The value is spaces when the report is first initiated.
Note: There are some conditions under which a Report may seem to have started
satisfactorily with no error status being returned, but may not run due to a
system limitation. That is, you may have exceeded the maximum number of
processes that your operating system can handle.
Passing Parameters to Your Report
You can use LINC logic to pass parameter information to your Report in the following ways:
$ Use MESSAGE; and ACCEPT; logic commands so that your Report can collect runtime
information from user input.
$ In your Ispec logic, you can store information in the Database for your Report to read.
You must use this method if your parameter information is greater than 254 characters.
$ Specify the PA; command option with your RUN; command. Before you generate the
Report you want to run, you must have specified a data item on the Report Options
screen that will contain your parameter data. For more details, see your LINC
Generate Operations Guide. This is the simplest method of passing parameter data to
a Report using LINC logic, but it is limited to a maximum of 254 characters.
Restrictions on parameter passing are:
$ The PA; command option is ignored in LDA Run Time.
$ GLB.PARAM may be used to pass parameters in LDA Run Time.
$ Binary data is not allowed in the parameter for a UNIX LINC System, .
$ The contents of the Report parameter are undefined if a Report parameter is defined in
the Report, but the RUN; command does not pass the parameter.
$ The parameter will be ignored with no error, if the RUN; command passes a parameter,
but the Report does not specify a parameter.
$ The initial value of your Report parameter will be recovered regardless of any changes
you have made to the contents of Setup Data or Global Setup Data in your Report
logic, if the Report goes into recovery.
$ Up to 254 bytes of information can be sent to the Report from a WAKE.UP; command
in your Report or Ispec logic.
1-208 v