Job Management Partner 1/Software Distribution Client Description and User's Guide

6.5.2 Syntax of the environment settings file

Organization of this subsection

(1) Format

(2) Details

(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}]
[NETMDMGF_UAPGEN=UAP-installation-work-directory]
[NETMDMGF_UPTGEN=UAP-installation-work-directory]
[EventType=IM]
When your JP1/Software Distribution Client is an updated version from the previous JP1/Software Distribution Workstation and JP1/Software Distribution Workstation Generator, you can use the environment settings file of the previous version. If you use the previous environment settings file, the SyslogLevel attribute in the previous file is also valid. This attribute corresponds to the SystemLogOutputLevel attribute shown above. If you specify or omit both of these attributes in the environment settings file, the value that SystemLogOutputLevel explicitly or implicitly specifies prevails.

(2) Details

NETMDMGF_HOKAN directory-for-installation-scheduled-packages ~ <</NETMDMGF/HOKAN>>

This attribute specifies the name of the directory for temporarily storing the installation-scheduled packages that are not installed yet.

LOGFileDirectory log-file-directory ~ <</NETMDMGF>>

This attribute specifies the name of the directory for storing log 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.

You can use the SyslogLevel attribute of the previous version (JP1/Software Distribution Workstation Generator) instead of the SystemLogOutputLevel attribute. 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.

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. 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.

NETMDMGF_UAPGEN UAP-installation-work-directory ~ <1 to 64 alphanumeric characters> <</usr/bin/UAPGEN>>

Specify the name of the work directory for UAP-based installation. Note that storing other subdirectories and files in the specified directory will cause an installation error.

NETMDMGF_UPTGEN UAP-installation-work-directory ~ <1 to 64 alphanumeric characters> <</usr/bin/UPTGEN>>

Specify the name of the work directory for UAP-based installation that is used during installation on the day of application. Note that storing other subdirectories and files in the specified directory will cause an installation error.

EventType IM

Specify IM as the type of JP1 events to be issued.

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

[Contents][Back][Next]

[Trademarks]