Summary of system events

Mnemonic:

PPMODE

Meaning:

A time sharing command, or a subcommand of EDIT or TEST, is to be run.

Circumstances:

The TSO/E terminal monitor program or the EDIT/TEST command processor issues this SYSEVENT when the command or subcommand is about to be run. It causes no action on the part of SRM.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the first 4 characters of the command or subcommand name.

Reg 15: Contains the last 4 characters of the command or subcommand name.

Outputs:

None.

Mnemonic:

TIMEREXP

Meaning:

Time of day (TOD) clock initialized.

Purpose:

At TOD clock initialization, the SYSEVENT schedules SRM time-driven routines. Subsequent scheduling is done through SYSEVENT 05 (Time).

Circumstances:

TOD clock initialized.

Locks Required:

Local

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: Contains X'01' to indicate entry from system TOD clock initialization.

Outputs:

None.

Mnemonic:

TERMWAIT

Meaning:

Terminal wait.

Purpose:

Indicates that a TSO/E session is in a terminal wait state.

Circumstances:

A TSO/E session is in terminal wait after the issuance of a TGET or a TPUT. Receiving the TERMWAIT SYSEVENT is an indicator for SRM that the current transaction for a TSO/E address space must end, if the address space is in long wait status and is swappable. The occurrence of this system event does not always mean that the entire address space is in a long wait status. Use the quiesce function for proper determination.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: contains:

X'00'

If for an input terminal wait.

X'80'

If for an output terminal wait.

Outputs:

None.

Mnemonic:

NIOWAIT

Meaning:

An address space is suspected of being in long wait.

Purpose:

Indicates to SRM when an address space is suspected of entering a long wait.

Circumstances:

Some task in the address space entered long wait. Occurrence of this SYSEVENT does not mean that the entire address space is in a long wait status. This determination can be made only by the quiesce function. The time that is spent by a swappable address space in long wait is not considered part of the current transaction for that address space.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

USERRDY

Meaning:

User ready.

Purpose:

Indicates that a swapped out address space in a wait state or an address space for which the quiesce function is running has at least one dispatchable unit, (SRB) that is ready to run.

Circumstances:

Something is causing a dispatchable unit (SRB) to be scheduled to this address space.

Locks Required:

Dispatcher Note that the dispatcher lock might not always be held.

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

This SYSEVENT is not traced by GTF.

Mnemonic:

TIME

Meaning:

The SRM timer interval expired.

Purpose:

Invokes the time slice dispatching algorithm if it is active and is to run. Schedules all other SRM algorithms that are due. Calculates the time of the next invocation of this SYSEVENT and informs the timer routine.

Circumstances:

The time routines recognize that the SRM time interval elapsed. When the SYSEVENT is issued, the SRM timer queue element is removed from the queue.

Locks Required:

Local

Inputs:

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

MEMCREAT

Meaning:

Address space create.

Purpose:

Indicates that a new address space is about to be created. Indicates the type of origin of the new address space (for example, START, LOGON, MOUNT). Gives SRM a chance to prohibit the creation of the address space.

Circumstances:

At the earliest point where the ASID is known and the space for the ASCB is obtained.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

If START.

X'02'

If LOGON.

X'03'

If MOUNT.

Outputs:

Reg 1, byte 0: contains:

X'00'

If the address space creation can proceed.

X'80'

If the address space creation cannot proceed because of a resource shortage that is determined by SRM.

Mnemonic:

MEMDEL

Meaning:

Address space deletes.

Purpose:

Indicates the deletion of an address space to SRM, allowing SRM to release resources that are assigned to that address space.

Circumstances:

The memory delete function is about to free the storage for the ASCB and unassign the ASID.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 2: Contains X'80' indicating that no more swap-ins are to be started until the next MEMDEL SYSEVENT.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, byte 3: contains X'00' indicating that the memory delete function can proceed.

Mnemonic:

JOBSELCT

Meaning:

Job selection.

Purpose:

Indicates that an address space started by using system services on behalf of a new job, START or MOUNT command, or a TSO/E session.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a serialized parameter list. The parameter list is mapped by the IRAICSP mapping macro.

Output:

None.

Mnemonic:

JOBTERM

Meaning:

Job termination.

Purpose:

Indicates that an address space completed using system services on behalf of a job, START or MOUNT command, or a TSO/E session.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: pointer to an 8-byte area that contains the job name or user ID.

Outputs:

None.

Mnemonic:

INITATT

Meaning:

Attached by initiator.

Purpose.

Indicates that an initiator attached a task; this SYSEVENT is related to a JOBSELCT SYSEVENT (code 8).

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: contains the address of a serialized parameter list. The parameter list is mapped by the IRAICSP mapping macro.

Outputs:

None.

Mnemonic:

INITDET

Meaning:

Detach by initiator.

Purpose:

Indicates that an initiator detached a task.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

QSCEST

Meaning:

Quiesce started.

Purpose:

Permits an initial assessment of whether an address space, which is suspected of being in long wait, is in fact in long wait. Provides for reversing the quiesce of an address space.

Circumstances:

SRM recently posted quiesce.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: contains:

X'00'

If the address space is not in a long wait.

X'80'

If all tasks in the address space are in a long wait.

Outputs:

Reg 1, byte 3: contains:

X'00'

When the region control task (RCT) is to continue with the quiesce.

X'08'

When the address space should be restored to its original status.

Mnemonic:

QSCECMP

Meaning:

Quiesce completed.

Purpose:

Permits a final assessment of whether the address space is to be swapped out. If between QSCEST (code 0C) and QSCECMP, a USERRDY (code 04) has been received for the address space, the quiesce function will be notified that the address space is not in true long wait status. Also allows SRM to determine if the address space should be logically or physically swapped.

Note: The swapped in interval is defined to end with this SYSEVENT.

Circumstances:

The region control task (RCT) has completed quiesce processing for an address space.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: contains:

X'00'

If the address space is not in a long wait.

X'80'

If the address space is in long wait.

Reg 1, byte 1: contains:

X'40'

Indicates a successful In-Real-Swap for a logically swapped address space.

X'80'

Indicates a failure (RSM returned with an error).

Outputs:

Reg 1, byte 0: contains X'00' if USERRDY (code 04) was just received; unchanged by SRM if no USERRDY received since QSCEST (code 0C).

Reg 1, byte 2: Contains the swap reason code. The swap reason code values and descriptors are mapped by the IRASRCD mapping macro.

Reg 1, byte 3: contains:

X'00'

If the RCT is to schedule swap-out.

X'04'

If the RCT is to wait while the address space is logically swapped.

X'08'

If the address space is to be restored.

X'0C'

Indicates a TRANSWAP.

