CA EPIC for z/VSE 5.2 using ACL and robot is not detaching the tape at the end of the job.

Document ID : KB000050656
Last Modified Date : 14/02/2018
Show Technical Document Details

Problem:

EPIC does NOT detach the tape drive after the job is complete.
We see the messages

EP088 DISMOUNT CARTRIDGE SYSUSE    =cuu    
EP906 TAPE UNLOADED FROM DRIVE     cuu 

but the tape drive is still attached, as shown by the command

q ta all

TAPE rcuu ATTACHED TO vsemach cuu R/W

Cause:

The TSIDDEB summary report shows the settings of AUTOATT=Y, EPS100=Y, EPS102=Y and EPS103=Y are in effect.

AUTOATT

Activates the CA EPIC for z/VSE Autoattach feature. AUTOATT=YES should only be specified when Autoattach has been properly installed. Refer to "Autoattach Installation."

Related Configuration Options: VM

EPS100

When set to YES, option EPS100 removes CA EPIC for z/VSE's requirement for the AUTOATTACH feature in order to support an IBM ACL through the VSE Guest Server (VGS) interface. For ACLs accessed through LCDD or native VSE, this option has no effect.

Important! Do not specify this option for STK or MEMOREX ACLs.

EPS102

When set to YES, EPS102 allows AUTOATTACH to be used without modifications to the VM/CP nucleus. AUTOATTACH will use standard CP 'ATTACH' and 'DETACH' commands rather than EPIC's 'VATTACH' and 'VDETACH'. The 'DETACH' command will include the 'LEAVE' option to prevent mounted tapes from unloading during an AVR scan (except for TSIDINIT). VM/ESA or higher is required for the 'LEAVE' option.

Note: For more information, see AUTOATT, EPS103.

EPS103

EPS103='Y' specifies the use of the 'SILENTLY' prefix on the CP ATTACH and DETACH commands that are generated when option EPS102='Y'. This will suppress message traffic related to EPIC's ATTACH and DETACH commands on the VM Operator console. Z/VM 4.4 or later release is required for this option. EPS103='Y' does not have any effect unless EPS102='Y'.
The 'SILENTLY' prefix invoked by EPS103='Y' must be enabled after each VM IPL with the following class 'A' CP commands:
'CP MODIFY COMMAND ATTACH SILENT'
'CP MODIFY COMMAND DETACH SILENT'
We recommend placing them in AUTOLOG1'S profile exec.

Resolution:

Changing the setting of EPS103 to N will stop EPIC putting the 'SILENTLY' prefix on the DETACH commands, allowing the commands and error messages to go to the VM operator console and showing us more information. In this instance it then gave the following messages:

hh:mm:ss TAPE E1A0 ATTACHED TO RMSMASTR E1A0 BY RMSMASTR   
hh:mm:ss TAPE E1A0 DETACHED RMSMASTR E1A0 BY RMSMASTR, TAPE VOLUME   
TAPE E1A0 ATTACHED TO ESDVSE 0ABA   
hh:mm:ss TAPE E1A0 ATTACHED TO ESDVSE 0ABA BY RMSMASTR   
HCPDTG040E DEVICE 0ABA DOES NOT EXIST 

Although technically EPS100=Y and AUTOATT=Y are not mutually exclusive, EPS100 was introduced so that the robot can be used without Autoattach.

Unless Autoattach support is need for non-ACL drives there is no requirement to have AUTOATT=Y as well as EPS100=Y.

The DETACH command is modified by both these options so having both options active can cause confusion.

With EPS100=Y, a DETACH is still performed, even though AUTOATTACH is not active, and in that case the virtual device address is used, which is what is happening in this case as the '0ABA' referenced in the HCPxxx message is a virtual address.
Having the EPS102 and EPS103 options active is causing the 'SILENTLY' and 'LEAVE' parameters to be put on the command and that is making VM think that
'0ABA' is a real address. Setting both EPS102 and EPS103 to 'N', should make the DETACH work as it should do.

Set AUTOATT=N, EPS102=N and EPS103=N and with these settings the tape drive was successfully detached at end of job.

Additional Information:

These special options are described in Chapter 4 of the CA EPIC for z/VSE Installation and System Guide r5.2: