I tried changing a GSO(SAFDEF) record by modifying data in the RACROUTE section, and got error ACF00219 INVALID RACROUTE VALUE FOR FLD: KEYWORD NOT DEFINED

Document ID : KB000054579
Last Modified Date : 14/02/2018
Show Technical Document Details

Question:

I created a SAFDEF record by copying an existing SAFDEF record:

    ACF 
    SET CONTROL(GSO) 
    insert using(safdef.x1) safdef.sys
    SYS1 / SAFDEF.SYS LAST CHANGED BY SECURITY ON mm/dd/yy-hh:mm 
        FUNCRET(8) FUNCRSN(0) ID(MQX1) MODE(IGNORE) 
        RACROUTE(CLASS=DATASET REQUEST=AUTH ENTITYX=SECURITY.OLD) RETCODE(4) 

I needed to change the dataset name in the SAFDEF record, so I issued a CHANGE command:

    ACF 
    T C(GSO) 
    CHANGE SAFDEF.SYS RACROUTE(ENTITYX=SECURITY.NEW) rep 
    END 

and got an error message:

    ACF00219 INVALID RACROUTE VALUE FOR FLD: ENTITYX=SECURITY.NEW RSN: KEYWORD NOT DEFINED 

What is wrong with the command?

Answer: 

The problem is that any SAFDEF record that has RACROUTE parameters included needs to include a REQUEST= parameter, and in this case, since REPLACE is used, everything from the old value in the RACROUTE area needs to be included. The change command should be similar to this:

    ACF 
    T C(GSO)                                                                           
    CHANGE SAFDEF.SYS RACROUTE(CLASS=DATASET,REQUEST=AUTH,ENTITYX=SECURITY.NEW) REP 
    END