int GRBemptyenv ( GRBenv **envP )

Create an empty environment. Note that you will need to call GRBstartenv before you can use this environment. You should use this routine instead of GRBloadenv if you want to set parameters before actually starting the environment. This can be useful if you want to connect to a Compute Server, a token server, or the Gurobi Instant Cloud.

In addition to creating a new empty environment, this routine will check the current working directory for a file named gurobi.env, and it will attempt to read parameter settings from this file if it exists. The file should be in PRM format (briefly, each line should contain a parameter name, followed by the desired value for that parameter). This routine will also populate several parameters (ComputeServer, TokenServer, ServerPassword, etc.) from your gurobi.lic file.

In general, you should aim to create a single Gurobi environment in your program, even if you plan to work with multiple models. Reusing one environment is much more efficient than creating and destroying multiple environments.

Return value:

A non-zero return value indicates that there was a problem creating the environment. Refer to the Error Code table for a list of possible return values.


envP: The location in which the pointer to the newly created environment should be placed.