StorageTek SVT Information Area Output Exits
This section provides descriptions of the VTS component standard user output exits that are invoked during the output phase of daily update processing for the StorageTek VSM Virtual Tape Subsystem Information Area (IVT) files.
micsrm140
This section provides descriptions of the VTS component standard user output exits that are invoked during the output phase of daily update processing for the StorageTek VSM Virtual Tape Subsystem Information Area (IVT) files.
Contents
General Information for Output Exits
Each exit description includes the user exit name and title, a description of its purpose, and when it is invoked. It also shows which data elements are available and any special considerations.
Exit code must not issue either RETURN or DELETE statements since their invocation assumes the entire DATA step will be executed.
Exit code can set SKIP_REC = 1 to prevent the current observation from being written to the output file.
All VTS component output exits use the indirect form of exit invocation. For general information on indirect exits, refer to Section 4.3.1.2, Indirect Exit Points, of the System Modification Guide.
Output Exits for the SVT Information Area Files
One type of output exit is available for each SVT Information Area file:
- USRSfff exits - invoked before output to WORK.SVTfff
SVT Information Area USRSfff Exits
All SVT Information Area file USRSfff exits, except USRSSVS, are invoked when the raw data record is still in the input buffer. They generally have access to DETAIL timespan data elements for their respective files, regardless of the element activation status (on or off). Data elements turned off in the DETAIL timespan are not kept in the file, but in most cases were populated during the input record parsing.
To minimize WORK space requirements, derived data elements are not computed prior to output to the WORK files. If USRSfff exit code must examine derived data element values, the %fffDERV(TS=DETAIL) macro can be used to compute the derived data element values within the USRSfff exits. If the %fffDERV macro is invoked, the derived data elements will be computed, but not kept in the WORK file.
All modifications made in the USRSfff exits are propagated from the WORK files to the
MICS
database files.USRSCIP
Exit Prior to Output of WORK.SVTCIP
Description
The USRSCIP exit allows access to the data elements used to create Channel Interface Performance (SVTCIP) WORK file observations. At the point where this exit is invoked, the observation contains the 15-minute interval channel statistics for a VTSS ID (VTSSID). The specific channel is identified by Channel Interface Name (CIPINM) and Type of Link (CIPTOL).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTCIP file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTCIP file. In addition, individual SVTCIP observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTCIP file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSMVC
Exit Prior to Output of WORK.SVTMVC
Description
The USRSMVC exit allows access to the data elements used to create multivolume Cartridge Activity (SVTMVC) WORK file observations. At the point where this exit is invoked, the observation contains statistics relating to an event where there was VTV movement on a multivolume cartridge. The specific cartridge is identified by MVC ID (VTSSMID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTMVC file.
Uses
This exit can be used to examine, modify, or assign values to data elements before being output to the WORK.SVTMVC file. In addition, individual SVTMVC observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTMVC file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSRDR
Exit Prior to Output of WORK.SVTRDR
Description
The USRSRDR exit allows access to the data elements used to create Real Tape Drive Dismount Activity (SVTRDR) WORK file observations. At the point where this exit is invoked, the observation contains statistics relating to the dismount of a multivolume cartridge with current status of space used and free space on the cartridge. The specific cartridge is identified by MVC ID (VTSSMID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTRDR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTRDR file. In addition, individual SVTRDR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTRDR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSRMR
Exit Prior to Output of WORK.SVTRMR
Description
The USRSRMR exit allows access to the data elements used to create Real Tape Drive Mount Activity (SVTRMR) WORK file observations. At the point where this exit is invoked, the observation contains statistics relating to the mount of a multivolume cartridge on a real tape drive. The specific cartridge is identified by data element MVC ID (VTSSMID) and the tape drive by data element RDT ID (VTSSRID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTRMR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTRMR file. In addition, individual SVTRMR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTRMR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSRPR
Exit Prior to Output of WORK.SVTRPR
Description
The exit allows access to the data elements used to create Real Tape Drive Performance (SVTRPR) WORK file observations. At the point where this exit is invoked, the observation contains the 15-minute interval statistics for a real tape drive attached to a VTSS (VTSSID). The tape drive id identified by data element RTD ID (VTSSRID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTRPR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTRPR file. In addition, individual SVTRPR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTRPR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSSSP
Exit Prior to Output of WORK.SVTSSP
Description
The USRSSSP exit allows access to the data elements used to create VTSS Subsystem Performance (SVTSSP) WORK file observations. At the point where this exit is invoked, the observation contains the 15-minute interval statistics for a virtual tape subsystem identified by data element VTSS ID (VTSSID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTSSP file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTSSP file. In addition, individual SVTSSP observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTSSP file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSSVS
Exit Prior to Output of WORK.SVTSVS
Description
The USRSSVS exit allows access to the data elements used to create StorageTek VTSS Summary (SVTSVS) WORK file observations. At the point where this exit is invoked, the observation contains a 15-minute interval summary for the overall activity of a virtual tape subsystem, identified by data element VTSS ID (VTSSID) for a specific z/OS system (SYSID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTSVS file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTSVS file. In addition, individual SVTSVS observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTSVS file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVDR
Exit Prior to Output of WORK.SVTVDR
Description
The USRSVDR exit allows access to the data elements used to create Virtual Tape Volume Dismount Activity (SVTVDR) WORK file observations. At the point where this exit is invoked, the observation contains statistics relating to the dismount of a virtual tape volume. The specific volume and virtual tape drive are identified by data elements VTV VOLSER ID (VTSSVID) and VTD Device ID (VTSSDID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVDR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVDR file. In addition, individual SVTVDR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVDR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVGR
Exit Prior to Output of WORK.SVTVGR
Description
The USRSVGR exit allows access to the data elements used to create Virtual Tape Volume Migrate Activity (SVTVGR) WORK file observations. At the point where this exit is invoked, the observation contains statistics for a virtual tape volume migration event. The virtual tape volume is identified by data element VTV Volser ID (VTSSVID). The real tape drive and the multivolume cartridge used for the migration are identified by data elements RTD ID (VTSSRID) and MVC ID (VTSSMID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVGR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVGR file. In addition, individual SVTVGR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVGR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVMR
Exit Prior to Output of WORK.SVTVMR
Description
The USRSVMR exit allows access to the data elements used to create Virtual Tape Volume Mount Activity (SVTVMR) WORK file observations. At the point where the exit is invoked, the observation contains statistics relating to the mount of a virtual tape volume. The specific volume and virtual tape drive are identified by data elements VTV VOLSER ID (VTSSVID) and VTD Device ID (VTSSDID). The job and step name of the address space requesting the mount are identified by data elements Job Identification (JOB) and Program Step Name (STEPNAME).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVMR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVMR file. In addition, individual SVTVMR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVMR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVMV
Exit Prior to Output of WORK.SVTVMV
Description
The exit allows access to the data elements used to create Virtual Tape Volume Movement (SVTVMV) WORK file observations. At the point where this exit is invoked, the observation contains statistics related to an event where a virtual tape volume was moved from one multivolume cartridge to another. The specific virtual volume is identified by data element VTV VOLSER ID. The old and new multivolume cartridges are identified by data elements Old MVC Volser ID (VMVOMI) and New MVC Volser ID (VMVNMI).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVMV file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVMV file. In addition, individual SVTVMV observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVMV file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVRR
Exit Prior to Output of WORK.SVTVRR
Description
The exit allows access to the data elements used to create Virtual Tape Volume Recall Activity (SVTVRR) WORK file observations. At the point where this exit is invoked, the observation contains statistics for a virtual tape volume recall. The specific virtual volume is identified by data element VTV VOLSER ID. The real tape drive and the multivolume cartridge used for the recall are identified by data elements RTD ID (VTSSRID) and MVC ID (VTSSMID).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVRR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVRR file. In addition, individual SVTVRR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVRR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVSS
Exit Prior to Output of WORK.SVTVSS
Description
The exit allows access to the data elements used to create Virtual Tape Volume Scratch Status (SVTVSS) WORK file observations. At the point where this exit is invoked, the observation contains statistics for a scratched virtual tape volume. The specific virtual volume is identified by data element VTV VOLSER ID.
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVSS file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVSS file. In addition, individual SVTVSS observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVSS file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVUN
Exit Prior to Output of WORK.SVTVUN
Description
The USRSVUN exit allows access to the data elements used to create VTV
MVC Unlink Activity (SVTVUN) WORK file observations. At the point where this exit is invoked, the observation contains reason a specific virtual tape volume (VTV) is unlinked from a Multi-Volume Cartridge (MVC).
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVUN file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVUN file. In addition, individual SVTVUN observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVUN file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None
USRSVXR
Exit Prior to Output of WORK.SVTVXR
Description
The exit allows access to the data elements used to create Virtual Tape Volume Delete Activity (SVTVXR) WORK file observations. At the point where this exit is invoked, the observation contains statistics for a deleted virtual tape volume. The specific virtual volume is identified by data element VTV VOLSER ID.
Invocation
This exit gains control immediately before the output of a record to the WORK.SVTVXR file.
Uses
This exit can be used to examine, modify, or assign values to data elements before they are output to the WORK.SVTVXR file. In addition, individual SVTVXR observations can be prevented from being output by setting element SKIP_REC=1 ;
Elements Available
All DETAIL timespan SVTVXR file data elements specified in sharedprefix.MICS.GENLIB(VTSGENIN).
Coding Restrictions
None