Skip to main content

System Coupling Fortran library 2024 R2

syscconnectf Interface Reference

Last update: 17.07.2025

Provide an interface to connect to System Coupling. More...

Public Member Functions

type(syscerrorf) function syscconnectf (schost, scport, participantname, buildinformation)
 Provide a function to establish connection to System Coupling.
 
type(syscerrorf) function syscconnectparallelf (schost, scport, participantname, communicator, buildinformation)
 Provide a function to establish connection to System Coupling and pass a custom MPI communicator.
 

Detailed Description

Provide an interface to connect to System Coupling.

Definition at line 83 of file syscSystemCouplingF.fi.

Constructor & Destructor Documentation

◆ syscconnectf()

type(syscerrorf) function syscconnectf ( character(*), intent(in)  schost,
integer(kind=4), intent(in)  scport,
character(*), intent(in)  participantname,
character(*), intent(in), optional  buildinformation 
)

Provide a function to establish connection to System Coupling.

A participant must have obtained the host and port information from System Coupling prior to calling this function (e.g. via an input argument when participant application was started).

If using a support MPI distribution, this function should be called on all ranks that belong to the MPI_COMM_WORLD communicator.

Parameters
[in]scHostName of the host on which System Coupling is running.
[in]scPortPort number on which System Coupling is listening for participant connections.
[in]participantNameName of this participant (e.g. "MAPDL-1").
[in]buildInformationInformation about the build of this participant solver.
Returns
a SyscErrorF type that can be checked for any errors.

Definition at line 109 of file syscSystemCouplingF.fi.

113!
114 import :: syscerrorf
115 integer(kind=4), intent(in) :: scPort
116 character(*), intent(in) :: scHost
117 character(*), intent(in) :: participantName
118 character(*), optional, intent(in) :: buildInformation
119 type(SyscErrorF) :: ret
120!
121!DIR$ IF DEFINED(_WIN32) .and. ( .not. DEFINED(SYSTEM_COUPLING_PARTICIPANT_PROXY))
122!DIR$ ATTRIBUTES DLLIMPORT :: syscConnectF
123!DIR$ ENDIF
124!

Member Function/Subroutine Documentation

◆ syscconnectparallelf()

type(syscerrorf) function syscconnectparallelf ( character(*), intent(in)  schost,
integer(kind=4), intent(in)  scport,
character(*), intent(in)  participantname,
integer(kind=4), intent(in)  communicator,
character(*), intent(in), optional  buildinformation 
)

Provide a function to establish connection to System Coupling and pass a custom MPI communicator.

A participant must have obtained the host and port information from System Coupling prior to calling this function (e.g. via an input argument when participant application was started).

Parameters
[in]scHostName of the host on which System Coupling is running.
[in]scPortPort number on which System Coupling is listening for participant connections.
[in]participantNameName of this participant (e.g. "MAPDL-1").
[in]communicatorMPI communicator on which all API calls are made.
[in]buildInformationInformation about the build of this participant solver.
Returns
a SyscErrorF type that can be checked for any errors.

Definition at line 151 of file syscSystemCouplingF.fi.

156!
157 import :: syscerrorf
158 integer(kind=4), intent(in) :: scPort
159 character(*), intent(in) :: scHost
160 character(*), intent(in) :: participantName
161 integer(kind=4), intent(in) :: communicator
162 character(*), optional, intent(in) :: buildInformation
163 type(SyscErrorF) :: ret
164!
165!DIR$ IF DEFINED(_WIN32) .and. ( .not. DEFINED(SYSTEM_COUPLING_PARTICIPANT_PROXY))
166!DIR$ ATTRIBUTES DLLIMPORT :: syscConnectParallelF
167!DIR$ ENDIF
168!

Connect with Ansys