DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home
Contents
Index
Master Index
New Book
mi_sysname()
The
mi_sysname()
function
attempts to set the value of the logical system name of the current system to match the value of the argument.
Syntax
char *mi_sysname(
sysname
)
char *sysname;
sysname
is the name of the system or
NULL
.
Valid in Client Application?
Valid in Server Routine?
Yes
Yes
Usage
If its argument is
NULL
,
mi_sysname()
returns the value of the logical system name of the current system. The current system is defined by the
MI_SERVER
system parameter. If there is no current system (a connection has not yet been established),
mi_sysname()
returns
default
.
The logical system name cannot be set to a value that is not included in the system parameter file. Therefore, if the argument to
mi_sysname()
does not match the value of a system name in the system parameter file, an error results, and
mi_sysname()
returns
NULL
.
Return Values
On success, returns the current system name; on failure, returns
NULL
.
DataBlade API Programmer's Manual
, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.
