IMON-BAS is called using the command START-IMON. If the TPR subsystem IMON is not yet active, this command starts it automatically.
Two interfaces are available for operating IMON-BAS:
Menu interface
IMON-BAS runs in menu mode. The menu interface is only available in interactive dialog.
General information on the IMON-BAS menu interface can be found in the section "Working with the menu interface of IMON-BAS". The menu functions are described in the section "Description of the IMON-BAS menu options".
SDF interface
IMON-BAS runs in statement mode, i.e. using SDF statements. The statements are described in the section "The IMON-BAS statements".
The INPUT-INTERFACE operand determines which interface is used to start IMON-BAS in the interactive dialog. The interface can also be switched here while the program is running.
A welcome screen is output when IMON-BAS is started in the menu mode that informs the user of calls to some important functions..
START-IMON |
VERSION = *STD / <product-version>(...) ,MONJV = *NONE / <filename 1..54 without-gen-vers> ,CPU-LIMIT = *JOB-REST / <integer 1..32767 seconds> ,INPUT-INTERFACE = *STD / *SDF |
VERSION =
The IMON version to be used.
VERSION = *STD
Use the version set with the SELECT-PRODUCT-VERSION command. If no version was selected, the highest available version of IMON is loaded by default.
VERSION = <product-version >
Defines the product version in the format mm.n[a[so]], e.g. 2.9 or 2.9A or 2.9A00 (see also description of SDF data types on "SDF syntax representation ").
MONJV =
A job variable for monitoring the IMON session.
MONJV = *NONE
No job variable.
MONJV = <filename 1..54 without-gen-vers>
The name of the job variable that is to monitor the IMON session.
CPU-LIMIT =
Maximum CPU time in seconds allowed for the program at runtime.
CPU-LIMIT = *JOB-REST
Use the remaining CPU time for the task.
CPU-LIMIT = <integer 1..32767 seconds>
The maximum time to be used.
INPUT-INTERFACE =
The interface to be used to start IMON-BAS.
INPUT-INTERFACE = *STD
Start IMON-BAS with the menu interface in interactive mode.
Start IMON-BAS with the SDF interface in procedure or batch mode.
INPUT-INTERFACE = *SDF
Start IMON-BAS with the SDF interface.
Notes
The TPR subsystem IMON-GPN must be started.
The TPR subsystem IMON is started automatically using the START-IMON command provided IMON-BAS and IMON-GPN were installed correctly and IMON-GPN is already started.
When you start IMON at the console, you must specify the operand INPUT-INTERFACE=*SDF.
When the program ends, the monitoring job variable can assume the following values:
Status display
(byte 0 - 2)
Return code
(byte 3 - 7)
Meaning
$T
'BLANK'0000
No error
$T
'BLANK'1010
Statement or function rejected, program is resumed.
$A
'BLANK'2010
Statement or function rejected, program is aborted.
Spin-off takes place.
$A
'BLANK'2015
Unexpected EOF on SYSDTA.
$A
'BLANK'3020
Internal inconsistency.
Terminating IMON-BAS
The way in which you terminate IMON-BAS depends on the current operating interface:
You can terminate IMON-BAS from the menu interface either by pressing [F3] or by selecting the Exit option in the File menu.
If the SDF interface is set, you can terminate IMON-BAS using the END statement.