Skip to Content

Default language.

Task Lock Function

The PTF IWH158A provides users with a secure mechanism to protect their tasks, thereby preventing any Code Pipeline operations on the task until it is unlocked. To enable this feature, you must add an M.EX entry (LK) and an M.ER variable (TASKLOCK).

Warning

Important

  • To lock a task, you must use a REXX program that uses WZZTSI to do a TASK SETPROC.
  • To unlock a task, you must either use a REXX program that uses WZZTSI to do a TASK ENDPROC, use the CU command in ISPF, or select Cleanup in Workbench.

M.EX Entry – LK

This entry requires the Operation to be set as LK, the Exit Key as $$$$, and the Preop Routine must be set as INTERNAL. The following is a sample configuration:

M.EX               MODIFY PROCESSING EXIT DETAIL (ISPW)                     
Command ===>                                                                
                                                                           
Enter required details:                                                     
                                                                           
 Operation  (KEY) ==> LK                                                   
 Exit Key   (KEY) ==> $$$$                                                 
 Description      ==> ISPW LK OP FOR TASK LOCK                             
                                                                           
 Preop Routine    ==> INTERNAL                                             
                                                                           
                                                                           
 Postop Routine   ==>                                                      
                                                                           
                                                                           
 Valid In Environment  OUTS ==> N (Y yes, N no)                            
                       TEST ==> Y (Y yes, N no)                            
                       HOLD ==> Y (Y yes, N no)                            
                       PROD ==> Y (Y yes, N no)                            
 Update Last Operation Code ==> Y (Y yes, N no)                            
                                                                           
Press ENTER to complete the change or END to terminate                      
Note: You can add a new entry by overtyping the Keys with new unique values 

M.ER Entry – TASKLOCK

This entry requires the Type Code to be set as TASKLOCK, and View Code must be blank.

The Variable/Dsname must start with LK. The other four parameters are optional, with default values if not specified. The overall length must not exceed 55 characters.

Specify the variable using the following syntax:

LK ID(uuuuuuu) RQ(rrr) CU(ccc) LVLS(llll,llll)

where,

  • ID(uuuuuuu):
    • Specifies the userid that will be displayed as the one locking the task.
    • If omitted, the requesting user’s userid is displayed.
  • RQ(rrr):
    • Specifies the required level of authority for a user to lock a task.
    • Defaults to ADM (admin authority) if not specified.
    • Options:
      • ADM: The user must have admin authority.
      • ANY: Any user can lock a task.
  • CU(ccc):
    • Specifies the required authority level for a user to unlock a task.
    • Defaults to ADM (admin authority) if not specified.
    • Options:
      • ADM: The user must have admin authority.
      • ANY: Any user can unlock a task.
  • LVLS(llll, llll):
    • Specifies a list of levels for which a task lock operation can be requested for a task.
    • If not specified, all levels are considered valid.
    • The number of levels permitted is limited only by the allowable size of the LK string.

The following is a sample configuration:

M.ER               MODIFY EXTERNAL REFERENCE DETAIL (ISPW)                 
Command ===>                                                               
                                                                          
Enter required details:                                                    
                                                                          
 Type Code (KEY) ==> TASKLOCK           View Code (KEY) ==>               
                                                                          
 Description     ==> TASK LOCK CONTROLS                                   
                                                                          
 Variable/Dsname ==> LK ID(LOCKUID) RQ(ADM) CU(ADM) LVLS(DEV1,HLD1)       
 (Fully qualified if data set name, no quotes)                            
                                                                          
Press ENTER to complete the change or END to terminate                     
Note: You can add a new entry by overtyping the keys with new unique values

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI DevX Code Pipeline 22.01