The following preparations must be made before staring MARENUCP:
- Define the mandatory and optional parameters. Using the MARENADM statement EDIT-/MODIFY-MAREN-PARAMETERS, the following mandatory or optional system-specific parameters must be defined which are also or exclusively evaluated by MARENUCP:
- CID-UID
- DEFAULT-FREE-DATE
- DEFAULT-HOME-LOCATION
- MOUNT-CHECK-INTERVAL
- OPERATOR-ROLE
- RESERVATION-SEQUENCE
- RESERVE-DEVICE-TYPES
- TEST-MODE
- These parameters may be changed during operation. The changes come into effect immediately.
- Use of a reservation file. A reservation file to be used must be assigned with the link name MARENLMF before calling MARENUCP (see section “Location management via a reservation file”).
- Using a MAREN exit. If an exit routine is to be used, the corresponding module library must be assigned with the link name MARENLIB before calling MARENUCP (see chapter “MAREN exits”). The exit routine is called after any assigned reservation files have been evaluated.
Starting MARENUCP
MARENUCP can be started after BS2000 and BCAM are ready to operate.
MARENUCP is called by means of the START-MARENUCP command. MARENUCP can also be called by means of the START-PROGRAM command for compatibility reasons.
| START-MARENUCP | Alias: MARENUCP | ||||||||
| |||||||||
VERSION =
The selected MARENUCP version is used.
VERSION = *STD
Before MARENUCP is called, the version is set by means of the SELECT-PRODUCT-VERSION command (in system mode). This set version is used as the default version.
VERSION = <product-version mandatory-man-corr>
Full version identifier.
VERSION = <product-version mandatory-man-without-corr>
Version identifier excluding the correction status.
VERSION = <product-version without-man-corr>
Version identifier excluding the release and correction status.
MONJV =
Specification of a job variable for monitoring the MARENUCP run.
MONJV = *NONE
A monitor job variable is not used.
MONJV = <filename 1..54 without-gen-vers>
Explicit specification of the job variable used to monitor the MARENUCP run.
CPU-LIMIT =
Maximum CPU time in seconds allocated for the program.
CPU-LIMIT = *JOB-REST
The remaining CPU time is to be used for the job.
CPU-LIMIT = <integer 1..32767 seconds>
Only the specified time is to be used.
Terminating MARENUCP
MARENUCP is terminated by means of the MARENADM statement//STOP-CONTROL-PROGRAM PROGRAM-NAME=MARENUCP
Alternatively, it can be terminated with the command (TSOS or OPERATING privilege):/INFORM-PROGRAM MSG=C'H[ALT][,KILL]',JOB-ID=*TSN(<tsn>)
If HALT is specified, MARENUCP usually ends immediately. If, however, a tape has already been reserved in response to a request, processing of this request is completed, after which MARENUCP is terminated. Further requests are not processed.
If HALT,KILL are specified, MARENUCP ends immediately.
If the errors that lead to termination of the MARENUCP run are easy to diagnose and therefore do not require a dump, they are simply logged by MARENUCP. Appropriate messages are issued to SYSOUT and/or console and task switch 29 is set.