X'10'

Indicates a REALSWAP.

Mnemonic:

TRANSWAP

Meaning:

Transition swap an address space.

Purpose:

Causes the transition of an address space from swappable to non-swappable.

Note: If you specify an ASID with DONTSWAP, OKSWAP, or TRANSWAP, that ASID must specify the home address space. In other words, you can only control swapping in the address space in which the SYSEVENT is issued. If you specify a different address space, the request will fail.

Circumstances:

A TRANSWAP is issued for a V=R job step or a non-swappable program to force a swap out. After the subsequent swap in, frames are allocated from preferred storage and the address space is marked non-swappable. TRANSWAP prevents these programs from being assigned frames in reconfigurable storage.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of the ECB to be posted, or zero if there is no dependency on the transition. (Note: An ECB can only be specified if the request is for the current address space.)

Outputs:

Reg 1, byte 3: contains:

X'00'

Transition request accepted.

X'04'

Transition was done previously.

Post codes:

X'00'

Transition is complete. The post is issued by SYSEVENT SWOUTCMP (0F).

X'04'

The address space became non-swappable before it could be swapped out. The post is issued by SYSEVENT QSCEST (0C) or QSCECMP (0D).

Mnemonic:

SWOUTCMP

Meaning:

Swap-out completed.

Purpose:

Indicates that swap-out processing has completed.

Circumstances:

All I/O needed to swap-out this address space has just completed.

Locks Required:

RSMAD

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of a parameter list. The format is as follows:

Word 1

The number of pages swapped out

Word 2

The working set size (the number of pages to be swapped in)

Word 3, bytes 0-2

Reserved

Word 3, byte 3

Flag byte:

Bits 0-6

Reserved

Bit 7

Contains 0 if the address space is in long wait; contains 1 if the address space is waiting for an unfinished real storage manager service.

Outputs:

None.

Mnemonic:

SWINSTAT

Meaning:

Swap-in status.

Circumstances:

Swap-in processing for an address space that has just started, or just completed.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'00'

Swap-in is starting.

X'01'

Resources needed to perform the swap-in were obtained.

X'02'

Swap-in is complete.

Outputs:

None.

Mnemonic:

SWINFL

Meaning:

Swap-in failed.

Circumstances:

Swap-in processing failed to obtain or initialize the LSQA and fixed pages for the specified address space.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

Swap-in failed because there are not enough page control blocks (PCBs) available to complete the swap-in.

X'02'

Swap-in failed because there are not enough frames available for the working set.

X'03'

Swap-in failed because swapping in this address space would cause the number of fixed frames to exceed the limit that SRM passed to RSM on the swap-in request.

X'04'

Swap-in failed because there are not enough frames available for the address space's segment table.

Outputs:

None.

Mnemonic:

QSCEFL

Meaning:

Quiesce failed.

Purpose:

Notifies SRM that during an attempt to quiesce an address space the quiesce function has failed. The address space has been restored when the SYSEVENT is issued.

Circumstances:

Region control task failed to complete quiesce processing due to an abnormal situation.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

RSTORCMP

Meaning:

Restore completed.

Purpose:

Permits an assessment of whether an address space, suspected of having left long wait status, is in fact ready.

Note: The swapped in interval is defined to begin with this SYSEVENT.

Circumstances:

Region control task has completed restore processing for an address space. The circumstances giving rise to the restoring of an address space still in long wait stem from not knowing that the address space is waiting on more than one event.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: contains:

X'00'

If the address space is ready.

X'80'

If the address space is in a long wait.

Outputs:

None.

Mnemonic:

ENQHOLD

Meaning:

ENQ contention occurred.

Purpose:

Identifies a holder of a resource causing contention. SRM may boost the service to the holder (enclave or address space) of the resource to resolve the contention.

Circumstances:

Application dependent.

Locks Required:

Local and CMSEQDQ

Inputs for Type 0 Callers:

Reg 0, bytes 0-1: ASID of address space holding the resource. If the high order bit of the ASID is set to 1, then this ENQHOLD is for an enclave, and access registers 0-1 contain the 8-byte enclave token.

Reg 0, byte 2, bits 0-6: Reserved.

Reg 0, byte 2, bit 7: Set to 0 for Type 0 callers.

Reg 0, byte 3: SYSEVENT code.

Access Registers 0-1: Contains the enclave token or 0.

Inputs for Type 2 Callers:

Reg 0, bytes 0-1: ASID of address space holding the resource.

Reg 0, byte 2, bits 0-6: Reserved.

Reg 0, byte 2, bit 7: Set to 2 for Type 2 callers.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a parameter list. The parameter list is mapped by the IRAEVPL macro.

Inputs for Type 3 Callers:

Reg 0, bytes 0-1: ‘8000’X .

Reg 0, byte 2: Set to 3 for Type 3 callers.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a parameter list. The parameter list is mapped by the IRAEVPL macro.

Outputs:

None.

Mnemonic:

ENQRLSE

Meaning:

Notify SRM that a resource causing contention has been released

Purpose:

Notify SRM that the holder of a resource causing contention has released the resource.

Circumstances:

Application dependent.

Locks Required:

Local and CMSEQDQ

Inputs for Type 0 Callers:

Reg 0, bytes 0-1: ASID of address space holding the resource. If the high order bit of the ASID is set to 1, then this ENQRLSE is for an enclave, and access registers 0-1 contain the 8-byte enclave token.

Reg 0, byte 2, bits 0-6: Reserved.

Reg 0, byte 2, bit 7: Set to 0 for Type 0 callers.

Reg 0, byte 3: SYSEVENT code.

Access Registers 0-1: Contains the enclave token or 0.

Inputs for Type 2 Callers:

Reg 0, bytes 0-1: ASID of address space holding the resource.

Reg 0, byte 2, bits 0-6: Reserved.

Reg 0, byte 2, bit 7: Set to 2 for Type 2 callers.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a parameter list. The parameter list is mapped by the IRAEVPL macro.

Inputs for Type 3 Callers:

Reg 0, bytes 0-1: ‘8000’x.

Reg 0, byte 2: Set to 3 for Type 3 callers.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a parameter list. The parameter list is mapped by the IRAEVPL macro.

Outputs:

None.

Mnemonic:

RSMCNSTS

Meaning:

Real storage manager constants

Purpose:

Notifies SRM that the amount of online real storage has changed and that SRM should calculate new storage threshold values.

Circumstances:

Issued when the amount of online real storage has changed.

Locks Required:

RSMGL (under certain conditions)

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'00'

If the RSM frame counts are not being initialized.

X'04'

If the RSM frame counts are being initialized.

X'08'

If expanded storage reconfiguration is underway.

X'0C'

