8464ch10_OperSW.fm Draft Document for Review February 7, 2020 3:15 pm GLYPH<SM590000> LIBRARY EJECT,volser,{PURGE|KEEP|LOCATION} GLYPH<129> Remove the volume record from the TCDB (PURGE or P). GLYPH<129> Keep the volume record in the TCDB and update it to indicate that the cartridge was  ejected (KEEP or K). If the record contains information in the SHELF location field,  it is not changed. If the SHELF location field is empty, the operator must enter  information about the new location as a reply to write to operator with reply  (WTOR). The reply can be up to 32 characters long. GLYPH<129> Keep the volume record in the TCDB and update it, including updating the SHELF  location, even if information is in this field (LOCATION or L). The operator must  enter the new information as a reply to WTOR. GLYPH<SM590000> VARY  unit ,ONLINE/OFFLINE – When used against a real, physical volume, the  LIBRARY EJECT  command instructs the  library the volume is in to EJECT the volume. With a TS7700, all the volumes that are  contained within are virtual, so no volume can be physically ejected.  Consider the following points: Therefore, when issued against a virtual volume in a TS7700, the  EJECT  command is  used to delete that virtual volume from the TS7700. Virtual volumes can be deleted  only if they are in a scratch category.  This command cannot be used to eject a physical backend volume from a TS3500 or  TS4500 because the host has no knowledge of backend tape libraries. The following  options are available for this command: If none of the variations (PURGE, KEEP, or LOCATION) is indicated in the command, a  default decides whether the record is kept or purged. This default can be set separately for  each library through the ISMF Library Definition window. This command is available for the operator to delete a single virtual volume. Mass deletion  of virtual volumes is performed through program interfaces, such as ISMF, a tape  management system (TMS), or a batch job. For more information about the following commands, see  z/OS MVS System Commands ,  SA38-0666: The  VARY  unit  command is no different from what it was before. However, new situations  are seen when the affected unit is attached to a library. When the library is offline, the tape units cannot be used. This state is internally indicated  in a status (offline for library reasons), which is separate from the normal unit offline  status. A unit can be offline for library and single-unit reasons. A unit that is offline only for library reasons cannot be varied online by running  VARY  unit ,ONLINE . Only  VARY SMS,LIBRARY(...),ONLINE  can bring it back online.  You can bring a unit online that was individually varied offline, and was offline for library  reasons, by varying it online individually and varying its library online. Although the order  of these activities is not important, both are necessary. 10.1.2 MVS system commands  Chapter 10. z Host Console operations  593