UTIMER - Com-plete Timer Services Utility

#### Search Results

Search

# UTIMER - Com-plete Timer Services Utility

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:

- Command Format

- Using UTIMER

- UTIMER Functions

- Timer Exits

## Command Format

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)

## Using UTIMER

UTIMER is menu-driven. This means that you can access its functions directly from the UTIMER Main Menu.

### Entering Operands

#### Request Time

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.

#### Request Interval

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").

### Serving Timer Requests

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.

## UTIMER Functions

The UTIMER functions are discussed in the remainder of this section.

### Send Message

To send a message either to yourself or to another user ID, select function ID "S" or press PF1 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 ENTER, Com-plete displays the following message at the top of the UTIMER Main Menu:

    YOUR REQUEST HAS BEEN ADDED

#### Special usage of this function:

- 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

### Handle Job (OS systems only)

To submit, release, or cancel a job, select function ID "H" or press PF2 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 ENTER, 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.

### Log Me Off

To request that UTIMER log you off the Com-plete system at a certain time, select function ID "OF" or press PF3 on the UTIMER Main Menu. Also enter the required operand "Request Time".

When you press ENTER, Com-plete will display the following message at the top of the UTIMER Main Menu:

    YOUR REQUEST HAS BEEN ADDED

### List Personal Services

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 PF5 on the UTIMER Main Menu.

When you press ENTER, 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

### List All Services

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 PF6 on the UTIMER Main Menu.

When you press ENTER, a UTIMER Services Display screen like the one shown above appears, except it will show all users' requests.

### Restore Last Menu

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 PF12 on the UTIMER Main Menu.

## Timer Exits

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.

### On this page

- Command Format
- Using UTIMER
- UTIMER Functions
- Timer Exits