Address space minor commands

The following commands are minor commands of the address space selection majors commands. Minor commands are most commonly used with the JASnnn or JOBN commands to select a single address space by ASIDnnn or name.

You can use the address space minors with majors such as BATX and TSOJ, where they report on the first job selected. Use the authorized address space minors only with the address space majors that select one job at a time; this reduces the chance of an address space being accidentally modified when the display line changes unexpectedly.

All of these minors except for TADR and TSNM require the action character (-) in front of them to execute. It specifies that the command execute only once, and changes to a comment character (>) after this execution.

MCTL

Specifies CPU time limit for an address space.

Type:

Minor of address space majors

MCTL is authorized because it circumvents any job class restrictions. You can use MCTL to prevent the abend of a critical job if it takes more CPU time than was specified. MCTL may result in CPU time limits that are rounded up (by one second) from the user specification, due to the conversion between real time and time of day clock units.

Format:

{-}MCTL{=|+|-}{nnnn}{H|M|S}

-

An action character.

=

Sets the CPU time limit equal to the value specified by the nnnn argument.

+

Adds the value nnnn to the CPU time limit.

-

Subtracts the nnnn value from the CPU time limit.

nnnn

Decimal value to be added/subtracted/set.

H

Specifies hours as the unit of time.

M

Specifies minutes as the unit of time.

S

(Default) Specifies seconds as the unit of time.

For example:

>MCTL=23 H
+      >> TIME LIMIT IS NOW 23:00 HR <<

MNSW

Marks an address space nonswappable by the SRM.

Type:

Minor of address space majors

OMEGAMON uses a standard SRM interface to mark the current job step nonswappable.

For example, to mark job PAYROLL nonswappable, enter:

 JOBN  PAYROLL
-MNSW

MSWP

Marks an address space swappable by the SRM.

Type:

Minor of address space majors

The SRB routine uses a standard SRM interface to mark the current job step as subject to swapout.

For example, to mark job PAYROLL swappable, enter:

 JOBN  PAYROLL
-MSWP

SWPI

Causes the SRM to swap in an address space.

Type:

Minor of address space majors

To cause the SRM to swap in an address space, OMEGAMON invokes a standard SRM interface that forces a swap-in.

Note: To force the swap-in to occur, the SRM causes the target user to disregard the MPL constraints for the rest of the job step. For example, a job in a domain with the maximum MPL set to zero (that is, a swapout domain) can swap in and accumulate service after you issue SWPI.

For example, to swap in job PAYROLL, enter:

 JOBN  PAYROLL
-SWPI

The SRM swaps users in and out of memory on the basis of dynamically calculated recommendation Because SWPI does not affect these, the SRM will most likely swap the indicated user out again almost immediately. This limits the usefulness of the SWPI command.

TADR

Displays the unit address for the terminal of a TSO user.

Type:

Minor of address space majors

TADR is authorized because TSO keeps this information in a fetch-protected control block. (Note that VTAM® terminals typically have no unit address; use TSNM instead.) Here is an example:

 TSOJ  TS145    TS031    TS089
 TADR    345      34F      341 

TSNM

Displays the symbolic name of a TSO terminal as it is defined to TCAM or VTAM.

Type:

Minor of address space majors

TSNM is authorized because TSO keeps this information in a fetch-protected control block. Here is an example:

 TSOJ  TS145    TS031    TS089
 TSNM  L0413    L0416    RCRT0005