Skip to main content

System Coupling Fortran library 2025 R1

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. More...
 
type(syscerrorf) function syscconnectparallelf (scHost, scPort, participantName, communicator, buildInformation)
 Provide a function to establish connection to System Coupling and pass a custom MPI communicator. More...
 

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