LCPU


The LCPU (LCP) service provides the ability to display and modify the CPU time limits for an address space that were originally specified by the TIME parameter on the JOB and EXEC statements.

The CPU limit for the current job step and the limit for the job (maximum for all job steps) are displayed. The CPU time used and CPU time remaining for the job step are also displayed.

If new values are specified, the step limit is reset to the specified limit value. The job limit is also reset if the current value is less than the specified value; otherwise, it remains unchanged.

The maximum CPU limit value that can be specified is 1,440 minutes, which can be specified in minutes, seconds, or a combination of both.

Syntax

GUID-E4BFF43F-726D-4CF7-A8EF-48CE05AFED7F-low.pngThe parameters are defined as follows:

Parameter

Description

asi

address space instance; see Identifying-address-spaces for more information

minutes

number of minutes for the new CPU time limit

The maximum value that can be specified is 1440.

seconds

number of seconds for the new CPU time limit

You can specify the CPU time limit in minutes or seconds or both. If specifying in seconds only, you must insert two commas between the address space instance and the number of seconds, to indicate zero minutes.

U

in the third or fourth parameter position, indicates that the CPU time limit for the step can be set to a value less than the current limit value

Examples

To display the current CPU time limits and the amount of time remaining for the job and job step, type

LCPU, VAM3A

   [1]               [2]                               [3]                 
AMTLC1I  CPU limit for job VAM3A               [4] 10 minutes            
AMTLC2I  CPU limit for current step  ASMSTEP   [4]  2 minutes, 30 seconds
AMTLC3I  Step time used                        [4]  1 minutes, 35 seconds
AMTLC4I  Step time remaining                   [4] 55 seconds
AMTLC0I  CPU limit changed [5]

To increase the CPU time limit for the current job step and to display the new limit values and remaining CPU time, type

LCPU, VAM3A, 5

   [1]               [2]                               [3]              
AMTLC1I   CPU limit for job VAM3A              [4] 10 minutes            
AMTLC2I   CPU limit for current step ASMSTEP   [4]  5 minutes            
AMTLC3I   Step time used                       [4]  1 minutes, 35 seconds
AMTLC4I   Step time remaining                  [4]  3 minutes, 25 seconds
AMTLC0I   CPU limit changed [5]

Legend:

  1. message number
  2. address space instance (asi)
  3. minutes and seconds fields
  4. CPU time limit message lines
  5. notification of changed CPU limit

Related topic

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView SYSPROG Services 6.1