Ending Entire System Server - Software AG Documentation

Common Entire System Server Features
■ Position parameter 1: NODE-ID of the Entire System Server or -f or --file
With Online-Trace, the numerical NODE-ID is specified to indicate MONITOR-MODE, whereas -f or
--file causes the dataset assigned using the DDNAME TRACEIN (z/OS), TRACIN (SYS001) DLBL
or TLBL (z/VSE) or logical file name TRIN (BS2000/OSD) to be processed as input (FILE-MODE ).
■ Keyword parameters:
■ -d | --displ
The prepared result data is transferred to SYSPRINT (z/OS), SYSLST (z/VSE) or SYSOUT
(BS2000/OSD).
■ -n | --ntrout
If this parameter is specified, no output file will be generated with the prepared result data
using the logical file name TROUT. This key is accepted only if the parameter -d | --displ
has also been specified.
■ -p | --poll
This option causes ESYTRACE in the MONITOR-MODE not to terminate the program at the end of
the buffer, but to wait for further data in the trace buffer. This enables a running ESY node
to be monitored in real time. Under z/VSE, additional steps are required before this can be
used.
For the format of the optional output file, the following file attributes are required:
Option
BS2000/OSD
z/OS
z/VSE
Explanation
Size: SPACE=(4,4)
Features: BLKSIZE=(STD,2),FCBTYPE=SAM,RECFORM=V
LRECL=315, RECFM=FBA
LRECL=315
The following parameters are recommended for the two modes:
■ parameter list for MONITOR-MODE: NODE-ID --displ --poll
■ parameter list for FILE-MODE: --file
The output file generated is useable only for error analysis by Software AG support. It contains
no user data whatsoever other than the user ID.
For real-time monitoring of error situations, these steps should be used:
1. Start Entire System Server
2. Start diagnosis program ESYTRACE in MONITOR-MODE with the --poll option.
ESYTRACE will format trace data as soon as it is placed in the buffer.
84
Administration