LAPI_Senv 子例程

用途

用于设置运行时变量。

库

可用性库 (liblapi_r.a)

C 语法

#include <lapif.h>
 
int LAPI_Senv(hndl, query, set_val)
lapi_handle_t hndl;
lapi_query_t query;
int set_val;

FORTRAN 语法

include 'lapif.h'
 
LAPI_SENV(hndl, query, set_val, ierror)
INTEGER hndl
INTEGER query
INTEGER set_val
INTEGER ierror

描述

Type of call: 本地查询

使用此子例程为特定 LAPI 实例设置运行时属性。在 C 中， lapi_query_t 枚举定义可在运行时设置的属性。这些属性是在 FORTRAN 中显式定义的。请参阅 LAPI_Qenv 以获取更多信息。

您可以使用 LAPI_Senv 来设置以下运行时属性: ACK_THRESHOLD， ERROR_CHK， INTERRUPT_SET和 TIMEOUT。

参数

INPUT
恩德尔: 指定 LAPI 句柄。
查询: 指定您要设置的查询的类型。在 C 中，查询的值由 lapi.h中的 lapi_query_t 枚举定义。在 FORTRAN 中，这些值是在 lapif.h的 32 位版本和 64 位版本中显式定义的。
set_val: 指定您要设置的查询的整数值。
输出
国际错误: 指定 FORTRAN 返回码。这始终是最后一个参数。

限制

对于共享内存通信和数据传输，或者对于任务发送给自己的消息，会报告 LAPI 统计信息不。

C 示例

可以使用 LAPI_Senv来设置以下值:


ACK_THRESHOLD:
int value;
LAPI_Senv(hndl, ACK_THRESHOLD, value);
/* LAPI sends packet acknowledgements (acks) in groups, waiting until  */
/* ACK_THRESHOLD packets have arrived before returning a group of acks */
/* The valid range for ACK_THRESHOLD is (1 <= value <= 30)             */
/* The default is 30.                                                  */

ERROR_CHK:
boolean toggle;
LAPI_Senv(hndl, ERROR_CHK, toggle);
/* Indicates whether LAPI should perform error checking.  If set, LAPI */ 
/* calls will perform bounds-checking on parameters.  Error checking   */ 
/* is disabled by default.                                             */

INTERRUPT_SET:
boolean toggle;
LAPI_Senv(hndl, INTERRUPT_SET, toggle);
/* Determines whether LAPI will respond to interrupts.  If interrupts  */
/* are disabled, LAPI will poll for message completion.                */
/* toggle==True will enable interrupts, False will disable.            */
/* Interrupts are enabled by default.                                  */

TIMEOUT:
int value;
LAPI_Senv(hndl, TIMEOUT, value);
/* LAPI will time out on a communication if no response is received    */
/* within timeout seconds.  Valid range is (10 <= timeout <= 86400).   */
/* 86400 seconds = 24 hours.  Default value is 900 (15 minutes).       */

返回值

LAPI_SUCCESS: 指示已成功完成函数调用。
LAPI_ERR_HNDL_INVALID: 指示传入的恩德尔无效 (未初始化或处于 "已终止" 状态)。
LAPI_ERR_QUERY_TYPE: 指示所传递的查询无效。
LAPI_ERR_SET_VAL: 指示 set_val 指针不在有效的范围内。

位置

/usr/lib/liblapi_r.a