osi_signal — Generate the requested signal event

Function

The osi_signal service generates the requested signal to the target process.

Requirements

Operation	Environment
Authorization:	Problem or supervisor state, any PSW key
Dispatchable unit mode:	Task
Cross memory mode:	Any
AMODE:	31-bit
ASC mode:	Any
Interrupt status:	Enabled for interrupts
Locks:	Unlocked
Control parameters:	All parameters must be addressable by the caller and in the primary address space.

Format

     osi_signal(OSI_structure,
              Target_Osipid,
              Signal_value,
              Signal_options,
              Return_value,
              Return_code,
              Reason_code);

Parameters

OSI_structure

Supplied parameter

Type:: Structure
Length:: Specified by the Osilen field.

OSI_structure contains information that is used by the OSI operations. The PFS receives this structure on each PFS interface operation.

For more information about the full description of this structure, see Interface structures for C language servers and clients.

Target_Osipid

Supplied parameter

Type:: Integer
Length:: Fullword

A copy of the Osipid field from the target process.

Signal_value

Supplied parameter

Type:: Integer
Length:: Fullword

The name of a fullword that contains the signal value. See z/OS XL C/C++ Runtime Library Reference for a description of the signal.h header and the signal values.

Signal_options

Supplied parameter

Type:: Integer
Length:: Fullword

The name of a fullword that contains the signal option flags. See kill (BPX1KIL, BPX4KIL) — Send a signal to a process in z/OS UNIX System Services Programming: Assembler Callable Services Reference for a description of the declaration of signal option flags.

Return_value

Returned parameter

Type:: Integer
Length:: Fullword

A fullword in which the osi_signal service returns the results of the signal request, as one of the following values:

-1: The operation was not successful.
0: The operation was successful.

Return_code

Returned parameter

Type:: Integer
Length:: Fullword

A fullword in which the osi_signal service stores the return code. The osi_signal service returns Return_code only if Return_value is -1. See z/OS UNIX System Services Messages and Codes for a complete list of supported return code values.

Reason_code

Returned parameter

Type:: Integer
Length:: Fullword

A fullword in which the osi_signal service stores the reason code. The osi_signal service returns Return_code only if Return_value is -1. Reason_code further qualifies the Return_code value. The reason codes are described in z/OS UNIX System Services Messages and Codes.

Usage notes

The PFS must have the process ID of the task that is to receive the signal. This information must be retrieved from the target OSI_structure and placed in a variable that is visible to the task that will eventually invoke the osi_signal service.
The address of the osi_signal routine is passed to the PFS in the OSIT structure when the PFS is initialized.