If expanded storage reconfiguration is complete.

Outputs:

None.

Mnemonic:

AVQLOW

Meaning:

Available frame queues below limit.

Purpose:

Notifies SRM that the number of frames on the available frame queues has dropped below predefined limits.

Circumstances:

Issued whenever allocation of a frame causes the number left on the available frame queues to drop below one of the predefined limits.

Locks Required:

RSMGL

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

If the number of frames on the available frame queues has dropped below the limit.

X'02'

If the number of frames on the available frame queues has dropped to zero.

X'03'

If a frame is needed and there are no frames on the available frame queues.

X'04'

If the ratio of fixed frames to total frames has increased above the allowable value.

X'05'

If a frame from the SQA reserve queue must be used to satisfy a SQA GETMAIN request.

Outputs:

None.

Mnemonic:

AVQOK

Meaning:

Available frame queue above limit.

Purpose:

Notifies SRM that the number of frames on the available frame queues has risen above a predefined limit.

Circumstances:

Is issued whenever unallocation of a frame causes the number left on the available frame queues to rise above the predefined limit. This SYSEVENT is issued only when the number of frames rises above the predefined limit after the “available frame queues below limit” SYSEVENT (code 17) was issued.

Locks Required:

RSMGL

Inputs:

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

SQALOW

Meaning:

Unallocated SQA and CSA below threshold.

Purpose:

Indicates that the amount of unallocated virtual SQA and CSA has dropped below one of two predefined thresholds.

Circumstances:

Virtual storage manager has just satisfied an SQA or CSA allocation request which resulted in the amount of unallocated SQA and CSA dropping below one of the two predefined thresholds.

Locks Required:

VSMFIX

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

If the first (less serious) threshold is passed.

X'02'

If the second threshold is passed.

Outputs:

None.

Mnemonic:

SQAOK

Meaning:

Unallocated SQA and CSA above threshold.

Purpose:

Indicates that the amount of unallocated SQA has risen above one of two predefined thresholds.

Circumstances:

Virtual storage manager has just handled an SQA or CSA unallocation request which resulted in the amount of unallocated SQA and CSA rising above one of the two predefined thresholds.

Locks Required:

VSMFIX

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

If the first (less serious) threshold is passed.

X'02'

If the second threshold is passed.

Outputs:

None.

Meaning:

A system component address space is initiated for operation.

Mnemonic

EASINIT

Purpose:

Indicates that a system component address space is initialized, but is not allowed to contend for system resources yet. Accumulation of its residency time and active time needs to be started.

Circumstances:

Before the completion of the master scheduler initialization, a system component address space is initialized for the operation.

Locks Required:

Local

Inputs:

Reg 0, bytes 0 and 1: The ASID of the address space that is initialized.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 2: A flag byte identifying attributes of the address space that is initialized. The flag is:

X'80'

An address space that is defined as privileged. (If using ASCRE to create the address space, this corresponds to the PRIV attribute).

Reg 1, byte 3: A type code identifying the kind of address space that is initialized. The type code is:

X'01'

An address space in which high-priority system services execute (if using ASCRE to create the address space, this corresponds to the HIPRI attribute).

other

An address space in which high priority system services do not execute.

Outputs:

None.

Mnemonic:

DEVALLOC

Meaning:

Device allocation request.

Purpose:

Provides SRM with necessary data for making a device allocation decision where two or more candidates exist.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of a list of three full-word addresses. The first points to a list of candidate UCB addresses. The second points to a list of addresses of UCBs already allocated to the requesting jobstep. The third points to a 2-word return area.

The first word in the list of candidate UCBs contains a count of the number of candidates in the list. The first word of the list of addresses of already allocated UCBs contains a count of the number of addresses in the list. All input and output data areas must be fixed.

Outputs:

Reg 1, bytes 0-3: Contains the same address present at input.

Return area 1st word: Contains the address of the candidate list entry which was selected.

Reg 15, byte 3: contains:

X'00'

If allocation selection was successfully made.

X'08'

If allocation selection was unsuccessfully made.

Mnemonic:

CONFIGCH

Meaning:

System configuration change.

Purpose:

Indicates that a central processor is to be removed from or added to the system. Also can indicate whether the system is to bring online or take offline the Vector Facility attached to a central processor.

Circumstances:

The system operator has issued a CONFIG central processor (online or offline) command.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of the PCCA for the central processor being removed from or added to the system.

Outputs:

None.

Mnemonic:

VERIFYPG

Meaning:

Not valid in goal mode.

Mnemonic:

RESETPG

Mnemonic:

ALTCPREC

Meaning:

Alternate central processor recovery (ACR)

Purpose:

Notifies SRM that one central processor has been removed from the configuration.

Circumstances:

As a result of some error, ACR has had to reconfigure one central processor out of the system.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of the PCCA for the failed central processor.

Outputs:

None.

Mnemonic:

TGETTPUT

Meaning:

TGET/TPUT satisfied.

Purpose:

Indicates a change in the status of the current TSO/E transaction.

Circumstances:

TGET or TPUT completed.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: - Flag byte, as follows:

Bit 0

Contains 0 if TGET was satisfied. Contains 1 if TPUT was satisfied.

Bit 1

(Applies to TGET satisfied only.) Contains 0 if all the data in the TSO/E input message was transferred by the TGET. Contains 1 if part of the data in the TSO/E input message was not yet transferred by this TGET (at least one more TGET is required to obtain the rest of the data in the TSO/E input message).

Bits 2-7

Reserved

Outputs:

None.

Mnemonic:

SETDMN

Meaning:

Not valid in goal mode.

Mnemonic:

REQSERVC

Meaning:

Request for service data.

Purpose:

Permits service-related data to be obtained for a given address space from SRM.

Circumstances:

TSO/E TIME command will also use the REQSERVC SYSEVENT to obtain service data.

The output area does not have to be fixed, and the issuer is not required to be authorized.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a 3-word area where the service data is to be stored.

Outputs:

Service data supplied by SRM:

• In the case of a TSO/E address space, the 3-word area contains:

  Word 1

  Total service for the job

  Word 2

  Total transaction active time

  Word 3

  Contents are as follows:

  Bytes 0-1

  Performance group number last assigned to the address space

  Bytes 2-3

  For TSO/E users, the total number of transactions.

• In the case of a non-TSO/E address space, the 3-word area contains:

  Word 1

  Total service for the session

  Word 2

  Total active time for all transactions

  Word 3

  Contents are as follows:

  Bytes 0-1

  Performance group number last assigned to the address space

  Bytes 2-3

  Zeros.

Reg 15, byte 3: contains:

X'04'

If data was lost due to accumulation control block error.

X'00'

Otherwise

