Deactivate trace
Component: | BS2000 |
Functional area: | Error logging |
Domain: | ERROR-LOGGING |
Privileges: | TSOS |
Routing code: | R |
Function
This command deactivates a previously activated trace listed as “active” in the trace address list and places it in the “initialized” state.
Switchable, temporary traces serve to store brief information on all operations of a functional unit in the order of their execution.
Format
STOP-TRACE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
TRACE-IDENTIFICATION =
Specifies whether all or only selected traces from the list of switchable traces are to be deactivated.
TRACE-IDENTIFICATION = list-poss(51): <name 1..8>(...)
Specifies the names of up to 51 traces that are to be deactivated. The specified traces must be ON (activated) or ON/OFF (trace is only partially active, i.e. it collects information on different events).
If the traces involved are not statically defined, they are assigned to a specific subsystem that can be defined in more detail in the following operands.
See the START-TRACE command for the names of possible traces.
SUBSYSTEM-NAME =
Specifies the subsystem to which the trace is assigned.
SUBSYSTEM-NAME = *ALL
The traces are to be deactivated in all cases, regardless of the subsystem to which they are assigned.
SUBSYSTEM-NAME = <name 1..8>
Exact specification of the subsystem to which the trace to be deactivated is assigned.
SUBSYSTEM-NAME = *NONE
Only statically defined traces that are not assigned to any subsystem are to be deactivated.
SUBSYSTEM-VERSION =
Specifies the version of the subsystem to which the trace is assigned.
SUBSYSTEM-VERSION = *ALL
The traces are to be deactivated for all versions of the selected subsystem.
SUBSYSTEM-VERSION = <product-version without-man-corr> /
<product-version mandatory-man-corr>
Specifies the version.
If a version is specified, the format specified here must be identical to the format used when the subsystem was defined (release and correction status mandatory or not allowed; see also "product-version" (SDF syntax representation)).
TRACE-IDENTIFICATION = *ALL(...)
All traces that are to be deactivated.
If the traces involved are not statically defined, they are assigned to a specific subsystem that can be defined in more detail in the following operands.
SUBSYSTEM-NAME =
Specifies the subsystem to which the trace is assigned.
SUBSYSTEM-NAME = *ALL
The traces are to be deactivated in all cases, regardless of the subsystem to which they are assigned.
SUBSYSTEM-NAME = <name 1..8>
Exact specification of the subsystem to which the trace to be deactivated is assigned.
SUBSYSTEM-NAME = *NONE
Only traces that are not assigned to any subsystem are to be deactivated.
SUBSYSTEM-VERSION =
Specifies the version of the subsystem to which the trace is assigned.
SUBSYSTEM-VERSION = *ALL
The traces are to be deactivated for all versions of the selected subsystem.
SUBSYSTEM-VERSION = <product-version without-man-corr> /
<product-version mandatory-man-corr>
Specifies the version.
If a version is specified, the format specified here must be identical to the format used when the subsystem was defined (release and correction status mandatory or not allowed; see also "SDF syntax representation").
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 0 | CMD0001 | Specified traces are already ON |
2 | 0 | PDT0208 | One of the specified traces is already OFF |
32 | CMD0221 | Internal error | |
1 | 32 | PDT0203 | Specified trace is not switchable |
2 | 32 | PDT0203 | One of the traces specified in the list is not switchable |
1 | 32 | PDT0210 | Invalid ON/OFF pattern for the specified trace |
2 | 32 | PDT0210 | Invalid ON/OFF pattern for one of the traces specified in the list |
1 | 64 | PDT0200 | Specified trace does not exist |
2 | 64 | PDT0200 | One of the traces specified in the list does not exist |
1 | 64 | PDT0202 | Trace is of the type PERMANENT |
2 | 64 | PDT0202 | One of the traces specified in the list is of the type PERMANENT |
64 | PDT0209 | No authorization for command | |
1 | 64 | PDT0214 | Deactivation of some traces was rejected with different error messages; no action taken |
2 | 64 | PDT0214 | Deactivation of some traces was rejected with different error messages; other specified traces were deactivated |