5.6.2 Syntax of the environment settings file
- Organization of this subsection
(1) Format
[NETMDMGF_HOKAN=directory-for-installation-scheduled-packages] [LOGFileDirectory=log-file-directory] [LOGFileRecordMax=number-of-records] [SystemLogOutputLevel={0|1|2|3}] [EvntlogLevel={0|1|2}] [CommandWait=timeout] [GF_WatchTimer={ON|OFF}] [ERR_CONTINUE={ON|OFF}]
(2) Details
- NETMDMGF_HOKAN directory-for-installation-scheduled-packages ~ <1 to 64 alphanumeric characters> <</NETMDMGF/HOKAN>>
-
This attribute specifies the name of the directory for temporarily storing the installation-scheduled packages that are not installed yet. If a directory that does not exist is specified, distribution that uses generator tools cannot be performed.
- LOGFileDirectory log-file-directory ~ <1 to 64 alphanumeric characters> <</NETMDMGF>>
-
This attribute specifies the name of the directory for storing log files. If a directory that does not exist is specified, logs cannot be output to files.
- LOGFileRecordMax number-of-records ~ <numerics>((1 to 9999)) <<100>>
-
This attribute specifies the maximum number of records that the log file can contain. This attribute is effective only when you initialize the log file.
- SystemLogOutputLevel ~ <numerics> {0|1|2|3} <<3>>
-
This attribute specifies the output level of the messages that may be output to the syslog file. However, if you specify or omit both of these attributes in the environment settings file, the value that SystemLogOutputLevel explicitly or implicitly specifies prevails.
- 0
-
Does not output messages.
- 1
-
Outputs messages only during startup, shutdown, and when an error occurs.
- 2
-
Outputs messages only during startup, shutdown, and when an error or warning occurs.
- 3
-
Outputs only start, termination and runtime messages. The runtime messages include messages about normal processing and abnormal processing.
The following table lists the messages that the generator tools output to syslog.
Message ID
Facility
Level
KDGFnnnn-E
LOG_USER
LOG_ERR
KDGFnnnn-S
LOG_USER
LOG_CRIT
KDGFnnnn-W
LOG_USER
LOG_WARNING
KDGFnnnn-I
LOG_USER
LOG_INFO
- Legend:
-
nnnn: A four-digit number is displayed as the message code.
- EvntlogLevel ~ <numerics> {0 | 1 | 2} <<0>>
-
This attribute specifies the level for outputting messages as JP1 events.
- 0
-
Does not output messages.
- 1
-
Only outputs messages at the start of installation or when an error occurs.
- 2
-
Outputs messages during startup/shutdown, UAP startup/shutdown, and when an error occurs.
- CommandWait timeout ~ <numerics>((1 to 9999)) <<3600>>
-
This attribute specifies the timeout (in seconds) for the command waiting until the target file is unlocked. Specifying 9999 prevents the timeout from occurring. The command waiting time indicates the waiting time that occurs due to an exclusive control for the rdsupt command that runs as an extended function of the client services and that is executed by the user.
- GF_WatchTimer ~ <characters> {ON|OFF} <<ON>>
-
This attribute specifies whether to monitor the UAP execution time.
- ON
-
Monitors the execution time.
If the user command does not terminate although this attribute is set to ON and a timeout occurs, the system assumes that the user command failed and continues processing. If this occurs, the user command is not forcibly terminated. The timer uses the time specified in the APWatchTimer attribute in the packaging information file. The initial value of APWatchTimer is 300.
- OFF
-
Does not monitor the execution time.
- ERR_CONTINUE ~ <characters> {ON|OFF} <<ON>>
-
This attribute specifies whether to terminate the processing if an error occurs in the rdsupt command.
- ON
-
Continues the processing even when an error occurs.
- OFF
-
Terminates the processing when an error occurs.
If OFF is specified and an error occurs during installation processing by the rdsupt command, the installation of the next package is not executed.