Mnemonic:

REQPGDAT

Meaning:

Request by SMF for job paging data.

Purpose:

Permits SMF to obtain paging data for a given address space from SRM.

Circumstances:

SMF issues REQPGDAT during step termination.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 2, bit 0: 0 indicates that this paging data request is for the end of a job step; 1 indicates that this paging data request is for an SMF accounting interval.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a fixed area where the paging data is to be stored.

Outputs:

Reg 1 contains the same address as on input.

Reg 15, byte 3: contains:

X'00'

Data successfully returned.

X'04'

Data not returned.

Mnemonic:

COPYDMDT

Meaning:

Not valid in goal mode.

Mnemonic:

DONTSWAP

Meaning:

Address space is now not swappable.

Purpose:

Indicates to SRM that the issuing address space must not be swapped until further notice.

Note: If you specify an ASID with DONTSWAP, OKSWAP, or TRANSWAP, that ASID must specify the home address space. In other words, you can only control swapping in the address space in which the SYSEVENT is issued. If you specify a different address space, the request will fail.

Circumstances:

Application dependent.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID of issuing address space, or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, byte 3: contains:

X'00'

If the request to mark the address space as non-swappable was honored.

X'04'

If request is not for the current address space.

X'08'

If request was not authorized, or if the outstanding count of DONTSWAP requests (code 29) has reached its maximum value.

Mnemonic:

OKSWAP

Meaning:

Address space is now swappable.

Purpose:

Indicates to SRM that the issuing address space can now be swapped.

Note: If you specify an ASID with DONTSWAP, OKSWAP, or TRANSWAP, that ASID must specify the home address space. In other words, you can only control swapping in the address space in which the SYSEVENT is issued. If you specify a different address space, the request will fail.

Circumstances:

Application dependent.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID of issuing address space, or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, byte 3: contains:

X'00'

If the request to mark the address space as swappable was honored.

X'04'

If the request is not for the current address space.

X'08'

If the request was not authorized.

Mnemonic:

RSTORFL

Meaning:

Restore of an address space failed.

Purpose:

When it is not possible to restore an address space, the region control task (RCT) issues a RSTORFL SYSEVENT to inform SRM.

Circumstances:

This SYSEVENT gets issued by the region control task (RCT), when it is currently not possible to restore the address space. SRM tells the region control task (RCT) how to continue.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 2: SYSEVENT type.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, byte 3: contains:

X'00'

RCT continues to wait on the ASCBQECB.

X'08'

RCT cancels the address space.

Mnemonic:

None.

Purpose:

Issued by SRM itself in order to invoke its control routine immediately without waiting for a SYSEVENT issued by another component.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of the service request block under which this SYSEVENT is issued.

Outputs:

None.

Mnemonic:

REQSVDAT

Meaning:

Request service data.

Purpose:

Permits SMF to obtain service-related data for a given address space.

Circumstances:

SMF issues REQSVDAT during job or session completion processing.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or 0.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: The address of a fixed area where the service data is to be stored.

Outputs:

The contents of the area are mapped by the IRARQSRV macro in SYS1.MODGEN.

This SYSEVENT is not traced by GTF.

Mnemonic:

HOLD

Meaning:

Hold the address space from being swapped out.

Purpose:

Notify SRM that the issuing address space must not be swapped out until a SYSEVENT NOHOLD (X'33') occurs.

Circumstances:

The running program has a short instruction sequence during which the address space cannot be swapped out.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

This SYSEVENT is not traced by GTF.

Mnemonic:

NOHOLD

Meaning:

No longer hold the address space from being swapped out.

Purpose:

Notify SRM that the issuing space which has previously issued a HOLD (SYSEVENT X'32'), can be considered for swapping.

Circumstances:

The issuing program no longer has a requirement that its address space be non-swappable.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

None.

Mnemonic:

NEWOPT

Meaning:

Set new OPT.

Purpose:

Change the OPT currently in use by SRM.

Circumstances:

The system operator has entered a SET command with the OPT keyword. To synchronize the setting of the new OPT values, all values established by the old OPT are replaced under the SRM lock. The SET command processor is responsible for obtaining and releasing the OPT parameter list.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of the OPT parameter list (IRAOLST) that describes the new OPT.

Outputs:

None.

This SYSEVENT is not traced by GTF.

Mnemonic:

TRAXERPT or EVENT53

Meaning:

Report the start time and service data for a completed transaction.

Purpose:

Allows a subsystem to use RMF™ to report transaction data.

Circumstances:

At the completion of a transaction, the subsystem provides the data needed for RMF to report the number of transactions, the average elapsed time per transaction, and the service used.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a serialized parameter list. The parameter list is mapped by the IHATREPL mapping macro.

Outputs:

Reg 15, byte 3: Contains one of the following return codes:

X'00'

The data for the transaction has been reported correctly.

X'08'

Processing could not be completed at this time. No queue elements are available for recording data. No statistics are reported, but a retry could be successful.

X'0C'

Reporting is temporarily suspended. RMF is not running online reports, or the TOD clock is stopped. No statistics are reported, but a later retry might be successful.

X'10'

Reporting is inoperative. The clock is in error, or the reporting facility is not installed. No statistics can be reported.

This SYSEVENT is not traced by GTF.

Mnemonic:

TRAXFRPT or EVENT54

Meaning:

Report the elapsed time for a completed transaction.

Purpose:

Allows a subsystem to use RMF to report transaction data.

Circumstances:

At the completion of a transaction, the subsystem provides SRM with the data RMF needs to report the number of transactions and the average elapsed time per transaction.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a serialized parameter list. The parameter list is mapped by the IHATRBPL mapping macro.

Outputs:

Reg 15, bytes 0-3: Contains one of the following return codes:

X'00'

The data for the transaction has been reported correctly.

X'08'

Processing could not be completed at this time. No queue elements are available for recording data. No statistics are reported, but a retry could be successful.

X'0C'

Reporting is temporarily suspended. RMF is not running online reports, or the TOD clock is stopped. No statistics are reported, but a later retry might be successful.

X'10'

Reporting is inoperative. The clock is in error, or the reporting facility is not installed. No statistics can be reported.

This SYSEVENT is not traced by GTF.

Mnemonic:

TRAXRPT or EVENT55

Meaning:

Report the start time for a completed transaction.

Purpose:

Allows a subsystem to use RMF to report transaction data.

Circumstances:

At the completion of a transaction, the subsystem provides SRM with the data RMF needs to report the number of transactions and the average elapsed time per transaction.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a serialized parameter list. The parameter list is mapped by the IHATRBPL mapping macro.

Outputs:

Reg 15, bytes 0-3: Contains one of the following return codes:

