USEREXIT FORMAT FMTMINI EXEC

Products

• VM:Secure for z/VM

Issue/Introduction

When I issue the ADDE entry command with the linux skeleton the FORMAT exit does not have all the disks needed. See console below.
The disk for link_vaddr does not exist and if I try to LINK it I am told the userid does not exist.

How do I use this exit with the FORMAT exit.


     4 *-* parse arg userid userid2 vaddr acigroup link_vaddr fmtmode fmtblksiz 
 ,      fmtlabel fmttype macroname fmtcmd cmdtarget                             
       >>>   "PM1PKR"                                                           
       >>>   "TEST"                                                             
       >>>   "100"                                                              
       >>>   "*"                                                                
       >>>   "100"                                                              
       >>>   "B"                                                                
       >>>   "4096"                                                             
       >>>   "DK0100"                                                           
       >>>   "ADD"                                                              
       >>>   "MAN000S0"                                                         
       >>>   "FORMAT"                                                           
       >>>   "SERVANT"                                                          
     6 *-* 'CP Q V DA'                                                          
       >>>   "CP Q V DA"                                                        
DASD 0190 3390 N20RES R/O        214 CYL ON DASD  C755 SUBCHANNEL = 0004        
DASD 0191 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 000C        
DASD 0193 3390 N20RES R/O        500 CYL ON DASD  C755 SUBCHANNEL = 0007        
DASD 0194 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 0011        
DASD 019D 3390 N20RES R/O        292 CYL ON DASD  C755 SUBCHANNEL = 0005        
DASD 019E 3390 N20RES R/O        500 CYL ON DASD  C755 SUBCHANNEL = 0006        
DASD 01A0 3390 N20RES R/W      11130 CYL ON DASD  C755 SUBCHANNEL = 000A        
DASD 01B0 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 000D        
DASD 01B1 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 000E        
DASD 01B2 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 000F        
DASD 01D0 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 0010        
DASD 0293 3390 N20G01 R/W          5 CYL ON DASD  CD81 SUBCHANNEL = 000B        
DASD 2192 3390 WSS201 R/O         20 CYL ON DASD  C993 SUBCHANNEL = 0012        
     7 *-* exit 0                                                               

Environment

Release : 3.2

Component : CA VM:Secure for z/VM

Resolution

For the FORMAT user exit part:

 

Though the FORMAT user exit runs on the VM:Secure service machine,  the work (formatting) is done on a servant (for those running with servant support) or on the user running the command (if NO servant support (SERVANT OFF)). 

 

So, the exit controls what happens by issuing VM:Secure primitive macro calls to the SERVANT or USER, depending on the field cmdtarget passed to the exit.  In your case,  cmdtarget = SERVANT.  

 

Since the servant is doing the formatting, the device doesn't exist on VM:Secure service machine, but  on the SERVANT that will do the formatting. This is why you don't see the information for the disk on the CP Q V DA issued in the exit on VM:Secure.

 

See VMXEXITK XEXEC for prototype logic to help you send the commands needed to the VMSECURE servant to do the formatting you need to do.  It can be found on the SAMPZ disk in the VMFSETUP for VM:Secure.  

See the VM:Secure Primitives for User Exits documentation in the beginning of the user exits reference in the Reference documentation: 

 

https://techdocs.broadcom.com/us/en/ca-mainframe-software/traditional-management/ca-vm-secure-for-z-vm-with-security/3-2/reference/user-exit-reference/vmsecure-primitives-in-user-exits.html