GLYPH<SM590000> LIBRARY EJECT,volser,{PURGE|KEEP|LOCATION} 

Consider the following points: 

– 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. 

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: 

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. 

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. 

## 10.1.2 MVS system commands 

For more information about the following commands, see z/OS MVS System Commands , SA38-0666: 

GLYPH<SM590000> VARY unit ,ONLINE/OFFLINE 

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. 