X'00'

The data for the transaction has been reported correctly.

X'08'

Processing could not be completed at this time. No queue elements are available for recording data. No statistics are reported, but a retry could be successful.

X'0C'

Reporting is temporarily suspended. RMF is not running online reports. There currently is no report performance group (RPGN) specified for non-TSO/E users, or the TOD clock is stopped. No statistics are reported, but a later retry might be successful.

X'10'

Reporting is inoperative. The clock is in error, or the reporting facility is not installed. No statistics can be reported.

This SYSEVENT is not traced by GTF.

Mnemonic:

DIRECTPO

Meaning:

Directions for a page-out.

Purpose:

To determine where to send a page being removed from real storage.

Circumstances:

RSM issues this SYSEVENT to determine whether a page-out page that is being removed from real storage is to be moved to expanded storage or to auxiliary storage.

Locks Required:

RSM or higher must be held on entry to SRM.

Inputs:

Reg 0, bytes 0-1: ASID of the address space that owns the page.

Note: For common area pages, the ASID is X'FFFF'.

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'01'

If the page is a page-out page.

X'03'

If the page is a VIO page.

X'04'

If the page is in a hiperspace (a block-addressable data page).

X'05'

Self-steal.

Outputs:

Reg 15, byte 3: Return code:

X'00'

Send the page to expanded storage.

X'04'

Send the page to auxiliary storage.

This SYSEVENT is not traced by GTF.

Mnemonic:

VIOVSAV

Meaning:

Can SAVE processing be performed for a VIO data set.

Purpose

Used by ASM to ask SRM if a job associated with a particular VIO data set is eligible for journaling and therefore eligible for SAVE processing.

Circumstances:

This SYSEVENT will be issued when ASM receives a SAVE request for data in expanded storage.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 13: Contains the address of a 72 byte save area that SRM will use.

Outputs:

Return code 0 in register 15 indicates that the job is eligible for restart (ASM should process the SAVE).

Return code 4 in register 15 indicates that the job is not eligible for restart and the SAVE can be ignored.

This SYSEVENT is not traced by GTF.

Mnemonic:

MSCHECK

Meaning:

Check migration swap directions.

Purpose:

RSM issues MSCHECK to determine whether or not a swapped out address space should be moved from expanded to auxiliary storage.

Circumstances:

RSM issues the MSCHECK SYSEVENT to determine if primary or secondary working set pages should be migrated.

Locks Required:

RSM lock

Inputs:

Reg 0, byte 3: SYSEVENT code.

Output:

Reg 15, bytes 0-3: Contains one of the following return codes:

X'00'

Page should be migrated

X'04'

Page should not be migrated

Mnemonic:

OMVSWAIT

Meaning:

z/OS UNIX System Services wait.

Purpose:

Signal to SRM that z/OS UNIX System Services is changing status with respect to either an input or output wait.

Circumstances:

z/OS UNIX System Services indicates that the address space is either running in non-canonical mode and is waiting for input, or the z/OS UNIX System Services address space is waiting for output.

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, bytes 3: SYSEVENT code

Reg 1, bytes 0-3: Contain the function code for the OMVSWAIT SYSEVENT as follows:

1

OMVSWAIT address space is waiting for input

2

OMVSWAIT address space is no longer waiting for input

3

OMVSWAIT address space is waiting for output

4

OMVSWAIT address space is no longer waiting for output

Outputs:

Reg 15, bytes 0-3 contain one of the following return codes:

X'00'

SYSEVENT is successful

X'04'

The function code in register 1 is not valid

Mnemonic:

STGIFAIL

Meaning:

SYS1.STGINDEX data set is inactive.

Purpose:

Used by ASM to inform SRM that the SYS1.STGINDEX data set is not present or has become unusable.

Circumstances:

This SYSEVENT will be invoked either at master scheduler initiation, or later during VIO mainline processing when a SYS1.STGINDEX failure is detected.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 13: Contains the address of a 72 byte save area that SRM will use.

Outputs

None

Mnemonic:

CMDSTART

Meaning:

Command start.

Purpose:

Notify SRM that the current transaction is the first transaction for a TSO/E command.

Circumstances:

A TSO/E command was invoked by the terminal monitor program. SRM is not notified for subcommand invocation or commands invoked by processors other than the terminal monitor program.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a fixed parameter list. The format of the parameter list is:

Word 										Offset  Length   Description

Word 1, byte 0     0        1       X'80': Command came from
                                    an “in-storage” list.
Word 1, bytes 1-3 	1 					3 		  	 Reserved
Words 2-3 							4 					8			  	 Command name (left-justified,
                                    EBCDIC padded with blanks).

Outputs:

None.

This SYSEVENT is not traced by GTF.

Mnemonic:

CMDEND

Meaning:

Command end.

Purpose:

Notify SRM that the transaction is the last transaction for the current command.

Circumstances:

A TSO/E command processor has just ended and control is returned to the terminal monitor program.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 0: Contains X'80' if this command put the next command on an in-storage list.

Reg 1, bytes 1-3: Reserved.

Mnemonic:

WKLDCHG

Meaning:

Workload change.

Purpose:

Requests the SRM to perform fast workload acceptance (FWA).

Circumstances:

In an extended recovery facility (XRF) environment, an address space associated with an alternate subsystem issues this SYSEVENT to indicate that a takeover is in progress.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID of the address space for which FWA is requested, or zero to indicate the current ASID.

Reg 0, bytes 1-3: SYSEVENT code.

Outputs:

None.

Mnemonic:

MIGCNSTR

Meaning:

Migration constraint.

Purpose:

Either indicates that there is a shortage of expanded storage frames eligible for migration on a least-recently-used (LRU) basis, or indicates that this shortage is relieved.

Circumstances:

RSM initially issues this SYSEVENT when there is a shortage of expanded storage frames eligible for migration on an LRU basis, and subsequently when this shortage is relieved.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, byte 3: contains:

X'00'

If migration is constrained by a lack of expanded storage frames eligible for migration on an LRU basis.

X'01'

If migration is no longer constrained because enough expanded storage frames have been made available for migration.

X'02'

If expanded storage is not available due to a lack of frames eligible for migration.

X'03'

If expanded storage is not available due to a lack of real storage for migration.

Outputs:

Reg 15, byte 3: Return code (issued only when migration is constrained):

X'00'

Disregard the storage isolation working set targets. This causes pages to be migrated regardless of these targets.

X'04'

Continue to honor the storage isolation working set targets.

Mnemonic:

MIGPURGE

Meaning:

Migration purge.

Purpose:

Either indicates that there is a shortage of available expanded storage frames and affords SRM the opportunity to designate an address space whose pages residing on expanded storage should be migrated, or indicates that the designated address space's pages have been migrated.

