z/VM: CP Commands and Utilities Reference - z/VM - IBM

RETRIEVE
RETRIEVE
►►
RETRIEVE
Purpose
Operands
ALL
Usage Notes
ACCOUNT
ALL
LOGROUTE
EREP
SYMPTOM
LOGROUTE
TO
TO
userid
userid
1862 z/VM: CP Commands and Utilities Reference
AT
AT
nodeid
nodeid
Use the RETRIEVE utility to collect accounting, I/O error (EREP), and symptom
records and to place them in the proper file for later processing and analysis.
ACCOUNT
EREP
SYMPTOM
ALL
indicates the type of records that you want to collect. Specify ACCOUNT if you
want to collect only accounting records; specify EREP if you want to collect only
EREP records; and specify SYMPTOM if you want to collect only SYMPTOM
records. Specify ALL if you want to collect all of the record types. This is the
default.
LOGROUTE TO userid
indicates the user ID to which error records will be routed. LOGROUTE is valid
only when EREP or ALL is also specified. If EREP or ALL is specified and
LOGROUTE is omitted, the error records are accumulated in CMS files on file
mode A. They are not routed to another user ID.
AT nodeid
indicates the node ID to which error records will be routed. If AT is omitted,
RETRIEVE processing assumes the LOGROUTE user ID is on the same
system.
FOR
FOR time
indicates the time interval at which error records will be collected and sent to
the specified user. For time, specify a whole number from 1 to 1440 indicating
the time interval, in minutes. If this parameter omitted, the default is 30 minutes.
1. The user issuing the RETRIEVE utility must have a directory entry containing an
IUCV directory control statement authorizing the virtual machine to connect to
the CP system service which supports the type of record being collected.
*ACCOUNT must be specified for ACCOUNT records, *LOGREC for EREP
records, and *SYMPTOM for SYMPTOM records. Successful completion of this
command will cause this user ID to be known to CP (for recording purposes)
until a cold start of the system is performed.
FOR
time
time
►◄