gtpo1mg3Operations

ZTMSL-Display, Change, Add, or Remove Time Slice Attributes

Use this command to display, change, or remove time slice attributes, or to add a time slice name with its associated attributes to the time slice name table.

Requirements and Restrictions

You can only enter this command from the basic subsystem (BSS).

Format




Display
displays the attributes associated with a time slice name if a time slice name was specified. Otherwise, a list of all supported time slice names is displayed.

Remove
removes a time slice name from the time slice name table. ECBs that are referencing the deleted time slice name are unaffected.

Change
Changes the attributes defined for a specific time slice name.

Add
adds a new time slice name.

name
is a 1- to 8-character alphanumeric time slice name.

MAXEcb-maxe
assigns the maximum number of ECBs for the specified time slice name, where maxe is a value from 0-9999.

MAXTime-maxt
assigns the maximum amount of accumulated run time that an ECB enabled for time slicing can use before exiting with an error, where maxt is a value from 0-9999999 milliseconds (ms). A value of 0 means that there is no predefined maximum run time; the ECB will run until it completes its function.

MInsusp-mins
assigns the minimum amount of time that an ECB enabled for time slicing can remain suspended, where mins is a value from 0-9999 ms.

Runtime-runt
assigns the maximum amount of time that an ECB enabled for time slicing can run without giving up control, where runt is a value from 10-500 ms.
Note:
This value cannot exceed the SIP generated value for the application timeout counter (set to 500 ms by IBM).

Copy
selects from which copy of the time slice name table to display, change, add, or remove time slice attributes, where:

File
specifies the file copy.

Core
specifies the core copy.

Both
specifies both the file and core copies.

Additional Information

Examples

The values of the MAXECB, MINSUSP, MAXTIME, and RUNTIME parameters for the BIGSORT time slice name are changed in the file copy of the time slice name table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTMSL C BIGSORT MAXE-20,MI-40,MAXT-5000,R-200                           |
|                                                                                |
|System: TMSL0005I 10.52.44                                                      |
|        OLD TIME SLICE ATTRIBUTES FOR NAME BIGSORT ON FILE                      |
|                                                                                |
|            MAXECB-15    MAXTIME-2000      MINSUSP-80     RUNTIME-100           |
|                                                                                |
|        NEW TIME SLICE ATTRIBUTES FOR NAME BIGSORT ON FILE                      |
|                                                                                |
|            MAXECB-20    MAXTIME-5000      MINSUSP-40     RUNTIME-200           |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The supported time slice names are displayed from the core copy of the time slice name table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTMSL D C-C                                                             |
|                                                                                |
|System: TMSL0002I 10.52.44                                                      |
|        EXISTING TIME SLICE NAMES IN CORE                                       |
|                                                                                |
|            IBMRSVD1       IBMRSVD2        CLOCKCHG        GLOBALU              |
|            SCHEDCHG       FAREWAR         QUOTEME         BIGSORT              |
|            LITTLSRT                                                            |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The BSEARCH time slice name is added to both the file copy and the core copy of the time slice name table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTMSL A BSEARCH MAXE-20,MI-40,MAXT-5000,R-200 C-B                       |
|                                                                                |
|System: TMSL0004I 10.52.44                                                      |
|        NEW TIME SLICE ATTRIBUTES FOR NAME BSEARCH ON FILE                      |
|                                                                                |
|            MAXECB-15    MAXTIME-2000      MINSUSP-80     RUNTIME-100           |
|                                                                                |
|        NEW TIME SLICE ATTRIBUTES FOR NAME BSEARCH IN CORE                      |
|                                                                                |
|            MAXECB-15    MAXTIME-2000      MINSUSP-80     RUNTIME-100           |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The OLDSORT time slice name is removed from the core copy of the time slice name table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTMSL R OLDSORT C-C                                                     |
|                                                                                |
|System: TMSL0010I 10.52.44                                                      |
|        THE TIME SLICE NAME OLDSORT HAS BEEN REMOVED IN CORE                    |
+--------------------------------------------------------------------------------+

Related Information

See TPF System Macros for more information about time slice names and attributes and their relation to the TMSLC macro.