Skip to content

/AWS1/CL_GMLRUNTIMECONF

This data type has been expanded to use with the Amazon GameLift containers feature, which is currently in public preview.

A set of instructions that define the set of server processes to run on computes in a fleet. Server processes run either an executable in a custom game build or a Realtime Servers script. Amazon GameLift launches the processes, manages their life cycle, and replaces them as needed. Computes check regularly for an updated runtime configuration.

On a container fleet, the Amazon GameLift Agent uses the runtime configuration to manage the lifecycle of server processes in a replica container group.

An Amazon GameLift instance is limited to 50 processes running concurrently. To calculate the total number of processes defined in a runtime configuration, add the values of the ConcurrentExecutions parameter for each server process. Learn more about Running Multiple Processes on a Fleet.

CONSTRUCTOR

IMPORTING

Optional arguments:

IT_SERVERPROCESSES TYPE /AWS1/CL_GMLSERVERPROCESS=>TT_SERVERPROCESSLIST TT_SERVERPROCESSLIST

A collection of server process configurations that identify what server processes to run on fleet computes.

IV_MAXCONCURRENTGAMESESSACTS TYPE /AWS1/GMLMAXCONCURRENTGAMESE00 /AWS1/GMLMAXCONCURRENTGAMESE00

The number of game sessions in status ACTIVATING to allow on an instance or container. This setting limits the instance resources that can be used for new game activations at any one time.

IV_GAMESESSACTTIMEOUTSECONDS TYPE /AWS1/GMLGAMESESSACTTMOUTSECS /AWS1/GMLGAMESESSACTTMOUTSECS

The maximum amount of time (in seconds) allowed to launch a new game session and have it report ready to host players. During this time, the game session is in status ACTIVATING. If the game session does not become active before the timeout, it is ended and the game session status is changed to TERMINATED.


Queryable Attributes

ServerProcesses

A collection of server process configurations that identify what server processes to run on fleet computes.

Accessible with the following methods

Method Description
GET_SERVERPROCESSES() Getter for SERVERPROCESSES, with configurable default
ASK_SERVERPROCESSES() Getter for SERVERPROCESSES w/ exceptions if field has no val
HAS_SERVERPROCESSES() Determine if SERVERPROCESSES has a value

MaxConcurrentGameSessionActivations

The number of game sessions in status ACTIVATING to allow on an instance or container. This setting limits the instance resources that can be used for new game activations at any one time.

Accessible with the following methods

Method Description
GET_MAXCONCURRENTGAMESESSA00() Getter for MAXCONCURRENTGAMESESSIONACTS, with configurable d
ASK_MAXCONCURRENTGAMESESSA00() Getter for MAXCONCURRENTGAMESESSIONACTS w/ exceptions if fie
HAS_MAXCONCURRENTGAMESESSA00() Determine if MAXCONCURRENTGAMESESSIONACTS has a value

GameSessionActivationTimeoutSeconds

The maximum amount of time (in seconds) allowed to launch a new game session and have it report ready to host players. During this time, the game session is in status ACTIVATING. If the game session does not become active before the timeout, it is ended and the game session status is changed to TERMINATED.

Accessible with the following methods

Method Description
GET_GAMESESSACTTMOUTSECONDS() Getter for GAMESESSIONACTTIMEOUTSECONDS, with configurable d
ASK_GAMESESSACTTMOUTSECONDS() Getter for GAMESESSIONACTTIMEOUTSECONDS w/ exceptions if fie
HAS_GAMESESSACTTMOUTSECONDS() Determine if GAMESESSIONACTTIMEOUTSECONDS has a value