Show TOC Start of Content Area

Background documentation LOG  Locate the document in its SAP Library structure

Use

This section contains the log commands used for AS Java log system administration. They are added to the Shell environment by executing “ADD LOG” on the command line.

LOG_ARCHIVE

Syntax

LOG_ARCHIVE

Description

Creates archive for all log files.

 

LOG_CREATE

Syntax

LOG_CREATE [-? | -H]  [-C | -D | -F OID]

Arguments

 

-? | -H

Displays the help message.

-C | -D | -F

Specifies the type of the object to be created: log controller (C), log destination (D), or log formatter (F).

OID

The ID of the object to be created. The OID identifier must represent a unique name for the Log Configurator Service.

Description

Creates and registers new objects into the Log_Configurator Service.

Recommendation

Use the LOG_LIST command to obtain information about the existing objects. To change the settings of a newly created object you can use the LOG_EDIT command.

 

 

LOG_DUMPS

Syntax

LOG_DUMPS [-? | -H]  [OID]  [ON | OFF]

Arguments

 

-? | -H

Displays the help message.

OID

The ID of the log controller to be debugged. The OID identifier must represent a valid name for the Log Configurator Service.

ON | OFF

Turns the additional console output ON or OFF.

Description

Enables or disables additional console output for a specified log controller.

Recommendation

You can use the LOG_LIST command to obtain information about the existing controllers.

Note that if this log controller already has an associated log destination of type ConsoleLog some messages may be displayed twice.

Keep in mind the hierarchy of the log controllers. If neither ON nor OFF is specified, then the current status is shown. If no OID is given – a "global" configuration is assumed.

 

 

LOG_EDIT

Syntax

LOG_EDIT [-? | -H]  [-C | -D | -F OID]

Arguments

 

-? | -H

Displays the help message.

-C | -D | -F

Specifies the type of the object to be edited: log controller (C), log destination (D), or log formatter (F).

OID

The ID of the object to be edited. The OID identifier must represent a valid name for the Log Configurator Service.

Description

Reconfigures previously registered objects in the Log Configurator Service.

Recommendation

You can use the LOG_LIST command to retrieve the current logging settings or the LOG_CREATE command to add a new object to the existing configuration.

Note

Note that only "named" objects can be edited (name is case sensitive), and that this operation will affect all the users of the corresponding object.

 

 

LOG_LIST

Syntax

LOG_LIST [-? | -H]  [-T]  [-C | -D | -F [OID | -T]]

Arguments

 

-? | -H

Displays the help message.

-C | -D | -F

Specifies the type of the object to be listed: log controller (C), log destination (D), or log formatter (F).

-T

Specifies that a thorough info should be provided.

Recommendation

The -T switch can be used as a single argument or after a type specifier (that is: -C, -D, or -F). In this case the command behaves as if there is no -T (the only difference is that a detailed information will be provided for the appropriate objects, instead of simple listing of their names).

The object identifier, that is, the name of an object as printed by this command, displays a thorough information about the settings of a particular object. It must be used with a preceding type specifier but without the -T switch. The -T switch can be used only when no object ID is given.

 

OID

The ID of the object to be inspected. The OID identifier must represent a valid name for the Log Configurator Service.

Description

Shows information about the currently configured objects in the Log Configurator Service.

Note

Only "named" objects can be displayed (name is case sensitive). If the command is used without arguments, it provides a complete listing of all registered object names sorted by their corresponding types. If it is executed with a type specifier but with no object identifier, then this command lists the name of every object of the respective type that is configured with the Log Configurator Service

 

 

LOG_REMOVE

Syntax

LOG_REMOVE [-? | -H]  [-C | -D | -F OID]

Arguments

 

-? | -H

Displays the help message.

-C | -D | -F

Specifies the type of the object to be removed: log controller (C), log destination (D), or log formatter (F).

OID

The ID of the object to be removed. The OID identifier must represent a valid name for the Log Configurator Service.

Description

Removes previously configured objects from the Log Configurator Service.

Recommendation

You can use the LOG_LIST command to retrieve the necessary information.

Note that only "named" objects can be removed (name is case sensitive), and that this operation will affect all the users of the corresponding object.

 

 

More Information

More information about how to use the shell commands: Administration Using Telnet.

 

 

End of Content Area