Use of this trace makes sense if execution problems are suspected with requests in ARCHIVE.
The ARCHIVE trace is activated and deactivated with the privileged commands START-ARCHIVE-TRACE and STOP-ARCHIVE-TRACE. This trace can only be started for specific functional areas and tasks.
START-ARCHIVE-TRACE |
TSN = *ALL / <alphanum-name 1..4> ,DOMAIN = *ALL / list-poss(32): *DEVICE / *MULTIPLEXING / *PACKET / *SYNCRONIZATION / *PLAM / *MEMORY / *DIRECTORY |
STOP-ARCHIVE-TRACE |
CLOSE-MODE = *NORMAL-CLOSE / *PSEUDO-CLOSE |
MODIFY-ARCHIVE-TRACE |
TSN = *ALL / <alphanum-name 1..4> ,DOMAIN = *ALL / list-poss(32): *DEVICE / *MULTIPLEXING / *PACKET / *SYNCRONIZATION / *PLAM / *MEMORY / *DIRECTORY |
The DOMAIN operand determines whether the trace should cover all or only (several) specific functional areas:
The operand value *ALL initiates trace entries for all functional areas which are subsequently named.
The operand value *DEVICE initiates trace entries for all volume and tape device requests to MAREN and NDM in the modules FAPO, FASC, FASR and FAUTDM.
The operand value *MULTIPLEXING initiates trace entries for all requests between tape driver and multiplexing subtasks.
The operand value *PACKET initiates trace entries for packet processing in the modules FAFN, FAFNSV and FARPX.
The operand value *SYNCHRONISATION initiates trace entries for synchronization between ARCHIVE main task and subtasks in the FASC module.
The operand value *PLAM initiates trace entries for writing and reading the PLAM info in the FAFNPL module.
The operand value *MEMORY initiates trace entries for storage requests/releases in the FAUTMR module.
The operand value *DIRECTORY initiates trace entries for accesses to directories in the modules FARAM and FAUTRM.
When the ARCHIVE trace is started or stopped the associated trace ID is output.
When the trace is deactivated the diagnostic information is written to a file and the associated file name is output. The CLOSE-MODE=*PSEUDO-CLOSE operand allows the trace to continue, but the data written up to this point can be read.