mvsunsigsetup (BPX1MSD, BPX4MSD) — Detach the signal setup

Function

The mvsunsigsetup callable service deletes the task's signal set up established by the mvssigsetup service (see mvssigsetup (BPX1MSS, BPX4MSS) — Set up MVS signals). The parameters specified in the mvssigsetup service are returned by the mvsunsigsetup service. The signal actions for all signals in the process set by the sigaction service (see sigaction (BPX1SIA, BPX4SIA) — Examine or change a signal action) are set to default action SIG_DFL.

Requirements

Operation	Environment
Authorization:	Supervisor state or problem state, any PSW key
Dispatchable unit mode:	Task
Cross memory mode:	PASN = HASN
AMODE (BPX1MSD):	31-bit
AMODE (BPX4MSD):	64-bit
ASC mode:	Primary mode
Interrupt status:	Enabled for interrupts
Locks:	Unlocked
Control parameters:	All parameters must be addressable by the caller and in the primary address space.

Format

CALL BPX1MSD,(Signal_interface_routine_address,
              User_data,
              Default_override_signal_set,
              Default_terminate_signal_set,
              Return_value,
              Return_code,
              Reason_code)

AMODE 64 callers use BPX4MSD with the same parameters. The Signal_interface_routine_address parameter is a doubleword.

Parameters

Signal_interface_routine_address

Returned parameter

Type:: Address
Length:: Fullword (doubleword)

The name of a fullword (doubleword) return area where Signal_interface_routine_address, set by the mvssigsetup service, is returned.

User_data

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword return area where User_data, set by the mvssigsetup service, is returned.

Default_override_signal_set

Returned parameter

Type:: Character string
Character set:: No restriction
Length: 8 bytes

The name of an 8-byte area where Default_override_signal_set, set by the mvssigsetup service, is returned.

Default_terminate_signal_set

Returned parameter

Type:: Character string
Character set:: No restriction
Length:: 8 bytes

The name of an 8-byte area where Default_terminate_signal_set, set by the mvssigsetup service, is returned.

Return_value

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the mvsunsigsetup service returns 0 if the request is successful, or -1 if it is not successful.

Return_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword in which the mvsunsigsetup service stores the return code. The mvsunsigsetup service returns Return_code only if Return_value is -1. For a complete list of possible return code values, see z/OS UNIX System Services Messages and Codes. The mvsunsigsetup service can return one of the following values in the Return_code parameter:

Return_code	Explanation
EMVSINITIAL	The service failed (JRNotSigSetup).

Reason_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword in which the mvsunsigsetup service stores the reason code. The mvsunsigsetup service returns Reason_code only if Return_value is -1. Reason_code further qualifies the Return_code value. For the reason codes, see z/OS UNIX System Services Messages and Codes.

Related services

mvssigsetup (BPX1MSS, BPX4MSS) — Set up MVS signals

Characteristics and restrictions

See The relationship of z/OS UNIX signals to callable services.

Examples

For an example using this callable service, see BPX1MSD (mvsunsigsetup) example.