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

The syntax format is as follows:

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 list of return code values, see Return codes (errnos) in 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 a list of reason codes, see Reason codes in 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

See BPX1MSD (mvsunsigsetup) example.