...
json.
args:
...
file (a full path),
format (optional, 'nmis' or 'json', if not set: guess from file extension
...
or assume nmis), lock (optional, defaults false),
...
cache (optional, default false, IFF set return the material from cache -
...
but this is LIVE and SHARED data! you have to use Clone if your app needs
...
to change anything in this structure!)
returns:
undef on error (sets error_string), (hash reference, filehandle) if lock,
...
(hash reference) otherwise.
writeHashtoFileOmk()
write hash structure to a file, as json or nmis/perl dump
args:
file (a full path), data (hash ref), both required
...
handle (optional, open filehandle, if present it's expected to be locked
...
...
and NO locking takes place!
...
format (optional, 'nmis' or 'json', if not present format is guessed from
...
file extension)
...
cache (optional, if set to 1 data is fed to setOmkCache)
attention: if format is not given, and the file arg doesn't have an extension,
then the extension .nmis is automatically added!
returns: (status, error), with status 1 being good.
...
Returns unix epoch seconds in utc.
arg:
takes anything that time::parsedate understands, plus an optional timezone argument
...
and returns full seconds (ie. unix epoch seconds in utc)
if no timezone is given, the configured timezone omkd_display_timezone or local is used.
...