Circumstances:

RSM initially issues this SYSEVENT when there is a shortage of available expanded storage frames. The issuing of this SYSEVENT affords SRM the opportunity to designate an address space whose pages on expanded storage should be migrated (that is, before they would be selected for migration on a least-recently-used (LRU) basis). RSM subsequently issues this SYSEVENT after the expanded storage frames of the designated address space have been successfully migrated.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code:

Reg 1, bytes 1-3: Address of a 3-word parameter area. (SRM also uses this parameter area to return information.) In the parameter area, words 1-3 are reserved for output.

Outputs:

Reg 1, bytes 1-3: Address of a 3-word parameter area as follows:

Word 1

Zero or the address of the ASCB of the designated address space

Word 2

Zero or the number of pages to migrate.

Word 3

Zero or the number of non-working set pages that are to be converted to secondary pages and migrated.

Reg 15: Return code:

X'00'

The address of the ASCB has been returned in the first word of the parameter area.

X'04'

There are no more address spaces that have pages to purge. The parameter area is set to zeroes.

Mnemonic:

MIGSWAP

Meaning:

Migration swap in.

Purpose:

Indicates that a primary working set has been chosen to be migrated to auxiliary storage and that SRM must swap in the designated address space.

Circumstances:

RSM issues this SYSEVENT when it has migrated the non-working set and secondary set pages of an address space, and has then encountered a primary working set page. SRM determines whether the address space should be swapped in to real storage and swapped out to auxiliary storage, or remain in expanded storage.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID of the address space chosen to be swapped out to auxiliary storage.

Reg 0, byte 3: SYSEVENT code.

Reg 1: Address of the input parameter list, which has the following format:

Word 1

Contains the type of migration code:

0

This address space is being migrated to free expanded storage frames.

1

This address space is being purged from expanded storage. (SRM returned this address space using a MIGPURGE SYSEVENT.)

2

This address space is being migrated because it has resided in expanded storage too long.

Word 2

Contains the number of expanded storage frames that are being migrated.

Outputs:

Reg 1: Address of the parameter list, which contains the following:

Word 1

Reserved for input.

Word 2

If the return code is zero, this word contains the number of pages that are being migrated. Otherwise, this word contains zero.

Reg 15, byte 3: Return code:

X'00'

The address space is to be migrated.

X'04'

The address space cannot be migrated at this time.

Mnemonic:

SOUTSUSP

Meaning:

Suspended swap out.

Purpose:

Indicates that an address space swap-out was suspended because of a shortage of expanded storage frames.

Circumstances:

RSM issues this SYSEVENT when an address space cannot be swapped out because there are not enough free frames in expanded storage. SRM determines whether to end the swap-out, or to defer it until enough expanded storage frames are freed.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID of the address space being swapped out.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 15, byte 3: Return code:

X'00'

Defer the swap-out until enough expanded storage frames are freed and the SRB can be rescheduled.

X'04'

End the swap-out.

Mnemonic:

UCBCHG

Meaning:

UCB change.

Purpose:

Notify SRM that a device or a channel path was varied online or offline or that a device was boxed.

Locks Required:

Any locks lower than SRM

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: UCB address.

Outputs:

None.

Mnemonic:

DDR

Meaning:

Dynamic device reconfiguration.

Purpose:

Notify SRM that a dynamic device reconfiguration (DDR) function occurred.

Locks Required:

Any locks lower than SRM

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of the parameter list, which contains the addresses of the “to” and “from” UCBs.

Outputs:

None.

Mnemonic:

CHANNEL

Meaning:

Change in status of the channel measurement facility.

Purpose:

Notify SRM that there is a change in the status of the channel measurement facility.

Locks Required:

Any locks lower than SRM

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of the channel facilities recovery block (IOSDCFRB).

Outputs:

None.

Mnemonic:

AVAILPUP

Purpose:

Reserve or release storage for dumping purposes.

Circumstances:

DUMPSRV reserves frames during IPL. DUMPSRV releases frames when needed for capturing a dump.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Number of frames reserved.

Outputs:

None.

Mnemonic:

CPUTCONV

Meaning:

central processor time conversion.

Purpose:

Return the conversion factor needed to convert central processor seconds into service units.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Conversion factor.

Outputs:

None

Mnemonic:

STGTEST

Meaning:

Storage test.

Purpose:

Indicate a snapshot of storage utilization.

Circumstances:

Used as an aid in determining how much storage can be exploited by an application.

Locks Required:

None

Inputs:

Reg 0, byte 0-1: ASID

Reg 0, byte 2: Request type, as follows:

X'80'

Request for addressable storage (read, expanded, and auxiliary)

X'00'

Request for block addressable storage (expanded only)

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of the return area.

Outputs:

The contents of the return area are as follows:

Word 1

The amount of processor storage available, with little or no exposure to system paging or as directed by the installation through storage isolation, in units of 4K bytes.

Word 2

The amount of processor storage available, with some increased paging or as directed by the installation through storage isolation, in units of 4K bytes.

Word 3

The amount of total virtual storage available including auxiliary in units of 4K bytes.

Reg 15, byte 3: Contains X'00' if processing was successful.

Mnemonic:

AUXTREQ

Meaning:

Auxiliary storage shortage threshold request.

Purpose:

Obtain the auxiliary storage shortage threshold.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, bytes 0-3: Auxiliary storage shortage threshold.

Mnemonic:

APPCREQ

Meaning:

APPC Request.

Purpose:

Record APPC conversations.

Circumstances:

There is an APPC request that requires a corresponding verb complete signal.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or 0.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of parameter list that indicates the type of verb request.

Outputs:

Reg 15, byte 3: Return code:

X'00'

Request was recorded.

X'04'

Request was incorrect.

X'08'

Request was incorrect.

X'0C'

Request was not recorded because no storage is available.

X'10'

Request was not recorded because address space is no longer active.

Mnemonic:

INITID

Meaning:

Initiator identified.

Purpose:

Initialize address space information pertaining to the initiator.

Circumstances:

A started task is recognized as an initiator.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID or 0.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Parameter list mapped by the IRAICSP mapping macro.

Outputs:

None.

Mnemonic:

SADBRSTR

Meaning:

System activity display block (SADB) restart.

Purpose:

Asynchronous notification of the completion of a SADB request.

Circumstances:

A SADB failure is encountered and a restart is attempted.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Address of a three word parameter list.

Outputs:

None.

Mnemonic:

CHKSWIN

Meaning:

Check address space status.

Purpose:

Determine whether an address space is currently swapped in, is in the process of being swapped in, or is ready to be swapped in.

Circumstances:

