Nstasklog, Nstaskexitcode, Nstaskcurrentitem – Red Hat 8.1 User Manual

Page 81: Nstasktotalitems

Advertising
background image

Syntax

case-exact string

Example

nsTaskStatus: Loading entries....

nsTaskLog

This entry contains all of the log messages for the task, including both warning and information
messages. New messages are appended to the end of the entry value, so this attribute value grows
larger, without erasing the original contents, by default.

Successful task operations, which have an nsTaskExitCode of 0, are only recorded in the nsTaskLog
attribute. Any non-zero response, which indicates an error, may be recorded in the error log as an error,
but the error message is only recorded in the nsTaskLog attribute. For this reason, use the information
in the nsTaskLog attribute to find out what errors actually occurred.

This attribute value is set by the server and should not be edited.

Parameter

Description

Entry DN

cn=task_name, cn=task_type, cn=tasks,
cn=config

Valid Values

Any string

Default Value
Syntax

Case-exact string

Example

nsTaskLog: example...

nsTaskExitCode

This attribute contains the exit code for the task. This attribute only exists after the task is completed
and any value is only valid if the task is complete. The result code can be any LDAP exit code, as listed
in

Section 5.4, “LDAP Result Codes”

, but only a 0 value equals success; any other result code is an

error.

This attribute value is set by the server and should not be edited.

Parameter

Description

Entry DN

cn=task_name, cn=task_type, cn=tasks,
cn=config

Valid Values

0 (success) to 97

[ ]

Default Value
Syntax

Integer

Example

nsTaskExitCode: 0

nsTaskCurrentItem

This attribute shows the number of subtask which the task operation has completed, assuming the task
can be broken down into subtasks. If there is only one task, then nsTaskCurrentItem is 0 while the
task is running, and 1 when the task is complete. In this way, the attribute is analogous to a progress
bar. When the nsTaskCurrentItem attribute has the same value as nsTaskTotalItems, then the task
is completed.

This attribute value is set by the server and should not be edited.

Parameter

Description

Entry DN

cn=task_name, cn=task_type, cn=tasks,
cn=config

Valid Values

0 to the maximum 32 bit integer value
(2147483647)

Default Value
Syntax

Integer

Example

nsTaskCurrentItem: 148

nsTaskTotalItems

This attributes shows the total number of subtasks that must be completed for the task operation. When
the nsTaskCurrentItem attribute has the same value as nsTaskTotalItems, then the task is
completed.

This attribute value is set by the server and should not be edited.

a

Any resp o nse o ther than 0 is an erro r.

[

a

]

Red Hat Directory Server 8.1 Configuration and Command Reference

81

Advertising