Starting the PERCON run

The command /START-PERCON or /PERCON calls PERCON as an autonomous program. For the syntax description see chapter "Notational conventions ".

Application areas: FILE, UTILITIES

START-PERCON / PERCON

VERSION = *STD / <product-version> / <product-version without-corr> / <product-version without-man>

,CPU-LIMIT = *JOB-REST / <integer 1..32767>

,MONJV = *NONE / <filename 1..54 without-gen-vers>

,PROGRAM-MODE = 24 / *ANY

VERSION = *STD / / <product-version> / <product-version without-corr> /

<product-version without-man>

Specifies the PERCON version to be called. The version can be called with various details

as indicated below: nn.nann or n.nann nn.na or n.na nn.n or n.n

(e.g. 03.0A00) (e.g. 03.0A) (e.g. 03.0)

fully qualified version specification specification without correction status specification without correction status and without release status

n is a numeric, a is an alpha character.

The version specification can be prefixed by the letter V and enclosed in single quotes.

Omission of the VERSION operand or specification of the operand value *STD means that no particular version is requested. If the version specification does not supply sufficient details, thus referring to more than one installed PERCON version, the correct version is selected using the criteria listed in chapter "Installation ". Execution of the start command is aborted and error message PER0104 is output if no version can be found that matches the version specification.

As an alternative, the command /SELECT-PRODUCT-VERSION can be used to request a particular PERCON version. This command is entered prior to calling PERCON (prior to calling the main program if PERCON is called as a subprogram). If the subsequent PERCON start command is entered without explicit version specification, the PERCON version specified with the /SELECT-PRODUCT-VERSION command will be started.

CPU-LIMIT = *JOB-REST / <integer 1..32767 seconds>
Maximum CPU time, in seconds, allowed for execution of the program.
If execution of the program exceeds the specified time, in interactive mode the program is interrupted and message EXC0075 is output. The user can request a dump, abort the program or continue the program. If a STXIT routine is defined in the program for the event of reaching the CPU time limit, this routine is executed and the program terminated.
In batch mode the program is terminated. See also manual  [9] "BS2000 commands" section "Time limits in BS2000".

CPU-LIMIT = *JOB-REST
If the job was started with a time limit, the remaining CPU time will be used as the time limit for the program. Otherwise, the program executes without a time limit.

MONJV = *NONE / <filename 1..54 without-gen-vers>
Specifies the name of the job variable that is to monitor the PERCON run. The job variable must already have been cataloged. This is only available to users with the software product JV (see manual [7] "Job Variables").

During the PERCON run the system sets the following values for the job variables:

Value $R $T $A

Meaning/reason for setting the value PERCON is executing. PERCON was terminated normally. PERCON was aborted.

MONJV = *NONE
No job variable is defined.

PROGRAM-MODE =

Defines the location in the address space where PERCON is loaded.

PROGRAM-MODE = 24
The entire load unit is loaded below the 16-Mb boundary. The program is executed in 24-bit addressing mode. External references are interpreted as 24-bit addresses.

PROGRAM-MODE = *ANY
The modules of the load unit can be located either below or above the 16-Mb boundary.