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


RACROUTE REQUEST=DEFINE (execute form)

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

The execute form of the RACROUTE REQUEST=DEFINE macro is written as follows. Refer to the standard form of the RACROUTE REQUEST=DEFINE macro to determine additional parameters that are required by the time the RACROUTE service is invoked using the execute form of the macro.

   
   name name: Symbol. Begin name in column 1.
   
One or more blanks must precede RACROUTE.
   
RACROUTE  
   
One or more blanks must follow RACROUTE.
   
REQUEST=DEFINE  
   
    ,ACCLVL=access access value addr: Rx-type address or register (2) – (12)
    value addr  
    ,ACCLVL=(access value parm list addr: Rx-type address or register (2) – (12)
    addr,parm list addr)  
   
    ,ACEE=acee addr acee 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)
   
    ,CHKAUTH=YES  
    ,CHKAUTH=NO  
   
    ,CLASS=class name addr class name addr: Rx-type address or register (2) – (12)
   
    ,DATA=data addr data addr: Rx-type address or register (2) – (12)
   
    ,DSTYPE=N  
    ,DSTYPE=V  
    ,DSTYPE=M  
    ,DSTYPE=T  
   
    ,ENTITY=profile name profile name addr: Rx-type address
    addr  
    ,ENTITYX=extended extended profile name addr: Rx-type address or register (2) – (12)
    profile name addr  
Note: ENTITY or ENTITYX must be specified on the list, execute, or modify form of the macro.
   
    ,ENVIR=VERIFY Specifies that only verification is to be done.
   
    ,ERASE=YES  
    ,ERASE=NO  
   
    ,EXPDT=expir-date addr expir-date addr: Rx-type address or register (2) – (12)
    ,EXPDTX=extended extended expir-date addr: Rx-type address or register (2) – (12)
    expir-date addr  
    ,RETPD=retn-period addr retn-period addr: Rx-type address or register (2) – (12)
   
    ,FILESEQ=number number: 1–65535
    ,FILESEQ=reg reg: Register (2) – (12)
   
    ,GENERIC=YES  
    ,GENERIC=ASIS  
   
    ,INSTLN=parm list addr parm list addr: Rx-type address or register (2) – (12)
   
    ,LEVEL=number  
    ,LEVEL=reg reg: Register (2) – (12)
   
    ,MCLASS=class class name addr: Rx-type address or register (2) – (12)
    name addr  
   
   
    ,MENTITY=entity addr entity addr: Rx-type address or register (2) – (12)
    ,MENTX=extended extended entity addr: Rx-type address or register (2) – (12)
    entity addr  
   
    ,MGENER=ASIS  
    ,MGENER=YES  
   
    ,MGMTCLA=management management type addr: Rx-type address or register (2) – (12)
    type addr  
   
    ,MVOLSER=volser addr volser addr: Rx-type address or register (2) – (12)
   
    ,NOTIFY=notify-id addr notify-id addr: Rx-type address or register (2) – (12)
   
    OWNER=owner id addr owner id addr: Rx-type address or register (2) – (12)
   
    ,RACFIND=YES  
    ,RACFIND=NO  
   
    ,RELEASE=number number: See Standard Form
    ,RELEASE=(,CHECK) Default: RELEASE=1.6
    ,RELEASE=  
    (number,CHECK)  
   
    ,RESOWN=resource resource owner addr: Rx-type address or register (2) – (12)
    owner addr  
   
    ,SECLABL=addr addr: Rx-type address or register (2) – (12)
   
    ,SECLVL=addr addr: Rx-type address or register (2) – (12)
   
    ,STORCLA=storage class storage class addr: Rx-type address or register (2) – (12)
    addr  
   
    ,TAPELBL=STD  
    ,TAPELBL=BLP  
    ,TAPELBL=NL  
   
    ,TYPE=DEFINE  
    ,TYPE=DEFINE, new resource name addr: A-type address or register (2) – (12)
    NEWNAME=new  
    resource name addr  
   
    ,TYPE=DEFINE, extended new resource name addr: A-type address or register (2) – (12)
    NEWNAMX=extended  
    new resource name  
    addr  
    ,TYPE=ADDVOL, old vol addr: A-type address or register (2) – (12)
    OLDVOL=old  
    vol addr  
    ,TYPE=CHGVOL, old vol addr: A-type address or register (2) – (12)
    OLDVOL=old  
    vol addr  
    ,TYPE=DELETE  
   
    ,UACC=ALTER  
    ,UACC=CONTROL  
    ,UACC=UPDATE  
    ,UACC=READ  
    ,UACC=EXECUTE  
    ,UACC=NONE  
    ,UACC=reg reg: Register (2) – (12)
   
    ,UNIT=unit addr unit addr: Rx-type address or register (2) – (12)
   
    ,VOLSER=vol addr vol addr: Rx-type address or register (2) – (12)
Note: VOLSER is required for CLASS=DATASET and DSTYPE not equal to M when a discrete profile name is used.
   
    ,WARNING=YES
Note: Warning is valid if TYPE=DEFINE is specified.
    ,WARNING=NO  
   
   ,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 RACROUTE REQUEST=DEFINE macro instruction with the following exceptions:
,MF=(E,ctrl addr)
specifies the execute form of the RACROUTE REQUEST=DEFINE 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.

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 RACROUTE REQUEST=DEFINE 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