Patch Name: PHCO_19771

Patch Description: s700_800 10.20 st(1M), shared tape, cumulative patch

Creation Date: 99/09/22

Post Date:  99/09/27

Hardware Platforms - OS Releases:
	s700: 10.20
	s800: 10.20

Products: N/A

Filesets:
	OS-Core.SYS-ADMIN OS-Core.ADMN-ENG-A-MAN

Automatic Reboot?: No

Status: General Release

Critical: No

Path Name: /hp-ux_patches/s700_800/10.X/PHCO_19771

Symptoms:
	PHCO_19771:
	If the tape is allocated to the same system as where
	the st(1M) command is issued, st(1M) returns 1, instead
	of 0 when successful.  Also, a different error format
	is returned other than what is described on the man
	page in this case on failure.

	PHCO_16719:
	Need a command-line interface for checking the status of a
	shared tape device, or for reclaiming a shared tape device
	from a host that has failed while holding a reservation on
	the device.

Defect Description:
	PHCO_19771:
	Changes have been made to st(1M) to allow the proper
	return code to be returned on success.  Also, a more
	descriptive, correctly formatted error message has been
	added in the case that a device is on the same system
	as where the st(1M) command was issued, but the device is
	busy.

	PHCO_16719:
	Need a command-line interface for checking the status of a
	shared tape device, or for reclaiming a shared tape device
	from a host that has failed while holding a reservation on
	the device.  An enhancement to the mt(1) command adds the
	functionality that allows a host to reserve and release a
	shared tape device.  However, if a host goes down, then it
	is unable to issue the mt(1) release command.  This st(1M)
	command allows the device to be reclaimed, so that it is
	available for use by other hosts.

SR:
	8606105555 4701401190

Patch Files:
	/usr/sbin/st
	/usr/share/man/man1m.Z/st.1m

what(1) Output:
	/usr/sbin/st:
		PATCH_10_20: st.o 99/09/22
	/usr/share/man/man1m.Z/st.1m:
		None

cksum(1) Output:
	1201153632 12288 /usr/sbin/st
	4136766480 1728 /usr/share/man/man1m.Z/st.1m

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHCO_16719

Equivalent Patches:
	PHCO_19772:
	s700: 11.00
	s800: 11.00

Patch Package Size: 70 KBytes

Installation Instructions:
	Please review all instructions and the Hewlett-Packard
	SupportLine User Guide or your Hewlett-Packard support terms
	and conditions for precautions, scope of license,
	restrictions, and, limitation of liability and warranties,
	before installing this patch.
	------------------------------------------------------------
	1. Back up your system before installing a patch.

	2. Login as root.

	3. Copy the patch to the /tmp directory.

	4. Move to the /tmp directory and unshar the patch:

		cd /tmp
		sh PHCO_19771

	5a. For a standalone system, run swinstall to install the
	    patch:

		swinstall -x autoreboot=true -x match_target=true \
			-s /tmp/PHCO_19771.depot

	By default swinstall will archive the original software in
	/var/adm/sw/patch/PHCO_19771.  If you do not wish to retain a
	copy of the original software, you can create an empty file
	named /var/adm/sw/patch/PATCH_NOSAVE.

	WARNING: If this file exists when a patch is installed, the
	         patch cannot be deinstalled.  Please be careful
		 when using this feature.

	It is recommended that you move the PHCO_19771.text file to
	/var/adm/sw/patch for future reference.

	To put this patch on a magnetic tape and install from the
	tape drive, use the command:

		dd if=/tmp/PHCO_19771.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions: None