adm.GetSystemFile

The job passes the system file (e.g. as.cfg) to the client and locks it. System files are in the DB table osresources with resourcetype=1.

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Controls opening mode and timestamp return:
LOWORD(Flags) = 0 = system file is opened for reading
LOWORD(Flags) = 2 = system file is opened for writing
If Version != 0 or HIWORD(Flags) != 0 or LOWORD(Flags) != 2:
  `HIWORD(Flags) = 1` → LowDateTime and HighDateTime are returned
  `HIWORD(Flags) = 2` → only LowDateTime is returned

FileName

STRING

Yes

Name of the system file

Version

INT

Yes

Version of the system file to be requested

2. Output Parameters

Name Type Dependency Description

[FileCount]

INT

Optional

Number of returned files (always 1)

[LowDateTime]

INT

Optional

Timestamp in LowDateTime format

[HighDateTime]

INT

Optional

Timestamp in HighDateTime format

3. Output Files

Name Description

[File list]

Name and path of the system file

4. Return Value

(INT): 0 = Job successful, otherwise error code.

See also: adm.StoreSystemFile