ESCLASS


The ESCLASS (ESC) service provides the ability to display a list of all current service classes.

Related topic

It also provides the ability to

  • display a specific service class
  • change a service class
  • quiesce an address space
  • resume a job that has been quiesced

Syntax

GUID-F2496D18-6D93-42D0-AB11-8854D788CE29-low.pngThe parameters are defined as follows:

Parameter

Description

asi

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

newclass

new service class name to be applied to the address space

QUIESCE (Q)

address space is to be quiesced

RESUME (R)

service class for the specified address space is to be set according to the current service policy

Example 1

To display a list of all service classes in the current service policy, type

ESC

AMTES4I Policy name:  BBPOL002
AMTES4I Policy desc:  BMC Software Test Policy
AMTES4I Activated by: BTSSEC3
AMTES4I From:         SYSC
AMTES4I On:           Tuesday, December 15, 2002 at 6:17:06 AM
AMTES0I
AMTES5I Class     Description
AMTES6I --------  --------------------------------
AMTES7I APPCHOT   APPC Hot Transactions
AMTES7I APPCNRM   APPC Normal Transactions
AMTES7I BATHOT    Batch Hot Jobs
AMTES7I BATNRM    Batch Normal Jobs
AMTES7I BATPROD   Batch Production Jobs
AMTES7I CICSHOT   CICS Hot Transactions
AMTES7I CICSNRM   CICS Normal Transactions
AMTES7I CICST1    T1** TRANS for J. Barnard
AMTES7I CICST2    T2** TRANS for J. Barnard
AMTES7I CICST3    T3** TRANS for J. Barnard
AMTES7I CICST4    T4** Trans for J. Barnard
AMTES7I CICST5    T5** TRANS for J. Barnard
AMTES7I COMPOSIT  composite service class
AMTES7I GRS       GRS Service Class
AMTES7I IMSHOT    IMS Hot Transactions
AMTES7I IMSNRM    IMS Normal Transactions
AMTES7I OMVSNRM   Open MVS Normal Transactions
AMTES7I RMF       rmf extractor service class
AMTES7I RMFGAT    RMF III Gatherer Service Class
AMTES7I SERVERS   Service class for Servers
AMTES7I STCLOW    Low Priority STC's
AMTES7I STCNONE   stc no service
AMTES7I STCNRM    Normal STC's
AMTES7I STCPAS    PAS STC's
AMTES7I STCPROD   Production STC's
AMTES7I STCSYS    System STC's
AMTES7I SWAPOUT   no service
AMTES7I TSOAVG    Normal TSO Users
AMTES7I TSOBBV    TSO BBV Users
AMTES7I TSODEMO   TSO DEMO Users


AMTES7I TSONRM    Normal TSO Users
AMTES7I TSONRM1   Normal TSO Users 2
AMTES7I TSOQ2     q/a TSO Users
AMTES7I TSOTEST   MMR Test TSO Service Class
AMTES7I SYSTEM    HIGH PRIORITY SYSTEM WORK
AMTES7I SYSSTC    STARTED TASK DEFAULT
AMTES7I SYSOTHER  UNCLASSIFIED WORK

Example 2

To display the service class and related service information for a specific address space, type

ESC,XTSTHPAS

AMTES1I Job name:        XTSTHPAS
AMTES1I Service class:   STCPAS
AMTES1I Description:     PAS STC's
AMTES1I Resource group:  PASSTC
AMTES1I Current period:  1
AMTES2I Importance lvl:  3
AMTES2I Period type:     Velocity goal
AMTES2I Goal:            60%

Example 3

To change the service class for a specified address space and display the information, type

ESC,XTSTHPAS,STCNRM

AMTES3I Service class changed for address space XTSTHPAS
AMTES0I
AMTES1I Job name:        XTSTHPAS
AMTES1I Service class:   STCNRM
AMTES1I Description:     Normal STC's
AMTES1I Current period:  1
AMTES2I Importance lvl:  4
AMTES2I Period type:     Velocity goal
AMTES2I Goal:            30%

Example 4

To quiesce a specified address space, type

ESC,XTSTHPAS,Q

AMTES9I Address space XTSTHPAS has been quiesced.

Example 5

To resume (restart) a specified address space and display the information, type

ESC,XTSTHPAS,RESUME

AMTES8I Resume successful for address space XTSTHPAS
AMTES0I
AMTES1I Job name:        XTSTHPAS
AMTES1I Service class:   STCPAS
AMTES1I Description:     PAS STC's
AMTES1I Resource group:  PASSTC
AMTES1I Current period:  1
AMTES2I Importance lvl:  3
AMTES2I Period type:     Velocity goal
AMTES2I Goal:            60%

Usage notes

The following points detail what the ESCLASS service can do.

  • display a list of all service classes in the current service policy and their descriptions

    This display is produced when the ESCLASS service is executed without any operands.

  • display the service class for a specific address space and service-related information

    This display is produced when a job name or ASID is specified as the first and only parameter. The ASID must be enclosed in parentheses and is assumed to be a decimal value unless preceded by an x.

    Example

     (x24) = (36)

  • change the service class for an address space

    This action is taken when a valid job name (or ASID) is specified as the first parameter and a valid service class is specified as the second parameter.

    Example

    ESCLASS,(x24),newclass will change the service class for the job in the address space with an ASID of decimal 36 (hexadecimal 24) to newclass.

  • quiesce an address space by specifying a valid job name or ASID as the first parameter and Q or QUIESCE as the second parameter

    Example

    ESCLASS job1,Q will quiesce job1.

  • resume (restart) a job that has been quiesced and cause the service class to be set according to the current service policy

    Specify the name of a job or an ASID as the first parameter and the keyword RESUME as the second parameter.

    Note

    Resuming a job causes the appropriate service class in the current service policy to be applied to the specified job. If you are resetting the job to reverse a QUIESCE, check the service class that is displayed to ensure that it is the desired service class. If not, use the ESCLASS service to change the service class. An example of resuming an address space:

    ESCLASS,JOB1,RESUME

 

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