Unregister

The Unregister_Test service cancels an outstanding TP test request before the test begins. You can call this service after calling Register_Test or Accept_Test. This service is useful if you change your mind about performing the test or are unable to initiate an inbound allocate request for the TP.

Requirements

Authorization:

Supervisor state or problem state, any PSW key

Dispatchable unit mode:

Task or SRB mode

Cross memory mode:

Any PASN, any HASN, any SASN

AMODE:

31-bit

ASC mode:

Primary or access register (AR)

Interrupt status:

Enabled for I/O and external interrupts

Locks:

Unlocked

Control parameters:

All parameters must be addressable by the caller and in the primary address space.

Format

Figure 1. Invocation of the Unregister_Test Callable Service

CALL ATBTEU1  ( Return_To_Program,
                ASCB_address,
                Return_code
              );

Parameters

Return_to_program

Supplied parameter

Type: Integer
Char Set: N/A
Length: 4 bytes

Specifies whether to return control to the program that called Register_Test. It has two possible values:

Value: Description
0: No - specifies that control not be returned to the program that called Register_Test.
1: Yes - specifies that control be returned to the program that called Register_Test.

ASCB_address

Supplied parameter

Type: Pointer
Char Set: N/A
Length: 4 bytes

Specifies the pointer to the address space control block (ASCB) that represents the address space for which the Unregister_Test service should cancel the pending test request. Only programs with PSW key 0-7 can use this parameter. Problem programs (key 8) can only cancel test requests for their own address spaces and should pass a null pointer (X‘00000000’) or a pointer to their own address space.

Return_code

Returned parameter

Type: Integer
Char Set: N/A
Length: 4 bytes

Possible values from the Unregister_Test service are:

Decimal Value: Description
0: Unregister_Test service completed successfully.
4: No active test request was found for the address space.
8: APPC/MVS is not available.
12: Problem state program supplied the address of an ASCB other than its own.
16: APPC/MVS service failure.
20: Value of Return_to_program parameter was not valid.

Restrictions

Transaction programs that call the Unregister_Test service while in task mode should not have any enabled unlocked task (EUT) functional recovery routines (FRRs) established. For more information about EUT FRRs, see the section on providing recovery in z/OS MVS Programming: Authorized Assembler Services Guide.