Pre-set properties

Some manifest properties are set automatically.

The following manifest properties are set automatically. Unlike built-in properties, these properties do not have to be added to a collector to populate them.

The properties marked as Selector in the table description can be used in a selector. The others serve only to provide information in the manifest.

Table 1. Automatically set manifest properties
Property Description
BF_AGENT_VERSION Selector. The version number of the agent that is installed on the server.
BF_EXCLUSIVE Selector. It is a flag that takes no operator or value. If a selector includes this property, all slots on the selected server are reserved for the duration of the job.

If a step in the job specifies a different server to run on, all current slots on the current server continue to be reserved while the other server runs the step.

BF_JOBS Selector. The number of jobs (steps) that the server resource is running at the same time. This value is updated every time the console assigns a step to the server, independent of other manifest property updates.
BF_LAST_REFRESH The time of the last update of built-in properties in the manifest. The value is reported as a UNIX® timestamp: the number of seconds since January 1, 1970.
BF_LASTJOBS The number of jobs that the server was running the last time the manifest was refreshed.
BF_LAST_UPDATE The time of the last update of run-command properties to the manifest. The value is reported, such as a UNIX® timestamp, as the number of seconds since January 1, 1970.
BF_LOADRATIO Selector. A calculated value, reported as a ratio: the number of jobs (BF_JOBS) divided by the maximum number of jobs allowed for the server (Max Jobs setting). A server that has 1 job running and 4 Max Jobs has a load ratio of .25.
BF_NAME Selector. Specifies the server resource to run on. The value is the name of the server resource. The BF_NAME property is not displayed in the manifest list.
BF_RESERVE Selector. It is a flag that takes no operator or value. If a selector includes this property, a slot is reserved on the selected server for the duration of the job.
  • If a step in a job specifies a different server to run on, then the slot on the selected server is reserved while the other server runs the step.
  • If a step specifies the selected server explicitly, the server uses the reserved slot for that step.

This flag prevents project delays that occur when projects lose their slot on a server when one or more of their steps are run on other servers.


Feedback