The Com-plete menu-driven utility UTIMER is a timer that allows you to schedule various functions at a predefined time. You can schedule the following items with UTIMER:
Message switching (Send Message);
Attach a program;
Issue UQ K command;
Job handling (submit, release, cancel);
Your own logoff from Com-plete;
This document covers the following topics:
To invoke UTIMER, enter the command:
*UTIMER
This displays the UTIMER Main Menu:
17:24:25 TID 15 COMPLETE User ID SAG 25.06.09
-- Com-plete Timer Services -- UTMR
Function ID PFK Operands
---------------------- -- --- ------------------------------------------
Send Message S 1 Time etc., Message, Userid (,Urgent)
Handle Job H 2 Time etc., Job Name, Job Action
Log Me Off OF 3 Time etc.
List Personal Services LP 5
List All Services LA 6
Restore Last Menu R 12
Select Function: or PFK
and Operands
Request Time: 0 : 0 on 25 / 06 / 09
Repeat If Impossible:
Up to: 24 : 0 on 25 / 06 / 09
Request Interval: (D Day W Week M Month Y Year)
Message Text:
Userid: SAG Urgent:
Job Name: Job Action: (S Submit R Release C Cancel)
|
UTIMER is menu-driven. This means that you can access its functions directly from the UTIMER Main Menu.
Note that the first three functions on the UTIMER Main Menu ("Send Message", "Handle Job", and "Log Me Off") require that the "Request Time" operand be entered.
Note that when you add a new timer request, you must enter a valid time and date that is later than the present time. If the action could not be performed on the first attempt, you can also request that the timer attempt to repeat the action "Up to" a certain time and day.
By using the optional operand "Request Interval", you can also repeat the request in increments of a day ("D"), a week ("W"), a month ("M"), or a year ("Y").
The timer monitor UTIMRM is loaded into an attached TIB at Com-plete startup time, storing all timer requests in a timer SD file. The Com-plete nucleus consults UTIMRM each minute in order to determine what is to be performed at the present time.
The UTIMER functions are discussed in the remainder of this section.
To send a message either to yourself or to another user ID, select function ID "S" or press on the UTIMER Main Menu. Enter the required operands in the input fields next to "Request Time", "Message Text", and "Userid" (note that "Userid" defaults to your user ID). In addition, if it is an urgent message, mark "Urgent" with any character on the UTIMER Main Menu.
When you press , Com-plete displays the following message at the top of the UTIMER Main Menu:
YOUR REQUEST HAS BEEN ADDED
Issue UQ K command: enter the command as message text and set Userid to SYSTEM
Attach a program: add the program name starting with ‘*’ plus parameters as message text and set Userid to COMP
To submit, release, or cancel a job, select function ID "H" or press on the UTIMER Main Menu. Also enter the required operands in the input fields next to "Request Time" and "Job Name", and enter "S", "R", or "C" as "Job Action".
When you press , Com-plete displays the following message at the top of the UTIMER Main Menu:
YOUR REQUEST HAS BEEN ADDED
The jobs to be submitted are stored in a data set referenced by a "SYSJOBS" DD statement in the Com-plete startup procedure.
To request that UTIMER log you off the Com-plete system at a certain time, select function ID "OF" or press on the UTIMER Main Menu. Also enter the required operand "Request Time".
When you press , Com-plete will display the following message at the top of the UTIMER Main Menu:
YOUR REQUEST HAS BEEN ADDED
To display all of the scheduled UTIMER requests for the user ID displayed at the bottom of the UTIMER Main Menu (the default is your user ID), select function ID "LP" or press on the UTIMER Main Menu.
When you press , the UTIMER Services Display (for the user ID displayed at the bottom of the UTIMER Main Menu) appears:
14:03:59 TID 13 COM-5.1. User ID ADMIN 09/26/97
UTML
USERID | DATE | TIME | FREQUENCY |SEND MSG TO| USER |L|R|C|S| JOBNAME || F
==============================================================================
SAJXS 09/24/87 09.05 X SAJXSREP
SAJXS 09/24/87 15.00 REMINDE... SAJXS SAJXSCNF
SAJXS 09/24/87 19.00 X SAJXSCNF
==============================================================================
L = LOGOFF USERID ; R = RELEASE JOB ; C = CANCEL JOB ; S = SUBMIT JOB
F = FLAGS :: L = LONG MSG ; D = DELETE ; F = FREEZE ; A = ACTIVATE |
Note:
The "List All Services" function is available for control users
only.
To display all scheduled requests for all users, select function ID "LA" or press on the UTIMER Main Menu.
When you press , a UTIMER Services Display screen like the one shown above appears, except it will show all users' requests.
The "Restore Last Menu" function is useful when you want to add several similar requests.
To cause the last-entered input data (i.e., function ID and
operands) to reappear on the UTIMER Main Menu, select function ID "R" or press
on the UTIMER Main Menu.
The following table describes the three UTIMER timer exits.
| Exit | Description |
|---|---|
| UTMEX1 | Is called by UTIMER in order to decide whether a request is to be logged in the timer SD file or not. |
| UTMEX2 | Is consulted each minute by UTIMRM in order to decide whether a request is to be served at the present time or not. This exit can be used to add new "artificial" requests. |
| UTMEX3 | Is an RJE submission exit called by UTIMRM; is similar to UXEEX3. |
For detailed exit interface descriptions, see the Com-plete System Programming documentation.
Note:
In order for an installation to be able to use UTIMER, the
Com-plete systems programmer must add the following statement to the Com-plete
sysparms:
STARTUPPGM=UTIMRM
With the SUBMIT function, you are advised to catalog UTIMRM in ULIB with AF, as UTMOO3 errors may occur otherwise.