gtps1m3uSystem Macros

MPIFC-Request MPIF Service

Use this system macro to request Multi-Processor Interconnect Facility (MPIF) services. See Format for more information about the valid request types.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




RTYPE
This required parameter specifies the type of request being made by the user. The valid options are:

IDENTIFY
This function establishes the existence of a unique, named user that will communicate with other users of MPIF.

RTYPE=IDENTIFY means that REG contains a pointer to a parameter list containing the user identification. If REG is not specified, R1 is assumed. The parameter list is in the form of the DCTMUP DSECT.

An IDTOK is assigned using the IDENTIFY function. It associates the user with MPIF resources and is required for other MPIF functions. The token is returned in the IDTOK field in the user's parameter list.

CONNECT
This function attempts to establish a logical connection between the calling user and the user named in the parameter list.

ACCEPT
This function attempts to complete a logical connection between the calling user and the user name in the parameter list.

DISCONNECT
This function breaks a logical connection between the calling user and the user named in the parameter list.

FORGET
This function is the opposite of IDENTIFY. Any connections involving the calling user are disconnected. All knowledge of the user is eliminated.

QUERY
This function formats directory information into an area of storage provided by you.

SEND
This function normally schedules the transfer of data across a logical connection. SEND is also used to control pacing values to the other side of a connection.

REG=R1|Rx
The symbolic name of a general register (R0 through R7 inclusive) which contains the address of the parameter list, defined in DCTMUP, associated with the service request. R1 is the default.

ADSPACE
This parameter is only valid when issued by C-type code and is used to indicate the address space in which the code is processing.

EVM
The program that issued the MPIFC is running in the ECB virtual memory (EVM). This is the default.

SVM
The program that issued the MPIFC is running in the system virtual memory (SVM).

Entry Requirements

R14 and R15 must be available for use by this macro.

Return Conditions

Programming Considerations

Examples

None.