Issued by SMF to avoid unnecessary system overload.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 15, byte 3: Return code:

X'00'

Address space is swapped in, in the process of being swapped in, or ready to be swapped in.

X'04'

Otherwise.

Mnemonic:

REQFASD

Meaning:

Request fast path address space data

Purpose:

Allows a caller to retrieve address space data. This SYSEVENT is not traced by GTF.

Circumstances:

Application dependent.

Locks Required:

None

Note: No serialization is obtained, runs under the caller's recovery. If invoked while WLM is changing policies or modes, an abend may result. In this case, no dumping or recording should be done as part of the caller's recovery. SYSEVENT REQASD can be used if serialization to prevent possible abends is desired.

Inputs:

Reg 0, bytes 0-1: ASID

Reg 0, byte 3: SYSEVENT code

Reg 1, bytes 0-3: address of IRARASD parameter list

Reg 13: address of workarea

Outputs:

Reg 15: Return code:

X'00'

Successful completion. The IRARASD parameter list has been filled in.

X'08'

The IRARASD parameter list is too small.

X'12'

The ASID is not valid.

Mnemonic:

REQASD

Meaning:

Request address space data

Purpose:

Allows a caller to retrieve address space data.

Circumstances:

Application dependent.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID

Reg 0, byte 3: SYSEVENT code

Reg 1, bytes 0-3: address of IRARASD parameter list

Outputs:

Reg 15: Return code:

X'00'

The IRARASD parameter list has been filled in correctly.

X'08'

The IRARASD parameter list is too small.

Mnemonic:

WLMSTCHG

Meaning:

WLM state change

Circumstances:

Issued when reporting is impacted due to a change in the state of the system.

Locks Required:

WLM local lock

Inputs:

Reg 0, byte 3: SYSEVENT code

Outputs:

None

Mnemonic:

WLMCOLL

Meaning:

WLM collect workload information

Purpose:

To collect the workload activity information to be provided when a caller issues the IWMRCOLL service.

Circumstances:

Application dependent.

Locks Required:

WLM local lock

Inputs:

Reg 0, byte 3: SYSEVENT code

Reg 1, bytes 0-3: address of output area parameter list (mapped by the IWMWRCAA data area).

Outputs:

Reg 15: Return code:

X'00'

Successful completion.

X'08'

Insufficient space for data.

Mnemonic:

REQSRMST

Meaning:

Request SRM status

Purpose:

To provide information about the status of SRM on a system.

Circumstances:

Application dependent.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code

Reg 1: address of IRASRMST parameter list

Outputs:

Reg 15: Return code:

X'00'

Successful completion. The IRASRMST parameter list has been filled in.

X'08'

The IRASRMST parameter list is too small.

Mnemonic:

RCVPADAT

Meaning:

Receive policy data

Purpose:

Provides the latest information to SRM about how well each system in the sysplex is processing towards goals in a service policy.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code

Reg 1: address of policy data.

Outputs:

None.

Mnemonic:

ENCCREAT

Meaning:

Create enclave

Purpose:

Create an enclave, validate the service class token, classify the enclave work, register the enclave as active, start transaction processing for the enclave.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code, byte 2: SYSEVENT type

Reg 1: address of parameter list

Outputs:

Enclave token

Reg 15, byte 3 contains:

X'00'

If successful completion.

X'04'

If successful completion, but ENVT was expanded.

X'08'

If service class token sequence is not valid, and the enclave is not created.

X'12'

The maximum amount of active enclaves in the system has been reached. The enclave was not created.

Mnemonic:

ENCDELET

Meaning:

Delete enclave

Purpose:

Delete an enclave, validate the enclave token, and end the enclave transaction.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1: address of parameter list.

Outputs:

Reg 15, byte 3 contains:

X'00'

If successful completion. The enclave token has been deleted.

X'04'

If enclave SRBs are active at the time of delete.

X'08'

If input enclave token is not valid.

X'0C'

If enclave token represents foreign enclave.

X'10'

If enclave is already deleted.

Mnemonic:

STATEXIT

Meaning:

WLM sysplex management state change exit

Purpose:

WLM uses STATEXIT when a state change occurs on a remote system.

Circumstances:

WLM uses STATEXIT when a state change occurs on a remote system that requires an update to the VTAM® generic, sysplex router, or ARM-related data used by SRM on the receiving system.

Locks Required:

SRM lock

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1: address of parameter list.

Output:

None.

Mnemonic:

CLSFYENC

Meaning:

Re-classify enclave transactions

Purpose:

Indicates when enclave transactions may be re-classified during policy activation.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 13: address of standard 72 byte savearea.

Outputs:

None.

Mnemonic:

REQASCL

Meaning:

Request address space classification attributes

Purpose:

To query classification attributes of an address space

Circumstances:

Application dependent.

Locks Required:

SRM lock

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1: address of parameter list mapped by IRARASC.

Output:

Reg 15, bytes 0-3: Contains one of the following return codes:

X'00'

Normal completion.

X'04'

Information returned, but address space may not be in the service class or PGN assigned in the classification rules. For example, the address space may have been moved by the RESET operator command into a different PGN or service class, or the address space is assigned the system defined service class (SYSTEM, or SYSSTC).

X'08'

Input parameter list is not properly initialized (eyecatcher, version or size specified is too small)

X'12'

Classification information is not available. This may be true for MASTER address space, for an address space that is starting up or ending.

Mnemonic:

ENCSTATE

Meaning:

Enclave state change.

Purpose:

Inform SRM of enclave state changes.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of IRAEVPL.

Reg 13, bytes 0-3: Contains the address of a 72 byte save area.

Outputs:

Reg 15, bytes 0-3: Set to 0; no non-zero return codes.

Mnemonic:

HSPCQRY

Meaning:

Request recommendations for expanded storage management

Purpose:

Based on WLM's expanded storage policy, WLM will attempt to make a recommendation on a caller's home address space hiperspace pages to:

• Use expanded storage
• Recommend the caller make its own decision
• Not use expanded storage

Locks Required:

None

Inputs:

Reg 13, bytes 0-3: Contains the address of a 72 byte save area.

Output:

Reg 15, byte 3: Contains one of the following return codes:

X'00'

Yes, use expanded storage to cache HSP

X'04'

Maybe, caller is to make its own decision.

X'08'

No, do not use expanded storage

Mnemonic:

WLMQUEUE

Meaning:

WLM work queue management event.

Purpose:

Inform SRM of changes in WLM-managed work queues.

Locks Required:

WLMQ, WLMRES, WLM local may be held on entry; none required by SRM.

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of the parameter list mapped by IRAWLMPL.

Outputs:

Return codes in IRAWLMPL.

