z/OS Security Server RACROUTE Macro Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


RACDEF (execute form)

z/OS Security Server RACROUTE Macro Reference
SA23-2294-00

The execute form of the RACDEF macro is written as follows:

   
   name name: Symbol. Begin name in column 1.
   
One or more blanks must precede RACDEF.
   
RACDEF  
   
One or more blanks must follow RACDEF.
   
ENTITY=profile name addr profile name addr: Rx-type address
Note: ENTITY must be specified on either the list or the execute form of the macro.
   
    ,VOLSER=vol addr vol addr: Rx-type address or register (2) – (12)
Note: VOLSER is required only for CLASS=‘DATASET’ and DSTYPE not equal to M when a discrete profile name is used.
   
    ,TYPE=DEFINE  
    ,TYPE=DEFINE, new dsn addr: Rx-type address or register (2) – (12)
    NEWNAME=  
    new dsn addr  
    ,TYPE=ADDVOL, old vol addr: Rx-type address or register (2) – (12)
    OLDVOL=  
    old vol addr  
   ,TYPE=CHGVOL,  
    OLDVOL=  
    old vol addr  
   ,TYPE=DELETE  
   
    ,DDNAME=ddname addr ddname addr: A-type address or register (2) – (12)
Note: DDNAME is valid for OPEN/CLOSE routine.
   
    ,DSTYPE=N  
    ,DSTYPE=V  
    ,DSTYPE=M  
    ,DSTYPE=T  
   
    ,INSTLN=parm list addr parm list addr: Rx-type address or register (2) – (12)
   
    ,CLASS=class name addr class name addr: Rx-type address or register (2) – (12)
   
    ,MENTITY=entity addr entity addr: Rx-type address or register (2) – (12)
   
    ,MCLASS=class name class name addr: Rx-type address or register (2) – (12)
    addr  
   
    ,MVOLSER=volser addr volser addr: Rx-type address or register (2) – (12)
   
    ,MGENER=ASIS  
    ,MGENER=YES  
   
    ,ACEE=acee addr acee addr: Rx-type address or register (2) – (12)
   
    ,UNIT=unit addr unit addr: Rx-type address or register (2) – (12)
   
    ,OWNER=owner id addr owner id addr: Rx-type address or register (2) – (12)
   
    ,LEVEL=number  
    ,LEVEL=reg reg: Register (2) – (12)
   
    ,UACC=ALTER  
    ,UACC=CONTROL  
    ,UACC=UPDATE  
    ,UACC=READ  
    ,UACC=EXECUTE  
    ,UACC=NONE  
    ,UACC=reg reg: Register (2) – (12)
   
    ,DATA=data addr data addr: Rx-type address or register (2) – (12)
   
    ,AUDIT=NONE  
    ,AUDIT=audit value audit value: ALL, SUCCESS, or FAILURES
    ,AUDIT=(audit value access level: READ, UPDATE, CONTROL, or ALTER
    (access level),  
    audit value  
    (access level))  
    ,AUDIT=(reg) reg: Register (2) – (12)
   
    ,RACFIND=YES  
    ,RACFIND=NO  
   
    ,CHKAUTH=YES  
    ,CHKAUTH=NO  
   
    ,GENERIC=YES  
    ,GENERIC=NO  
   
    ,WARNING=YES  
    ,WARNING=NO
Note: Warning is valid only if TYPE=DEFINE is specified.
   
    ,RELEASE=number number: 1.8.1, 1.8, 1.7, or 1.6
    ,RELEASE=(,CHECK) Default: RELEASE=1.6
    ,RELEASE=  
    (number,CHECK)  
   
    ,FILESEQ=reg reg: Register (2) – (12)
    ,FILESEQ=number number: 1–65535
   
    ,EXPDT=expir-date addr expir-date addr: Rx-type address or register (2) – (12)
    ,RETPD=retn-period addr retn-period addr: Rx-type address or register (2) – (12)
    ,EXPDTX=extended extended expir-date addr: A-type address or register (2) – (12)
    expir-date addr  
   
    ,ENVIR=VERIFY Specifies that only verification is to be done.
   
    ,RESOWN=resource resource owner addr: Rx-type address or register (2) – (12)
    owner addr  
   
    ,STORCLA=storage class storage class addr: Rx-type address or register (2) – (12)
    addr  
   
    ,MGMTCLA=management management class addr: Rx-type address or register (2) – (12)
    class addr  
   
    ,ACCLVL=(access value access value addr: Rx-type address or register (2) – (12)
    addr)  
    ,ACCLVL=(access value parm list addr: Rx-type address or register (2) – (12)
    addr,parm list addr)  
   
    ,TAPELBL=STD  
    ,TAPELBL=BLP  
    ,TAPELBL=NL  
   
    ,SECLVL=addr addr: Rx-type address or register (2) – (12)
   
    ,ERASE=YES  
    ,ERASE=NO  
   
    ,NOTIFY=notify-id addr notify-id addr: Rx-type address or register (2) – (12)
   
,MF=(E,ctrl addr) ctrl addr: Rx-type address or register (1) or (2) – (12)
The parameters are explained under the standard form of the RACDEF macro instruction with the following exceptions:
,MF=(E,ctrl addr)
specifies the execute form of the RACDEF macro, using a remote, control-program parameter list.
,RELEASE=number
,RELEASE=(,CHECK)
,RELEASE=(number,CHECK)
specifies the RACF® release level of the parameter list to be generated by this macro.

To use the parameters associated with a release, you must specify the release number of that release or a later release number. If you specify an earlier release level, the parameter is not accepted by macro processing, and an error message is issued at assembly time. For the parameters that are valid for RELEASE=1.6 and later, see Table 1.

The default is RELEASE=1.6.

When you specify the RELEASE keyword, checking is done at assembly time. Compatibility between the list and execute forms of the RACDEF macro is validated at execution time if you specify the CHECK subparameter on the execute form of the macro.

The size of the list form expansion must be large enough to accommodate all parameters defined by the RELEASE keyword on the execute form of the macro. Otherwise, when CHECK processing is requested, the execute form of the macro is not done, and a return code of X'64' is returned.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014