Library Reference ¶ This is a dictionary of all referenced libraries and their name spaces. SysSocket Interfaces ¶ Library Identification ¶ Name: SysSocket Interfaces Version: newest Company: System Namespace: SysSocket_Interfaces Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysSocket Interfaces, * (System) SysSocket2 Interfaces ¶ Library Identification ¶ Name: SysSocket2 Interfaces Version: newest Company: System Namespace: SysSocket2_Interfaces Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysSocket2 Interfaces, * (System) SysTypes2 Interfaces ¶ Library Identification ¶ Name: SysTypes2 Interfaces Version: newest Company: System Namespace: SysTypes Library Properties ¶ LinkAllContent: False Optional: False QualifiedOnly: False SystemLibrary: False Key: SysTypes2 Interfaces, * (System)
SysProcessCreate (FUN) ¶ FUNCTION SysProcessCreate : RTS_IEC_HANDLE <description>Function to create a process. NOTE: Is only available on systems with processes! This function starts the specified application as new process, optionally either in the fore- or in the background. </description> <result><p>RESULT: Handle to the created process or RTS_INVALID_HANDLE if failed.</p></result> InOut: Scope Name Type Comment Return SysProcessCreate RTS_IEC_HANDLE Input pszApplication REFERENCE TO STRING <param name=”pszApplication” type=”IN”>Name of application to start as a separate process</param> pszCommandLine REFERENCE TO STRING <param name=”pszCommandLine” type=”IN”>String with the command line</param> ulHide UDINT <param name=”ulHide” type=”IN”>The application runs in the background for ulHide=1, else in the foreground.</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>
SysProcessCreate2 (FUN) ¶ FUNCTION SysProcessCreate2 : RTS_IEC_HANDLE <description>Function to create a process. NOTE: Is only available on systems with processes! This functions creates and eventually starts a new process for the specified application. The properties of the created process can be defined by appropriate flags.</description> <result><p>RESULT: Handle to the created process or RTS_INVALID_HANDLE if failed.</p></result> InOut: Scope Name Type Comment Return SysProcessCreate2 RTS_IEC_HANDLE Input pszApplication REFERENCE TO STRING <param name=”pszApplication” type=”IN”>Name of application to start as a separate process</param> pszCommandLine REFERENCE TO STRING <param name=”pszCommandLine” type=”IN”>String with the command line</param> ulFlags UDINT <param name=”ulFlags” type=”IN”>A combination of the process flags SYSPROCESS_CREATEFLAG_XXX.</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>
SysProcessExecuteCommand (FUN) ¶ FUNCTION SysProcessExecuteCommand : DINT <description>Function to start a system command. The command is operating system dependent!</description> <result><p>RESULT: Result of command after execution</p></result> InOut: Scope Name Type Comment Return SysProcessExecuteCommand DINT Input pszComand REFERENCE TO STRING <param name=”pszCommand” type=”IN”>Command line parameters to be transmitted to application at execution</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>
SysProcessExecuteCommand2 (FUN) ¶ FUNCTION SysProcessExecuteCommand2 : DINT <description>Function to start a system command. The command is operating system dependent! Command will be executed, only if allowed (see settings for details). Output of the executed command will be filled into pszStdOut. </description> <result><p>RESULT: Number of bytes, read from the commands output.</p></result> InOut: Scope Name Type Comment Return SysProcessExecuteCommand2 DINT Input pszCommand REFERENCE TO STRING <param name=”pszCommand” type=”IN”>Command line parameters to be transmitted to application at execution</param> pszStdOut REFERENCE TO STRING <param name=”pszStdOut” type=”IN”>Buffer for StdOut string</param> udiStdOutLen UDINT <param name=”udiStdOutLen” type=”IN”>Buffersize for StdOut string buffer</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code. ERR_PARAMETER: if pszCommand, pszStdOut or udiStdOutLen is null, ERR_NO_ACCESS_RIGHTS: if command is not allowed</param>
SysProcessFreeHandle (FUN) ¶ FUNCTION SysProcessFreeHandle : RTS_IEC_RESULT <description>Function to release the process handle that is returned by SysProcessCreate or SysProcessGetCurrentHandle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessFreeHandle RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param>
SysProcessGetCurrentHandle (FUN) ¶ FUNCTION SysProcessGetCurrentHandle : RTS_IEC_HANDLE <description>Function to get a handle to the current process</description> <result><p>RESULT: Returns the handle of the process actually running by the processor or RTS_INVALID_HANDLE if failed.</p></result> InOut: Scope Name Type Comment Return SysProcessGetCurrentHandle RTS_IEC_HANDLE Input pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>
SysProcessGetOSId (FUN) ¶ FUNCTION SysProcessGetOSId : UDINT <description>Function to determine an operating system dependent identification of a process. This identification must be unique in the system at a defined time! SysProcessGetOSId can only applied to the process actually executed or to processes having been generated by SysProcessCreate.</description> <result><p>RESULT: Returns the operating system specific identification of the process</p></result> InOut: Scope Name Type Comment Return SysProcessGetOSId UDINT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>
SysProcessGetPriority (FUN) ¶ FUNCTION SysProcessGetPriority : RTS_IEC_RESULT <description>This function retrieves the priority of the process specified by its handle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessGetPriority RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pulPriority POINTER TO UDINT <param name=”pulPriority” type=”OUT”>Pointer to variable being assigned to priority of the process</param>
SysProcessGetState (FUN) ¶ FUNCTION SysProcessGetState : RTS_IEC_RESULT <description>This function retrieves the status of the process specified by its handle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessGetState RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pulState POINTER TO UDINT <param name=”pulState” type=”OUT”>Pointer to variable being assigned to value 1 for running processes and value 2 for terminated processes</param>