ACFBSYNC - Batch Sync Utility

Describes the ACFBSYNC batch sync utility.
acf2src
The ACFBSYNC utility provides a high-speed batch utility to synchronize the SYS1.BRODCAST data set with the Logonid database for TSO users. ACFBSYNC accepts a newly allocated BRODCAST data set or an old BRODCAST data set. The entire data set is rebuilt for processing, including both the Notices section and User Mail Directory.
The INSERT subcommand of the ACF command adds new logonids to the data set. To limit the users added, set the GSO TSO record to LOGONCK. This setting checks for only the TSO attribute in the logonid before adding the logonid to the BRODCAST data set. This is
not
true, however, if a SYSUT1 input file has been specified. In the case of SYSUT1, the only check performed is making sure the logonid is not more than seven characters. Full ACCOUNT privileges are required to execute ACFBSYNC.
You must run the TSO SYNC command at least once before running the ACFBSYNC to initialize and build a new BRODCAST data set or to rebuild the data set when it becomes full or is damaged. Use the UADS option when issuing the SYNC command for an ACF2 system (for example, SYNC UADS). To run the TSO SYNC command, you must have the TSO ACCTPRIV privilege.
Files
  • SYSLBC
    Identifies the BRODCAST data set that is built. If this DD statement points to an old BRODCAST data set, only the user mail section is rebuilt. If the DD statement points to a newly allocated BRODCAST data set, that data set is built from scratch. ACFBSYNC issues an enqueue for integrity so the active system BRODCAST data set might be rebuilt. Broadcom advises that you undertake such a process during low usage hours.
  • SYSUT1
    Specifies that a file must define a variable format data set containing CA ACF2 logonid records. Produce this file from the daily CA ACF2 backups or as the SAVEREC output from the ACFRPTSL report generator. If not specified, ACFBSYNC uses the online CA ACF2 Logonid database (that implies CA ACF2 is active) as input.
Parameters
Parameters are valid only when the online Logonid database is processed. These parameters are not valid if the SYSUT1 input file is specified.
  • [IF(
    attribute-name-1,...,attribute-name-n
    )]
    Specifies that only those logonid records that have the specified attribute fields in their logonid record are added to the SYS1.BRODCAST data set. Specify the IF parameter as one attribute name or with multiple attribute names separated by commas. Multiple attribute names are processed using AND logic. This means that an ACFBSYNC parameter of IF(TSO,ACCOUNT), adds logonid records that have both the TSO and ACCOUNT attributes to the SYS1.BRODCAST data set. You can specify any field defined as a bit field in the logonid record in the IF parameter. Use the IF parameter with the LIKE and UID parameters. This format enables you to further define the ACFBSYNC selection criteria.
  • [LIKE(
    ********
    |logonidmask)]
    Specifies that only those logonid records that match the specified logonid mask are created in the SYS1.BRODCAST data set. The default is all logonids.
  • [UID(
    -
    |
    uid-mask
    )]
    Specifies that only those logonid records whose UID matches the specified UID mask are created in the SYS1.BRODCAST data set. The default is all users.
Example
SAMPLE JOB STREAMS TO RUN ACFBSYNC - //SYNCH JOB1 (ADD ALL CA ACF2 LOGONIDS TO BRODCAST) //SYNCH EXEC PGM=ACFBSYNC //SYSLBC DD DSN=SYS1.BRODCAST,DISP=OLD //SYNCH JOB1 (ADD ONLY LOGONIDS WITH TSO ATTRIBUTES TO BRODCAST) //SYNCH EXEC PGM=ACFBSYNC,PARM='IF(TSO)' //SYSLBC DD DSN=SYS1.BRODCAST,DISP=OLD //SYNCH JOB1 (ADD LOGONIDS BASED ON INPUT FILE) //SYNCH EXEC PGM=ACFBSYNC //SYSLBC DD DSN=SYS1.BRODCAST,DISP=OLD //SYSUT1 DD DSN=INPUT.LOGONIDS,DISP=SHR
Notes
  • For ACFBSYNC processing, the ID is restricted to no more than seven characters in length. Any logonid in the input to ACFBSYNC that is eight characters in length is bypassed.
  • All messages produced by ACFBSYNC appear in the executing user's JOBLOG. See
    Messages
    for a description of the messages.
  • To use ACFBSYNC, run the SYNC command at least once on any new BRODCASTdata set.
  • Upon completion, ACFBSYNC issues termination messages identifying the number of logonids input and the number placed in the BRODCAST data set.
  • Parameters are valid only when the online Logonid database is used as input.
  • All messages currently in the Notices and User Mail Directory are deleted after running the ACFBSYNC utility.
  • The disposition of the BRODCAST data set on the SYSLBC DD statement can be OLD or SHR.