Mnemonic:

ENCASSOC

Meaning:

Enclave is associated with an address space.

Purpose:

Indicates to SRM that an enclave and an address space are related for purposes of storage management. IWMEJOIN and IWMSTBGN register this same association.

Locks Required:

None

Inputs:

Reg 0, byte 0-1: The high order bit of byte 0-1 must be set and the 8-byte enclave token must be specified in access register 0-1.

Reg 0, byte 2: Contains the function code. The values are documented in IRAEVPL.

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of the parameter list mapped by IRAEVPL.

Outputs:

Reg 15, bytes 0-3: Contains the return code. The values are documented in IRAEVPL.

Mnemonic:

IWMRESET

Meaning:

Reset address space.

Purpose:

Issued by WLM to change the service class of an address space. This is called by the RESET operator command and by the IWMRESET programming interface.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: ASID

Reg 0, byte 2: The request type documented in IRAWLMPL

Reg 0, byte 3: SYSEVENT code

Reg 1, bytes 0-3: Contains the address of the parameter list mapped by IRAWLMPL.

Outputs:

Reg 1, byte 3: Contains the return code. The values are documented in IRAWLMPL.

This SYSEVENT is not traced by GTF.

Mnemonic:

SCTCNV

Meaning:

Convert service class token.

Purpose:

To convert a service class token into the service class index and report class index.

Locks Required:

None

Inputs:

Reg 1, bytes 0-3: Pointer to service class token.

Outputs:

Reg 0, bytes 0-3: Report class index.

Reg 15, bytes 0-3: Service class index.

Mnemonic:

COPYTXSH

Meaning:

Copy transaction server history.

Purpose:

To re-establish server history relationships after a policy switch.

Locks Required:

None

Inputs:

Reg 1, bytes 0-3: Contains the address of the old policy mapped by IRAWMST.

Outputs:

None.

Mnemonic:

FREEAUX

Meaning:

Return recommendation for free available AUX storage

Locks Required:

None

Inputs:

None

Outputs:

Reg 0: Recommended number of free AUX slots

Mnemonic:

ENCS97

Meaning:

Multisystem enclave SMF97 recording

Mnemonic:

ENCXSYS

Meaning:

Multisystem enclave processing

Mnemonic:

ENCREADY

Meaning:

Move enclave from inactive enclave queue to active enclave queue

Mnemonic:

LPARMGMT

Meaning:

LPAR management processing (BCP-only, not for external use)

Mnemonic:

SUBSSORT

Meaning:

CHPID sort I/O subsystem

Mnemonic:

IOVIOLAT

Meaning:

CHPID IO violate

Mnemonic:

IODEL

Meaning:

I/O subsystem delete processing

Mnemonic:

NEWSTSI

Meaning:

Store system information

Mnemonic:

QVS

Meaning:

Query virtual server

Purpose:

Return capacity information for software licensing.

Locks Required:

None.

Inputs:

Register 1 contains the address of the parameter list mapped by IRAQVS. Field QvsLen must be filled in with the length of the parameter list.

Outputs:

Contains the return code. The values are documented in IRAQVS.

Mnemonic:

REALSWAP

Meaning:

Swap Real Frames processing

Purpose:

Inform SRM about the start of recovering fixed real storage from a swappable address space.

Locks Required:

None.

Mnemonic:

ENCREG

Meaning:

Enclave registration/deregistration

Purpose:

Register an enclave to avoid premature deletion of the enclave. Undo (deregister) a previous registration of the enclave.

Locks Required:

None

Inputs:

Reg 0, byte 3: SYSEVENT code.

Reg 1: Address of parameter list.

Outputs:

Reg 15, byte 3: Contains one of the following:

X'00'

Successful completion

X'04'

Enclave is delete pending

X'08'

Invalid function code

X'0C'

Invalid enclave token

X'10'

Invalid registration token

X'14'

Internal error

SYSEVENT Code:

7D (hex)

Mnemonic:

ENCEWLM

Meaning:

Work request management

Purpose:

This SYSEVENT is used by WLM when a work request is started or stopped.

Locks Required:

None

Inputs:

Reg 0, byte 0-1: SYSEVENT code

Reg 1: Address of parameter list

Outputs:

Reg 15, byte 3: contains one of the following:

X'00'

Successful completion

X'04'

Work request was not found

X'08'

Invalid function code

X'0C'

Invalid enclave

X'10'

Parent work request handle is zero

X'14'

Dependent enclave

X'18'

Failed to validate process ID

X'1C'

Output buffer for this request code was too small

Mnemonic:

CANCEL

Meaning:

Notify SRM that an address space is being cancelled.

Purpose:

When the CANCEL command for an address space has been accepted by the command processor, the command processor notifies SRM that cancel processing is starting for the address space.

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: ASID or zero.

Reg 0, byte 3: SYSEVENT code.

Outputs:

Reg 1, byte 3: contains:

X'00'

The CANCEL request was honoured.

X'04'

The CANCEL request was not successful.

Mnemonic:

FULLPRE

Meaning:

Changes the preemption of an address space.

Purpose:

Sysevent allows to switch full preemption on and off.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: zero.

Reg 0, byte 2 contains a function code:

X'00'

Switch full preemption on

X'01'

Switch full preemption off

Reg 0, byte 3: SYSEVENT code.

Outputs:

None

Mnemonic:

PBGDD

Meaning:

Pass descriptions for generic PB delay states from WLM to SRM.

Purpose:

Internal sysevent called by WLM to link the descriptions for the generic delay states to SRM control blocks.

Locks Required:

None

Inputs:

Reg 0, bytes 0-1: zero.

Reg 0, byte 2 contains a function code:

X'00'

Define descriptions

X'01'

Retrieve descriptions

Reg 0, byte 3: SYSEVENT code.

Reg 1, contains the address of the area that contains the descriptions for the delay states.

Outputs:

Reg 1: contains X'00' or the address of a data area that contains descriptions for delay states, which can be the case for function:

retrieve

In this case, the use is obvious.

define

In this case, the area is not used by SRM anymore and can be freed by the caller. This case happens when descriptions are replaced, which means the old descriptions are not needed anymore and thus are returned to be disposed by the caller.

Note: The caller is WLM code, which means no external users.

Mnemonic:

QRYCONT

Meaning:

Query contention.

Purpose:

Returns contention information about SRM managed contentions for address spaces or enclaves.

Circumstances:

Application dependent

Locks Required:

Local

Inputs:

Reg 0, bytes 0-1: X’8000’

Reg 0, byte 3: SYSEVENT code.

Reg 1, bytes 0-3: Contains the address of a parameter list. The parameter list is mapped by the IRAEVPL macro.

Outputs:

None.