How do you use the ACF command in batch?

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

Summary:

You can use ACF commands in batch in several different ways:

  • Use the ACF2 supplied program: PGM=ACFBATCH

  • Use the IBM supplied Batch TSO (or Batch TMP) program: PGM=IKJEFT01

For this document, we will review the use of ACFBATCH and IKFEFT01

There are several other ACF2 batch processing utilities: ACFBCOMP, ACFDCOMP, ACFBSYNC, ACFESGP, ACFMERGE, ACFNRULE, ACFRPG, ACFRULCU, and ACFXREF. All of these utilities (including ACFBATCH) are documented in the CA ACF2 Reports and Utilities Guide.

 

Instructions:

ACFBATCH:

The ACFBATCH utility program allows you to execute the ACF commands necessary to maintain logonids, DSN access rules, resource rules, and all the other Infostorage database records, in batch. When adding (inserting) or changing logonids, you will need to run the ACFBSYNC utility to synchronize the new logonid additions or changes with SYS1.BRODCAST.

Sample JCL:

//*** YOUR STANDARD JOB CARD ***      
//*                                   
//STEP010  EXEC  PGM=ACFBATCH         
//SYSHELP  DD  DISP=SHR,DSN=SYS1.HELP 
//SYSPRINT DD  SYSOUT=*               
//SYSIN    DD  *                      
 SHOW STATE     
SET RESOURCE( FAC) LIST BPX //*

NOTE: the SYSHELP DD is only required when you want to issue the HELP command. Specify the HELP dataset for ACF2.



IKJEFT01:

The IBM supplied program, IKJEFT01, allows you to perform TSO processing in batch. This program will put the batch session into the TSO READY mode. The primary difference between ACFBATCH and using IKJEFT01 is that you need to enter "ACF" in the TSO environment to get into ACF mode. Then the ACF commands can be issued. A subsequent END command will put the batch session back into TSO READY mode. At that point if another ACF command is to be issued, then you need to specify ACF again to get into ACF mode.

Sample JCL using IKJEFT01 to issue an ACF command, a (TSO) LISTC command, and another ACF command:

//*** YOUR STANDARD JOB CARD ***   
//*                                
//STEP010  EXEC  PGM=IKJEFT01      
//SYSTSPRT DD  SYSOUT=*            
//SYSTSIN  DD  *                   
 ACF                               
 SHOW STATE                        
 END                               
 
 LISTC ENTRY('SYS1.LINKLIB') ALL   
                                   
 ACF                               
SET CONTROL(GSO) LIST OPTS END //*

Note: as with ACFBATCH, a DD for SYSHELP can be supplied if you need to issue the HELP command. This can be a concatenation that includes both the system HELP dataset and the ACF2 HELP dataset. 

 

Additional Information:

 

CA ACF2 Report and Utilities Guide (does not include IBM IKJEFT01)