Releasing PDS(E) member locked by ESP Workstation or a Dseries user.

Products

• ESP Workload Automation

Issue/Introduction

PDS(E) member is locked by ESP Workload Automation Workstation user.  Same lock can happen on Dseries Server user, how do you release it?

 

 

Environment

Release: All
Components: ESP Workload Automation, ESP Workload Automation Workstation, ESP Workload Automation Agent for z/os 

Resolution

The LISTLOCK and UNDOLOCK are the commands to list pds members that are held by users.

The command can be issued from ESP Workload Automation Workstation LMI. Or as Modify command against ESP Workstation STC.

 /F ESPWS,cmd

The command can be issued from the Z/OS Agent STC. 

/F ZOSAGENT,cmd

EXAMPLE: List lock to Workstation Server STC. Same command would be issued against Z/OS AGENT STC.

/F ESPWSS,listlock
ESPWSS4647I List of Currently Locked Files
ESPWSS4648I   User     ID  Task       Date-Time File
ESPWSS4649I USER02 2 00F810 20030801-141823 xxxx.PROCLIB(TEST)
ESPWSS4650I Locks currently held = 1
ESPWSS000 -->

If you want to unlock the file, you then enter:
/F ESPWSS,UNDOLOCK ID(n) ------> where n is the ID number from the LISTLOCK command.
ESPWSS4644I 'UNDOLOCK ID(2)' submitted by user USER01 at 20030801-141934
ESPWSS4645I File xxxx.PROCLIB(TEST) unlocked by USER01 at 20030801-141934; owner was USER02
ESPWSS4646I Locks released = 1
ESPWSS000 -->

The xxxx.PROCLIB(TEST) is no longer locked.

For recording purposes the LISTLOCK and UNDOLOCK are captured in the ESP Workstation Server STC log:
ESPWSS4638I File xxxx.PROCLIB(TEST) locked
ESPWSS4644I 'UNDOLOCK ID(2)' submitted by user USER01 at 20030801-144124
ESPWSS4645I File xxxx.PROCLIB(TEST) unlocked by USER01 at 20030801-1441
ESPWSS4646I Locks released = 1