Message C1G0087E in Endevor ALTER action

Products

• Endevor

Issue/Introduction

ALTER action might fail with error message

C1G0087E  ALTER ACTION FAILED BECAUSE SMF RECORDING IS NOT ACTIVE FOR ENVIRONMENT <env_name>

Cause

ALTER action requires SMF recording to be enabled for element actions in the environment affected by the action. If it is not enabled, ALTER fails with this error message C1G0087E, which contains the name of the affected environment.

The background reason is that, should any problem be triggered by the changes made by the ALTER action, reporting on SMF data would be the only way to determine whether an ALTER action had been performed (and by whom).

Resolution

For static environments (defined in the C1DEFLTS table), SMF action recording needs to be enabled for the environment by parameter SMFACT=Y in the  C1DEFLTS TYPE=ENVRNMNT macro that defines it. The table needs to be re-assembled so that the change takes effect.

If the environment is dynamically defined, then WRITE SMF ACTION RECORDS clause needs to be added to the DEFINE ENVIRONMENT statement that defines it. The statement needs to be executed by the batch admin utility ENBE1000.

Remember that DEFINE statements processed by the ENBE1000 utility update the object in question (the dynamic environment in this case) when it is found to be already present.

Remember also that SMF recording at the environment level requires also SMF recording to be enabled by setting a SMF record number in parameter SMFREC# in C1DEFLTS TYPE=MAIN

Finally, remember that SMF recording requires Endevor to run with APF authorization for all loadlibs named in STEPLIB DD

In order to 'see' whether SMF recording is enabled, an options report may be taken, for example, by adding //EN$TROPT DD SYSOUT=*,SPIN=NO to the JCL step that runs the ALTER action. The report (written to EN$TROPT DD) shows the required information. For example:

...
CUSTOMER NAME....<customer name>                                          
                                                                           
--------------------------------------------------------------- - Options -
Site ID..........0                Access Tbl........<table>     ACM.......Y
Version..........19.0.00          SMF Record Number.000         DB2.......N
Environments.....5                Library System....LB          QuickEdit.Y
...
ENVIRONMENT NAME........<name>        ENVIRONMENT TITLE.......<title> 
Next Env Name...........<name>        WRK           Next Stage ID...........2              
Write SMF Action Recs...N             Write SMF Security Recs.N             Write SMF Admin Recs....N
...